Verbindung zu einem GitHub-Repository herstellen

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

Hinweise

  • Enable the Cloud Build API.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the API

  • Halten Sie Ihren Quellcode in einem GitHub-Repository bereit.
  • Sie benötigen entweder eine Dockerfile 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 die gcloud-Befehle auf dieser Seite 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ähle 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, Ihre Verbindung zu GitHub zu authentifizieren oder die GitHub-App zu installieren. Falls 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 werden darauf aufgefordert, die Google Cloud Build-App zum Herstellen einer Verbindung zu Google Cloudzu autorisieren.

        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 als Option auswählen, ist 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 Ihr neues 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, rufen Sie die Seite Mit GitHub authentifizieren auf. Dies ist möglicherweise erforderlich, wenn Sie feststellen, Seite „Cloud Build Connect Repository“ gibt an, dass die GitHub-Anwendung nach der Installation der Cloud Build-App auf GitHub nicht in Repositories installiert wurde.

Nächste Schritte