Mit einem GitHub-Repository verbinden

Auf dieser Seite wird beschrieben, wie Sie ein GitHub-Repository mit Cloud Build verbinden. Weitere Informationen zu Cloud Build-Repositories finden Sie unter Cloud Build-Repositories.

Hinweis

  • Aktivieren Sie die Cloud Build API.

    Rollen, die zum Aktivieren von APIs erforderlich sind

    Zum Aktivieren von APIs benötigen Sie die IAM-Rolle „Service Usage-Administrator“ (roles/serviceusage.serviceUsageAdmin), die die Berechtigung serviceusage.services.enable enthält. Informationen zum Zuweisen von Rollen.

    API aktivieren

  • Halten Sie Ihren Quellcode in einem GitHub-Repository bereit.
  • Sie benötigen entweder eine Dockerfile-Datei oder eine Cloud Build-Konfigurationsdatei in Ihrem GitHub-Quell-Repository.
  • Wenn Sie Ihr Repository zum ersten Mal mit Cloud Build verbinden, benötigen Sie Berechtigungen auf Administratorebene für das Repository. Weitere Informationen zu GitHub-Repository-Berechtigungen finden Sie unter Repository-Berechtigungsstufen für eine Organisation.

  • Wenn Sie auf dieser Seite gcloud-Befehle verwenden möchten, installieren Sie die Google Cloud CLI.

Mit einem GitHub-Repository verbinden

So verbinden Sie Ihr GitHub-Repository mit Cloud Build:

  1. Öffnen Sie in der Google Cloud console die Seite Repositories.

    Zur Seite „Repositories“

  2. Wählen Sie in der Projektauswahl in der oberen Leiste Ihr Google Cloud Projekt aus.

  3. Wählen Sie oben auf der Seite den Tab 1. Generation aus.

  4. Klicken Sie auf Repository verbinden.

    Das Feld Repository verbinden wird angezeigt.

    1. Wählen Sie unter Anbieter für die Quellcodeverwaltung auswählen die Option GitHub Cloud Build GitHub App aus.

    2. Klicken Sie auf Weiter.

      Möglicherweise werden Sie aufgefordert, die Verbindung zu GitHub zu authentifizieren oder die GitHub App zu installieren. Wenn Sie dies noch nicht getan haben, führen Sie die folgenden Schritte aus:

      1. Wenn Sie sich noch nicht bei GitHub angemeldet haben, tun Sie es jetzt.

        Die Seite „Autorisierung“ wird eingeblendet. Sie autorisieren dort die Google Cloud Build App, eine Verbindung zu herzustellen Google Cloud.

        Screenshot der Schaltfläche "Autorisieren"

      2. Klicken Sie auf Google Cloud Build durch GoogleCloudBuild autorisieren.

      3. Klicken Sie auf Google Cloud Build installieren.

      4. Wählen Sie im angezeigten Dialogfeld Ihren GitHub-Nutzernamen oder Ihre Organisation aus.

      5. Wählen Sie je nach Ihren geschäftlichen Anforderungen eine der folgenden Optionen aus:

        • Alle Repositories : Aktivieren Sie aktuelle und zukünftige GitHub-Repositories für den Zugriff über die Cloud Build App.

        • Nur ausgewählte Repositories – Verwenden Sie das Drop-down-Menü Repositories auswählen , um nur bestimmte Repositories für den Zugriff über die Cloud Build App zu aktivieren.

        Sie können später weitere Repositories aktivieren. Wenn Sie Alle Repositories auswählen, wird die Cloud Build App autorisiert, auf alle Ihre Repositories zuzugreifen. Sie müssen jedoch jedes neue Repository über Cloud Build verbinden. Folgen Sie dazu der Anleitung in diesem Abschnitt.

      6. Klicken Sie auf Installieren , um die Cloud Build App zu installieren.

        Das Dialogfeld wird geschlossen und die Seite Repositories wird angezeigt.

    3. Wählen Sie im Abschnitt Repository auswählen die folgenden Felder aus:

      • GitHub-Konto ist das GitHub-Konto, mit dem die Cloud Build-GitHub-App installiert wird. Dieses Feld ist möglicherweise bereits für Sie ausgewählt.

      • Repository sind die Repositories, die Sie mit Cloud Build verbinden möchten.

      Falls ein oder mehrere Ziel-Repositories nicht aufgeführt werden, klicken Sie auf Repositories auf GitHub bearbeiten , um weitere Repositories in der Cloud Build GitHub App zu aktivieren. Sie können dann das neue Ziel-Repository im Abschnitt Repository auswählen auswählen.

    4. Lesen Sie nach dem Auswählen des GitHub-Kontos und der Repositories den Haftungsausschluss und klicken Sie anschließend das Kästchen daneben an, um die Nutzungsbedingungen zu akzeptieren.

    5. Klicken Sie auf Verbinden.

    6. (Optional) Wählen Sie im Bereich Trigger erstellen im Feld Beispieltrigger für diese Repositories erstellen die Repositories aus, für die Sie einen Trigger erstellen möchten. Nachdem Sie Ihre Repositories ausgewählt haben, klicken Sie auf Trigger erstellen.

    7. Klicken Sie auf Fertig.

(Optional) Authentifiziertes GitHub-Konto aktualisieren

Wenn Sie das mit Ihrem Google-Konto verknüpfte GitHub-Konto aktualisieren müssen, können Sie zur Seite Mit GitHub authentifizierennavigieren. Dies ist möglicherweise erforderlich, wenn Sie feststellen, dass die Seite „Cloud Build Connect Repository“ angibt, dass die GitHub App nach der Installation der Cloud Build App auf GitHub nicht in Repositories installiert wurde.

Nächste Schritte

  • Repositories von GitHub erstellen
  • Blau/Grün-Bereitstellungen in der Compute Engine .
  • Erfahren Sie, wie Sie zusätzliche Repositories als Abhängigkeiten für Ihren Build angeben.