Kurzanleitung: Automatisieren

Auf dieser Seite wird erläutert, wie Sie Builds mit Cloud Build automatisieren.

Cloud Build verwendet Build-Trigger, um CI/CD-Automatisierungen zu aktivieren. Sie können Trigger so konfigurieren, dass sie auf eingehende Ereignisse warten, z. B. wenn ein neuer Commit per Push in ein Repository übertragen wird oder wenn eine Pull-Anfrage initiiert wird. Der Trigger wird dann automatisch aufgerufen, wenn neue Ereignisse eingehen.

Sie erstellen einen Trigger und konfigurieren ihn so, dass ein Build aufgerufen wird, wenn Sie eine Änderung an ein GitHub-Repository senden.

Hinweis

  1. Melden Sie sich bei Ihrem Google Cloud-Konto an. Wenn Sie mit Google Cloud noch nicht vertraut sind, erstellen Sie ein Konto, um die Leistungsfähigkeit unserer Produkte in der Praxis sehen und bewerten zu können. Neukunden erhalten außerdem ein Guthaben von 300 $, um Arbeitslasten auszuführen, zu testen und bereitzustellen.
  2. Wählen Sie in der Google Cloud Console auf der Seite der Projektauswahl ein Google Cloud-Projekt aus oder erstellen Sie eines.

    Zur Projektauswahl

  3. Die Abrechnung für das Cloud-Projekt muss aktiviert sein. So prüfen Sie, ob die Abrechnung für Ihr Projekt aktiviert ist.

  4. Aktivieren Sie die Cloud Build API.

    Aktivieren Sie die API

  5. Installieren und initialisieren Sie das Cloud SDK.
  6. Wählen Sie in der Google Cloud Console auf der Seite der Projektauswahl ein Google Cloud-Projekt aus oder erstellen Sie eines.

    Zur Projektauswahl

  7. Die Abrechnung für das Cloud-Projekt muss aktiviert sein. So prüfen Sie, ob die Abrechnung für Ihr Projekt aktiviert ist.

  8. Aktivieren Sie die Cloud Build API.

    Aktivieren Sie die API

  9. Installieren und initialisieren Sie das Cloud SDK.
  10. Erstellen Sie ein Konto auf GitHub, falls Sie noch keines haben.
  11. Wenn Sie die Bestätigung in zwei Schritten auf GitHub eingerichtet haben, erstellen Sie ein persönliches Zugriffstoken, das statt eines GitHub-Passworts über die Befehlszeile verwendet wird.

Quelldateien vorbereiten

Sie benötigen einen Beispielcode zur Erstellung des Builds. In diesem Abschnitt klonen Sie ein vorhandenes Quell-Repository mit einem Hello World-Beispiel in Go in Ihrem eigenen GitHub-Nutzerkonto.

  1. Rufen Sie das Cloud Build-Repository cloud-build-samples auf.

  2. Verzweigen Sie das Repository cloud-build-samples in Ihr eigenes GitHub-Konto.

    1. Klicken Sie auf dasGabel.
    2. Klicken Sie auf das GitHub-Nutzerkonto, zu dem Sie das Repository verzweigen möchten.

      Sie werden automatisch auf die Seite mit der verzweigten Version des cloud-build-samples-Repositorys weitergeleitet.

  3. Klonen Sie das Repository auf Ihren lokalen Computer. Führen Sie dazu den folgenden Befehl in Ihrem Terminal aus, wobei GITHUB_USERNAME der Nutzername für Ihr GitHub-Konto ist:

     git clone https://github.com/GITHUB_USERNAME/cloud-build-samples.git
    
  4. Rufen Sie das Verzeichnis quickstart-automate auf.

     cd cloud-build-samples/quickstart-automate
    

    Sie sehen die folgenden Dateien, die den Quellcode für das Hello World-Beispiel enthalten:

    • main.go: eine Go-Beispielanwendung, die Hello, world! ausgibt

       package main
      
       import (
           "fmt"
       )
      
       func main() {
           fmt.Println("Hello, world!")
       }
      
    • cloudbuild.yaml: Die Build-Konfigurationsdatei, die von Cloud Build verwendet wird, um als Build-Schritte angegebene Aktionen auszuführen. Der in dieser Datei verwendete Build-Schritt weist Cloud Build an, das golang-Image von Docker Hub zum Erstellen und Ausführen der main.go-Datei zu verwenden.

       steps:
       - name: golang
         args: ['go', 'run', 'quickstart-automate/main.go']
      

Repository verbinden

