Firebase CLI referansı

Firebase CLI (GitHub), Firebase projelerini yönetmek, görüntülemek ve bu projelere dağıtım yapmak için çeşitli araçlar sunar.

Firebase CLI'yı kullanmadan önce bir Firebase projesi oluşturun.

KSA'yı ayarlama veya güncelleme

Firebase KSA'yı yükleme

Firebase CLI'yı işletim sisteminize, deneyim düzeyinize ve/veya kullanım alanınıza uygun bir yöntemle yükleyebilirsiniz. CLI'yı nasıl yüklediğinizden bağımsız olarak aynı işlevlere ve firebase komutuna erişebilirsiniz.

Windows macOS Linux

Windows

Windows için Firebase CLI'yı aşağıdaki seçeneklerden birini kullanarak yükleyebilirsiniz:

Seçenek Açıklama Şu amaçlar için önerilir:
bağımsız ikili program CLI için bağımsız ikili programı indirin. Ardından, firebase komutunu çalıştırabileceğiniz bir kabuk açmak için yürütülebilir dosyaya erişebilirsiniz. Yeni geliştiriciler

Node.js kullanmayan veya bu platforma aşina olmayan geliştiriciler
npm KSA'yı yüklemek ve genel olarak kullanılabilen firebase komutunu etkinleştirmek için npm'yi (Node Package Manager) kullanın. Node.js kullanan geliştiriciler

bağımsız ikili dosya

Firebase KSA'nın ikili programını indirip çalıştırmak için aşağıdaki adımları uygulayın:

  1. Windows için Firebase CLI ikili programını indirin.

  2. firebase komutunu çalıştırabileceğiniz bir kabuk açmak için ikili dosyaya erişin.

  3. Giriş yapıp KSA'yı test etme adımına geçin.

npm

Firebase CLI'yı yüklemek için npm (Node Package Manager) kullanmak istiyorsanız aşağıdaki adımları uygulayın:

  1. nvm-windows (Node Sürüm Yöneticisi) kullanarak Node.js'yi yükleyin. Node.js'yi yüklediğinizde npm komut araçları da otomatik olarak yüklenir.

  2. Aşağıdaki komutu çalıştırarak Firebase KSA'yı npm üzerinden yükleyin:

    npm install -g firebase-tools

    Bu komut, genel olarak kullanılabilen firebase komutunu etkinleştirir.

  3. Giriş yapıp KSA'yı test etme adımına geçin.

macOS veya Linux

macOS veya Linux için Firebase KSA'yı aşağıdaki seçeneklerden birini kullanarak yükleyebilirsiniz:

Seçenek Açıklama Şu amaçlar için önerilir:
otomatik yükleme komut dosyası İşletim sisteminizi otomatik olarak algılayan, en son CLI sürümünü indiren ve ardından genel olarak kullanılabilen firebase komutunu etkinleştiren tek bir komut çalıştırın. Yeni geliştiriciler

Node.js kullanmayan veya bu platforma aşina olmayan geliştiriciler

CI/CD ortamında otomatik dağıtımlar
bağımsız ikili program CLI için bağımsız ikili programı indirin. Ardından, ikili programı iş akışınıza uyacak şekilde yapılandırıp çalıştırabilirsiniz. KSA kullanılarak tamamen özelleştirilebilen iş akışları
npm KSA'yı yüklemek ve genel olarak kullanılabilen firebase komutunu etkinleştirmek için npm'yi (Node Package Manager) kullanın. Node.js kullanan geliştiriciler

otomatik yükleme komut dosyası

Otomatik yükleme komut dosyasını kullanarak Firebase KSA'yı yüklemek için aşağıdaki adımları uygulayın:

  1. Aşağıdaki cURL komutunu çalıştırın:

    curl -sL https://firebase.tools | bash

    Bu komut dosyası, işletim sisteminizi otomatik olarak algılar, en son Firebase CLI sürümünü indirir ve ardından genel olarak kullanılabilen firebase komutunu etkinleştirir.

  2. Giriş yapıp KSA'yı test etme adımına geçin.

Otomatik yükleme komut dosyasıyla ilgili daha fazla örnek ve ayrıntı için firebase.tools adresindeki komut dosyasının kaynak koduna bakın.

bağımsız ikili dosya

İşletim sisteminize özel Firebase CLI ikili programını indirip çalıştırmak için aşağıdaki adımları uygulayın:

  1. İşletim sisteminiz için Firebase CLI ikili dosyasını indirin: macOS | Linux

  2. (İsteğe bağlı) Genel olarak kullanılabilen firebase komutunu ayarlayın.

    1. chmod +x ./firebase_tools komutunu çalıştırarak ikili dosyayı yürütülebilir hale getirin.
    2. İkili programın yolunu PATH'inize ekleyin.

  3. Giriş yapıp KSA'yı test etme adımına geçin.

npm

Firebase CLI'yı yüklemek için npm (Node Package Manager) kullanmak istiyorsanız aşağıdaki adımları uygulayın:

  1. nvm (Node Sürüm Yöneticisi) kullanarak Node.js'yi yükleyin.
    Node.js yüklendiğinde npm komut araçları da otomatik olarak yüklenir.

  2. Aşağıdaki komutu çalıştırarak Firebase KSA'yı npm üzerinden yükleyin:

    npm install -g firebase-tools

    Bu komut, genel olarak kullanılabilen firebase komutunu etkinleştirir.

  3. Giriş yapıp KSA'yı test etme adımına geçin.

Giriş yapma ve Firebase CLI'yi test etme

CLI'yı yükledikten sonra kimlik doğrulaması yapmanız gerekir. Ardından Firebase projelerinizi listeleyerek kimlik doğrulamasını onaylayabilirsiniz.

  1. Aşağıdaki komutu çalıştırarak Google Hesabınızı kullanarak Firebase'e giriş yapın:

    firebase login

    Bu komut, yerel makinenizi Firebase'e bağlar ve Firebase projelerinize erişmenizi sağlar.

  2. Firebase projelerinizi listeleyerek CLI'nın doğru şekilde yüklendiğini ve hesabınıza eriştiğini test edin. Aşağıdaki komutu çalıştırın:

    firebase projects:list

    Görüntülenen liste, Firebase konsolunda listelenen Firebase projeleriyle aynı olmalıdır.

En yeni CLI sürümüne güncelleme

Genellikle en güncel Firebase CLI sürümünü kullanmanız önerilir.

KSA sürümünü nasıl güncelleyeceğiniz, işletim sisteminize ve KSA'yı nasıl yüklediğinize bağlıdır.

Windows

  • Bağımsız ikili program: Yeni sürümü indirin, ardından sisteminizde değiştirin.
  • npm: npm install -g firebase-tools komutunu çalıştırın.

macOS

  • Otomatik yükleme komut dosyası: curl -sL https://firebase.tools | upgrade=true bash komutunu çalıştırın.

  • Bağımsız ikili program: Yeni sürümü indirin ve sisteminizdeki sürümle değiştirin.

  • npm: npm install -g firebase-tools komutunu çalıştırın.

Linux

  • Otomatik yükleme komut dosyası: curl -sL https://firebase.tools | upgrade=true bash komutunu çalıştırın.

  • Bağımsız ikili program: Yeni sürümü indirin ve sisteminizdeki sürümle değiştirin.

  • npm: npm install -g firebase-tools komutunu çalıştırın.

Firebase CLI'yı kaldırma

CLI'yı nasıl kaldıracağınız, işletim sisteminize ve CLI'yı nasıl yüklediğinize bağlıdır.

Windows

  • Bağımsız ikili program: İndirdiğiniz firebase.exe ikili programını silin.
  • npm: npm uninstall -g firebase-tools komutunu çalıştırın.

macOS

  • Otomatik yükleme komut dosyası: Çalıştır curl -sL https://firebase.tools | uninstall=true bash

  • Bağımsız ikili program: İndirdiğiniz firebase ikili programını silin. Konumunu PATH ortam değişkeninize eklediyseniz kaldırdığınızdan emin olun.

  • npm: npm uninstall -g firebase-tools komutunu çalıştırın.

Linux

  • Otomatik yükleme komut dosyası: Çalıştır curl -sL https://firebase.tools | uninstall=true bash

  • Bağımsız ikili program: İndirdiğiniz firebase ikili programını silin. Konumunu PATH ortam değişkeninize eklediyseniz kaldırdığınızdan emin olun.

  • npm: npm uninstall -g firebase-tools komutunu çalıştırın.

CLI'yı CI sistemleriyle kullanma

CLI'yı CI sistemleriyle kullanırken Uygulama Varsayılan Kimlik Bilgileri'ni kullanarak kimlik doğrulamanızı öneririz.

(Önerilir) Uygulama Varsayılan Kimlik Bilgileri'ni kullanma

Firebase CLI, ayarlanmışsa Uygulama Varsayılan Kimlik Bilgileri'ni algılar ve kullanır. KSA'nın CI ve diğer gözetimsiz ortamlarda kimliğini doğrulamanın en basit yolu, Uygulama Varsayılan Kimlik Bilgileri'ni ayarlamaktır.

(Eski) Kullanım FIREBASE_TOKEN

Alternatif olarak, FIREBASE_TOKEN kullanarak kimlik doğrulaması yapabilirsiniz. Bu yöntem, Uygulama Varsayılan Kimlik Bilgileri'nden daha az güvenlidir ve artık önerilmemektedir.

  1. Tarayıcısı olan bir makinede Firebase KSA'yı yükleyin.

  2. Aşağıdaki komutu çalıştırarak oturum açma işlemini başlatın:

    firebase login:ci

  3. Sağlanan URL'yi ziyaret edin ve bir Google Hesabı kullanarak giriş yapın.

  4. Yeni bir yenileme jetonu yazdırın. Mevcut CLI oturumu bu durumdan etkilenmez.

  5. Çıkış jetonunu CI sisteminizde güvenli ancak erişilebilir bir şekilde saklayın.

  6. firebase komutlarını çalıştırırken bu jetonu kullanın. Aşağıdaki iki seçenekten birini kullanabilirsiniz:

    • 1. seçenek: Jetonu ortam değişkeni olarak depolama FIREBASE_TOKEN. Sisteminiz jetonu otomatik olarak kullanır.

    • 2. seçenek: CI sisteminizde tüm firebase komutlarını --token TOKEN işaretiyle çalıştırın.
      Jeton yükleme için öncelik sırası şu şekildedir: işaret, ortam değişkeni, istenen Firebase projesi.

