In Firebase bereitstellen

Auf dieser Seite wird erläutert, wie Sie mit Cloud Build Anwendungen in Firebase bereitstellen. Wenn Sie Cloud Build noch nicht kennen, lesen Sie zuerst die Kurzanleitungen sowie die Übersicht über die Build-Konfiguration.

Hinweise

  • Enable the Cloud Build, Firebase, and Resource Manager APIs.

    Enable the APIs

  • Zum Ausführen der gcloud-Befehle auf dieser Seite müssen Sie die Google Cloud CLI installieren.

  • Halten Sie Ihren Anwendungsquellcode einschließlich firebase.json bereit. Ihr Quellcode muss in einem Repository gespeichert sein, z. B. Cloud Source Repositories, GitHub oder Bitbucket.

  • Wenn Sie noch kein Projekt für Firebase haben, können Sie ein Standardprojekt erstellen, indem Sie Firebase installieren und initialisieren.

Erforderliche IAM-Berechtigungen

  1. Öffnen Sie in der Google Cloud Console die Seite „IAM“:

    IAM-Seite öffnen

  2. Wählen Sie Ihr Projekt aus und klicken Sie auf Öffnen.

  3. Suchen Sie in der Berechtigungstabelle nach der E-Mail-Adresse des Dienstkontos, das Sie für den Build verwenden, und klicken Sie auf das Stiftsymbol.

  4. Fügen Sie die Rollen Cloud Build Service Account, Firebase Admin und API Keys Admin hinzu.

  5. Klicken Sie auf Speichern.

Builder der firebase-Community verwenden

Cloud Build bietet ein Builder-Image der Firebase-Community, mit dem Sie in Cloud Build firebase-Befehle aufrufen können. Wenn Sie diesen Builder in einer Cloud Build-Konfigurationsdatei verwenden möchten, müssen Sie zuerst das Image erstellen und an die Container Registry in Ihrem Projekt übertragen.

So erstellen Sie den Builder der firebase-Community und übertragen ihn per Push:

  1. Wechseln Sie zum Stammverzeichnis Ihres Projekts.

  2. Klonen Sie das Repository cloud-builders-community:

    git clone https://github.com/GoogleCloudPlatform/cloud-builders-community.git

  3. Rufen Sie das firebase-Builder-Image auf:

    cd cloud-builders-community/firebase

  4. Reichen Sie den Builder in Ihrem Projekt ein. Dabei muss REGION eine der unterstützten Build-Regionen sein:

    gcloud builds submit --region=REGION .

  5. Wechseln Sie zurück zum Stammverzeichnis Ihres Projekts:

    cd ../..

  6. Entfernen Sie das Repository aus Ihrem Stammverzeichnis:

    rm -rf cloud-builders-community/

Bereitstellung konfigurieren

Nachdem Sie den Builder der firebase-Community erstellt haben, können Sie den Build-Schritt firebase in Ihrer Build-Konfigurationsdatei für die Bereitstellung in Firebase verwenden:

  1. Erstellen Sie eine Build-Konfigurationsdatei mit dem Namen cloudbuild.yaml oder cloudbuild.json, wobei project-id Ihr Google Cloud-Projekt ist ID und firebase-project-id ist die ID Ihres Firebase-Projekts:

    YAML 

          steps:
      - name: gcr.io/project-id/firebase
        args: ['deploy', '--project=firebase-project-id', '--only=hosting']

    JSON

    {
  "steps": [
   {
      "name": "gcr.io/project-id/firebase",
      "args": [
         "deploy",
         "--project",
         "firebase-project-id",
         "--only",
         "hosting"
       ]
  }
  ]
}

  2. Starten Sie den Build mithilfe der Build-Konfigurationsdatei:

    gcloud builds submit --region=REGION --config config-file-path source-directory

    Dabei gilt:

    • config-file-path ist der Pfad zur Build-Konfigurationsdatei.
    • source-directory ist der Pfad oder die URL zum Quellcode.
    • REGION ist eine der unterstützten Build-Regionen.

Kontinuierliche Bereitstellung

Sie können die Bereitstellung Ihrer Software in Firebase automatisieren, indem Sie Cloud Build-Trigger erstellen. Sie können die Trigger so konfigurieren, dass Images erstellt und bereitgestellt werden, wenn Sie Ihren Quellcode aktualisieren.

So automatisieren Sie die Bereitstellung in Firebase:

  1. Fügen Sie in Ihrem Repository eine Build-Konfigurationsdatei mit Schritten zum Aufrufen der Befehl firebase deploy, wobei project-id ist Ihre Google Cloud-Projekt-ID:

    YAML

    steps:
      - name: gcr.io/project-id/firebase
        args: ['deploy', '--project=project-id', '--only=hosting']

    JSON

    {
  "steps": [
   {
      "name": "gcr.io/project-id/firebase",
      "args": [
         "deploy",
         "--project",
         "project-id",
         "--only",
         "hosting"
       ]
  }
  ]
}

  2. Erstellen Sie einen Trigger mit der im vorherigen Schritt erstellten Build-Konfigurationsdatei:

    1. Öffnen Sie in der Google Cloud Console die Seite Trigger:

      Zur Seite "Trigger"

    2. Wählen Sie oben auf der Seite im Drop-down-Menü zur Projektauswahl Ihr Projekt aus.

    3. Klicken Sie auf Öffnen.

    4. Klicken Sie auf Trigger erstellen.

      Auf der Seite Erstellen Sie einen Trigger geben Sie die folgenden Einstellungen ein:

      1. Geben Sie einen Namen für den Trigger ein.

      2. Wählen Sie das Repository-Ereignis aus, das den Trigger aufrufen soll.

      3. Wählen Sie das Repository aus, das Ihren Quellcode und die Build-Konfigurationsdatei enthält.

      4. Geben Sie den regulären Ausdruck für den Zweig- oder Tag-Namen an, mit dem der Trigger gestartet wird.

      5. Konfiguration: Wählen Sie die Build-Konfigurationsdatei aus, die Sie zuvor erstellt haben.

    5. Klicken Sie auf Erstellen, um den Build-Trigger zu speichern.

Jedes Mal, wenn Sie neuen Code an Ihr Repository übertragen, wird automatisch ein Build gestartet und in Firebase bereitgestellt.

Weitere Informationen zum Erstellen von Cloud Build-Triggern finden Sie unter Build-Trigger erstellen und verwalten.

Codebeispiel

Ein Codebeispiel für die Bereitstellung in Firebase mit Cloud Build finden Sie unter deploy-firebase-example.

Nächste Schritte