Benutzerdefinierte Pipelines für Betriebssystem-Images mit der Google Cloud Console erstellen und verwalten

Sie können eine Image Builder-Pipeline direkt in der Google Cloud Console konfigurieren und starten. Die Google Cloud Konsole bietet eine interaktive Oberfläche, auf der Sie die Quelle des Basis-Images, Ausgabeziele, Anpassungsschritte, und Ausführungstrigger angeben können.

Hinweis

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für Ihr Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Erstellen und Verwalten von Pipelines zur Image-Anpassung über die Google Cloud Console benötigen:

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

Pipeline erstellen und verwalten

In der Google Cloud Console können Sie neue Pipelines für benutzerdefinierte Betriebssystem-Images erstellen, vorhandene Konfigurationen bearbeiten, vorhandene Pipelines duplizieren oder Pipelines löschen, wenn sie nicht mehr benötigt werden.

Pipeline erstellen

So erstellen Sie eine Pipeline für benutzerdefinierte Betriebssystem-Images über die Google Cloud Console: Führen Sie die folgenden Schritte aus:

  1. Rufen Sie in der Google Cloud Console die Images Seite auf.

    Zur Seite „Images“

  2. Klicken Sie auf Image Builder , um zur Image Builder-Startseite zu gelangen.

  3. Wählen Sie in der Regionsauswahl die Region aus, in der Sie die Pipeline erstellen möchten.

  4. Klicken Sie auf Pipeline erstellen.

  5. Konfigurieren Sie im Abschnitt Pipeline-Einstellungen die grundlegenden Details der Pipeline:

    • Name:Geben Sie einen eindeutigen Namen für die Pipeline ein.
    • Beschreibung : (Optional) Geben Sie eine Beschreibung für die Pipeline ein.
    • Region: Wählen Sie die Google Cloud Region für Ihre Pipeline aus. Image Builder wird in allen Regionen unterstützt, in denen Cloud Build verfügbar ist.
    • Dienstkonto: Wählen Sie das Dienstkonto aus, das mit den erforderlichen IAM-Berechtigungen konfiguriert wurde, oder erstellen Sie ein neues Dienstkonto.
    • Konfigurationsquelle:Wählen Sie eine der folgenden Methoden aus, um festzulegen, wo Ihre Anpassungskonfigurationen und -skripts gespeichert werden:
      • In ein Repository einbinden:Wählen Sie diese Option aus, um Ihr Anpassungsrezept und Ihre Skripts aus einem Git-Repository abzurufen. Da die Datei imagebuilder.yaml des Repositorys das Quell-Basis-Image, die Build-Zone, die Anpassungsschritte und die Einstellungen für das Ziel-Image definiert, wird in der Console direkt zu den Triggern übergegangen. Konfigurieren Sie die folgenden Felder:
        • Repository:Wählen Sie ein verbundenes Repository aus oder klicken Sie auf Repository verknüpfen , um ein GitHub-, GitLab- oder Bitbucket-Repository zu verbinden.
        • Pfad zur Image Builder-Konfiguration:Geben Sie den relativen Pfad zur Datei mit dem Anpassungsrezept im Repository ein, z. B. imagebuilder.yaml.
        • Cloud Storage-Ordner:Klicken Sie auf Durchsuchen , um den Cloud Storage-Ordner auszuwählen, in den Pipeline-Logs und Build-Artefakte hochgeladen werden.
      • Skripts in Google Cloud Storage speichern:Wählen Sie diese Alternative aus, um das Basis-Image, die Details des Ziel-Images und die Anpassungsschritte direkt in der Console-Oberfläche zu konfigurieren. Die Console speichert Ihre Skripts in Cloud Storage und führt Sie durch den vollständigen Schritt-für-Schritt-Assistenten. Konfigurieren Sie das folgende Feld:
        • Ordner für Anpassungsskripts:Klicken Sie auf Durchsuchen , um den Cloud Storage-Ordner auszuwählen, in dem Ihre Anpassungsskripts gespeichert werden sollen.
    • Artifact Registry : (Optional) Wenn Sie das Ziel-Image-Archiv hochladen und kryptografische SLSA-Build-Herkunftsnachweise generieren möchten, wählen Sie in der Liste Artifact Registry-Repository ein generisches Repository aus. Weitere Informationen finden Sie unter Image-Herkunft überprüfen.

  6. Klicken Sie auf Weiter , um zu den übrigen Konfigurationsbereichen zu gelangen, die von der ausgewählten Konfigurationsquelle abhängen:

    • Wenn Sie „In ein Repository einbinden“ ausgewählt haben :

      Das Rezept imagebuilder.yaml des Repositorys definiert das Quell-Basis-Image, die Einstellungen für das Ziel-Image und die Anpassungsschritte. Die Console überspringt die manuelle Eingabe und geht direkt zu den Triggern über:

      1. Konfigurieren Sie im Abschnitt Trigger, wann die Pipeline ausgeführt werden soll:
        • Nach Zeitplan ausführen:Geben Sie einen wiederkehrenden Zeitplan mit der Cron-Syntax an.
        • Bei Repository-Ereignis ausführen:Lösen Sie Builds automatisch aus, wenn Repository-Ereignisse auftreten, z. B. An einen Branch übertragen, Neues Tag übertragen oder Pull-Anfrage, und geben Sie Filter für Branch- oder Tag Muster an.
      2. Klicken Sie auf Weiter , um zum Abschnitt Zusammenfassung zu gelangen.
      3. Prüfen Sie die Pipeline-Konfiguration und klicken Sie auf Erstellen.

    • Wenn Sie „Skripts in Google Cloud Storage speichern“ ausgewählt haben :

      1. Geben Sie im Abschnitt Details zum Quell-Image das Basis-Betriebssystem-Image an:
        • Image-Familie verwenden:Wählen Sie eine öffentliche Betriebssystem-Familie aus, z. B. Container-Optimized OS oder Ubuntu. Die Pipeline wählt für jeden Build automatisch das neueste (nicht verworfene) Image dieser Familie aus.
        • Vorhandenes Image verwenden:Wählen Sie ein bestimmtes Betriebssystem-Image aus.
      2. Klicken Sie auf Weiter , um zum Abschnitt Details zum Ziel-Image zu gelangen:
        • Geben Sie einen Namen für das generierte benutzerdefinierte Betriebssystem-Image ein.
        • (Optional) Geben Sie eine Image-Familie, eine Beschreibung, Ressourcenlabels und vom Kunden verwaltete Verschlüsselungsschlüssel (CMEK) an.
      3. Klicken Sie auf Weiter , um zum Abschnitt Anpassung zu gelangen:
        • Wählen Sie Anpassungsaktionen aus, um einzelne Anpassungsschritte hinzuzufügen, zu bearbeiten oder neu anzuordnen, z. B. das Installieren von Paketen oder das Ausführen von Inline-Shell-Skripts.
        • Wählen Sie YAML hinzufügen aus, um Rohrezept-steps direkt in YAML zu schreiben oder einzufügen.
        • (Optional) Wählen Sie unter Erweiterte Konfigurationen die spezifische Zone, den Maschinentyp oder die Reservierung aus, die für die Worker- und Test-VMs verwendet werden soll, auf denen Build-Jobs ausgeführt werden. Bare-Metal-Maschinentypen werden nicht unterstützt. Sie können auch benutzerdefinierte VPC-Einstellungen für Netzwerk, Subnetz oder Externe IP-Adresse angeben, z. B. ephemeral oder none, in der infrastructureConfig Ihres Rezepts.
      4. Klicken Sie auf Weiter , um zum Abschnitt Trigger zu gelangen:
        • Wählen Sie Nach Zeitplan ausführen aus, um einen automatisierten wiederkehrenden Zeitplan zu definieren, oder lassen Sie das Kästchen deaktiviert, um die Ausführung manuell zu starten.
      5. Klicken Sie auf Weiter , um zum Abschnitt Zusammenfassung zu gelangen.
      6. Prüfen Sie die Pipeline-Konfiguration und klicken Sie auf Erstellen.