Firebase projesi başlatma

CLI kullanılarak gerçekleştirilen birçok yaygın görev (ör. bir Firebase projesine dağıtım yapma) için proje dizini gerekir. firebase init komutunu kullanarak bir proje dizini oluşturun. Proje dizini genellikle kaynak denetimi kök dizininizle aynıdır ve firebase init komutunu çalıştırdıktan sonra dizinde bir firebase.json yapılandırma dosyası bulunur.

Yeni bir Firebase projesi başlatmak için uygulamanızın dizininde aşağıdaki komutu çalıştırın:

firebase init

firebase init komutu, proje dizininizi ve bazı Firebase ürünlerini ayarlama adımlarında size yol gösterir. Proje başlatma sırasında Firebase CLI, aşağıdaki görevleri tamamlamanızı ister:

  • Varsayılan bir Firebase projesi seçin.

    Bu adım, mevcut proje dizinini bir Firebase projesiyle ilişkilendirir. Böylece projeye özel komutlar (ör. firebase deploy) uygun Firebase projesinde çalıştırılır.

    Ayrıca, aynı proje diziniyle birden fazla Firebase projesini ilişkilendirmek (ör. hazırlık projesi ve üretim projesi) de mümkündür.

  • Firebase projenizde ayarlamak istediğiniz Firebase ürünlerini seçin.

    Bu adımda, seçilen ürünler veya özellikler için belirli dosyaların yapılandırmalarını ayarlamanız istenir. Bu yapılandırmalar hakkında daha fazla bilgi için ilgili ürünün belgelerine (ör. Hosting veya Authentication) bakın. Daha fazla Firebase ürünü ayarlamak için firebase init komutunu daha sonra da çalıştırabilirsiniz.

İlk kullanıma hazırlama işleminin sonunda Firebase, yerel uygulama dizininizin kökünde otomatik olarak aşağıdaki iki dosyayı oluşturur:

  • Proje yapılandırmanızı listeleyen bir firebase.json yapılandırma dosyası.

  • Projenizin takma adlarını depolayan bir .firebaserc dosyası.

firebase.json dosyası

firebase init komutu, proje dizininizin kökünde bir firebase.json yapılandırma dosyası oluşturur.

firebase.json dosyası, öğeleri Firebase CLI ile dağıtmak için gereklidir. Bu dosya, proje dizininizdeki hangi dosyaların ve ayarların Firebase projenize dağıtılacağını belirtir (ör. Hosting ayarları, Authentication sağlayıcı yapılandırmaları, güvenlik kuralları ve Cloud Functions yapılandırması). Bazı ayarlar proje dizininizde veya Firebase konsolunda tanımlanabildiğinden olası dağıtım çakışmalarını çözdüğünüzden emin olun.

Firebase Hosting seçeneklerinin çoğunu doğrudan firebase.json dosyasında yapılandırabilirsiniz. Ancak Firebase CLI ile dağıtılabilen diğer Firebase hizmetleri için firebase init komutu, bu hizmetlerin ayarlarını tanımlayabileceğiniz belirli dosyalar oluşturur (ör. Cloud Functions için index.js dosyası). Ayrıca firebase.json dosyasında dağıtım öncesi veya dağıtım sonrası kancalar da ayarlayabilirsiniz.

Aşağıdaki firebase.json dosyası, birçok Firebase hizmetinin yapılandırma seçeneklerini gösteren kapsamlı bir örnektir. Ayrıca çoklu kod tabanı Cloud Functions, Local Emulator Suite kurulumu ve Remote Config şablonu gibi özellikleri de gösterir. Belirli bir proje için firebase.json dosyasının yalnızca o projeye yönelik olarak ayarlanmış Firebase hizmetlerinin yapılandırmalarını (ör. yalnızca Firebase Hosting ve Cloud Functions) içereceğini unutmayın. $schema anahtarının eklenmesi, birçok kod düzenleyicide doğrulama ve otomatik tamamlama özelliklerini etkinleştirir.

    {
      "$schema": "https://raw.githubusercontent.com/firebase/firebase-tools/master/schema/firebase-config.json",
      "hosting": {
        "public": "public",
        "ignore": [
          "firebase.json",
          "**/.*",
          "**/node_modules/**"
        ],
        "cleanUrls": true,
        "trailingSlash": false
      },
      "apphosting": {
        "backendId": "my-app",
        "rootDir": "backend",
        "ignore": [
          "firebase.json",
          "**/.*",
          "**/node_modules/**"
        ]
      },
      "firestore": {
        "rules": "firestore.rules",
        "indexes": "firestore.indexes.json"
      },
      "storage": {
        "rules": "storage.rules"
      },
      "database": {
        "rules": "database.rules.json"
      },
      "dataconnect": {
        "source": "dataconnect",
        "location": "us-central1"
      },
      "functions": [
        {
          "source": "functions",
          "codebase": "default",
          "ignore": [
            "**/.*",
            "**/node_modules/**"
          ],
          "predeploy": [
            "npm --prefix \"$RESOURCE_DIR\" run lint",
            "npm --prefix \"$RESOURCE_DIR\" run build"
          ]
        }
      ],
      "emulators": {
        "auth": {
          "port": 9099
        },
        "functions": {
          "port": 5001
        },
        "firestore": {
          "port": 8080
        },
        "hosting": {
          "port": 5000
        },
        "storage": {
          "port": 9199
        },
        "ui": {
          "enabled": true,
          "port": 4000
        },
        "singleProjectMode": true
      },
      "extensions": {
        "my-storage-resizer": "firebase/storage-resize-images@^0.1.0"
      },
      "auth": {
        "providers": {
          "anonymous": true,
          "emailPassword": true,
          "googleSignIn": {
            "oAuthBrandDisplayName": "My App",
            "supportEmail": "support@myapp.com"
          }
        }
      },
      "remoteconfig": {
        "template": "remoteconfig.template.json"
      }
    }

Varsayılan olarak firebase.json kullanılsa da alternatif bir yapılandırma dosyası belirtmek için --config PATH işaretini iletebilirsiniz.

Birden fazla Cloud Firestore veritabanı için yapılandırma

firebase init komutunu çalıştırdığınızda firebase.json dosyanız, yukarıdaki örnekte gösterildiği gibi projenizin varsayılan veritabanına karşılık gelen tek bir firestore anahtarı içerir.

Projenizde birden fazla Cloud Firestore veritabanı varsa firebase.json dosyanızı düzenleyerek her veritabanıyla farklı Cloud Firestore Security Rules ve veritabanı dizini kaynak dosyalarını ilişkilendirin. Dosyayı, her veritabanı için bir giriş içeren bir JSON dizisiyle değiştirin.

      "firestore": [
        {
          "database": "(default)",
          "rules": "firestore.default.rules",
          "indexes": "firestore.default.indexes.json"
        },
        {
          "database": "ecommerce",
          "rules": "firestore.ecommerce.rules",
          "indexes": "firestore.ecommerce.indexes.json"
        }
      ],

Dağıtımda yoksayılacak Cloud Functions dosya

İşlev dağıtımı sırasında KSA, functions dizininde yoksayılacak dosyaların listesini otomatik olarak belirtir. Bu sayede, dağıtımınızın veri boyutunu artırabilecek gereksiz dosyaların arka uca dağıtılması önlenir.

Varsayılan olarak yoksayılan dosyaların JSON biçiminde gösterilen listesi şöyledir:

"ignore": [
  ".git",
  ".runtimeconfig.json",
  "firebase-debug.log",
  "firebase-debug.*.log",
  "node_modules"
]

firebase.json içinde ignore için kendi özel değerlerinizi eklerseniz yukarıdaki listede gösterilen dosya listesini sakladığınızdan (veya eksikse eklediğinizden) emin olun.

Proje takma adlarını yönetme

Birden fazla Firebase projesini aynı proje diziniyle ilişkilendirebilirsiniz. Örneğin, hazırlık için bir Firebase projesi, üretim için başka bir Firebase projesi kullanmak isteyebilirsiniz. Farklı proje ortamları kullanarak değişiklikleri üretime dağıtmadan önce doğrulayabilirsiniz. firebase use komutu, takma adlar arasında geçiş yapmanıza ve yeni takma adlar oluşturmanıza olanak tanır.

Proje takma adı ekleme

Proje başlatma sırasında bir Firebase projesi seçtiğinizde projeye otomatik olarak default takma adı atanır. Ancak projeye özel komutların farklı bir Firebase projesinde çalıştırılmasına izin vermek ve aynı proje dizinini kullanmaya devam etmek için proje dizininizden aşağıdaki komutu çalıştırın:

firebase use --add

Bu komut, başka bir Firebase projesi seçmenizi ve projeyi takma ad olarak atamanızı ister. Takma ad atamaları, proje dizininizdeki bir .firebaserc dosyasına yazılır.

Proje takma adlarını kullanma

Atanan Firebase projesi takma adlarını kullanmak için proje dizininizden aşağıdaki komutlardan birini çalıştırın.

Komut Açıklama
firebase use Proje dizininiz için tanımlanmış takma adların listesini görüntüleme
firebase use \
PROJECT_ID|ALIAS		 Tüm komutları, belirtilen Firebase projesinde çalıştırılacak şekilde yönlendirir.
CLI, bu projeyi "etkin proje" olarak kullanır.
firebase use --clear Etkin projeyi temizler.

Diğer CLI komutlarını çalıştırmadan önce yeni bir etkin proje ayarlamak için firebase use PROJECT_ID|ALIAS komutunu çalıştırın.
firebase use \
--unalias PROJECT_ALIAS		 Proje dizininizden bir takma adı kaldırır.

Herhangi bir CLI komutuyla --project işaretini ileterek etkin proje olarak kullanılan projeyi geçersiz kılabilirsiniz. Örneğin: CLI'nızı, staging takma adını atadığınız bir Firebase projesinde çalışacak şekilde ayarlayabilirsiniz. prod takma adını atadığınız Firebase projesinde tek bir komut çalıştırmak istiyorsanız örneğin firebase deploy --project=prod komutunu çalıştırabilirsiniz.

