Application Design Center (ADC) ve Firebase'i kullanmaya başlama

Firebase, Google Cloud'dan Application Design Center (ADC) ile entegre olarak kurumsal müşterilerin standardizasyon ve yönetim ihtiyaçlarını karşılamasını sağlarken uygulama geliştiricilerinin de hızlı bir şekilde uygulama yayınlamasına olanak tanır. ADC kullanımı, altyapının önceden tanımlanmış şablonlar aracılığıyla kurumsal standartlara ve en iyi uygulamalara uymasını sağlar. Bu şablonlar, kaynakların sağlanması ve IAM izinlerinin verilmesi gibi işlemler için güvenlik önlemlerini tanımlar.

Bu sayfada aşağıdaki konular hakkında bilgi edinebilirsiniz:

ADC ve Firebase'e genel bakış

ADC ile ilgili genel bilgi edinmek için Google Cloud belgelerini incelemenizi öneririz. Google Cloud belgelerinde, ADC için temel kavramlar ve ilk kurulum kılavuzu gibi çeşitli ayrıntılı kılavuzlar da sunulmaktadır.

ADC kullanılırken "uygulama", birlikte bir işletme işlevi sunan kaynak ve hizmetlerin mantıksal gruplandırması olarak tanımlanır. Firebase geliştiricileri için "uygulama"yı, ADC Firebase projesine eşdeğer olarak düşünebilirsiniz. Kayıtlı iOS, Android ve web uygulamalarınızın tümü, proje için aynı kaynakları ve hizmetleri paylaşır ve bunlara erişebilir.

Başlangıç olarak, Google Cloud konsolunda bulunan tasarım tuvali adlı GUI deneyimini kullanarak ADC ile çalışmanızı öneririz. Tasarım tuvali, uygulamalarınız için kullanmak istediğiniz altyapının mimari diyagramlarını görselleştirmenize ve oluşturmanıza olanak tanır.

ADC, Terraform tarafından desteklenir. Bu nedenle, ADC kullanılarak tanımlanan altyapının kod tanımına her zaman erişebilirsiniz.

Desteklenen Firebase ürünleri

ADC ile kullanılabilecek desteklenen Firebase ürünlerinin ilk grubu aşağıda verilmiştir:

ADC kullanımı için önemli karakterler

ADC'i anlamanın ve kullanmanın yaygın bir yolu, ADC ile ilgili görevleri iki karakter temelinde ayırmaktır:

  • Platform Mühendisi: Bu karakter, yeniden kullanılabilir ve politikaya uygun ADC şablonları tasarlar, doğrular ve bir ADC kataloğunda yayınlar.

  • Uygulama Geliştirici: Bu karakter, altyapıyı yapılandırmak ve dağıtmak için yayınlanan ADC şablonlarını (ör. ekibin ADC kataloğundan) kullanır. Ayrıca uygulamanın asıl kod tabanını ve özelliklerini geliştirirler.

Erişimi kontrol etmek için gereken IAM rolleri

IAM rolleri atayarak hangi proje üyelerinin (veya ana hesapların) belirli görevleri gerçekleştirebileceğini kontrol edebilirsiniz.

Örneğin, alan oluşturup ataması, katalogları yönetmesi ve şablon tasarlaması gereken platform mühendisine Uygulama Tasarım Merkezi Yöneticisi rolünü (roles/designcenter.admin) atayabilirsiniz. Ancak şablonları kullanabilmesi ancak oluşturamaması için bir uygulama geliştiriciye yalnızca Uygulama Düzenleyici rolünü (roles/designcenter.applicationEditor) atamanız daha olasıdır.

Aşağıdaki tabloda ADC ile ilgili görevler, bu görevlerin hedeflediği karakterler ve gerekli roller açıklanmaktadır:

Görev Karakter IAM rolü 1
Şablon oluşturma ve yönetme
Tam ADC yaşam döngüsünü yönetme
(alanları, katalogları, şablonları yönetme, uygulamaları yapılandırma ve dağıtma dahil)
Platform Mühendisi Uygulama Tasarım Merkezi Yöneticisi
(roles/designcenter.admin) yönetim projesinde
Şablon oluşturup yönetme, uygulamaları yapılandırma ve dağıtma Platform Mühendisi Yönetim projesinde
Application Design Center Kullanıcısı (roles/designcenter.user)
ADC uygulamalarını dağıtmak için hizmet hesabı oluşturma
Hizmet hesabı oluşturma Platform Mühendisi Yönetim projesinde
hizmet hesapları oluşturma (roles/iam.serviceAccountCreator)
Bir hizmet hesabına ADC dağıtımı için kullanılan projeye erişim izni verme Platform Mühendisi Dağıtım projesinde Proje IAM Yöneticisi
(roles/resourcemanager.projectIamAdmin) rolü
ADC uygulamasını yapılandırma ve dağıtma
Uygulama yaşam döngüsünün tamamını kontrol edin
(kaynak kodu ve CI/CD sistemleriyle entegrasyon dahil)
Uygulama Geliştirici Yönetim projesinde
Uygulama Yöneticisi (roles/designcenter.applicationAdmin)
Yönetici tarafından oluşturulan mevcut şablonlara ve bağlantılara göre uygulamaları yapılandırma ve dağıtma Uygulama Geliştirici Uygulama Düzenleyici
(roles/designcenter.applicationEditor) yönetim projesinde

1 Bu rollerden bazılarının, Google Cloud hiyerarşisinde üst düzey bir kaynak olan yönetim projesinde ayarlanması gerekir.

Genel iş akışı

Bu bölümde, ADC şablonu oluşturma ve kullanmayla ilgili genel bir iş akışı açıklanmaktadır. Adımlar, genellikle adımı gerçekleştirecek kişiyle etiketlenir.

  1. 1. adım: Kurulum ADC (Platform Mühendisi)
  2. 2. adım: Şablon oluşturun (Platform Mühendisi)
  3. 3. adım: Şablon kullanma (Uygulama Geliştirici)
  4. 4. adım: Gerçek uygulamanızı geliştirin (Uygulama Geliştirici)

1. adım: ADC (Platform Mühendisi) kurulumu

Platform mühendisi (veya daha üstü) rolü, ADC kurulumu için bu görevleri tamamlar. ADC hizmetini kullanmak için gereken her şeyi ayarlamak üzere bu görevlerin genellikle yalnızca bir kez tamamlanması yeterlidir.

  1. İlk ADC kurulum.

    Google Cloud belgelerindeki ADC için ilk kurulum kılavuzunda yer alan adımları ve talimatları uygulayın. Bu kılavuzda, klasör düzeyinde sınırlar ayarlayacağınız varsayılmaktadır.

    Bu kurulumu tamamladıktan sonra bir alanınız olur. Bu alan, bir ekibin ortak çalışması, şablon oluşturması ve uygulama dağıtması için özel bir alandır. Bu alanın (ve klasör ile kataloğun) birlikte çalışmak istediğiniz herkesle paylaşıldığından emin olun ADC.

  2. Alan için erişimi ve kullanıcıları ayarlayın.

    Google Cloud belgelerindeki ADC için Alan kullanıcılarını yönetme adımlarını uygulayın. Bu sayfanın önceki kısımlarında yer alan Erişimi kontrol etmek için gereken IAM rolleri bölümündeki talimatları uygulayın.

  3. Projelerin temel hazırlığını önceden yapın.

    Klasörde bir veya daha fazla yeni Google Cloud projesi oluşturun. Bu projelere bir Cloud Billing hesabı bağladığınızdan emin olun. Bu projeler, uygulama geliştiriciniz tarafından şablonda tanımlanan altyapıyı dağıtırken kullanılır.

  4. Dağıtım hizmet hesabı yapılandırma

    ADC, dar kapsamlı bir hizmet hesabı kullanarak kaynakların otomatik temel hazırlığını yönetir. Bu sayede, uygulama geliştiricinin altyapı dağıtmak için kendi hesabını kullanması engellenir.

    ADC, oluşturduğunuz şablonların dağıtımını test ederken sizin adınıza otomatik olarak dar kapsamlı bir hizmet hesabı oluşturabilir. Uygulama geliştiriciler için uygun gördüğünüz izinlere sahip kendi hizmet hesabınızı da kullanabilirsiniz.

2. adım: Şablon oluşturma (Platform Mühendisi)

