Bereitstellungseinheiten für Modelle und Pakete

Auf dieser Seite wird beschrieben, wie Sie Bereitstellungseinheiten für ein SaaS-Angebot modellieren und verpacken. In der SaaS-Laufzeit wird eine Bereitstellungseinheit als Art von Einheit bezeichnet.

Erstellen Sie eine Art von Einheit für jede Komponente des SaaS-Angebots, die Sie unabhängig verwalten möchten. Weitere Informationen finden Sie im folgenden Abschnitt Modell des SaaS-Angebots bestimmen.

Bei Bedarf können Sie ein SaaS-Angebot mit einer einzelnen Art von Einheit für das gesamte SaaS-Angebot erstellen.

Einheitstypen werden durch einen Blueprint definiert, der eine als OCI-Image verpackte Terraform-Konfiguration ist. Bevor Sie eine Art von Einheit erstellen, müssen Sie für jede Art von Einheit einen Blueprint erstellt haben. Weitere Informationen zum Erstellen von Blueprints finden Sie unter Blueprint erstellen und hochladen.

Hinweise

  1. Sie müssen ein SaaS-Angebot für Ihre SaaS-Anwendung definieren.
  2. Prüfen Sie, ob Sie ein Artifact Registry-Repository erstellt haben.
  3. Prüfen Sie, ob Sie die Dienstkonten mit den erforderlichen Berechtigungen haben. Weitere Informationen finden Sie unter SaaS-Laufzeit-Dienstkonten.
  4. Für jede Art von Einheit, die Sie erstellen, müssen Sie eine Terraform-Konfiguration haben und den Blueprint vorbereitet haben. Weitere Informationen finden Sie im folgenden Abschnitt Modell des SaaS-Angebots bestimmen.

Modell des SaaS-Angebots festlegen

Um das SaaS-Angebot zu modellieren, müssen Sie festlegen, wie viele Arten von Einheiten Sie erstellen möchten und welche Beziehung zwischen diesen Arten von Einheiten besteht.

Sie können beispielsweise zwei Einheitentypen erstellen: einen für die Infrastruktur wie eine VM und einen für die Anwendung, die auf der Infrastruktur bereitgestellt wird. Bei Bedarf können Sie ein SaaS-Angebot mit einer einzelnen Art der Einheit für das gesamte SaaS-Angebot erstellen.

Berücksichtigen Sie Folgendes, wenn Sie entscheiden, wie Sie das SaaS-Angebot mithilfe von Arten von Einheiten modellieren:

  • Prüfen Sie die Abhängigkeiten zwischen den Komponenten des SaaS-Angebots. Wenn ein SaaS-Angebot beispielsweise eine Anwendung umfasst, die in einem gemeinsam genutzten Kubernetes-Cluster bereitgestellt wird, sollten Sie einen Einheitentyp verwenden, um diesen gemeinsam genutzten Cluster zu modellieren.
  • Berücksichtigen Sie den Release- und Wartungszyklus der Komponenten des SaaS-Angebots. Wenn es Komponenten gibt, die gemeinsam verwaltet werden, z. B. die Infrastruktur, sollten Sie diese Komponenten mit einer Art von Einheit modellieren.

Nachdem Sie dieses Modell festgelegt haben, müssen Sie für jede Art von Einheit einen Blueprint erstellen. Dazu müssen Sie Folgendes tun:

  1. Identifizieren Sie die Terraform-Konfiguration, die mit dieser Art der Einheit verknüpft werden soll. Weitere Informationen zu den erforderlichen Terraform-Konfigurationen finden Sie unter Blueprints in der SaaS-Laufzeit.
  2. Achten Sie darauf, dass die Terraform-Konfiguration als OCI-Image gepackt und in die Artifact Registry übertragen wird oder sich in einem ZIP-Archiv oder Git-Repository befindet. Weitere Informationen finden Sie unter Blueprint erstellen und hochladen.

Wenn Sie einen Blueprint für jeden Einheitentyp haben, können Sie der Anleitung auf dieser Seite folgen, um die Einheitentypen zu erstellen.

Art der Einheit erstellen

Sie können einen Einheitentyp mit einer Terraform-Konfiguration erstellen, die auf folgende Weise bereitgestellt wird:

  • In einem ZIP-Archiv.
  • In einem Git-Repository.
  • Als OCI-Image verpackt.