Kaynak denetimi ve proje takma adları

Genel olarak, ekibinizin proje takma adlarını paylaşmasına izin vermek için .firebaserc dosyanızı kaynak denetimine eklemeniz gerekir. Ancak açık kaynak projeler veya başlangıç şablonları için genellikle .firebaserc dosyanızı eklememelisiniz.

Yalnızca sizin kullanımınıza yönelik bir geliştirme projeniz varsa her komutla birlikte --project işaretini iletebilir veya Firebase projesine takma ad atamadan firebase use PROJECT_ID komutunu çalıştırabilirsiniz.

Firebase projenizi yerel olarak sunma ve test etme

Firebase projenizi üretime dağıtmadan önce yerel olarak barındırılan URL'lerde görüntüleyebilir ve test edebilirsiniz. Yalnızca belirli özellikleri test etmek istiyorsanız firebase serve komutundaki bir işaretçide virgülle ayrılmış liste kullanabilirsiniz.

Aşağıdaki görevlerden birini yapmak istiyorsanız yerel proje dizininizin kökünden aşağıdaki komutu çalıştırın:

  • Firebase'de barındırılan uygulamanızın statik içeriğini görüntüleme
  • Firebase Hosting için dinamik içerik oluşturmak amacıyla Cloud Functions kullanıyorsanız ve yerel bir URL'de Hosting emülasyonu yapmak için üretim (dağıtılmış) HTTP işlevlerinizi kullanmak istiyorsanız.
firebase serve --only hosting

Yerel HTTP işlevlerini kullanarak projenizin emülasyonunu oluşturma

Yerel HTTP işlevlerini kullanarak projenizin emülasyonunu oluşturmak için proje dizininizden aşağıdaki komutlardan birini çalıştırın.

  • HTTP işlevlerini ve barındırmayı yerel URL'lerde test etmek için aşağıdaki komutlardan birini kullanın:

    firebase serve
     
    firebase serve --only functions,hosting // uses a flag

  • Yalnızca HTTP işlevlerini emüle etmek için aşağıdaki komutu kullanın:

    firebase serve --only functions

Diğer yerel cihazlardan test etme

Varsayılan olarak firebase serve, yalnızca localhost tarafından gönderilen isteklere yanıt verir. Bu, barındırılan içeriğinize bilgisayarınızın web tarayıcısından erişebileceğiniz ancak ağınızdaki diğer cihazlardan erişemeyeceğiniz anlamına gelir. Diğer yerel cihazlardan test etmek istiyorsanız --host işaretini şu şekilde kullanın:

firebase serve --host 0.0.0.0  // accepts requests to any host

Firebase projesine dağıtma

Firebase CLI, kod ve öğelerin Firebase projenize dağıtımını yönetir. Bu öğeler arasında şunlar bulunur:

  • Firebase Hosting sitenizin yeni sürümleri
  • Yeni, güncellenmiş veya mevcut Cloud Functions for Firebase
  • Firebase SQL Connect için yeni veya güncellenmiş şemalar ve bağlayıcılar
  • Firebase Realtime Database için Security Rules
  • Cloud Storage for Firebase için Security Rules
  • Cloud Firestore için Security Rules
  • Cloud Firestore için dizinler
  • Authentication için yapılandırma

Bir Firebase projesine dağıtım yapmak için proje dizininizden aşağıdaki komutu çalıştırın:

firebase deploy

İsterseniz dağıtımlarınızın her birine yorum ekleyebilirsiniz. Bu yorum, projenizin Firebase Hosting sayfasındaki diğer dağıtım bilgileriyle birlikte gösterilir. Örneğin:

firebase deploy -m "Deploying the best new feature ever."

firebase deploy komutunu kullanırken aşağıdakileri göz önünde bulundurun:

  • Kaynakları bir proje dizininden dağıtmak için proje dizininde bir firebase.json dosyası olmalıdır. Bu dosya, firebase init komutu tarafından sizin için otomatik olarak oluşturulur.

  • Varsayılan olarak firebase deploy, proje dizininizdeki tüm dağıtılabilir kaynaklar için bir sürüm oluşturur. Belirli Firebase hizmetlerini veya özelliklerini dağıtmak için kısmi dağıtımı kullanın.

Belirli Firebase hizmetlerini dağıtma

Yalnızca belirli Firebase hizmetlerini veya özelliklerini dağıtmak istiyorsanız firebase deploy komutundaki bir işaretçide virgülle ayrılmış liste kullanabilirsiniz. Örneğin, aşağıdaki komut Firebase Hosting içeriğini ve Cloud Storage Security Rules dağıtır.

firebase deploy --only hosting,storage

Aşağıdaki tabloda, kısmi dağıtım için kullanılabilen hizmetler ve özellikler listelenmiştir. İşaretlerdeki adlar, firebase.json yapılandırma dosyanızdaki anahtarlara karşılık gelir.

İşaret söz dizimi Dağıtılan hizmet veya özellik
--only auth Authentication sağlayıcı yapılandırması
--only database Firebase Realtime Database Security Rules
--only dataconnect Firebase SQL Connect şema ve bağlayıcı
--only firestore Yapılandırılmış tüm veritabanları için Cloud Firestore Security Rules ve dizinler
--only functions Cloud Functions for Firebase
--only hosting Firebase Hosting içerik
--only storage Cloud Storage for Firebase Security Rules

Security Rules için dağıtım çakışmaları

Firebase Realtime Database, Cloud Storage for Firebase ve Cloud Firestore için Security Rules değişkenini yerel proje dizininizde veya Firebase konsolunda tanımlayabilirsiniz.

Dağıtım çakışmalarını önlemenin bir başka yolu da kısmi dağıtım kullanmak ve Firebase konsolunda yalnızca Security Rules tanımlamaktır.

Dağıtım öncesi ve dağıtım sonrası komut dosyası görevlerini ayarlama

Dağıtım öncesi veya dağıtım sonrası görevleri gerçekleştirmek için kabuk komut dosyalarını firebase deploy komutuna bağlayabilirsiniz. Örneğin, dağıtım öncesi komut dosyası, TypeScript kodunu JavaScript'e çevirebilir ve dağıtım sonrası kancası, yöneticileri Firebase Hosting adresine yapılan yeni site içeriği dağıtımları hakkında bilgilendirebilir.

Dağıtım öncesi veya dağıtım sonrası kancaları ayarlamak için firebase.json yapılandırma dosyanıza bash komut dosyaları ekleyin. Kısa komut dosyalarını doğrudan firebase.json dosyasında tanımlayabilir veya proje dizininizdeki diğer dosyalara başvurabilirsiniz.

Örneğin, aşağıdaki komut dosyası, Firebase Hosting ortamına başarılı bir şekilde dağıtım yapıldığında Slack mesajı gönderen bir dağıtım sonrası görevin firebase.json ifadesidir.

"hosting": {
  // ...

  "postdeploy": "./messageSlack.sh 'Just deployed to Firebase Hosting'",
  "public": "public"
}

messageSlack.sh komut dosyası, proje dizininde bulunur ve şu şekilde görünür:

curl -X POST -H 'Content-type: application/json' --data '{"text":"$1"}'
     \https://SLACK_WEBHOOK_URL

Dağıtabileceğiniz tüm öğeler için predeploy ve postdeploy kancaları oluşturabilirsiniz. firebase deploy komutunu çalıştırmanın, firebase.json dosyanızda tanımlanan tüm dağıtım öncesi ve dağıtım sonrası görevleri tetiklediğini unutmayın. Yalnızca belirli bir Firebase hizmetiyle ilişkili görevleri çalıştırmak için kısmi dağıtım komutlarını kullanın.

Hem predeploy hem de postdeploy kancaları, komut dosyalarının standart çıkış ve hata akışlarını terminale yazdırır. Başarısızlık durumları için aşağıdakileri göz önünde bulundurun:

  • Dağıtım öncesi kanca beklendiği gibi tamamlanamazsa dağıtım iptal edilir.
  • Dağıtım herhangi bir nedenle başarısız olursa dağıtım sonrası kancalar tetiklenmez.

Ortam değişkenleri

Dağıtım öncesi ve dağıtım sonrası kancalarında çalışan komut dosyalarında aşağıdaki ortam değişkenleri kullanılabilir:

  • $GCLOUD_PROJECT: Etkin projenin proje kimliği
  • $PROJECT_DIR: firebase.json dosyasını içeren kök dizin
  • $RESOURCE_DIR: (Yalnızca hosting ve functions komut dosyaları için) Dağıtılacak Hosting veya Cloud Functions kaynaklarını içeren dizinin konumu

Dağıtım kotaları

Firebase dağıtım işlemlerinizin hızını veya hacmini sınırlayan bir kotayı aşmanız mümkündür (ancak bu pek olası değildir). Örneğin, çok sayıda işlev dağıtırken HTTP 429 Quota hata mesajı alabilirsiniz. Bu tür sorunları çözmek için kısmi dağıtımı kullanmayı deneyin.

Dağıtımı geri alma

Seçilen sürüm için Geri alma işlemini seçerek projenizin Firebase Hosting sayfasından Firebase Hosting dağıtımını geri alabilirsiniz.

Firebase Realtime Database, Cloud Storage for Firebase veya Cloud Firestore için Security Rules sürümlerini geri almak mümkün değildir.

Komut referansı

Bu bölümde, aşağıdaki kullanım alanları ve ürünler için kullanılabilen komutlar açıklanmaktadır:

CLI yönetim komutları

Komut Açıklama
help CLI veya belirli komutlar hakkında yardım bilgilerini gösterir.
init Mevcut dizinde yeni bir Firebase projesi ilişkilendirin ve oluşturun.
Bu komut, geçerli dizinde bir firebase.json yapılandırma dosyası oluşturur.
login

CLI'nın kimliğini Google Hesabınızla doğrulayın. Web tarayıcısına erişim gerekir.

localhost erişimine izin vermeyen uzak ortamlarda CLI'ya giriş yapmak için --no-localhost işaretini kullanın.

