VM-Produkte über die Befehlszeile bereitstellen

Im Google Cloud Marketplace angebotene VM-Produkte sind benutzerdefinierte VM-Instanzen, die Sie in Compute Engine ausführen können. Eine Übersicht über die Compute Engine-Konzepte finden Sie in der Compute Engine-Dokumentation.

Einige VM-Produkte im Google Cloud Marketplace unterstützen die Bereitstellung über die Befehlszeile mit Terraform, einem Open-Source-Tool zum Bereitstellen und Verwalten von Infrastruktur. Weitere Informationen zu Terraform finden Sie unter Erste Schritte mit Terraform.

Überblick

Auf dieser Seite werden die Schritte zum Bereitstellen von VM-Produkten über die Befehlszeile mithilfe von Terraform beschrieben. Auf übergeordneter Ebene haben Sie folgende Möglichkeiten:

  1. Gehen Sie zum entsprechenden Abschnitt des Google Cloud Marketplace-Eintrags des Produkts.

  2. Optional können Sie das Dienstkonto auswählen oder erstellen, das Sie für die Befehlszeilenbereitstellung verwenden möchten.

  3. Optional: Richten Sie die Dienstkonto-Identitätsübernahme ein.

  4. Konfigurieren Sie Ihre gcloud-Umgebung für Terraform.

  5. Laden Sie das Terraform-Modul oder das Code-Snippet herunter, mit dem Sie das VM-Produkt über die Befehlszeile bereitstellen.

  6. Verwenden Sie das Modul oder Code-Snippet, um das VM-Produkt bereitzustellen.

Tab für Befehlszeilenbereitstellung aufrufen

So starten Sie die Bereitstellung eines VM-Produkts über die Befehlszeile:

  1. Rufen Sie in Cloud Marketplace die Seite mit der Produktliste für das VM-Produkt auf, das Sie über die Befehlszeile bereitstellen möchten.

    Marketplace aufrufen

  2. Klicken Sie auf die Schaltfläche Starten oder auf Mit Befehlszeile bereitstellen, um den Tab Bereitstellung über die Befehlszeile aufzurufen.

(Optional) Dienstkonto auswählen oder erstellen

Auf dem Tab Befehlszeilenbereitstellung können Sie das Dienstkonto auswählen oder erstellen, das Sie für die Bereitstellung über die Befehlszeile verwenden möchten. Wenn Sie beim Generieren Ihres Code-Snippets auf dem Tab Befehlszeilenbereitstellung kein Dienstkonto ausgewählt oder erstellt haben, müssen Sie das generierte Terraform-Snippet manuell bearbeiten, um ein Dienstkonto hinzuzufügen, bevor Sie es verwenden. Weitere Informationen zu Dienstkonten finden Sie unter Dienstkonten erstellen und verwalten.

Wenn Sie ein Cloud Marketplace-VM-Produkt über die Befehlszeile bereitstellen möchten, muss das verwendete Dienstkonto die IAM-Rolle „Compute-Administrator“ (roles/compute.admin) haben. Wenn Sie ein neues Dienstkonto über den Tab Befehlszeilenbereitstellung erstellen, weist Google Cloud Marketplace dem neuen Dienstkonto diese Rolle automatisch zu. Wenn Sie ein vorhandenes Dienstkonto auf dem Tab Befehlszeilenbereitstellung auswählen, müssen Sie prüfen, ob das Dienstkonto diese Rolle hat.

So wählen oder erstellen Sie Ihr Dienstkonto:

  1. Klicken Sie im Google Cloud Marketplace-Eintrag des VM-Produkts auf dem Tab Deployment über die Befehlszeile unter Dienstkonto konfigurieren (optional) auf die Schaltfläche Konfigurieren.

  2. Unter Dienstkonto fordert Berechtigungen an können Sie auf Vorhandenes Dienstkonto auswählen oder Neues Dienstkonto erstellen klicken.

Vorhandenes Dienstkonto auswählen

So wählen Sie ein vorhandenes Dienstkonto aus:

  1. Wählen Sie unter Dienstkonto auswählen das Dienstkonto aus, das Sie verwenden möchten. Die Liste enthält alle vorhandenen Dienstkonten mit der Rolle „Compute-Administrator“ (roles/compute.admin).

    Wenn keines Ihrer vorhandenen Dienstkonten die Rolle „Compute-Administrator“ (roles/compute.admin) hat, ist die Liste leer. Wenn die Liste leer ist, können Sie diese Rolle einem Ihrer vorhandenen Dienstkonten zuweisen und dann zu diesem Tab zurückkehren oder stattdessen ein neues Dienstkonto erstellen.

  2. Klicken Sie auf die Schaltfläche Senden.

Neues Dienstkonto erstellen

Um ein neues Dienstkonto zu erstellen:

  1. Wählen Sie einen Namen für das Dienstkonto aus und fügen Sie ihn im Feld Name des Dienstkontos ein.

  2. Wählen Sie eine ID für das Dienstkonto aus und fügen Sie sie in das Feld Dienstkonto-ID ein.

  3. Geben Sie im Feld Beschreibung des Dienstkontos eine Beschreibung für das Dienstkonto ein.

  4. Klicken Sie auf die Schaltfläche Dienstkonto erstellen.