Art der Einheit mit einem ZIP-Archiv erstellen

Führen Sie die folgenden Schritte aus, um mit einer Terraform-Konfiguration in einem ZIP-Archiv eine Einheit zu erstellen.

Weitere Informationen zum Vorbereiten eines ZIP-Archivs finden Sie unter ZIP-Archiv hochladen.

So erstellen Sie eine Art der Einheit:

  1. Rufen Sie in der Console SaaS Runtime > Unit Kinds auf.

    Zu „Einheitentypen“

  2. Wählen Sie Erstellen aus.

  3. Wählen Sie unter Blueprint erstellen die Option Hochladen aus, um ein ZIP-Archiv hochzuladen, das die Terraform-Konfiguration enthält.

    1. Klicken Sie auf Suchen und suchen Sie nach dem ZIP-Archiv mit der Terraform-Konfiguration, in der die Ressourcen oder Anwendungen definiert sind, die zu dieser Einheit gehören.

    2. Klicken Sie auf Weiter: Entwurf konfigurieren.

  4. Gehen Sie auf der Seite Entwurf speichern so vor:

    1. Klicken Sie für Repository aus Artifact Registry auswählen auf Durchsuchen und wählen Sie das von Ihnen erstellte Repository aus.

    2. Geben Sie unter Artifact image name einen Namen für das OCI-Image ein.

    3. Wählen Sie für Infrastructure Manager-Terraform-Version die Version von Terraform aus, die für Bereitstellungen verwendet werden soll. Eine Liste der unterstützten Terraform-Versionen finden Sie unter Unterstützte Terraform-Versionen.

    4. Wählen Sie für das Cloud Build-Dienstkonto das Dienstkonto aus, das die Berechtigungen zum Erstellen des Images hat. Weitere Informationen finden Sie unter Dienstkonto für die Artefakterstellung.

    5. Klicken Sie auf Weiter: Details zur Art der Einheit.

  5. Führen Sie auf der Seite Eigenschaften der Art der Einheit konfigurieren die folgenden Schritte aus:

    1. Geben Sie unter Name der Einheit einen Namen für die Einheit ein. Der Name darf nur Kleinbuchstaben, Ziffern oder Bindestriche enthalten.

    2. Wählen Sie unter SaaS-Angebot das SaaS-Angebot aus, das Sie mit dieser Art von Einheit verknüpfen möchten.

    3. Für Abhängigkeiten:

      • Wenn dies die erste oder einzige Art von Einheit ist, die Sie für das SaaS-Angebot erstellen, fügen Sie keine Abhängigkeit hinzu.

      • Wenn Sie andere Einheitenarten erstellt haben, die von dieser Einheitenart abhängig sind, wählen Sie Abhängigkeit hinzufügen aus.

        1. Wählen Sie für Art der Einheit die vorhandene Art der Einheit aus, die von der Art der Einheit abhängt, die Sie erstellen.

        2. Geben Sie für Alias einen Namen ein, den Sie für die Zuordnung von Eingabevariablen verwenden können.

        3. Klicken Sie auf Fertig.

        4. Wenn Sie die Zuordnung von Variablen definieren möchten, führen Sie die folgenden Schritte aus. Weitere Informationen zur Variablenzuordnung finden Sie unter Variablenzuordnung.

          1. Wählen Sie Eingabe- und Ausgabevariablenzuordnungen definieren aus.

          2. Für Zuordnungen von Eingabevariablen:

            1. Wählen Sie Zuordnung von Eingabevariablen hinzufügen aus.
            2. Geben Sie bei Variable den Namen der Eingabevariable ein.
            3. Wählen Sie für Zuordnungstyp Folgendes aus:
              • Von: Die andere Einheit, die zugeordnet werden soll.
              • To, um die andere Einheit zuzuordnen.
            4. Wählen Sie unter Abhängigkeit die vorhandene Einheit aus, der Sie Variablen zuordnen.
            5. Geben Sie unter Ausgabevariable den Namen der Ausgabevariable ein.
            6. Wählen Sie Fertig aus.

          3. Wenn Sie eine weitere Eingabevariable hinzufügen möchten, wählen Sie Zuordnung von Eingabevariablen hinzufügen aus und wiederholen Sie die Schritte.

          4. So fügen Sie Zuordnungen von Ausgabevariablen hinzu:

            1. Wählen Sie den Tab Zuordnungen von Ausgabevariablen aus.
            2. Wählen Sie Zuordnung von Ausgabevariablen hinzufügen aus und wiederholen Sie die Schritte, die Sie für die Zuordnung von Eingabevariablen ausgeführt haben.

  6. Klicken Sie auf Weiter: Releasekonfiguration.

  7. Geben Sie unter Releasename einen Namen für den Release ein.

  8. Optional: Fügen Sie den Ressourcen, die Sie bereitstellen, ein Label hinzu. Weitere Informationen zu Labels finden Sie in der Label-Übersicht.

    So fügen Sie ein Label hinzu:

    1. Wählen Sie unter Labels die Option Labels hinzufügen aus.

    2. Geben Sie für Schlüssel 1 und Wert 1 das gewünschte Schlüssel/Wert-Paar ein.

    3. Wiederholen Sie die Schritte für jedes Label, das Sie hinzufügen möchten.

  9. Klicken Sie auf Erstellen.