login:ci Kullanımdan kaldırıldı. Bunun yerine, Google Cloud hizmet hesabı (GOOGLE_APPLICATION_CREDENTIALS) ile Uygulama Varsayılan Kimlik Bilgileri'ni kullanın.
Etkileşimli olmayan ortamlarda kullanılacak bir kimlik doğrulama jetonu oluşturun.
login:add Ek bir Google Hesabı'na giriş yapın.
login:list Kimliği doğrulanmış tüm Google Hesaplarını listeleme
login:use \
EMAIL_ADDRESS 		Etkin Google Hesabı'nı ayarlayın.
logout CLI'da Google Hesabınızın oturumunu kapatın.
open İlgili proje kaynaklarına erişmek için bir tarayıcı açın.
projects:list Erişiminiz olan tüm Firebase projelerini listeler.
use

CLI için etkin Firebase projesini ayarlayın.

Proje takma adlarını yönetme hakkında daha fazla bilgi edinin.

Proje yönetimi komutları

Komut Açıklama
Firebase projelerinin yönetimi
projects:addfirebase Mevcut bir Google Cloud projesine Firebase'e özgü yapılandırmalar ekleyin ve Firebase'e özgü hizmetleri etkinleştirin.
projects:create Yeni bir Google Cloud projesi oluşturun, ardından Firebase'e özel yapılandırmaları ekleyin ve yeni projede Firebase'e özel hizmetleri etkinleştirin.
projects:list Erişiminiz olan tüm Firebase projelerini listeler.
Firebase uygulamalarının yönetimi (iOS, Android, web)
apps:create Yeni bir Firebase uygulaması oluşturun.
apps:list Etkin Firebase projesindeki tüm kayıtlı Firebase uygulamalarını listeler.
apps:sdkconfig \
[PLATFORM] \
[FIREBASE_APP_ID]

Belirtilen Firebase uygulamasının Firebase yapılandırmasını yazdırır.

  • PLATFORM; IOS, ANDROID veya WEB (büyük/küçük harfe duyarlı değildir) olabilir. Bu parametre belirtilmezse CLI, etkin Firebase projesindeki tüm Firebase uygulamalarının listesini göstererek bir uygulama seçmenizi ister. Etkin Firebase projesinde yalnızca bir Firebase uygulaması varsa CLI bu uygulamayı otomatik olarak seçer.
  • FIREBASE_APP_ID, Firebase uygulamasının uygulama kimliğidir (önce PLATFORM parametresinin belirtilmesi gerekir). Atlanırsa CLI, yalnızca bir uygulama eşleşiyorsa uygulamayı otomatik olarak seçer veya birden fazla uygulama eşleşiyorsa bir uygulama seçmenizi ister.

KSA, etkileşimli olmayan modda çalışıyorsa:

  • Etkin Firebase projesinde yalnızca bir Firebase uygulaması varsa hem PLATFORM hem de FIREBASE_APP_ID parametrelerini atlayabilirsiniz.
  • Etkin Firebase projesinde birden fazla Firebase uygulaması varsa PLATFORM (ve projede bu platform türünde birden fazla Firebase uygulaması varsa FIREBASE_APP_ID) belirtmeniz gerekir.

Bu komut, aşağıdaki isteğe bağlı işareti destekler:

  • -o veya --out [FILENAME]
    Yapılandırma çıkışını standart çıkışa yazdırmak yerine bir dosyaya yazın. FILENAME atlanırsa varsayılan olarak platforma özgü bir dosya adı (iOS için GoogleService-Info.plist, Android için google-services.json veya web için firebase-js-config.json) kullanılır. Hedef dosya zaten mevcutsa CLI, üzerine yazma işlemini onaylamanızı ister (veya etkileşimli olmayan modda başarısız olur).
SHA sertifika karmalarının yönetimi (yalnızca Android)
apps:android:sha:create \
FIREBASE_ANDROID_APP_ID \
SHA_HASH 		Belirtilen SHA sertifika karmasını belirtilen Firebase Android uygulamasına ekler.
apps:android:sha:delete \
FIREBASE_ANDROID_APP_ID \
SHA_ID 		Belirtilen Firebase Android uygulamasından, belirtilen SHA sertifikasını (apps:android:sha:list içindeki SHA_ID ile tanımlanır) silin.
apps:android:sha:list \
FIREBASE_ANDROID_APP_ID 		Belirtilen Firebase Android uygulaması için tüm SHA sertifika karmalarını listeler.

Dağıtım ve yerel geliştirme

Bu komutlar, Firebase projenizi dağıtmanıza ve projenizle etkileşim kurmanıza olanak tanır.

Komut Açıklama
deploy

Proje dizininizdeki kodları ve öğeleri etkin Firebase projesine dağıtın.

Bu komut, proje dizininizde bir firebase.json yapılandırma dosyası gerektirir.

Firebase projesine dağıtım yapma hakkında daha fazla bilgi edinin.

serve

Firebase Hosting yapılandırmanızı ve/veya yerel HTTP Cloud Functions (örneğin, --only hosting veya --only functions kullanarak) test etmek için yerel bir sunucu başlatın.

Bu komut, proje dizininizde bir firebase.json yapılandırma dosyası gerektirir.

Yerel olarak yayınlama ve test etme hakkında daha fazla bilgi edinin.

App Distribution komut

Komut Açıklama
appdistribution:distribute \
RELEASE_BINARY_FILE \
--app FIREBASE_APP_ID 		Belirtilen sürüm ikili program dosyasını (.apk, .aab veya .ipa) yükleyin ve belirtilen Firebase uygulaması için test kullanıcılarının kullanımına sunun.
appdistribution:testers:add \
[EMAILS...]

Etkin Firebase projesine bir veya daha fazla test kullanıcısı (boşlukla ayrılmış EMAILS olarak belirtilir) ekleyin. EMAILS atlanırsa --file FILE değerini iletmeniz gerekir.

Bu komut yalnızca projede henüz yer almayan test kullanıcılarını ekler; mevcut test kullanıcılarını kaldırmaz veya üzerine yazmaz.

Bu komut aşağıdaki isteğe bağlı işaretleri destekler:

  • --file FILE
    Eklenecek test kullanıcılarının e-posta adreslerini içeren, boş olmayan, virgülle veya yeni satırla ayrılmış bir dosyanın yolunu belirtin. Hem EMAILS hem de --file iletilirse EMAILS öncelikli olur.
  • --group-alias GROUP_ALIAS
    Ayrıca, belirtilen test kullanıcılarını GROUP_ALIAS ile tanımlanan test kullanıcısı grubuna ekleyin.
appdistribution:testers:remove \
[EMAILS...]

Test kullanıcılarını (boşlukla ayrılmış EMAILS olarak belirtilir) etkin Firebase projesinden kaldırın. EMAILS atlanırsa --file FILE değerini iletmeniz gerekir.

Bu komut aşağıdaki isteğe bağlı işaretleri destekler:

  • --file FILE
    Kaldırılacak test kullanıcısı e-posta adreslerini içeren, virgülle veya yeni satırla ayrılmış bir dosyanın yolunu belirtin. (Hem EMAILS hem de --file iletilirse EMAILS öncelikli olur.)
  • --group-alias GROUP_ALIAS
    Belirtilen test kullanıcılarını etkin Firebase projesinden kaldırmak yerine GROUP_ALIAS ile tanımlanan test kullanıcısı grubundan yalnızca kaldırın.
appdistribution:testers:list Etkin Firebase projesindeki test kullanıcılarını listeler.
appdistribution:groups:create \
DISPLAY_NAME \
[GROUP_ALIAS] 		Belirtilen DISPLAY_NAME ve isteğe bağlı GROUP_ALIAS ile bir test kullanıcısı grubu oluşturun.
GROUP_ALIAS atlanırsa DISPLAY_NAME üzerinden otomatik olarak bir takma ad oluşturulur.
appdistribution:groups:delete \
GROUP_ALIAS 		Belirtilen takma ada sahip test kullanıcısı grubunu siler.
appdistribution:groups:list Etkin Firebase projesindeki tüm test kullanıcısı gruplarını listeler.

App Hosting komut

Komut Açıklama
apphosting:backends:create \
--backend BACKEND_ID \
--primary-region REGION_NAME \
--app FIREBASE_WEB_APP_ID

App Hosting arka ucu içeren tek bir kod tabanına bağlı yönetilen kaynaklar koleksiyonunu oluşturun.

Bu komut, aşağıdaki isteğe bağlı (ancak önerilen) işaretleri destekler:

  • --backend BACKEND_ID
    Yeni App Hosting arka ucu için kimliği belirtin. Etkileşimli modda atlanırsa KSA, bir arka uç kimliği girmenizi ister.
  • --primary-region REGION_NAME
    App Hosting arka ucunun oluşturulacağı birincil bölgeyi belirtin. Etkileşimli modda belirtilmezse CLI, bir konum seçmenizi ister. App Hosting için desteklenen konumlar hakkında bilgi edinin.
  • -a veya --app FIREBASE_WEB_APP_ID
    Mevcut bir Firebase web uygulamasının uygulama kimliğini belirtin. Atlanırsa CLI, BACKEND_ID adında yeni bir Firebase web uygulamasını otomatik olarak oluşturur ve ilişkilendirir (proje, Firebase uygulama kotasına ulaşmadığı sürece).

Bu komut, aşağıdaki isteğe bağlı işaretleri de destekler:

  • --root-dir ROOT_DIR
    Uygulamanızın kök dizinini deponuza göre belirtin. Etkileşimli modda belirtilmezse KSA, dizini girmenizi ister (varsayılan olarak /).
  • -s veya --service-account SERVICE_ACCOUNT
    Sunucuyu çalıştırmak için kullanılan hizmet hesabını belirtin. Boş bırakılırsa varsayılan olarak varsayılan App Hosting Compute hizmet hesabı kullanılır.

CLI etkileşimli olmayan modda çalışıyorsa hem --backend hem de --primary-region gereklidir.

apphosting:backends:get \
BACKEND_ID

Belirtilen App Hosting arka ucunun herkese açık URL dahil ayrıntılarını alın.

Birden fazla bölge belirtilen BACKEND_ID ile bir arka uç içeriyorsa CLI bir uyarı kaydeder ve eşleşen ilk arka ucu yazdırır (bu komutun --location işaretini desteklemediğini unutmayın).

