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.

Hinweis

  • Aktivieren Sie die Cloud Build-, Firebase- und Resource Manager APIs.

    Rollen, die zum Aktivieren von APIs erforderlich sind

    Zum Aktivieren von APIs benötigen Sie die Berechtigung serviceusage.services.enable. Wenn Sie das Projekt erstellt haben, haben Sie diese Berechtigung wahrscheinlich bereits über die Rolle „Inhaber“ (roles/owner). Andernfalls können Sie diese Berechtigung über die Rolle „Service Usage-Administrator“ (roles/serviceusage.serviceUsageAdmin) erhalten. Informationen zum Zuweisen von Rollen

    APIs aktivieren

  • 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 wie Cloud Source Repositories, GitHub oder Bitbucket gespeichert sein.

  • 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. Rufen Sie in der Google Cloud -Console die Seite Cloud Build Berechtigungen auf:

    Zur Seite Berechtigungen

  2. Wählen Sie das Dienstkonto für Ihren Build aus.

  3. Setzen Sie den Status der folgenden Rollen auf Aktiviert:

    • Cloud Build-Dienstkonto: Ermöglicht dem alten Cloud Build-Dienstkonto, Builds zu aktualisieren, Build-Logs zu schreiben und Build-Artefakte zu speichern.
    • Firebase-Administrator: Ermöglicht Cloud Build den Zugriff auf Firebase.
    • API Keys Viewer: Ermöglicht Cloud Build den Zugriff auf die aktuelle Firebase Hosting-Konfiguration während der Build-Bereitstellung.

firebase-Docker-Image verwenden

Cloud Build bietet ein Builder-Image, mit dem Sie firebase-Befehle in Cloud Build aufrufen können. Wenn Sie diesen Builder in einer Cloud Build-Konfigurationsdatei verwenden möchten, können Sie den Build-Schritt firebase für die Bereitstellung in Firebase verwenden:

  1. Erstellen Sie eine Build-Konfigurationsdatei mit dem Namen cloudbuild.yaml oder cloudbuild.json, wobei PROJECT_ID IhreGoogle Cloud -Projekt-ID und FIREBASE_PROJECT_ID Ihre Firebase-Projekt-ID ist:

    YAML 

    steps:
- name: "us-docker.pkg.dev/firebase-cli/us/firebase"
   args: ['deploy', '--project=FIREBASE_PROJECT_ID', '--only=hosting']
## Or, target a specific version of firebase-tools
- name: "us-docker.pkg.dev/firebase-cli/us/firebase":x.y.z
   args: ['deploy', '--project=FIREBASE_PROJECT_ID', '--only=hosting']

    JSON 

    {
  "steps": [
   {
      "name": "us-docker.pkg.dev/firebase-cli/us/firebase",
      "args": [
         "deploy",
         "--project",
         "FIREBASE_PROJECT_ID",
         "--only",
         "hosting"
       ]
  }
  ]
}

    Sie können eine bestimmte Version von firebase-tools auswählen, indem Sie
    name: "us-docker.pkg.dev/firebase-cli/us/firebase":x.y.z verwenden.

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

    gcloud builds submit --region=REGION --config CONFIG_FILE_PATH SOURCE_DIRECTORY

    Wobei:

    • REGION ist eine der unterstützten Build-Regionen.
    • CONFIG_FILE_PATH ist der Pfad zur Build-Konfigurationsdatei.
    • SOURCE_DIRECTORY ist der Pfad oder die URL zum Quellcode.

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 die Google Cloud Projekt-ID ist:

    YAML

    steps:
      - name: us-docker.pkg.dev/firebase-cli/us/firebase
        args: ['deploy', '--project=PROJECT_ID', '--only=hosting']

    JSON

    {
  "steps": [
   {
      "name": "us-docker.pkg.dev/firebase-cli/us/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