Sie haben jetzt eine Art der Einheit erstellt. Wenn Sie eine weitere Einheit erstellen möchten, wiederholen Sie die gleichen Schritte und verwenden Sie das ZIP-Archiv, das die Terraform-Konfiguration für diese nächste Einheit enthält.

Wenn Sie alle für das SaaS-Angebot erforderlichen Einheiten erstellt haben, können Sie eine Einheiteninstanz bereitstellen.

Art der Einheit mit einem Git-Repository erstellen

Führen Sie die folgenden Schritte aus, um mit einer Terraform-Konfiguration in einem Git-Repository eine Einheit zu erstellen.

Weitere Informationen zur Verwendung eines Git-Repositorys für die Terraform-Dateien finden Sie unter Mit einem Git-Repository verbinden.

  1. Rufen Sie in der Console SaaS Runtime > Unit Kinds auf.

    Zu „Einheitentypen“

  2. Wählen Sie Erstellen aus.

  3. Wählen Sie unter Blueprint erstellen die Option Externes Repository verknüpfen aus.

  4. Wählen Sie für Repository das Git-Repository mit der Terraform-Konfiguration aus:

    1. Wenn das Git-Repository verknüpft ist, wählen Sie es aus der Liste aus.

    2. Wenn das Repository nicht verknüpft ist, klicken Sie auf Neues Repository verknüpfen, um das Repository mit Developer Connect zu verknüpfen.

      1. Wählen Sie Neue Verbindung erstellen aus.

      2. Wählen Sie unter Region eine Region für die Developer Connect-Verbindung aus. Wir empfehlen, dieselbe Region wie für das Artifact Registry-Repository zu verwenden.

      3. Optional: Für KMS-Schlüssel können Sie einen KMS-Schlüssel für die Verschlüsselung angeben.

      4. Geben Sie für Branch den Git-Zweig an, der die Terraform-Konfiguration enthält, die Sie mit dieser Einheit verknüpfen möchten.

  5. Gehen Sie auf der Seite Entwurf speichern so vor:

    1. Klicken Sie für Repository aus Artifact Registry auswählen auf Durchsuchen und wählen Sie das Artifact Registry-Repository aus, das Sie für das SaaS-Angebot verwenden.

    2. Geben Sie unter Artifact image name einen Namen für das OCI-Image ein.

    3. Wählen Sie für Infrastructure Manager-Terraform-Version die Version von Terraform aus, die für Bereitstellungen verwendet werden soll. Eine Liste der unterstützten Terraform-Versionen finden Sie unter Unterstützte Terraform-Versionen.

    4. Wählen Sie für das Cloud Build-Dienstkonto das Dienstkonto aus, das die Berechtigungen zum Erstellen des Images hat. Weitere Informationen finden Sie unter Dienstkonto für die Artefakterstellung.

    5. Klicken Sie auf Weiter: Details zur Art der Einheit.

  6. Führen Sie auf der Seite Eigenschaften der Art der Einheit konfigurieren die folgenden Schritte aus:

    1. Geben Sie unter Name der Einheit einen Namen für die Einheit ein. Der Name darf nur Kleinbuchstaben, Ziffern oder Bindestriche enthalten.

    2. Wählen Sie unter SaaS-Angebot das SaaS-Angebot aus, das Sie mit dieser Art von Einheit verknüpfen möchten.

    3. Für Abhängigkeiten:

      • Wenn dies die erste oder einzige Art von Einheit ist, die Sie für das SaaS-Angebot erstellen, fügen Sie keine Abhängigkeit hinzu.

      • Wenn Sie andere Einheitenarten erstellt haben, die von dieser Einheitenart abhängig sind, wählen Sie Abhängigkeit hinzufügen aus.

        1. Wählen Sie für Art der Einheit die vorhandene Art der Einheit aus, die von der Art der Einheit abhängt, die Sie erstellen.

        2. Geben Sie für Alias einen Namen ein, den Sie für die Zuordnung von Eingabevariablen verwenden können.

        3. Klicken Sie auf Fertig.

        4. Wenn Sie die Zuordnung von Variablen definieren möchten, führen Sie die folgenden Schritte aus. Weitere Informationen zur Variablenzuordnung finden Sie unter Variablenzuordnung.

          1. Wählen Sie Eingabe- und Ausgabevariablenzuordnungen definieren aus.

          2. Für Zuordnungen von Eingabevariablen:

            1. Wählen Sie Zuordnung von Eingabevariablen hinzufügen aus.
            2. Geben Sie bei Variable den Namen der Eingabevariable ein.
            3. Wählen Sie für Zuordnungstyp Folgendes aus:
              • Von: Die andere Einheit, die zugeordnet werden soll.
              • To, um die andere Einheit zuzuordnen.
            4. Wählen Sie unter Abhängigkeit die vorhandene Einheit aus, der Sie Variablen zuordnen.
            5. Geben Sie unter Ausgabevariable den Namen der Ausgabevariable ein.
            6. Wählen Sie Fertig aus.

          3. Wenn Sie eine weitere Eingabevariable hinzufügen möchten, wählen Sie Zuordnung von Eingabevariablen hinzufügen aus und wiederholen Sie die Schritte.

          4. So fügen Sie Zuordnungen von Ausgabevariablen hinzu:

            1. Wählen Sie den Tab Zuordnungen von Ausgabevariablen aus.
            2. Wählen Sie Zuordnung von Ausgabevariablen hinzufügen aus und wiederholen Sie die Schritte, die Sie für die Zuordnung von Eingabevariablen ausgeführt haben.

  7. Klicken Sie auf Weiter: Releasekonfiguration.

  8. Geben Sie unter Releasename einen Namen für den Release ein.

  9. Optional: Fügen Sie den Ressourcen, die Sie bereitstellen, ein Label hinzu. Weitere Informationen zu Labels finden Sie in der Label-Übersicht.

    So fügen Sie ein Label hinzu:

    1. Wählen Sie unter Labels die Option Labels hinzufügen aus.

    2. Geben Sie für Schlüssel 1 und Wert 1 das gewünschte Schlüssel/Wert-Paar ein.

    3. Wiederholen Sie die Schritte für jedes Label, das Sie hinzufügen möchten.

  10. Klicken Sie auf Erstellen.