Platform mühendisi karakteri, yeni bir ADC şablonu oluşturmak için tasarım tuvalini veya Gemini Cloud Assist aracını kullanır.

  1. Kaynakları tanımlayın.

    Tasarım tuvalini kullanarak bileşenleri tuvale sürükleyip bırakın ve aralarında bağlantılar oluşturun. Bu bileşenler, uygulama geliştiricilerin hangi Firebase (ve Google Cloud) hizmetlerini kullanmasını istediğinizi tanımlamanızı sağlar.

    Örneğin, şablon aşağıdaki gibi kaynakları tanımlayabilir:

    • Uygulama geliştiriciler, kaynakları kullanan iOS, Android ve web uygulamaları geliştirebilir.
    • Uygulama geliştiriciler, uygulamalarında Firebase AI Logic, Firebase Authentication, Cloud Firestore ve Firebase Security Rules kullanabilir (ADC için desteklenen tüm Firebase ürünlerinin listesine bakın).
    • Firebase Security Rules, başlangıçta tüm erişim isteklerini varsayılan olarak reddedecek şekilde ayarlanır. Ardından, uygulama geliştirici bu şablonu kendi dağıtımı için kullandığında bu Security Rules değerlerini kendi erişim modeline uygun şekilde değiştirebilir.
  2. Politikaları tanımlayın.

    Dağıtılan altyapı için IAM rolleri veya kaynaklar için izin verilen bölgeler gibi politikalar tanımlamak istiyorsanız bu politikaları ilgili arayüzlerde ayarlamanız gerekir. ADC şu anda şablon düzeyinde politika tanımlamayı desteklemiyor.

    Proje üyelerine, yapmalarını istediğiniz işleme bağlı olarak belirli Firebase IAM rolleri atayabilirsiniz. Örneğin, yalnızca Firebase konsolundaki kaynakları görüntülemeleri gerekiyorsa onlara Firebase Görüntüleyici rolünü (roles/firebase.viewer) atayın.

    Kaynaklar için bölge sınırlamalarını klasör veya kuruluş düzeyinde ayarlayabilirsiniz.

  3. Şablonu bir kataloğa ekleyin.

    Şablonunuzu test ettikten sonra ekibinizin kataloğuna ekleyin.ADC Bu kataloğun, şablonları kullanabilmeleri için uygun kişilerle, özellikle de uygulama geliştiricilerle paylaşılması gerekir (yukarıdaki 1. adım: ADC oluşturun bölümüne bakın).

3. adım: Şablon kullanma (Uygulama Geliştiricisi)

Uygulama geliştirici, önceden tanımlanmış bir şablon seçer, bu şablonu kendi kullanım alanına göre yapılandırır ve ardından altyapıyı dağıtır.

  1. Bir şablon seçip yapılandırın.

    ADC kataloğundan bir şablon seçip yapılandırarak uygulama taslağı oluşturun. Kullanılabilir yapılandırmalar (ör. kaynaklar için olası bölgeler), platform mühendisinin şablonu oluştururken belirlediği yapılandırmalarla sınırlıdır.

  2. Altyapıyı dağıtın.

    Uygulama taslağı oluşturulduktan sonra ADC uygulamasını, altyapı dağıtımı için oluşturulan önceden temel hazırlığı yapılmış projelerden birine dağıtın (yukarıdaki 1. adım: ADC uygulamasını ayarlayın bölümüne bakın).

    Firebase konsolunu ziyaret ederek projeniz için temel hazırlığı yapılmış kaynakları ve etkinleştirilmiş hizmetleri görüntüleyebilirsiniz.

4. adım: Gerçek uygulamanızı geliştirin (Uygulama Geliştirici)

ADC, Firebase'i ve Google Cloud altyapıyı (ör. kaynakları temel hazırlık ve API'leri etkinleştirme) ayarlamaya yardımcı olur. Ancak bu kaynakları ve API'leri kullanan asıl uygulamanın kodlamasını yapmaz.

Uygulama Geliştirici karakterinin yapması gereken bazı önemli işlemler şunlardır:

  1. Uygulamanızın kod tabanını Firebase'e bağlayın.

    Firebase yapılandırmasını alıp her uygulamanın kod tabanına ekleyin.

    Örneğin, şablon bir Android uygulamasına izin veriyorsa google-services.json dosyasını Android projenizdeki uygun dizine eklemeniz gerekir.

  2. Kod ve kaynakları uyumlu tutun.

    (Cloud Firestore kullanıyorsanız) Uygulamanın Cloud Firestore veri modeliyle uyumlu olması için Firebase Security Rules öğesini güncelleyip yayınladığınızdan emin olun.

Başka ne yapabilirsin?

  • App Hub'a otomatik olarak kaydedilen dağıtılan ADC "uygulamaları" izleyin. Bu sayede, daha geniş kapsamlı Google Cloud dağıtımları bağlamında Firebase kaynakları için birleştirilmiş izleme, maliyet gözlemi ve sorun giderme işlemleri yapılabilir.