Blueprints in der SaaS-Laufzeit

Wenn Sie die SaaS-Laufzeit verwenden möchten, müssen Sie eine Terraform-Konfiguration verwenden, um die SaaS-Anwendung und die Infrastruktur zu definieren, die Sie bereitstellen möchten.

In SaaS Runtime ist ein Blueprint die Bezeichnung für die verpackte Terraform-Konfiguration, die die Infrastruktur und Anwendung definiert, die Sie bereitstellen. Die verpackten Terraform-Konfigurationen sind OCI-Images (Open Container Initiative), die in Artifact Registry gespeichert sind.

Auf dieser Seite wird Folgendes beschrieben:

  • Die Anforderungen an die Terraform-Konfigurationen bei Verwendung der SaaS-Laufzeit.
  • Wie Sie die Terraform-Konfigurationen für die SaaS-Laufzeit bereitstellen können.
  • Wie die SaaS-Laufzeit die Terraform-Konfiguration verwendet.

Auf dieser Seite wird davon ausgegangen, dass Sie mit Terraform vertraut sind. Weitere Informationen zu Terraform finden Sie unter Was ist Terraform?.

Weitere Informationen zum Erstellen eines OCI-Images mit einer Terraform-Konfiguration finden Sie unter Blueprint erstellen und hochladen.

Blueprint-Anforderungen

SaaS Runtime verwendet Infrastructure Manager, um die Terraform-Konfigurationen auf Google Cloudbereitzustellen. Weitere Informationen zu Anforderungen und Einschränkungen finden Sie unter Einschränkungen für Terraform-Konfigurationen.

Für die Verwendung der Terraform-Konfiguration verwendet SaaS Runtime ein Paket der Terraform-Konfiguration. Dieses Paket ist ein OCI-Image (Open Container Initiative), das in Artifact Registry gespeichert ist.

Sie können ein OCI-Image mit der Terraform-Konfiguration bereitstellen. Andernfalls stellen Sie die Terraform-Konfiguration bereit und die SaaS-Laufzeit erstellt das OCI-Image. Details dazu, wie Sie die Terraform-Konfiguration bereitstellen können, finden Sie im folgenden Abschnitt Blueprint bereitstellen.

Terraform-Variablen in Blueprints

In Ihren Terraform-Konfigurationen können Sie Variablen verwenden, um Bereitstellungen anzupassen. Die SaaS-Laufzeit bietet flexible Möglichkeiten zum Verwalten dieser Variablen. Weitere Informationen finden Sie unter Variablen verwalten.

Blueprint bereitstellen

Sie können den Blueprint als Terraform-Konfiguration oder als OCI-Image bereitstellen, in dem die Terraform-Konfiguration enthalten ist.

Sie können der SaaS-Laufzeit einen Blueprint auf folgende Arten zur Verfügung stellen:

  • Terraform-Konfiguration, die in einem externen Repository gespeichert ist.
  • Terraform-Konfiguration, die in einem ZIP-Archiv gespeichert ist.
  • Erstellen Sie das OCI-Image mit der Terraform-Konfiguration und Cloud Build selbst und übertragen Sie es per Push an Artifact Registry.
  • Automatisieren Sie die Erstellung des OCI-Images mit der Terraform-Konfiguration und Cloud Build. Diese automatisierte Methode ist nützlich für CI/CD-Pipelines.

So verwendet die SaaS-Laufzeit den Blueprint

Wenn Sie die SaaS-Laufzeit verwenden, wird der Blueprint im Docker-Format in Artifact Registry gespeichert. Der Entwurf wird mit Infrastructure Manager auf Google Cloud bereitgestellt.

Weitere Informationen zum Repository in Artifact Registry finden Sie unter Repository für die SaaS-Laufzeit erstellen.

Blueprint hochladen

Sie können den Blueprint als Terraform-Konfiguration oder als OCI-Image bereitstellen, in dem die Terraform-Konfiguration enthalten ist.

Sie laden den Blueprint in die SaaS-Laufzeit hoch, wenn Sie eine Art von Einheit erstellen. Sie haben folgende Möglichkeiten, den Blueprint auszuwählen:

  • Laden Sie die Terraform-Konfiguration als ZIP-Archiv hoch.
  • Verknüpfen Sie ein externes Repository.
  • Wählen Sie ein vorhandenes Image aus Artifact Registry aus.

Weitere Informationen finden Sie unter Einheitentyp erstellen.

Blueprint bereitstellen

Die SaaS-Laufzeit stellt die im Blueprint beschriebene Infrastruktur bereit, wenn sie eine Einheit erstellt.

Die SaaS-Laufzeit verwendet Infrastructure Manager, um die Infrastruktur bereitzustellen. Infrastructure Manager verwendet Cloud Build als Teil seines Workflows. Wenn in der SaaS-Laufzeit eine Einheit erstellt wird, sind Informationen zum Status der Bereitstellung in allen drei Diensten verfügbar:

  • SaaS-Laufzeit
  • Infrastructure Manager
  • Cloud Build

Weitere Informationen dazu, wie Infrastructure Manager Terraform-Konfigurationen bereitstellt, finden Sie in der Infrastructure Manager-Übersicht.

Versionsverwaltung steuern

Die SaaS-Laufzeit steuert die Versionsverwaltung des Blueprints, indem sie das OCI-Image mit Artifact Registry versioniert und eine Release-Version in der SaaS-Laufzeit verwendet, um auf eine bestimmte Version des Blueprints in Artifact Registry zu verweisen.

Nächste Schritte