apphosting:backends:list Etkin Firebase projesindeki tüm etkin App Hosting arka uçlarını listeler.
apphosting:backends:delete \
BACKEND_ID

Belirtilen App Hosting arka ucunu silin.

CLI, harekete geçmeden önce bir onay istemi gösterir. Onay istemini atlamak için (etkileşimli modda gereklidir) şu işaretleri iletin: -f veya --force.

Birden fazla bölge belirtilen BACKEND_ID değerine sahip bir arka uç içeriyorsa CLI, etkileşimli modda hangi arka uçların silineceğini seçmenizi ister ve -f veya --force iletilirse başarısız olur (bu komutun --location işaretini desteklemediğini unutmayın).

apphosting:rollouts:create \
BACKEND_ID

Belirtilen App Hosting arka ucu için manuel olarak tetiklenen bir sunum oluşturun.

Bu komut, aşağıdaki isteğe bağlı, birbirini dışlayan işaretleri destekler. Hiçbiri sağlanmazsa CLI, dallar listesinden seçim yapmanızı ister. Etkileşimli olmayan modda bu işaretlerden birinin sağlanması gerekir.

  • -b veya --git-branch BRANCH_NAME
    Belirtilen Git dalındaki en son kaydı dağıtın.
  • -g veya --git-commit COMMIT_ID
    Belirtilen Git commit'ini dağıtın.

Birden fazla bölge, belirtilen BACKEND_ID değerine sahip bir arka uç içeriyorsa bu komut hem etkileşimli hem de etkileşimli olmayan modlarda başarısız olur (Bu komutun --location işaretini desteklemediğini unutmayın).

apphosting:secrets:set \
SECRET_NAME \
--data-file DATA_FILE_PATH

Belirtilen SECRET_NAME ile Google Cloud Secret Manager içinde gizli anahtar oluşturun veya mevcut bir gizli anahtarı güncelleyin.

Bu komut, aşağıdaki isteğe bağlı (ancak önerilen) işareti destekler:

  • --data-file DATA_FILE_PATH
    Gizli verilerin okunacağı bir yol belirtin veya standart girişten gizli verileri okumak için - olarak ayarlayın. Atlanırsa CLI, gizli değeri girmenizi ister (maskelenmiş girişle) veya standart giriş yönlendirilmişse standart girişten okur.

Bu komut, aşağıdaki isteğe bağlı işareti de destekler:

  • -l veya --location REGION_NAME
    Yeni bir gizli anahtar oluştururken replikasyonunu belirtilen Google Cloud Secret Manager bölgesiyle kısıtlayın. Atlanırsa Google Cloud Secret Manager otomatik global replikasyon kullanır. (Mevcut gizli anahtarlar için kopyalama politikaları değiştirilemez.)

CLI etkileşimli olmayan modda çalışıyorsa --data-file DATA_FILE_PATH parametresini iletin (veya gizli değeri standart girişe yönlendirin).

apphosting:secrets:grantaccess \
SECRET_NAME

Belirtilen gizli anahtarlar için bir dizi kullanıcı veya grup e-posta adresine ya da bir arka uç hizmet hesabına izin verin. Ardından, derleme veya çalışma zamanında App Hosting tarafından gizli anahtarlara erişilebilir.

Virgülle ayrılmış bir veya daha fazla SECRET_NAME değeri iletebilirsiniz. --emails veya --backend değerlerinden birini belirtmeniz gerekir (bu iki işaret birbirini hariç tutar).

Bir dizi kullanıcı veya grup e-posta adresine erişim izni verme:

  • -e veya --emails EMAILS
    Belirtilen gizli anahtarlara erişim izni verilmesi gereken kullanıcı veya grup e-postalarının virgülle ayrılmış bir listesini belirtin.

Bir arka ucun hizmet hesabına erişim izni verme:

  • -b veya --backend BACKEND_ID
    Hizmet hesabına belirtilen gizli anahtarlara erişim izni verilmesi gereken App Hosting arka ucunu belirtin.
  • -l veya --location REGION_NAME
    App Hosting arka ucu için bölgeyi belirtin. Atlanırsa CLI, eşleşen BACKEND_ID için tüm bölgelerde arama yapar. Birden fazla bölgede bu kimliğe sahip bir arka uç varsa CLI, etkileşimli modda birini seçmenizi ister (etkileşimli olmayan modda --location gereklidir).
apphosting:secrets:revokeaccess \
SECRET_NAME

Belirtilen gizli anahtarlara erişim izinlerini bir dizi kullanıcı veya grup e-postasından ya da bir arka uç hizmet hesabından iptal edin.

Virgülle ayrılmış bir veya daha fazla SECRET_NAME değeri iletebilirsiniz. --emails veya --backend değerlerinden birini belirtmeniz gerekir (bu iki işaret birbirini hariç tutar).

Bir grup kullanıcı veya grup e-posta adresinin erişimini iptal etme:

  • -e veya --emails EMAILS
    Belirtilen gizli anahtarlara erişimi iptal edilecek kullanıcı veya grup e-postalarının virgülle ayrılmış bir listesini belirtin.

Arka uç hizmet hesabının erişimini iptal etme:

  • -b veya --backend BACKEND_ID
    Hizmet hesabının belirtilen gizli anahtarlara erişiminin iptal edilmesi gereken App Hosting arka ucunu belirtin.
  • -l veya --location REGION_NAME
    App Hosting arka ucu için bölgeyi belirtin. Atlanırsa CLI, eşleşen BACKEND_ID için tüm bölgelerde arama yapar. Birden fazla bölgede bu kimliğe sahip bir arka uç varsa CLI, etkileşimli modda birini seçmenizi ister (etkileşimli olmayan modda --location gereklidir).
apphosting:secrets:describe \
SECRET_NAME 		Belirtilen gizli anahtar adı için meta verileri ve sürümleri alın.
apphosting:secrets:access \
SECRET_NAME[@VERSION] 		Belirtilen sürümde, belirtilen gizli anahtar adı için gizli anahtarın değerine erişin.
[@VERSION] atlanırsa varsayılan olarak en yeni sürüme erişilir.

Authentication (kullanıcı yönetimi) komutları

Komut Açıklama
auth:export \
DATA_FILE

Etkin Firebase projesinin kullanıcı hesaplarını bir JSON veya CSV dosyasına aktarın.

Daha fazla bilgi için "auth:import and auth:export" sayfasına bakın.

auth:import \
DATA_FILE

Kullanıcı hesaplarını bir JSON veya CSV dosyasından etkin Firebase projesine aktarın.

Daha fazla bilgi için "auth:import and auth:export" sayfasını inceleyin.

Cloud Firestore komut

Komut Açıklama
firestore:locations

Etkin Firebase projesindeki Cloud Firestore veritabanı örnekleri için kullanılabilir konumları listeler.

Standard sürüm, Enterprise sürüm ve MongoDB uyumluluğu için kullanılabilir konumlar hakkında bilgi edinin.

firestore:databases:create \
DATABASE_ID \
--location REGION_NAME

Belirtilen konumda belirtilen Cloud Firestore veritabanı örneğini (yerel modda) oluşturun.
REGION_NAME için kullanılabilir konumları listelemek üzere firebase firestore:locations komutunu çalıştırın.

Bu komut aşağıdaki isteğe bağlı işaretleri destekler:

  • --delete-protection DELETION_PROTECTION_STATE
    Belirtilen Cloud Firestore veritabanı örneğinin silinmesine izin verin veya silinmesini engelleyin. Geçerli değerler ENABLED veya DISABLED'dir. Atlanırsa varsayılan olarak DISABLED olur.
  • --point-in-time-recovery PITR_STATE
    Belirtilen Cloud Firestore veritabanı örneği için belirli bir noktadan önceyi kurtarmanın etkinleştirilip etkinleştirilmeyeceğini ayarlayın. Geçerli değerler ENABLED veya DISABLED'dir. Atlanırsa varsayılan olarak DISABLED olur.
  • --edition EDITION
    Belirtilen Cloud Firestore veritabanı örneğinin sürümünü ayarlayın.
    Geçerli değerler standard veya enterprise'dir. Atlanırsa varsayılan olarak standard olur.
  • --firestore-data-access ENABLEMENT_STATE
    (Yalnızca Enterprise sürümü) Cloud Firestore API'nin kullanılabilirliğini kontrol edin. Geçerli değerler ENABLED veya DISABLED'dir. Boş bırakılırsa varsayılan olarak ENABLED olur (ancak --mongodb-compatible-data-access, ENABLED olduğunda varsayılan olarak DISABLED olur).
  • --mongodb-compatible-data-access ENABLEMENT_STATE
    (Yalnızca Enterprise sürümü) MongoDB uyumlu API'nin kullanılabilirliğini kontrol edin. Geçerli değerler ENABLED veya DISABLED'dir. Atlanırsa varsayılan olarak DISABLED olur.
  • --realtime-updates ENABLEMENT_STATE
    (Yalnızca Enterprise sürümü) "İzle" (gerçek zamanlı) özelliğini etkinleştirin veya devre dışı bırakın. Geçerli değerler ENABLED veya DISABLED'dir. Boş bırakılırsa --firestore-data-access, ENABLED olduğunda varsayılan olarak ENABLED kullanılır (aksi takdirde sunucu varsayılanı kullanılır).
    Bu işaretin ayarlanması için --firestore-data-access değerinin ENABLED olması gerekir.
firestore:databases:list

Etkin Firebase projesindeki tüm Cloud Firestore veritabanı örneklerini listeler.

firestore:databases:get \
[DATABASE_ID]

Belirtilen Cloud Firestore veritabanı örneğinin veritabanı yapılandırmasını alın.
DATABASE_ID atlanırsa etkin Firebase projesinin varsayılan Cloud Firestore veritabanı örneği kullanılır.

Tablo çıkışı, tüm veritabanları için veritabanının Edition değerini içerir. Kurumsal veri erişimi ve gerçek zamanlı güncelleme durumu alanları, yalnızca --json iletildiğinde ham JSON çıkışına dahil edilir.

firestore:databases:update \
DATABASE_ID

Belirtilen Cloud Firestore veritabanı örneğinin veritabanı yapılandırmasını güncelleyin.

