Otomatik kullanıma sunma özelliğini etkinleştirdiyseniz GitHub deponuzdaki canlı dala her yeni kayıt gönderdiğinizde App Hosting, uygulamanızın yeni bir sürümünü otomatik olarak kullanıma sunar. Kullanıma sunma durumunu Firebase konsolundan veya App Hosting GitHub kontrolünden kontrol edebilirsiniz.
Ayrıca App Hosting, CI/CD entegrasyonu veya kullanıma sunmayı zorunlu kılmak istediğiniz diğer durumlar için manuel olarak tetiklenen kullanıma sunma işlemlerini destekler.
Kullanıma sunma işlemlerini görüntüleme
Firebase Console, uygulamanızın tüm kullanıma sunma işlemleriyle ilgili ayrıntılı bilgilere erişmenizi sağlar.
Hosting & Serverless> App Hosting'e gidin, ardından kullanıma sunma işlemlerini görmek istediğiniz arka uç için Görüntüle'yi seçin. Arka uç için Kullanıma sunma işlemleri sekmesinde, bu arka uç için tüm kullanıma sunma işlemlerinin geçmişini listeleyen bir tablo gösterilir.
Her sunum girişi, Cloud Build işine ve sunumu tetikleyen değişikliğe veya kayda bağlantılar içerir. Ayrıca yazar, oluşturma tarihi ve sunumun durumu hakkında temel bilgiler de sunar.
- Cloud Build işi, App Hosting aracının uygulamanızın derleme komutunu çalıştırdığı derleme ortamıdır. Derleme kimliğini tıklayarak Cloud Build günlüklerine erişebilirsiniz.
- Değişiklik, kullanıma sunmayı tetikleyen GitHub kaydı veya başka bir işlemdir.
Kullanıma sunma işlemini manuel olarak tetikleme
Yeni bir kaydetme göndermeden GitHub kaynağınızdan manuel olarak bir kullanıma sunma tetiklemek istiyorsanız Firebase konsolundan veya Firebase KSA'dan bir kullanıma sunma oluşturabilirsiniz. Bu, aşağıdaki gibi durumlarda kullanışlıdır:
- Statik içeriğin yeniden oluşturulmasını zorunlu kılma
- CI/CD sisteminin kullanıma sunma işlemlerini tetiklemesine izin verme
- Üretim kullanıma sunma işlemlerini belirli tarihler veya saatlerle sınırlama
Firebase konsolunda kullanıma sunma işlemini tetiklemek için:
- Firebase konsolunda Hosting & Serverless > App Hosting'e gidin.
- Kullanıma sunma oluşturmak istediğiniz arka uç için Görüntüle'yi tıklayın.
- Arka uç kontrol paneli özetinde Kullanıma sunma oluştur'u seçin.
- Dağıtılacak dalı seçin.
- Dağıtılacak kaydı (en son kayıt veya kayıt kimliğiyle belirtilen daha önceki bir kayıt) seçin.
- Oluştur'u seçin. Sürümün durumu ve derleme numarası, sürüm geçmişi tablosunda gösterilir. Kullanıma sunma süreci tamamlandığında bu sürüm, mevcut sürüm olarak gösterilir.
Firebase KSA'da bir kullanıma sunmayı tetiklemek için aşağıdaki komutu çalıştırın ve istendiğinde kullanıma sunma için dalı seçin:
firebase apphosting:rollouts:create BACKEND_ID
Alternatif olarak, --git-branch seçeneğini kullanarak belirli bir dal için en son kaydetme işleminin sunumunu başlatabilirsiniz:
firebase apphosting:rollouts:create BACKEND_ID
--git-branch BRANCH_NAME
--git-commit seçeneğini kullanarak belirli bir kaydetme işlemiyle de sunum oluşturabilirsiniz:
firebase apphosting:rollouts:create BACKEND_ID
--git-commit COMMIT_ID
Önceki bir kullanıma sunma işlemini geri yükleme
App Hosting, önceki bir sunumu geri yüklemek için iki seçenek sunar:
- Yeniden derleme yapmadan anında geri alma
- Yeniden derleme ve önceki bir sürüme geri alma
Anında geri alma işlemi oluşturma
Bazen uygulamanızın önceki bir sürümüne hızlıca geri dönmeniz gerekebilir. Örneğin, yeni kullanıma sunulan bir sürümde kritik bir hata keşfettiyseniz veya yeni sürümlerin kullanıma sunulmasını engelleyen, kararsız bir derleme sorunu yaşıyorsanız bu işlemi yapmanız gerekebilir. Bu gibi durumlarda, önceki bir sunumdan istediğiniz mevcut bir container görüntüsünü geri yükleyebilirsiniz. Bu görüntü yeniden oluşturulmaz ancak ilk oluşturulduğu zamanki kodu ve ortam yapılandırmasını kullanır.
Anında geri alma işlemi oluşturmak için:
- Firebase konsolunda Hosting & Serverless > App Hosting'e gidin.
- Geri alma işlemi oluşturmak istediğiniz arka uç için Görüntüle'yi tıklayın.
- Kullanıma sunma sekmesini seçin.
- Arka uç için Geçmiş tablosunda, önceki bir derlemenin üç nokta menüsünü seçin.
- Bu derlemeye geri dön'ü seçip onaylayın.
Yeniden oluşturma ve geri alma
Uygulamanızın eski bir sürümüne geri dönmek ancak mevcut yapılandırmayı korumak istiyorsanız geri alma işlemi kapsamında uygulamayı yeniden derleyebilirsiniz. Örneğin, en son sürümünüz Secret Manager içinde bir API anahtarı değerini güncellediyse yeniden derleme, geri alma işleminden sonra uygulamanızda yeni anahtarın kullanılmasını sağlayabilir.
Yeniden oluşturmak ve geri almak için:
- Firebase konsolunda Hosting & Serverless > App Hosting'e gidin.
- Geri alma işlemi oluşturmak istediğiniz arka uç için Kontrol panelini görüntüle'yi tıklayın.
- Kullanıma sunma sekmesini seçin.
- Kullanıma sunum oluştur'u seçin.
- Create a rollout (Dağıtım oluştur) iletişim kutusunda Earlier commit'i (Önceki kayıt) seçin ve ardından yeniden derlemek ve geri dönmek istediğiniz sürümün kayıt kimliğini girin. İşleme kimliği, Kullanıma sunma geçmişinizde listelenen her kullanıma sunma işleminin "Değişiklik ayrıntıları" bölümünde yer alır ve etikette parantez içinde gösterilir.
- Geri alma işlemini başlatmak için Oluştur'u seçin.
Kullanıma sunma ayarlarını değiştirme
Bir arka uç için kontrol panelindeki Ayarlar > Dağıtım görünümündeki kontrolleri kullanarak kullanıma sunma işlemlerinin canlı dalını değiştirebilir ve otomatik kullanıma sunma işlemlerini devre dışı bırakabilir veya etkinleştirebilirsiniz.
- Firebase konsolunda Hosting & Serverless > App Hosting'e gidin.
- Kullanıma sunma ayarlarını güncellemek istediğiniz arka uç için Görüntüle'yi tıklayın.
- Arka uç kontrol panelinde Ayarlar'ı seçin. Varsayılan görünümde alanlar ve özel alanlar hakkında bilgiler gösterilir.
- Dağıtım görünümünü seçin. Bu görünümde, kullanıma sunma işlemlerinin canlı dalını değiştirebilir ve otomatik kullanıma sunma işlemlerini devre dışı bırakabilir veya etkinleştirebilirsiniz. Ayrıca, uygulama kök dizinini ve arka uç ortamını ayarlama seçenekleri de vardır (Birden fazla ortama dağıtma bölümüne bakın).
Otomatik kullanıma sunma işlemlerini yönetme
Varsayılan olarak App Hosting, tüm dosyaların "gerekli" olduğunu varsayar. Bu, deponuza yapılan her yeni kaydetme işleminin yeni bir derleme ve kullanıma sunma işlemini tetiklediği anlamına gelir. Ancak, zamandan tasarruf etmek ve gereksiz dağıtımları önlemek için App Hosting'ı, bir kayıtta değiştirilen belirli dosya yollarına göre derlemeleri atlayacak şekilde yapılandırabilirsiniz.
Bu ayarı Ayarlar > Kullanıma sunma işlemleri > Kullanıma sunma tetikleyicileri bölümünden yapılandırabilirsiniz. Burada, deponuza yapılan her yeni kaydetme işleminin yeni bir derleme ve sunumu tetiklemesini istiyorsanız Required Paths (Gerekli Yollar) alanını boş bırakabilir veya her zaman bir sunumu tetiklemesi gereken dizinleri ya da dosyaları tam olarak belirtebilirsiniz. Dizinleri belirtirseniz değişikliklerin kullanıma sunmayı tetiklemesi gereken tüm yolları eklediğinizden emin olun.
Yoksayılan Yollar'a eklediğiniz dizinler veya dosyalar hiçbir zaman otomatik kullanıma sunma işlemini tetiklemez. Bir alt dizinin hem gerekli hem de yoksayılanlar listesinde yer aldığı durumlarda otomatik kullanıma sunma tetiklenmez. Yalnızca yoksayılan yollar listesini doldurursanız App Hosting, gerekli yollar için "*" değerini otomatik olarak doldurur.
Değiştirilen dosyaların hiçbirinin gerekli yollarınızla eşleşmediği bir commit gönderirseniz
(veya tüm değişiklikler, yoksayılan yollarınız tarafından açıkça hariç tutulursa)
App Hosting, GitHub etkinliğinin alındığını onaylamaya devam eder ancak derleme ve kullanıma sunma durumlarını SKIPPED olarak işaretler ve otomatik kullanıma sunma tetiklenmez.