Nachdem Sie die Pipeline erstellt haben:

  • Wenn Sie keine automatisierten Trigger konfiguriert haben, können Sie die Pipeline manuell ausführen: Klicken Sie in der Liste der Image Builder -Pipelines neben Ihrer Pipeline auf Weitere Aktionen > Ausführen.
  • Wenn Sie Nach Zeitplan ausführen oder Bei Repository-Ereignis ausführen konfiguriert haben, wird die Pipeline automatisch ausgeführt, wenn die Triggerbedingungen oder der Zeitplan erfüllt sind.

Pipeline bearbeiten

So bearbeiten Sie eine vorhandene Image Builder-Pipeline:

  1. Rufen Sie in der Google Cloud Console die Images Seite auf.

    Zur Seite „Images“

  2. Klicken Sie auf Image Builder , um die Liste der Pipelines aufzurufen.

  3. Klicken Sie neben der Pipeline, die Sie bearbeiten möchten, auf Weitere Aktionen > Bearbeiten.

  4. Aktualisieren Sie die Pipeline-Einstellungen, die Konfigurationsquelle, die Details zum Ziel-Image, die Anpassungsschritte oder die Triggereinstellungen nach Bedarf.

  5. Klicken Sie auf Speichern.

Pipeline duplizieren

So erstellen Sie eine neue Pipeline, indem Sie eine vorhandene Konfiguration kopieren:

  1. Rufen Sie in der Google Cloud Console die Images Seite auf.

    Zur Seite „Images“

  2. Klicken Sie auf Image Builder , um die Liste der Pipelines aufzurufen.

  3. Klicken Sie neben der Pipeline, die Sie duplizieren möchten, auf Weitere Aktionen > Duplizieren.

  4. Prüfen Sie im Formular zur Pipeline-Erstellung die vorausgefüllten Parameter, die aus der ursprünglichen Pipeline kopiert wurden. Sie können das Feld Pipeline-Name bearbeiten, um einen neuen eindeutigen Namen anzugeben.

  5. Aktualisieren Sie alle Pipeline-Parameter oder -Einstellungen nach Bedarf.

  6. Klicken Sie auf Erstellen.

