In Firebase bereitstellen

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

Hinweise

  • Cloud Build, Firebase, and Resource Manager APIs aktivieren.

    Aktivieren Sie die APIs

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

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

  • Wenn Sie noch kein Projekt für die Bereitstellung in 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 mit der Endung @cloudbuild.gserviceaccount.com und klicken Sie auf das Stiftsymbol. Dies ist das Cloud Build-Dienstkonto.

  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. Senden Sie den Builder in Ihrem Projekt, wobei REGION eine der unterstützten Build-Regionen ist:

    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 Ihre Google Cloud-Projekt-ID und firebase-project-id Ihre Firebase-Projekt-ID ist:

    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

    Wobei:

    • 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 des Befehls firebase deploy hinzu, wobei project-id Ihre Google Cloud-Projekt-ID ist:

    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