App Hosting, uygulamanızın dağıtımını basitleştirmek için karmaşık bir dizi arka plan görevini yönetir. Bu sayfa, görev akışının önemli bölümlerini açıklar ve uygulamanızın ihtiyaçlarına bağlı olarak akışı özelleştirmek isteyebileceğiniz noktalar hakkında bilgi sağlar.
Önemli terimler ve tanımlar
App Hosting akışının ayrıntılarını anlamak için bazı terimlerin çok net bir şekilde tanımlanması faydalıdır. Temel anahtar terimler şunlardır:
- Arka uç: App Hosting'nin web uygulamanızı oluşturmak ve çalıştırmak için oluşturduğu yönetilen kaynaklar koleksiyonu.
- Derleme: Uygulamanızın, genellikle bir git commit'ine bağlı olan belirli bir düzeltmesi. Derleme oluşturma sürecinde birçok alt süreç vardır. Bunlardan en önemlileri, Cloud Build'te uygulamanızın oluşturulması ve Cloud Run'te bir düzeltmenin yayılmasıdır (ilk olarak, kullanıma sunuluncaya kadar trafiğin% 0'ı sunulur).
- Yayınlama: Bir derlemeyi trafiği etkin bir şekilde sunacak şekilde ayarlama işlemi. Bir git commit'i tarafından otomatik olarak tetiklendiğinde App Hosting, canlı dalınızı kullanarak önce bir derleme oluşturur, ardından canlı trafiği buraya yönlendirmek için bir kullanıma sunma işlemi oluşturur.
- Yayındaki dal: GitHub deponuzun canlı URL'nize dağıtılan dalıdır. Genellikle özellik şubelerinin veya geliştirme şubelerinin birleştirildiği şubedir.
Google Cloud ve App Hosting mimarisi
App Hosting, web uygulamanızı dağıtabilmeniz, sunabilmeniz ve izleyebilmeniz için bir dizi Google Cloud ürününü koordine eder. Uygulamalar Cloud Build ile oluşturulur, Cloud Run üzerinde yayınlanır ve Cloud CDN'de önbelleğe alınır. Cloud Secret Manager gibi entegre hizmetler, API anahtarlarınızı güvende tutar.
- Bir taahhüt canlı şubenize itildiğinde Google Cloud Developer Connect, Firebase App Hosting adresine bir etkinlik gönderir.
- Bu etkinliğe yanıt olarak Firebase App Hosting, depoya bağlı arka uç için yeni bir derleme oluşturur.
- İlk olarak Firebase App Hosting, gönderiminiz için yeni bir Cloud Build derlemesi oluşturur. Bu işte, Google Cloud buildpack'leri, uygulamanıza uygun bir kapsayıcı ve yapılandırma (çevre değişkenleri, gizli veriler, minimum veya maksimum örnekler, eşzamanlı bellek, CPU ve VPC yapılandırması dahil) oluşturmak için uygulamanızda hangi çerçevenin kullanıldığını belirler. Daha fazla bilgi için App Hosting derleme sürecine bakın.
- Cloud Build işi tamamlandığında kapsayıcınız, Firebase App Hosting'ye özel bir Artifact Registry deposunda saklanır. Firebase App Hosting, görüntünüzü ve yapılandırmanızı kullanarak Cloud Run hizmetine yeni bir Cloud Run Düzeltme ekler.
- Cloud Run Düzeltmeniz tamamlandıktan ve sağlıklı olduğu doğrulandıktan sonra Firebase App Hosting, tüm yeni istekleri yeni Cloud Run Düzeltmenize yönlendirecek şekilde trafik yapılandırmasını değiştirir. Bu aşamada, kullanıma sunma işlemi tamamlanır.
- Firebase App Hosting üzerinde barındırılan bir web sitesine istek gönderildiğinde istek, Cloud CDN etkinken Google Cloud Yük Dengelemesi tarafından sunulur. Önbelleğe alınmamış istekler Cloud Run hizmetinize gönderilir. Cloud CDN ile performansı optimize etme hakkında bilgi edinmek için Uygulama içeriğini önbelleğe alma başlıklı makaleyi inceleyin.
Çerçeve entegrasyonu
App Hosting, aşağıdaki çerçevelerde geliştirilen web uygulamaları için önceden yapılandırılmış derleme ve dağıtım desteği sağlar:
- Next.js 13.5.x ve sonraki sürümler
- Angular 18.2.x ve üzeri
Belirli sürümler ve destek düzeyleriyle ilgili ayrıntılar için destek programlarına bakın.
App Hosting, Next.js ve Angular'a ek olarak çıktı paketi spesifikasyonumuzla eşleşen bir derleme çıkışı sağlayabilen tüm web çerçevelerini de destekler. App Hosting tarafından desteklenen çerçeveler, çerçeve bağdaştırıcılar ve ilgili araçlar hakkında daha fazla bilgi için App Hosting için çerçeveler ve araçlar başlıklı makaleyi inceleyin.
App Hosting deposu entegrasyonunun işleyiş şekli
GitHub deponuz ile App Hostingarka uç arasındaki önemli bağlantı, Google Cloud'un harici DevOps araçları için bağlantı platformu olan Developer Connect tarafından yönetilir. App Hosting arka uç oluştururken Developer Connect'in kullanıcı arayüzü iş akışı, Firebase GitHub uygulamasının kurulumunda size yol gösterir. Bu süreçteki önemli adımlar şunlardır:
- Developer Connect'e Secret Manager Yöneticisi rolünü verirsiniz. Bu sayede sistem, kimlik bilgilerini Cloud Secret Manager'da "gizli anahtar" olarak güvenli bir şekilde saklayabilir.
- Firebase GitHub uygulamasına GitHub deponuza erişmesi için yetki verin. Doğru depoya erişmek için ek GitHub izinlerine ihtiyacınız olabilir.
- Developer Connect, projenizin gizli yönetici deposunda özel bir GitHub yetkilendirme jetonu depolar. Bu jetonu değiştirmeyin veya silmeyin.
Ayrıca App Hosting, kullanıma sunma işlemi için kontrol sağlamak amacıyla GitHub Checks API ile entegre olur. Bu kontrol, kullanıma sunma işleminizin durumunu GitHub'da görüntülemenize ve hata olması durumunda dağıtım sürecinde hata ayıklamanıza olanak tanır.
Firebase ve diğer Google hizmetleriyle entegrasyon
App Hosting, Firebase Admin SDK'sını Google Uygulama Varsayılan Kimlik Bilgileri ile başlatabilmeniz için hem derleme hem de çalışma ortamınızı oluşturur. Böylece arka uç, hem derleme hem de çalışma zamanında diğer Firebase ürünleriyle iletişim kurabilir. Uygulamanızı başlatma ve Firebase SDK'larıyla ilgili diğer konular hakkında daha fazla bilgi için Firebase SDK'larını web uygulamanıza entegre etme başlıklı makaleyi inceleyin.
App Hosting yer
App Hosting, arka uç kaynaklarınızı birincil bölgeniz olarak adlandırılan belirli bir konumda oluşturur. App Hosting, hızlı yayınlama için küresel bir CDN ile entegre olurken önbelleğe alınmamış içerik, uygulamanızın birincil bölgesinden yayınlanır. Web uygulamanızın konumunda bu esnekliğin önemli avantajları vardır:
- Verileri coğrafi olarak kullanıcılarınıza daha yakın bir yere getirerek performansı iyileştirdi ve gecikmeyi azalttı.
- Bir bölgedeki App Hosting için meydana gelen büyük bir hata, diğer bölgelerde dağıtılan web uygulamalarını etkilemez.
Konsoldan veya Firebase CLI'den App Hosting arka uç oluştururken bu bölgelerden herhangi birini seçebilirsiniz:
us-central1(Iowa)asia-east1(Tayvan)europe-west4(Hollanda)
App Hosting arka uç hizmet hesabı
App Hosting arka uç, derleme sırasında ve çalışma zamanında bir hizmet hesabıyla diğer Google hizmetleriyle kimlik doğrulaması yapar. Firebase projesinde App Hosting'ü ilk kez etkinleştirdiğinizde bu amaçlar için bir varsayılan hizmet hesabı oluşturulur:
firebase-app-hosting-compute@PROJECT ID.iam.gserviceaccount.com
Bu hizmet hesabı varsayılan olarak tüm arka uçlar için geçerlidir ve uygulamanızı oluşturmanıza, çalıştırmanıza ve izlemenize olanak tanıyan minimum bir izin grubuna sahiptir. Ayrıca, Cloud Firestore'den veri yükleme gibi işlemleri gerçekleştirmek için Yönetici SDK'sının kimliğini Uygulama Varsayılan Kimlik Bilgileri ile doğrulama iznine sahiptir. Firebase App Hosting rolleri başlıklı makaleyi inceleyin.
Uygulamanızın derleme sırasında veya çalışan bir arka uçtan ek Google hizmetleriyle etkileşim kurması gerekiyorsa varsayılan hizmet hesabına rol ekleyerek hesabı özelleştirebilirsiniz. Örneğin, uygulamanız Vertex AI için izinler gerektiriyorsa roles/aiplatform.user veya ilgili bir rol eklemeniz gerekebilir.