En az bir işaret gereklidir (atlanmış işaretler mevcut ayarlarını korur). Bu komut aşağıdaki işaretleri destekler:

  • --delete-protection DELETION_PROTECTION_STATE
    Belirtilen Cloud Firestore veritabanı örneğinin silinmesine izin verin veya silinmesini engelleyin. Geçerli değerler ENABLED veya DISABLED'dir.
  • --point-in-time-recovery PITR_STATE
    Belirtilen Cloud Firestore veritabanı örneği için belirli bir noktadan önceyi kurtarmanın etkinleştirilip etkinleştirilmeyeceğini ayarlayın. Geçerli değerler ENABLED veya DISABLED'dir.
firestore:databases:delete \
DATABASE_ID

Belirtilen Cloud Firestore veritabanı örneğini silin.

CLI, işlem yapmadan önce bir onay istemi gösterir. Onay istemini atlamak için (etkileşimli olmayan modda gereklidir) --force işaretini iletin. (Diğer komutların aksine, firestore:databases:delete komutu -f kısayolunu desteklemez.)

firestore:indexes

Bir Cloud Firestore veritabanı örneğinin tüm dizinlerini listeleme

Bu komut, aşağıdaki isteğe bağlı işareti destekler:

  • --database DATABASE_ID
    Dizinlerini listelemek istediğiniz Cloud Firestore veritabanı örneğini belirtin. Atlanırsa dizinler, etkin Firebase projesinin varsayılan Cloud Firestore veritabanı örneği için listelenir.
firestore:delete \
[PATH]

Belirtilen veritabanı yolundaki (PATH) dokümanları bir Cloud Firestore veritabanı örneğinden silin.

--all-collections iletilmediği sürece PATH gereklidir. Alt koleksiyonları olan bir koleksiyonu veya dokümanı silmek için -r/--recursive ya da --shallow parametresinin iletilmesi gerekir.

CLI kullanarak Cloud Firestore verilerini silmenin okuma ve silme maliyetlerine yol açacağını unutmayın. Daha fazla bilgi için Cloud Firestore faturalandırmasını anlama başlıklı makaleyi inceleyin.

Bu komut aşağıdaki isteğe bağlı işaretleri destekler:

  • --database DATABASE_ID
    Belgelerin silineceği Cloud Firestore veritabanını belirtin. Atlanırsa belgeler, etkin Firebase projesinin varsayılan Cloud Firestore veritabanı örneğinden silinir.
  • --all-collections
    Veritabanındaki tüm koleksiyonları silin. (Bu işareti kullanırken PATH parametresini iletmeyin.)
  • -r veya --recursive
    Belirtilen yoldaki tüm dokümanları ve alt koleksiyonları yinelemeli olarak siler. (--shallow ile iletilemez.)
  • --shallow
    Yalnızca belirtilen düzeydeki belgeleri silin ve alt koleksiyonlardaki belgeleri yoksayın. Bu işlemin, iç içe yerleştirilmiş dokümanları sahipsiz bırakabileceğini unutmayın. (-r veya --recursive ile birlikte iletilemez.)

CLI, harekete geçmeden önce bir onay istemi gösterir. Onay istemini atlamak için (etkileşimli modda gereklidir) şu işaretleri iletin: -f veya --force.

Cloud Functions for Firebase komut

Daha fazla bilgi için ortam yapılandırma belgelerine bakın.

Komut Açıklama
functions:config:export

Etkin Firebase projesinin eski functions.config() çalışma zamanı yapılandırmasını Google Cloud Secret Manager içinde tek bir JSON gizli anahtarı olarak dışa aktarın (defineJsonSecret ile kullanılmak üzere).

Bu komut aşağıdaki isteğe bağlı işaretleri destekler:

  • --secret SECRET_NAME
    Google Cloud Secret Manager içinde oluşturulacak veya güncellenecek gizli anahtarın adını belirtin. Atlanırsa CLI, bir ad girmenizi ister (varsayılan olarak FUNCTIONS_CONFIG_EXPORT).
  • -f veya --force
    İstem olmadan varsayılan gizli anahtar adını (FUNCTIONS_CONFIG_EXPORT) kullanın ve gizli anahtar zaten mevcutsa onay olmadan yeni bir gizli anahtar sürümü ekleyin. (Etkileşimli olmayan modda mevcut bir gizli anahtara yeni sürüm eklemek için gereklidir.)
functions:delete \
FUNCTION_NAME...

Etkin Firebase projesinden belirtilen bir veya daha fazla işlevi siler.

CLI, harekete geçmeden önce bir onay istemi gösterir. Onay istemini atlamak için (etkileşimli modda gereklidir) şu işaretleri iletin: -f veya --force.

functions:list Etkin Firebase projesinde dağıtılan tüm işlevleri listeler.
functions:log Etkin Firebase projesinde dağıtılan tüm Cloud Functions için günlükleri okuyun.
functions:secrets:access \
SECRET_NAME[@VERSION] 		Belirtilen sürümde, belirtilen gizli anahtar adı için gizli anahtarın değerine erişin.
[@VERSION] atlanırsa varsayılan olarak en yeni sürüme erişilir.
functions:secrets:destroy \
SECRET_NAME[@VERSION]

Belirtilen sürümdeki belirtilen gizli anahtarı siler.
[@VERSION] atlanırsa varsayılan olarak en yeni sürüm imha edilir.

CLI, işlem yapmadan önce bir onay istemi gösterir. Bu istem, -f veya --force olmadan etkileşimli olmayan modda otomatik olarak onaylanır. Ancak gizli anahtar hâlâ etkin işlev uç noktalarına bağlıysa gizli anahtarı silmek için -f veya --force parametresini iletmeniz gerekir.

functions:secrets:get \
SECRET_NAME 		Belirtilen gizli anahtar adı için meta verileri ve sürümleri alın.
functions:secrets:prune Etkin Firebase projesindeki kullanılmayan tüm gizli anahtarları imha edin.
functions:secrets:set \
SECRET_NAME 		Belirtilen gizli anahtarı oluşturun veya güncelleyin.
functions:shell İşlevleri test etmek için yerel bir etkileşimli kabuk başlatın.
functions:config:clone \
--from PROJECT_ID

Kullanımdan kaldırıldı.
Başka bir projenin ortamını etkin Firebase projesine kopyalayın.

Varsayılan olarak devre dışıdır. Bu komutu kullanmak için önce firebase experiments:enable legacyRuntimeConfigCommands komutunu çalıştırın.

functions:config:get Kullanımdan kaldırıldı.
Etkin Firebase projesinin Cloud Functions mevcut yapılandırma değerlerini alın.
functions:config:set \
KEY=VALUE...

Kullanımdan kaldırıldı.
Etkin Firebase projesinin çalışma zamanı yapılandırma değerlerini Cloud Functions içinde saklayın.

Varsayılan olarak devre dışıdır. Bu komutu kullanmak için önce firebase experiments:enable legacyRuntimeConfigCommands komutunu çalıştırın.

functions:config:unset \
KEY...

Kullanımdan kaldırıldı.
Etkin Firebase projesinin çalışma zamanı yapılandırmasından değerleri kaldırın.

Varsayılan olarak devre dışıdır. Bu komutu kullanmak için önce firebase experiments:enable legacyRuntimeConfigCommands komutunu çalıştırın.

Crashlytics komut

Komut Açıklama
crashlytics:mappingfile:generateid \
--resource-file PATH/TO/ANDROID_RESOURCE.XML 		Belirtilen Android kaynak (XML) dosyasında benzersiz bir eşleme dosyası kimliği oluşturun.
crashlytics:mappingfile:upload \
--app FIREBASE_APP_ID \
--resource-file PATH/TO/ANDROID_RESOURCE.XML \
PATH/TO/MAPPING_FILE.TXT 		Belirtilen Firebase uygulaması için Proguard uyumlu bir eşleme (TXT) dosyası yükleyin ve bu dosyayı, belirtilen Android kaynak (XML) dosyasında bildirilen eşleme dosyası kimliğiyle ilişkilendirin.
crashlytics:symbols:upload \
--app FIREBASE_APP_ID \
PATH/TO/SYMBOLS...

