Proje kaynaklarını birden fazla sitede paylaşın

Tek bir Firebase projesinde bir veya daha fazla Firebase Hosting sitesi oluşturabilirsiniz. Sitelerin tümü aynı Firebase projesinde olduğundan tüm siteler projenin diğer Firebase kaynaklarına erişebilir.

Aynı Firebase projesinde birden fazla Hosting site oluşturarak Firebase kaynaklarını ilgili siteler ve uygulamalar arasında daha kolay paylaşabilirsiniz. Örneğin, blogunuzu, yönetici panelinizi ve herkese açık uygulamanızı aynı Firebase projesinde ayrı siteler olarak ayarlarsanız bunların tümü aynı Firebase Authentication kullanıcı veritabanını paylaşabilir ve kendi benzersiz alan adlarına veya içeriklerine sahip olabilir.

1. adım: Firebase KSA sürümünüzü güncelleyin

Firebase KSA'nın en yeni sürümüne geçerek en güncel Firebase Hosting özelliklerine erişin.

2. adım: Başka siteler ekleyin

Aşağıdaki yöntemlerden birini kullanarak Firebase projesine ek siteler ekleyin:

Bu yöntemlerin her biri için, siteye Firebase tarafından sağlanan varsayılan alt alan adlarını oluşturmak üzere kullanılan bir SITE_ID belirtirsiniz:

  • SITE_ID.web.app
  • SITE_ID.firebaseapp.com

Bu URL'lerde SITE_ID kullanıldığından site kimliği için aşağıdaki şartlar geçerlidir:

  • Geçerli bir ana makine adı etiketi olmalıdır. Bu nedenle ., _ vb. karakterler içeremez.
  • En fazla 30 karakter olmalıdır
  • Firebase'de global olarak benzersiz olmalıdır.

Aynı içeriği ve yapılandırmayı birden fazla URL'de sunmak için her siteye isteğe bağlı olarak özel alanlar da ekleyebilirsiniz.

İkincil bir siteyi silme

İstenmeyen siteleri Firebase projesinden silmek için aşağıdaki yöntemlerden birini kullanın:

Firebase proje kimliğinizle aynı SITE_ID olan varsayılan siteyi silemezsiniz.

3. adım: Siteleriniz için dağıtım hedefleri ayarlayın

Birden fazla siteniz olduğunda ve Firebase CLI dağıtım komutlarını çalıştırdığınızda CLI'nın, hangi ayarların her siteye dağıtılması gerektiğini iletmesi gerekir. Dağıtım hedefleri ile belirli bir siteyi firebase.json yapılandırma dosyanızdaki ve sitelerinize test veya dağıtım için Firebase CLI komutlarınızdaki TARGET_NAME ile benzersiz şekilde tanımlayabilirsiniz.

Dağıtım hedefi oluşturmak ve TARGET_NAME sitesine Hosting uygulamak için proje dizininizin kökünden aşağıdaki CLI komutunu çalıştırın:

firebase target:apply hosting TARGET_NAME RESOURCE_IDENTIFIER

Parametrelerin bulunduğu yerler:

  • TARGET_NAME — dağıtım yaptığınız Hosting sitesi için benzersiz bir ad (kendiniz tanımladığınız)

  • RESOURCE_IDENTIFIER — Hosting sitesi için Firebase projenizde listelenen SITE_ID

Örneğin, Firebase projenizde iki site (myapp-blog ve myapp-app) oluşturduysanız aşağıdaki komutları çalıştırarak her siteye benzersiz bir TARGET_NAME (sırasıyla blog ve app) uygulayabilirsiniz:

firebase target:apply hosting blog myapp-blog
 
firebase target:apply hosting app myapp-app

Dağıtım hedeflerinin ayarları, proje dizininizdeki .firebaserc dosyasında depolanır. Bu nedenle, dağıtım hedeflerini proje başına yalnızca bir kez ayarlamanız gerekir.

4. adım: Her site için barındırma yapılandırmasını tanımlayın

firebase.json dosyanızda bir sitenin barındırma yapılandırmasını tanımlarken sitenin uygulanan TARGET_NAME'sını kullanın.

  • firebase.json dosyanız birden fazla sitenin yapılandırmasını tanımlıyorsa dizi biçimini kullanın:

    {
  "hosting": [ {
      "target": "blog",  // "blog" is the applied TARGET_NAME for the Hosting site "myapp-blog"
      "public": "blog/dist",  // contents of this folder are deployed to the site "myapp-blog"

      // ...
    },
    {
      "target": "app",  // "app" is the applied TARGET_NAME for the Hosting site "myapp-app"
      "public": "app/dist",  // contents of this folder are deployed to the site "myapp-app"

      // ...

      "rewrites": [...]  // You can define specific Hosting configurations for each site
    }
  ]
}

  • firebase.json dosyanız yalnızca bir sitenin yapılandırmasını tanımlıyorsa dizi biçimi kullanmanız gerekmez:

    {
  "hosting": {
      "target": "blog",
      "public": "dist",

      // ...

      "rewrites": [...]
  }
}

5. adım: Yerel olarak test edin, değişiklikleri önizleyin ve sitelerinize dağıtın

Yerel proje dizininizin kökünden aşağıdaki komutlardan herhangi birini çalıştırın.

Komut Açıklama
firebase emulators:start --only hosting Yerel olarak barındırılan bir URL'de varsayılan Hosting sitesinin Hosting içeriğini ve yapılandırmasını taklit eder.
firebase emulators:start --only hosting:TARGET_NAME Yerel olarak barındırılan bir URL'de belirtilen Hosting sitesinin Hosting içeriğini ve yapılandırmasını taklit eder.
firebase hosting:channel:deploy \
CHANNEL_ID		 Hosting içeriğini ve yapılandırmasını bir önizleme URL'sinde varsayılan Hosting sitesine dağıtır.
firebase hosting:channel:deploy \
CHANNEL_ID --only TARGET_NAME		 Belirtilen Hosting sitesinin içeriğini ve yapılandırmasını bir önizleme URL'sinde Hosting dağıtır.
firebase deploy --only hosting Hosting içeriğini ve yapılandırmasını, firebase.json içinde yapılandırılan tüm Hosting sitelerinin canlı kanalına dağıtır.
firebase deploy --only hosting:TARGET_NAME Belirtilen Hosting sitesinin canlı kanalına Hosting içeriğini ve yapılandırmasını dağıtır.
Komut Açıklama
(önerilmez; bunun yerine emulators:start kullanın)
firebase serve --only hosting 		Hosting içeriğini ve varsayılan Hosting sitesinin yapılandırmasını yerel olarak barındırılan bir URL'de sunar.
(önerilmez; bunun yerine emulators:start kullanın)
firebase serve --only hosting:TARGET_NAME 		Belirtilen Hosting sitesinin Hosting içeriğini ve yapılandırmasını yerel olarak barındırılan bir URL'de sunar.