Nachdem Sie das Dienstkonto erstellt haben, können Sie die Zugriffssteuerung des Dienstkontos mit IAM verwalten.

Optional: Identitätsübernahme des Dienstkontos einrichten

Wir empfehlen die Identitätsübernahme des Dienstkontos, um den Zugriff auf Ihre Befehlszeilenbereitstellung zu verwalten. Wenn Sie die Identitätsübernahme verwenden, anstatt Dienstkontoschlüssel zu erstellen, mit denen jeder auf Ihre Bereitstellung zugreifen kann, verwalten Sie den Zugriff, indem Sie bestimmten Hauptkonten die IAM-Rolle „Ersteller von Dienstkonto-Tokens“ (roles/iam.serviceAccountTokenCreator) gewähren oder entziehen.

Informationen zum Zuweisen und Widerrufen von Rollen für Dienstkonten finden Sie unter Zugriff auf Dienstkonten verwalten. Weitere Informationen zur Identitätsübernahme von Dienstkonten finden Sie unter Identitätswechsel für Dienstkonten.

gcloud-Umgebung für Terraform konfigurieren

Auf dem Tab Befehlszeilenbereitstellung finden Sie unter gcloud konfigurieren eine Reihe von Befehlen. Zum Konfigurieren Ihrer gcloud-Umgebung für Terraform können Sie die bereitgestellten Befehle kopieren und ausführen.

Terraform-Modul herunterladen

Je nachdem, wie das VM-Produkt konfiguriert ist, verwenden Sie entweder ein enthaltenes Terraform-Modul oder ein generiertes Code-Snippet, um ein VM-Produkt über die Befehlszeile bereitzustellen. Wenn Sie prüfen möchten, ob Sie ein enthaltenes Modul oder ein generiertes Code-Snippet zum Bereitstellen eines VM-Produkts verwenden, rufen Sie den Tab Befehlszeilenbereitstellung des Cloud Marketplace-Eintrags des Produkts auf. Wenn Sie ein enthaltenes Modul zum Bereitstellen des Produkts verwenden, wird die Schaltfläche Herunterladen angezeigt. Wenn Sie ein generiertes Code-Snippet zum Bereitstellen des Produkts verwenden, wird die Schaltfläche Code generieren angezeigt.

Führen Sie die folgenden Schritte aus, um das enthaltene Modul oder das generierte Code-Snippet herunterzuladen:

Enthaltenes Terraform-Modul

  1. Klicken Sie im Cloud Marketplace-Eintrag des VM-Produkts auf dem Tab Befehlszeilenbereitstellung auf die Schaltfläche Herunterladen. Dadurch wird eine ZIP-Datei heruntergeladen, die das von Ihnen verwendete Terraform-Modul enthält.

  2. Extrahieren Sie das Terraform-Modul aus der heruntergeladenen ZIP-Datei.

Generiertes Code-Snippet

  1. Klicken Sie im Cloud Marketplace-Eintrag des VM-Produkts auf dem Tab Befehlszeilenbereitstellung auf die Schaltfläche Code generieren. Dadurch wird ein Code-Snippet generiert, das Sie kopieren und mit Terraform verwenden können, um eine VM mit Terraform bereitzustellen.

  2. Klicken Sie auf In Zwischenablage kopieren, um das generierte Code-Snippet zu kopieren.

Das enthaltene Modul oder das generierte Code-Snippet zum Bereitstellen des VM-Produkts verwenden

Führen Sie die folgenden Schritte aus, um das enthaltene Modul oder das generierte Code-Snippet zum Bereitstellen des VM-Produkts über die Befehlszeile zu verwenden:

Enthaltenes Terraform-Modul

  1. Suchen Sie in dem Terraform-Modul, das Sie heruntergeladene haben, die Datei README.md .

  2. Folgen Sie der produktspezifischen Anleitung aus der Datei README.md.

    Wenn Sie der produktspezifischen Anleitung folgen und Probleme auftreten, können Sie optional versuchen, das Modul bereitzustellen. Dazu führen Sie die folgenden Befehle aus:

    • terraform init

    • terraform apply

Generiertes Code-Snippet

  1. Prüfen Sie, ob das generierte Code-Snippet das Dienstkonto enthält, das Sie verwenden möchten. Wenn Sie für Ihre Befehlszeilenbereitstellung ein Dienstkonto konfiguriert haben, werden die Informationen dieses Dienstkontos in das generierte Code-Snippet eingefügt. Wenn Sie noch kein Dienstkonto konfiguriert haben, müssen Sie das generierte Code-Snippet bearbeiten, um das Dienstkonto anzugeben, das Sie verwenden möchten.

  2. Erstellen Sie eine neue Datei mit dem Namen main.tf auf dem Computer, auf dem Sie Terraform installiert haben.

  3. Fügen Sie das generierte Code-Snippet mit allen daran vorgenommenen Änderungen in die von Ihnen erstellte Datei main.tf ein.

  4. Führen Sie folgende Befehle aus:

    • terraform init

    • terraform apply

Nächste Schritte

Informationen zum Verwalten der Befehlszeilen-Deployments von VM-Produkten finden Sie unter Befehlszeilen-Bereitstellungen von VM-Produkten verwalten.