Android yerel kitaplık kilitlenmeleri (ör. Android NDK veya Unity ya da Flutter'ın Android derlemeleri) için Crashlytics ile uyumlu bir sembol dosyası oluşturun ve Firebase sunucularına yükleyin.

Bu komut yalnızca Android'i destekler. iOS dSYM'leri için Apple SDK'sının upload-symbols komut dosyasını kullanın.

Extensions komut

Komut Açıklama
ext Firebase Extensions komutlarının nasıl kullanılacağıyla ilgili bilgileri gösterir.
Etkin projede yüklü uzantı örneklerini listeleme
ext:configure \
EXTENSION_INSTANCE_ID 		Uzantı manifestinizde bir uzantı örneğinin parametre değerlerini yeniden yapılandırın.
ext:info \
PUBLISHER_ID/EXTENSION_ID 		Bir uzantıyla ilgili ayrıntılı bilgileri yazdırır.
ext:install \
PUBLISHER_ID/EXTENSION_ID 		Uzantı manifestinize yeni bir uzantı örneği ekleyin.
ext:sdk:install \
EXTENSION_NAME 		İşlevlerde uzantıları tanımlamak için SDK'ları yükleyin.
ext:list Bir Firebase projesinde yüklü olan tüm uzantı örneklerini listeleme
Her uzantının örnek kimliğini yazdırın.
ext:uninstall \
EXTENSION_INSTANCE_ID 		Uzantı manifestinizden bir uzantı örneğini kaldırın.
ext:update \
EXTENSION_INSTANCE_ID \
[UPDATE_SOURCE]

Bir uzantı örneğini, uzantı manifestinizdeki en yeni sürüme (veya belirtilen yayınlanmış UPDATE_SOURCE sürümüne) güncelleyin. UPDATE_SOURCE için yerel yolların ve URL'lerin desteklenmediğini unutmayın.

CLI, harekete geçmeden önce bir onay istemi gösterir. Etkileşimli modda bu istemi atlamak için -f veya --force komutunu kullanabilirsiniz. Ancak ext:update yalnızca etkileşimli bir komuttur ve -f veya --force ile bile etkileşimli olmayan modda desteklenmez.

ext:export Yüklü tüm uzantı örneklerini projenizden uzantı manifestinize aktarın.

Extensions yayıncı komutu

Komut Açıklama
ext:dev:init Geçerli dizinde yeni bir uzantı için iskelet kod tabanı başlatın.
ext:dev:list \
PUBLISHER_ID 		Bir yayıncı tarafından yüklenen tüm uzantıların listesini yazdırma.
ext:dev:register Devre dışı.
Yeni yayıncı profili kimliklerinin kaydedilmesi artık desteklenmiyor.
ext:dev:deprecate \
PUBLISHER_ID/EXTENSION_ID \
[VERSION_PREDICATE] 		Sürüm yüklemiyle eşleşen uzantı sürümlerini kullanımdan kaldırın.
Sürüm yüklemi tek bir sürüm (ör. 1.0.0) veya bir sürüm aralığı (ör. >1.0.0) olabilir.
Sürüm yüklemi sağlanmazsa ilgili uzantının tüm sürümleri kullanımdan kaldırılır.
ext:dev:undeprecate \
PUBLISHER_ID/EXTENSION_ID \
VERSION_PREDICATE 		Sürüm yüklemiyle eşleşen uzantı sürümlerini eski haline getirin.
Sürüm yüklemi, tek bir sürüm (ör. 1.0.0) veya bir sürüm aralığı (ör. >1.0.0) olabilir.
ext:dev:upload \
PUBLISHER_ID/EXTENSION_ID 		Uzantının yeni bir sürümünü yükleyin.
ext:dev:usage \
PUBLISHER_ID 		Bir yayıncı tarafından yüklenen uzantıların yükleme sayılarını ve kullanım metriklerini gösterir.

Hosting komut

Komut Açıklama
hosting:disable

Hosting sitesi için Firebase Hosting trafiği sunmayı durdurun.

Bu komut çalıştırıldıktan sonra sitenin Hosting URL'sinde "Site Bulunamadı" mesajı gösterilir.

Bu komut, aşağıdaki isteğe bağlı işareti destekler:

  • --site SITE_ID
    Devre dışı bırakılacak Hosting sitesini belirtin. Atlanırsa varsayılan olarak etkin Firebase projesinin varsayılan Hosting sitesi kullanılır.

CLI, harekete geçmeden önce bir onay istemi gösterir. Onay istemini atlamak için (etkileşimli modda gereklidir) şu işaretleri iletin: -f veya --force.

Hosting sitenin yönetimi
hosting:sites:create \
[SITE_ID]

Belirtilen SITE_ID değerini kullanarak yeni bir Hosting sitesi oluşturun.

CLI etkileşimli olmayan modda çalışıyorsa SITE_ID gereklidir.

Bu komut, aşağıdaki isteğe bağlı işareti destekler:

  • --app FIREBASE_APP_ID
    Yeni Hosting site ile ilişkilendirilecek mevcut bir Firebase web uygulaması belirtin.
hosting:sites:delete \
SITE_ID

Belirtilen Hosting sitesini silin.

CLI, harekete geçmeden önce bir onay istemi gösterir. Onay istemini atlamak için (etkileşimli modda gereklidir) şu işaretleri iletin: -f veya --force.

hosting:sites:get \
SITE_ID

Belirtilen Hosting sitesiyle ilgili ayrıntıları alın.

Tablo çıkışı; site kimliğini, varsayılan URL'yi ve Firebase web uygulaması kimliğini (bağlıysa) içerir. Ek meta veriler (ör. sitenin DEFAULT_SITE veya USER_SITE olup olmadığı) yalnızca --json iletildiğinde ham JSON çıkışına dahil edilir.

hosting:sites:list Etkin Firebase projesindeki tüm Hosting sitelerini listeler.
Önizleme kanallarının yönetimi
hosting:channel:create \
[CHANNEL_ID]

Belirtilen CHANNEL_ID kullanarak bir Hosting sitesi için yeni bir önizleme kanalı oluşturun.
Bu komut kanala dağıtılmaz.

CLI etkileşimli olmayan modda çalışıyorsa CHANNEL_ID gereklidir.

Bu komut, aşağıdaki isteğe bağlı işareti destekler:

  • --site SITE_ID
    Önizleme kanalının oluşturulacağı Hosting sitesini belirtin. Atlanırsa varsayılan olarak etkin Firebase projesinin varsayılan Hosting sitesi kullanılır.
hosting:channel:delete \
CHANNEL_ID

Belirtilen önizleme kanalını siler. Bir sitenin canlı kanalını silemezsiniz.

Bu komut, aşağıdaki isteğe bağlı işareti destekler:

  • --site SITE_ID
    Önizleme kanalının silineceği Hosting sitesini belirtin. Atlanırsa varsayılan olarak etkin Firebase projesinin varsayılan Hosting sitesi kullanılır.

CLI, harekete geçmeden önce bir onay istemi gösterir. Onay istemini atlamak için (etkileşimli modda gereklidir) şu işaretleri iletin: -f veya --force.

hosting:channel:deploy \
CHANNEL_ID

Hosting içeriğinizi ve yapılandırmanızı belirtilen önizleme kanalına dağıtın.
Önizleme kanalı henüz mevcut değilse bu komut, kanala dağıtım yapmadan önce Hosting sitesinde kanalı oluşturur.

Bu komut, aşağıdaki isteğe bağlı işareti destekler:

  • --only TARGETS
    Önizleme kanalına dağıtmak için firebase.json içinde yapılandırılmış Hosting hedeflerinin virgülle ayrılmış listesini belirtin. Atlanırsa firebase.json içinde yapılandırılan tüm Hosting sitelerine dağıtılır.
hosting:channel:list

Bir Hosting sitesinin tüm kanallarını ("canlı" kanal dahil) listeleme

Bu komut, aşağıdaki isteğe bağlı işareti destekler:

  • --site SITE_ID
    Kanalların listeleneceği Hosting sitesini belirtin. Atlanırsa varsayılan olarak etkin Firebase projesinin varsayılan Hosting sitesi kullanılır.
hosting:channel:open \
[CHANNEL_ID]

Belirtilen kanalın URL'sini bir tarayıcıda açar veya tarayıcıda açmak mümkün değilse URL'yi döndürür.

CLI etkileşimli olmayan modda çalışıyorsa CHANNEL_ID gereklidir.

Bu komut, aşağıdaki isteğe bağlı işareti destekler:

  • --site SITE_ID
    Önizleme kanalı için Hosting sitesini belirtin. Atlanırsa varsayılan olarak etkin Firebase projesinin varsayılan Hosting sitesi kullanılır.
Sürüm kopyalama
hosting:clone \
SOURCE_SITE_ID:SOURCE_CHANNEL_ID \
TARGET_SITE_ID:TARGET_CHANNEL_ID

Belirtilen "kaynak" kanalda en son dağıtılan sürümü belirtilen "hedef" kanala kopyalayın.

Bu komut, belirtilen "hedef" kanala da dağıtım yapar. "Hedef" kanal henüz mevcut değilse bu komut, kanala dağıtım yapmadan önce "hedef" Hosting sitesinde yeni bir önizleme kanalı oluşturur.

hosting:clone \
SOURCE_SITE_ID@VERSION_ID \
TARGET_SITE_ID:TARGET_CHANNEL_ID

Belirtilen sürümü, belirtilen "hedef" kanala kopyalayın.

Bu komut, belirtilen "hedef" kanala da dağıtım yapar. "Hedef" kanal henüz mevcut değilse bu komut, kanala dağıtım yapmadan önce "hedef" Hosting sitesinde yeni bir önizleme kanalı oluşturur.

VERSION_ID bilgisini Firebase konsolunun Hosting kontrol panelinde bulabilirsiniz.

Realtime Database komut

İlk, varsayılan Realtime Database örneğinizi Firebase konsolunda veya genel firebase init iş akışını ya da özel firebase init database akışını kullanarak oluşturabilirsiniz.

Örnekler oluşturulduktan sonra bunları CLI kullanarak belirli örnekleri yönetme ve bunlarla etkileşim kurma bölümünde açıklandığı şekilde yönetebilirsiniz.

Komut Açıklama
database:get \
PATH

Belirtilen veritabanı konumunda (PATH) bir Realtime Database örneği için verileri alın ve JSON olarak gösterin. Dizine eklenen verilerde sorgulamayı destekler.

Bu komut, aşağıdaki isteğe bağlı işareti destekler:

  • --instance DATABASE_NAME
    İşlem için Realtime Database örneğini belirtin. Atlanırsa varsayılan olarak etkin Firebase projesinin varsayılan Realtime Database örneği kullanılır.
database:instances:create \
DATABASE_NAME \
--location REGION_NAME

Belirtilen konumda belirtilen DATABASE_NAME ile bir Realtime Database örneği oluşturun.

Bu komut, aşağıdaki isteğe bağlı (ancak önerilen) işareti destekler:

Etkin Firebase projesi için varsayılan Realtime Database örneğini oluşturmak üzere bu komutu kullanamazsınız. Projede mevcut Realtime Database örneği yoksa projenin ilk Realtime Database örneğini (varsayılan örnek) oluşturmak için firebase init akışını çalıştırmanız istenir.

database:instances:list

Etkin Firebase projesindeki tüm Realtime Database örneklerini listeler.

Bu komut, aşağıdaki isteğe bağlı işareti destekler:

  • --location REGION_NAME
    Realtime Database örneklerini listelemek için belirli bir konum belirtin. Kullanılabilir bölge adları için Realtime Database için konumlar başlıklı makaleyi inceleyin.
database:profile

Bir Realtime Database örneği için işlem profili oluşturun.
Daha fazla bilgi için Realtime Database işlem türleri başlıklı makaleyi inceleyin.

Bu komut, aşağıdaki isteğe bağlı işareti destekler:

  • --instance DATABASE_NAME
    İşlem için Realtime Database örneğini belirtin. Atlanırsa varsayılan olarak etkin Firebase projesinin varsayılan Realtime Database örneği kullanılır.
database:push \
PATH \
[INFILE]

Belirtilen veritabanı konumundaki (PATH) bir listeye yeni veri aktarır. Bu işlem, bir Realtime Database örneğinde gerçekleştirilir.

Bir dosyadan (INFILE), STDIN'den veya -d (--data) işaretinden giriş alır.

Bu komut, aşağıdaki isteğe bağlı işareti destekler:

  • --instance DATABASE_NAME
    İşlem için Realtime Database örneğini belirtin. Atlanırsa varsayılan olarak etkin Firebase projesinin varsayılan Realtime Database örneği kullanılır.
database:remove \
PATH

Bir Realtime Database örneğinde belirtilen veritabanı konumundaki (PATH) tüm verileri siler.

Bu komut, aşağıdaki isteğe bağlı işareti destekler:

  • --instance DATABASE_NAME
    İşlem için Realtime Database örneğini belirtin. Atlanırsa varsayılan olarak etkin Firebase projesinin varsayılan Realtime Database örneği kullanılır.

CLI, harekete geçmeden önce bir onay istemi gösterir. Onay istemini atlamak için (etkileşimli modda gereklidir) şu işaretleri iletin: -f veya --force.

database:set \
PATH \
[INFILE]

Realtime Database örneğinde belirtilen veritabanı konumundaki (PATH) tüm verileri değiştirin.

Bir dosyadan (INFILE), STDIN'den veya -d (--data) işaretinden giriş alır.

Bu komut, aşağıdaki isteğe bağlı işareti destekler:

  • --instance DATABASE_NAME
    İşlem için Realtime Database örneğini belirtin. Atlanırsa varsayılan olarak etkin Firebase projesinin varsayılan Realtime Database örneği kullanılır.

CLI, harekete geçmeden önce bir onay istemi gösterir. Onay istemini atlamak için (etkileşimli modda gereklidir) şu işaretleri iletin: -f veya --force.

database:update \
PATH \
[INFILE]

Realtime Database örneğinde belirtilen veritabanı konumunda (PATH) kısmi güncelleme gerçekleştirin.

Bir dosyadan (INFILE), STDIN'den veya -d (--data) işaretinden giriş alır.

Bu komut, aşağıdaki isteğe bağlı işareti destekler:

  • --instance DATABASE_NAME
    İşlem için Realtime Database örneğini belirtin. Atlanırsa varsayılan olarak etkin Firebase projesinin varsayılan Realtime Database örneği kullanılır.

CLI, harekete geçmeden önce bir onay istemi gösterir. Onay istemini atlamak için (etkileşimli modda gereklidir) şu işaretleri iletin: -f veya --force.

Remote Config komut

Bu komutlar ve kullanım alanları, Remote Config programatik olarak değiştirme bölümünde daha ayrıntılı olarak ele alınmıştır.

Komut Açıklama
remoteconfig:versions:list

Remote Config şablonunun tüm sürümlerini listele.

Bu komut, aşağıdaki isteğe bağlı işareti destekler:

  • --limit NUMBER_OF_VERSIONS
    Döndürülecek maksimum sürüm sayısını belirtin. Mevcut tüm sürümleri döndürmek için 0 değerini belirtin. Atlanırsa varsayılan olarak 10 olur.
remoteconfig:get \
--version-number VERSION_NUMBER

Belirtilen sürümdeki Remote Config şablonunun ayrıntılarını alın.

Bu komut, aşağıdaki isteğe bağlı (ancak önerilen) işaretleri destekler:

  • -v veya --version-number VERSION_NUMBER
    Alınacak Remote Config şablonunun sürümünü belirtin. Atlanırsa varsayılan olarak en yeni sürüm kullanılır.
  • -o veya --output FILENAME
    Çıkışı tablo olarak yazdırmak yerine belirtilen dosya adıyla bir JSON dosyasına yazar.
remoteconfig:rollback \
--version-number VERSION_NUMBER

Remote Config şablonunu belirtilen önceki sürüme geri döndürün.

Bu komut, aşağıdaki isteğe bağlı (ancak önerilen) işareti destekler:

  • -v veya --version-number VERSION_NUMBER
    Geri dönülecek Remote Config şablonunun sürümünü belirtin. Atlanırsa varsayılan olarak bir önceki sürüme (mevcut sürüm - 1) ayarlanır.

CLI, harekete geçmeden önce bir onay istemi gösterir. Onay istemini atlamak için (etkileşimli modda gereklidir) şu işaretleri iletin: -f veya --force.

remoteconfig:experiments:list

Etkin Firebase projesindeki tüm Remote Config denemelerini listeler.

Bu komut aşağıdaki isteğe bağlı işaretleri destekler:

  • --filter EXPRESSION
    Denemeleri filtrelemek için ifadeyi belirtin.
  • --pageSize NUMBER
    Sayfa başına döndürülecek deneme sayısını belirtin. Atlanırsa varsayılan olarak 10 olur.
  • --pageToken TOKEN
    Liste için başlangıç ofsetini belirtin.
remoteconfig:experiments:get \
EXPERIMENT_ID

Belirtilen Remote Config denemesinin ayrıntılarını alın.

Tablo çıktısı; denemenin kaynak adını, görünen adını, durumunu (PENDING, RUNNING, DONE veya EXPIRED), başlangıç ve bitiş zamanlarını, varyantları (adlar ve trafiği paylaştırma ağırlıkları) ve yapılandırılmış hedefleri/metrikleri içerir. Deneme açıklaması, yalnızca --json iletildiğinde ham JSON çıkışına dahil edilir.

remoteconfig:experiments:delete \
EXPERIMENT_ID

Belirtilen Remote Config denemesini siler.

CLI, işlem yapmadan önce bir onay istemi gösterir ve -f veya --force işaretini desteklemez. Etkileşimli olmayan modda, onay varsayılan olarak "hayır" şeklinde ayarlanır ve komut, denemeyi silmeden çıkar.

remoteconfig:rollouts:list

Etkin Firebase projesindeki tüm Remote Config kullanıma sunma işlemlerini listeler.

Bu komut aşağıdaki isteğe bağlı işaretleri destekler:

  • --filter EXPRESSION
    Kullanıma sunma işlemlerini filtrelemek için ifadeyi belirtin.
  • --pageSize NUMBER
    Sayfa başına döndürülecek kullanıma sunma sayısını belirtin. Atlanırsa varsayılan olarak 10 olur.
  • --pageToken TOKEN
    Liste için başlangıç ofsetini belirtin.
remoteconfig:rollouts:get \
ROLLOUT_ID 		Belirtilen Remote Config kullanıma sunma işleminin ayrıntılarını alın.
remoteconfig:rollouts:delete \
ROLLOUT_ID

Belirtilen Remote Config kullanıma sunumunu silin.

CLI, işlem yapmadan önce bir onay istemi gösterir ve -f veya --force işaretini desteklemez. (Etkileşimli olmayan modda, onay varsayılan olarak "hayır" şeklinde ayarlanır ve komut, sunumu silmeden sonlandırılır.)

SQL Connect komut

Bu komutlar ve kullanım alanları, SQL Connect CLI referans kılavuzunda daha ayrıntılı olarak ele alınmıştır.

Komut Açıklama
dataconnect:services:list Etkin Firebase projesinde dağıtılan tüm SQL Connect hizmetlerini listeler.
dataconnect:sql:diff

Yerel bir SQL Connect şeması ile Cloud SQL veritabanı şemanız arasındaki farkları gösterir.

Bu komut aşağıdaki isteğe bağlı işaretleri destekler:

  • --service SERVICE_ID
    SQL Connect hizmet kimliğini belirtin. Boş bırakılırsa firebase.json içinde yapılandırılan tek hizmet kullanılır. Birden fazla hizmet yapılandırılmışsa --service ve gerekirse --location değerini belirtmediğiniz sürece komut başarısız olur.
  • --location LOCATION
    SQL Connect hizmetinin konumunu belirtin. Yalnızca hizmet kimliği birden fazla konumda kullanılıyorsa gereklidir.
dataconnect:sql:migrate

Cloud SQL veritabanınızın şemasını yerel SQL Connect şemanızla eşleşecek şekilde taşıyın.

Bu komut aşağıdaki isteğe bağlı işaretleri destekler:

  • --service SERVICE_ID
    SQL Connect hizmet kimliğini belirtin. Atlanırsa firebase.json içinde yapılandırılan tek hizmeti kullanır (birden fazla hizmet yapılandırılırsa --service ve gerekirse --location belirtmediğiniz sürece komut başarısız olur).
  • --location LOCATION
    SQL Connect hizmetinin konumunu belirtin. Yalnızca hizmet kimliği birden fazla konumda kullanılıyorsa gereklidir.

Etkileşimli modda KSA, işlem yapmadan önce bir onay istemi gösterir. Etkileşimli olmayan modda, yıkıcı olmayan taşıma işlemleri otomatik olarak çalıştırılır. Yıkıcı değişiklikler ise -f veya --force parametresini iletmediğiniz sürece iptal edilir (bu parametreler, etkileşimli modda onay istemlerini de atlar).

dataconnect:sql:grant \
--role SQL_ROLE \
--email EMAIL_ADDRESS

Kullanıcı veya hizmet hesabının belirtilen EMAIL_ADDRESS öğesine belirtilen SQL_ROLE (owner, writer veya reader rollerinden biri) rolünü verin.

Bu komut aşağıdaki isteğe bağlı işaretleri destekler:

  • --service SERVICE_ID
    SQL Connect hizmet kimliğini belirtin. Atlanırsa firebase.json içinde yapılandırılan tek hizmeti kullanır (birden fazla hizmet yapılandırılırsa --service ve gerekirse --location belirtmediğiniz sürece komut başarısız olur).
  • --location LOCATION
    SQL Connect hizmetinin konumunu belirtin. Yalnızca hizmet kimliği birden fazla konumda kullanılıyorsa gereklidir.
dataconnect:sdk:generate

SQL Connect bağlayıcılarınız için yazılı SDK'lar oluşturun.

Bu komut aşağıdaki isteğe bağlı işaretleri destekler:

  • --service SERVICE_ID
    SQL Connect hizmet kimliğini belirtin. Atlanırsa yapılandırılmış tüm hizmetler için SDK'lar oluşturulur.
  • --location LOCATION
    SQL Connect hizmetinin konumunu belirtin. Yalnızca hizmet kimliği birden fazla konumda kullanılıyorsa gereklidir.
  • --watch
    Bağlayıcı GQL dosyalarınızdaki değişiklikleri izleyin ve güncellemeler olduğunda SDK'larınızı yeniden oluşturun.