Zum Erstellen von Quellcode auf GitHub mit Triggern müssen Sie zuerst Cloud Build mit Ihrem GitHub-Repository verbinden. In diesem Abschnitt verbinden Sie Ihr cloud-build-samples-Repository mit Cloud Build.

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

    Zur Seite "Trigger"

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

  3. Klicken Sie auf Repository verbinden.

  4. Wählen Sie unter Quelle auswählen die Option GitHub (Cloud Build-GitHub-App) aus.

  5. Klicken Sie auf Weiter.

  6. GitHub-Konto authentifizieren

  7. Geben Sie im Abschnitt Repository auswählen Ihren Nutzernamen für das GitHub-Konto ein, indem Sie auf Hinzufügen klicken.

    Sie sehen ein Pop-up-Fenster für die Installation der Cloud Build GitHub-Anwendung.

  8. Klicken Sie auf Ihren GitHub-Nutzernamen.

  9. Klicken Sie auf Nur bestimmte Repositories, um die GitHub-Anwendung von Cloud Build in bestimmten Repositories zu installieren.

  10. Wählen Sie im Drop-down-Menü GITHUB_USERNAME/cloud-build-samples aus, wobei GITHUB_USERNAME der Nutzername für Ihr GitHub-Konto ist.

  11. Klicken Sie auf Installieren.

    Sie werden möglicherweise aufgefordert, das Passwort für Ihr GitHub-Konto einzugeben, bevor Sie fortfahren.

  12. Nachdem Sie die Cloud Build-GitHub-Anwendung installiert haben, können Sie jetzt Ihren Nutzernamen im Drop-down-Menü im Feld GitHub-Konto sehen. Wählen Sie Ihren Nutzernamen aus.

  13. Wählen Sie unter Repository GITHUB_USERNAME/cloud-build-samples als Repository aus.

  14. Klicken Sie auf das Häkchen, um den Nutzungsbedingungen für die Triggerverbindung zuzustimmen.

  15. Klicken Sie auf Verbinden.

  16. Klicken Sie auf Fertig.

    Im nächsten Abschnitt erstellen Sie einen Trigger.

Trigger erstellen

In diesem Abschnitt erstellen Sie einen Trigger.

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

    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. Name: Geben Sie hello-world-trigger als Namen für den Trigger ein.

    2. Ereignis: Wählen Sie als Repository-Ereignis Push zu Zweig aus, um Ihren Trigger aufzurufen.

    3. Quelle: Wählen Sie das Repository cloud-build-samples als Quelle aus, das Ihren Quellcode und Ihre Build-Konfigurationsdatei enthält.

    4. Build-Konfiguration: Wählen Sie die Cloud Build-Konfigurationsdatei als Build-Konfigurationsdatei aus.

    5. Speicherort der Cloud Build-Konfigurationsdatei: Geben Sie den Pfad zu Ihrer Cloud Build-Konfigurationsdatei als quickstart-automate/cloudbuild.yaml an.

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

Commit für Änderung ausführen

In diesem Abschnitt führen Sie in Ihrem eigenen GitHub-Konto eine Änderung des geklonten cloud-build-samples-Repositorys durch.

  1. Wechseln Sie im Terminalfenster zum Verzeichnis quickstart-automate:

      cd code-examaples/quickstart-automate
    
  2. Öffnen Sie die Datei main.go in Ihrem Terminal.

  3. Aktualisieren Sie die Zeile "Hello, world!" auf "Hallo Universum!"

      package main
    
      import (
          "fmt"
      )
    
      func main() {
          fmt.Println("Hello, universe!")
      }
    
  4. Gehen Sie zurück zum Stammverzeichnis Ihres Repositorys:

    cd ..
    
  5. Übernehmen Sie Ihre Änderungen mit GitHub, indem Sie den folgenden Befehl ausführen:

    git add quickstart-automate/main.go
    git commit -m "update text"
    git push
    

    Sie werden möglicherweise aufgefordert, Ihre Anmeldedaten einzugeben, wenn Sie Code in Ihr Repository übertragen. Wenn Sie dazu aufgefordert werden, geben Sie Ihren Nutzernamen und Ihr Passwort oder ein Authentifizierungstoken ein.

Sie haben eine Änderung an Ihrem Repository vorgenommen. Der Push führt zu einem automatischen Build durch den Trigger.

Build-Details ansehen

In diesem Abschnitt sehen Sie die Build-Details, die mit dem aufgerufenen Build verknüpft sind, nachdem Sie eine Änderung übernommen haben.

  1. Öffnen Sie die Cloud Build-Seite in der Google Cloud Console.

    Zur Seite "Cloud Build"

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

    Sie sehen die Seite Build-Verlauf:

    Screenshot der Seite "Build-Verlauf" zur Automatisierung

  3. Klicken Sie auf einen bestimmten Build.

    Es wird die Seite Build-Details angezeigt.

  4. Klicken Sie unter Build-Zusammenfassung auf Build-Artefakte, um sich die Artefakte Ihres Builds anzeigen zu lassen.

    Die Ausgabe sollte in etwa so aussehen:

    Grafik: Screenshot von Build-Artefakten

    Sie können das Build-Log von dieser Seite herunterladen.

Bereinigen

Mit den folgenden Schritten vermeiden Sie, dass Ihrem Google Cloud-Konto die auf dieser Seite verwendeten Ressourcen in Rechnung gestellt werden:

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

    Zur Seite "Build-Trigger"

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

  3. Klicken Sie auf Öffnen.

  4. Suchen Sie die Zeile mit dem Trigger, den Sie löschen möchten.

  5. Klicken Sie auf das Menü (vertikale Ellipsen) am rechten Ende der Zeile.

  6. Wählen Sie Löschen aus.

Sie haben jetzt den Trigger gelöscht, der mit dem geklonten Repository verknüpft ist.

Nächste Schritte