Pipeline löschen

Wenn Sie eine Pipeline löschen, beendet Image Builder zukünftige automatisierte Ausführungen und entfernt die Pipeline-Konfiguration dauerhaft. Durch das Löschen einer Pipeline werden keine benutzerdefinierten Betriebssystem-Images, Artifact Registry-Artefakte oder Cloud Storage-Buckets gelöscht, die Sie zuvor erstellt haben.

So löschen Sie eine Image Builder-Pipeline:

  1. Rufen Sie in der Google Cloud Console die Images Seite auf.

    Zur Seite „Images“

  2. Klicken Sie auf Image Builder , um die Liste der Pipelines aufzurufen.

  3. Klicken Sie neben der Pipeline, die Sie löschen möchten, auf Weitere Aktionen > Löschen.

  4. Klicken Sie im Bestätigungsdialogfeld auf Löschen, um die Pipeline dauerhaft zu entfernen.

Build überprüfen und beobachten

So verfolgen Sie den Fortschritt Ihrer Build-Pipeline:

  1. Rufen Sie in der Google Cloud Console die Cloud Build Seite auf.

    Zu Cloud Build

  2. Klicken Sie im Navigationsmenü auf Verlauf, um aktive oder abgeschlossene Jobs aufzurufen.

  3. Klicken Sie in der Liste Builds auf die Build-ID Ihres Builds, um die Container-Ausführungsprotokolle zu prüfen. In den Logs werden die Schritte angezeigt, die in der Worker-VM ausgeführt werden, z. B. Updates von Systempaketen oder benutzerdefinierte Shell-Befehle, gefolgt von den Ergebnissen der Validierungstests der Test-VM und der Registrierung der endgültigen Ausgabe.

Nächste Schritte