Sie haben jetzt eine Art der Einheit erstellt. Wenn Sie eine weitere Einheit erstellen möchten, wiederholen Sie die gleichen Schritte und verwenden Sie das Git-Repository, das die Terraform-Konfiguration für diese nächste Einheit enthält.

Wenn Sie alle für das SaaS-Angebot erforderlichen Einheiten erstellt haben, können Sie eine Einheiteninstanz bereitstellen.

Art der Einheit mit einem vorhandenen Bild erstellen

So erstellen Sie eine Art von Einheit mithilfe eines vorhandenen Blueprints, der ein OCI-Image ist:

Weitere Informationen zum Erstellen eines OCI-Images finden Sie unter:

  1. Rufen Sie in der Console SaaS Runtime > Unit Kinds auf.

    Zu „Einheitentypen“

  2. Wählen Sie Erstellen aus.

  3. Wählen Sie unter Create blueprint (Blueprint erstellen) die Option Select an existing image from artifact registry (Vorhandenes Image aus Artifact Registry auswählen) aus.

  4. Klicken Sie auf Weiter: Entwurf konfigurieren.

  5. Gehen Sie auf der Seite Entwurf speichern so vor:

    1. Für Vorhandenen Blueprint aus Artifact Registry auswählen oder eingeben:

      1. Klicken Sie auf Durchsuchen.

      2. Rufen Sie das Image auf, das die Terraform-Konfiguration enthält.

      3. Klicken Sie auf Auswählen.

    2. Klicken Sie auf Weiter: Details zur Art der Einheit.

  6. Führen Sie auf der Seite Eigenschaften der Art der Einheit konfigurieren die folgenden Schritte aus:

    1. Geben Sie unter Name der Einheit einen Namen für die Einheit ein. Der Name darf nur Kleinbuchstaben, Ziffern oder Bindestriche enthalten.

    2. Wählen Sie unter SaaS-Angebot das SaaS-Angebot aus, das Sie mit dieser Art von Einheit verknüpfen möchten.

    3. Für Abhängigkeiten:

      • Wenn dies die erste oder einzige Art von Einheit ist, die Sie für das SaaS-Angebot erstellen, fügen Sie keine Abhängigkeit hinzu.

      • Wenn Sie andere Einheitenarten erstellt haben, die von dieser Einheitenart abhängig sind, wählen Sie Abhängigkeit hinzufügen aus.

        1. Wählen Sie für Art der Einheit die vorhandene Art der Einheit aus, die von der Art der Einheit abhängt, die Sie erstellen.

        2. Geben Sie für Alias einen Namen ein, den Sie für die Zuordnung von Eingabevariablen verwenden können.

        3. Klicken Sie auf Fertig.

        4. Wenn Sie die Zuordnung von Variablen definieren möchten, führen Sie die folgenden Schritte aus. Weitere Informationen zur Variablenzuordnung finden Sie unter Variablenzuordnung.

          1. Wählen Sie Eingabe- und Ausgabevariablenzuordnungen definieren aus.

          2. Für Zuordnungen von Eingabevariablen:

            1. Wählen Sie Zuordnung von Eingabevariablen hinzufügen aus.
            2. Geben Sie bei Variable den Namen der Eingabevariable ein.
            3. Wählen Sie für Zuordnungstyp Folgendes aus:
              • Von: Die andere Einheit, die zugeordnet werden soll.
              • To, um die andere Einheit zuzuordnen.
            4. Wählen Sie unter Abhängigkeit die vorhandene Einheit aus, der Sie Variablen zuordnen.
            5. Geben Sie unter Ausgabevariable den Namen der Ausgabevariable ein.
            6. Wählen Sie Fertig aus.

          3. Wenn Sie eine weitere Eingabevariable hinzufügen möchten, wählen Sie Zuordnung von Eingabevariablen hinzufügen aus und wiederholen Sie die Schritte.

          4. So fügen Sie Zuordnungen von Ausgabevariablen hinzu:

            1. Wählen Sie den Tab Zuordnungen von Ausgabevariablen aus.
            2. Wählen Sie Zuordnung von Ausgabevariablen hinzufügen aus und wiederholen Sie die Schritte, die Sie für die Zuordnung von Eingabevariablen ausgeführt haben.

  7. Klicken Sie auf Weiter: Releasekonfiguration.

  8. Geben Sie unter Releasename einen Namen für den Release ein.

  9. Optional: Fügen Sie den Ressourcen, die Sie bereitstellen, ein Label hinzu. Weitere Informationen zu Labels finden Sie in der Label-Übersicht.

    So fügen Sie ein Label hinzu:

    1. Wählen Sie unter Labels die Option Labels hinzufügen aus.

    2. Geben Sie für Schlüssel 1 und Wert 1 das gewünschte Schlüssel/Wert-Paar ein.

    3. Wiederholen Sie die Schritte für jedes Label, das Sie hinzufügen möchten.

  10. Klicken Sie auf Erstellen.

Sie haben jetzt eine Art der Einheit erstellt. Wenn Sie eine weitere Geräteart erstellen möchten, wiederholen Sie die gleichen Schritte und verwenden Sie das OCI-Image, das die Terraform-Konfiguration für diese nächste Geräteart enthält.

Wenn Sie alle für das SaaS-Angebot erforderlichen Einheiten erstellt haben, können Sie eine Einheiteninstanz bereitstellen.

Nächste Schritte