Firebase App Hosting, Firebase JavaScript SDK'sı ve Node.js için Firebase Admin SDK ile oluşturulan dinamik web uygulamaları için idealdir. Tam özellikli bir web uygulamasında, Authentication, Cloud Firestore ve App Check gibi Firebase SDK'larının önemli rolleri vardır. Bu kılavuzda, Firebase SDK'larını optimize etmenize ve Firebase App Hosting üzerinde web uygulamanıza Firebase oluşturmaya başlamanıza yardımcı olacak bazı temel stratejiler açıklanmaktadır.
Firebase Admin SDK ve web SDK'larını otomatik olarak başlatma
Firebase App Hosting gibi Google ortamları, derleme ve çalışma zamanında bağımsız değişken içermeyen bir kurucu çağrısı aracılığıyla basitleştirilmiş uygulama başlatma olanağı sunar. Bu, hem Node.js için Firebase Admin SDK'ın (Firebase işlevlerinin büyük bir kısmını kullanıma sunan ve web uygulamanızda çok yararlı olabilecek sunucu tarafı SDK'sı) hem de Firebase JavaScript SDK'sının bir özelliğidir.
initializeApp() ile Firebase App Hosting'ın web uygulaması yapılandırmasını sizin için otomatik olarak doldurmasına izin verebilir, varsayılan değerleri geçersiz kılmak isterseniz belirli değerler üzerinde ayrıntılı kontrol seçeneğini kullanmaya devam edebilirsiniz.
Bağımsız değişken olmadan başlatma
Firebase Admin SDK veya Firebase JavaScript SDK'sını varsayılan yapılandırma değerleriyle ilk kullanıma hazırlamak için herhangi bir bağımsız değişken sağlamadan initializeApp() yöntemini kullanın.
Admin SDK
import { initializeApp } from 'firebase-admin/app';
const app = initializeApp();
Admin SDK için bu başlatma stratejisi, App Hosting ve Cloud Run, App Engine ve Cloud Run işlevleri dahil olmak üzere diğer Google sunucu ortamlarında çalışır.
JavaScript SDK
import { initializeApp } from 'firebase/app';
const app = initializeApp();
JavaScript SDK'sı için bu başlatma stratejisi App Hosting sürümünde çalışır.
Otomatik olarak doldurulan değerleri geçersiz kılma
Otomatik olarak eklenen varsayılan yapılandırmayı geçersiz kılabilirsiniz. Bu seçeneklerin Admin SDK ve JavaScript SDK'sı arasında farklılık gösterdiğini unutmayın.
Admin SDK geçersiz kılma kuralı
Realtime Database, Cloud Storage veya Cloud Functions gibi hizmetler için isteğe bağlı olarak özel başlatma seçenekleri belirtmek istiyorsanız FIREBASE_CONFIG ortam değişkenini kullanın. FIREBASE_CONFIG değişkeninin içeriği { karakteriyle başlıyorsa JSON nesnesi olarak ayrıştırılır. Aksi takdirde SDK, dizeyi seçenekleri içeren bir JSON dosyasının yolu olarak kabul eder.
# apphosting.yaml
env:
- variable: FIREBASE_CONFIG
value: '{"databaseURL":"https://project-id-default-rtdb.firebaseio.com","projectId":"my-project-id"}'
JavaScript SDK'sını geçersiz kılma
App Hosting tarafından JavaScript SDK'sını başlatmak için eklenen varsayılan FIREBASE_WEBAPP_CONFIG değerlerini geçersiz kılmak istiyorsanız apphosting.yaml içinde değerler belirtebilirsiniz:
# apphosting.yaml
env:
- variable: FIREBASE_WEBAPP_CONFIG
value: '{"apiKey":"myApiKey","appId":"app:123","authDomain":"project-id.firebaseapp.com","databaseURL":"https://project-id-default-rtdb.firebaseio.com","messagingSenderId":"0123456789","projectId":"project-id","storageBucket":"project-id.firebasestorage.app"}'
Otomatik başlatmayı diğer ortamlarda kullanma
Firebase JavaScript SDK'sını yüklediğinizde otomatik başlatma, bir npm postinstall komut dosyası ile ayarlanır. postinstall komut dosyası, App Hosting Cloud Build derleme ortamında otomatik olarak ayarlanan FIREBASE_WEBAPP_CONFIG ortam değişkenini arar.
JS SDK'yı Cloud Build dışında yüklüyorsanız Firebase JavaScript SDK'yı yüklerken bu ortam değişkenini kendiniz ayarlamanız gerekir.
Yükleme sırasında ortamı manuel olarak ayarlamak için:
Firebase konsolundan Firebase web uygulaması yapılandırma nesnenizi kopyalayın.
npm installkomutunu çalıştırmadan önce bir terminaldenFIREBASE_WEBAPP_CONFIGortam değişkenini ayarlayın.
FIREBASE_WEBAPP_CONFIG="{...}" npm install firebase
Firebase projenizi veya web uygulamanızı her değiştirdiğinizde bu komutu yeniden çalıştırın. Ara önbelleklerin de (.next/cache gibi) temizlenmesi gerekebilir.
FirebaseServerApp, SSR için kullanılmalıdır.
Web uygulamanızı geliştirirken Firebase JS SDK'sı veya diğer Firebase istemci SDK'larıyla çalıştıysanız FirebaseApp arayüzüne ve bu arayüzü kullanarak uygulama örneklerini nasıl yapılandıracağınıza muhtemelen aşinasınızdır. Firebase, sunucu tarafında benzer işlemleri kolaylaştırmak için FirebaseServerApp sunar.
FirebaseServerApp, sunucu tarafı oluşturma (SSR) ortamlarında kullanılmak üzere FirebaseApp'nin bir varyantıdır. İstemci taraflı oluşturma (CSR) ve sunucu taraflı oluşturma (SSR) arasındaki ayrımı kapsayan Firebase oturumlarını devam ettirmek için araçlar içerir.
FirebaseServerApp ile yapabilecekleriniz:
- Tam yönetim haklarına sahip Firebase Admin SDK yerine kullanıcı bağlamında sunucu tarafı kodunu yürütme.
- SSR ortamlarında App Check kullanımını etkinleştirin.
- İstemcide oluşturulan bir Firebase Auth oturumunu devam ettirme
FirebaseServerApp hizmetini bu amaçlarla kullanma hakkında ayrıntılı bilgi için SSR ile dinamik web uygulamalarında Firebase'i kullanma başlıklı makaleyi inceleyin.
Web uygulamanızda App Check özelliğini etkinleştirme
App Hosting üzerinde dinamik web uygulamanızın güvenliğini artırmak için App Check kullanabilirsiniz. SSR ile dinamik web uygulamalarında Firebase'i kullanma bölümünde açıklanan sunucu tarafı stratejilerinden bazılarını uygulayarak App Hosting arka uçlarınızı kötüye kullanıma karşı koruyabilirsiniz.