Oracle Cloud Infrastructure-Dokumentation

In Instanzgruppen bereitstellen

Erstellen Sie eine Pipeline, um Artefakte in Instanzgruppen bereitzustellen.

Voraussetzungen

Für das Deployment von Artefakten in einer Instanzgruppe sind folgende Voraussetzungen erforderlich:

  • Eine Deployment-Pipeline, eine Instanzgruppenumgebung für das Deployment und Artefakte. Artefakte können inline definiert oder in der Artefakt-Registry gespeichert werden.

    Beim DevOps-Deployment wird die Bereitstellung mehrerer Artefakte in einer Phase unterstützt. Bei Instanzgruppen-Deployments definiert eine Deployment-Konfigurationsdatei die Befehle und führt Schritte aus, um das Anwendungspackageartefakt aus der angegebenen Artefakt-Registry herunterzuladen und im Dateisystem der Ziel-Compute-Instanz zu platzieren. Siehe Deployment-Konfigurationsdatei.

  • Das Compute Instance Run Command-Plug-in muss auf der Instanz aktiviert sein, und das Plug-in muss ausgeführt werden. Um das Plug-in zu aktivieren, führen Sie die folgenden Schritte aus:
    1. Öffnen Sie in der Konsole das Navigationsmenü, und klicken Sie auf Compute. Klicken Sie unter Compute auf Instanzen.
    2. Wählen Sie eine Instanz in der Instanzgruppe aus, in der Artefakte bereitgestellt werden sollen.
      Hinweis

      DevOps unterstützt nur Instanzgruppen-Deployments in Oracle Linux und CentOS.
    3. Klicken Sie auf die Registerkarte Oracle Cloud Agent.

    4. Aktivieren Sie für das Compute Instance Run Command-Plug-in die Option Aktiviertes Plug-in (Status Aktiviert).

      Es dauert bis zu 10 Minuten, bis die Änderung wirksam wird.

      Achtung

      Funktionen, die vom Plug-in abhängen, wie Monitoring, Autoscaling, Deployment oder OS Management, funktionieren nicht, wenn das Plug-in deaktiviert ist.
      Achtung

      Um Anwendungen mit dem Compute Instance Run Command-Plug-in bereitzustellen, müssen Sie die Policys nach dem Least-Privilege-Prinzip ordnungsgemäß konfigurieren und verwalten. Weitere Informationen finden Sie unter Befehle auf einer Instanz ausführen.

      Informationen zum Verwalten von Plug-ins finden Sie unter Plug-ins mit Oracle Cloud Agent verwalten. Informationen zur Fehlerbehebung finden Sie unter Fehler in Oracle Cloud Agent beheben.

  • Berechtigung zum Ausführen von Befehlen auf der Instanz. Weitere Informationen finden Sie in der erforderlichen Identity and Access Management-(IAM-)Policy.

Informationen zum Erstellen dynamischer Gruppen und Policys für Deployment-Pipelines finden Sie unter Deployment-Pipeline-Policys. Weitere Informationen finden Sie unter DevOps-IAM-Policys.

Informationen zum Zugriff auf DevOps über die Oracle Cloud-Konsole, die REST-API und die CLI finden Sie unter Auf DevOps zugreifen.

    1. Öffnen Sie das Navigationsmenü, und klicken Sie auf Entwicklerservices. Klicken Sie unter DevOps auf Projekte.
    2. Wählen Sie ein Projekt und eine Deployment-Pipeline aus.
    3. Um der Pipeline eine Phase hinzuzufügen, klicken Sie auf das Plussymbol, und wählen Sie Phase hinzufügen aus.
    4. Wählen Sie als Phasentyp Instanzgruppe bereitstellen aus, und klicken Sie auf Weiter.
    5. Geben Sie einen Namen und eine Beschreibung für die Phase ein. Das Hinzufügen einer Beschreibung ist optional.
    6. Wählen Sie unter Umgebung eine vorhandene Instanzgruppe aus.
    7. Klicken Sie auf Artefakt auswählen, und wählen Sie die verfügbaren Deployment-Konfigurationsartefakte für Instanzgruppen aus, die bereitgestellt werden sollen.

      Die Deployment-Konfigurationsdatei definiert die Artefakte, die in die Instanz heruntergeladen werden sollen, sowie den Speicherort, an den die Artefakte kopiert werden müssen. Weitere Informationen finden Sie unter Deployment-Konfigurationsdatei.

    8. (Optional) Klicken Sie auf Artefakt auswählen, um weitere Artefakte hinzuzufügen, die während des Deployments in die Compute-Instanzen heruntergeladen werden.

      Diese zusätzlichen Artefakte dürfen nicht inline definiert sein.

    9. (Optional) Klicken Sie auf Load Balancer auswählen. Der Load Balancer muss in der Konsole verfügbar sein.
      1. Wählen Sie die Region und das Compartment des Load Balancers aus.
      2. Wählen Sie einen Load Balancer in der verfügbaren Liste aus.

      Der Load Balancer verteilt den Produktionstraffic während des Deployments. Weitere Informationen finden Sie unter Load-Balancer-Verwaltung.

    10. Um dem Load Balancer einen Listener hinzuzufügen, klicken Sie auf Listener wählen.

      Listener prüfen die IP-Adresse des Load Balancers auf eingehenden Traffic. Weitere Informationen finden Sie unter Listener-Verwaltung.

    11. Um bei nicht erfolgreicher Validierung automatisch zur letzten erfolgreichen Releaseversion zurückzukehren, wählen Sie Ja. Weitere Informationen finden Sie unter Deployment zurücksetzen.
    12. Die Rollout-Policy steuert die Rate und das Verhalten des Instanz-Rollouts in der gesamten Zielumgebung. Wählen Sie eine der folgenden Optionen aus:
      • Rollout nach Prozentsatz: Geben Sie einen Prozentsatz zwischen 1 und 100 ein. Dieser Wert kontrolliert den maximalen Prozentsatz von Instanzen, die gleichzeitig bereitgestellt oder nicht ausgeführt werden.
      • Rollout nach Anzahl: Geben Sie den Anzahlwert ein. Dieser Wert kontrolliert die maximale Anzahl von Instanzen, die gleichzeitig bereitgestellt oder nicht ausgeführt werden.
    13. (Optional) Geben Sie unter Verzögerung zwischen Batches eine Dauer in Sekunden ein.
    14. (Optional) Die Failure-Policy definiert die Fehlerkriterien für eine Phase. Sie kann basierend auf der Anzahl der Compute-Hosts definiert werden, die in einer Instanzgruppe nicht erfolgreich waren. Wählen Sie eine der folgenden Optionen aus:
      • -
      • Fehler nach Prozentsatz: Geben Sie einen Prozentsatz zwischen 1 und 100 ein. Dieser Wert definiert den Prozentsatz der Compute-Hosts, die nicht erfolgreich sind, wonach ein Phasenfehler auftritt.
      • Fehler nach Anzahl: Geben Sie den Anzahlwert ein. Dieser Wert definiert die Anzahl der Compute-Hosts, die nicht erfolgreich sind, wonach ein Phasenfehler auftritt.
    15. (Optional) Um der Pipeline Tags hinzuzufügen, klicken Sie auf Taggingoptionen anzeigen. Tagging ist ein Metadaten-System, mit dem Sie die Ressourcen im Mandanten organisieren und verfolgen können.

      Wenn Sie über Berechtigungen zum Erstellen von Ressourcen verfügen, sind Sie auch berechtigt, Freiformtags hinzuzufügen.

      Um ein definiertes Tag hinzuzufügen, benötigen Sie Berechtigungen zum Verwenden des Tag-Namespace.

      Weitere Informationen finden Sie unter Ressourcentags.

    16. Um der Pipeline die Phase hinzuzufügen, klicken Sie auf Hinzufügen.

      Eine Phasenvorschau enthält einen Snapshot der Konfiguration.

    Fügen Sie der Pipeline bei Bedarf weitere Phasen sequenziell oder parallel hinzu. Um die Build-Ausgabe in der Zielumgebung bereitzustellen, führen Sie die Deployment-Pipeline aus.

    Sie können der Deployment-Pipeline 100 parallele Phasen hinzufügen. Das Plug-in "Befehl ausführen" unterstützt jedoch nur fünf Befehle auf einer Instanz. Sie benötigen also genügend Instanzen, um 100 parallele Instanzgruppen-Deployments auszuführen.

    Um ein Deployment in der Build-Pipeline automatisch auszulösen, können Sie der Build-Pipeline eine Phase "Deployment auslösen" hinzufügen.

  • Um eine Instanzgruppenphase zu erstellen, führen Sie den Befehl create-deploy-compute-instance-group-stage aus:

    oci devops deploy-stage create-deploy-compute-instance-group-stage

    Erforderliche Parameter für den Befehl create-deploy-compute-instance-group-stage:

    • --compute-instance-group-environment-id
    • --deployment-spec-artifact-id
    • --rollout-policy
    • --pipeline-id
    • --stage-predecessor-collection

    Um alle Befehle für deploy-stage abzurufen:

    oci devops deploy-stage -h

    So erhalten Sie Hilfe für den Befehl create-deploy-compute-instance-group-stage:

    oci devops deploy-stage create-deploy-compute-instance-group-stage -h

  • Um eine Instanzgruppen-Deployment-Phase für die Pipeline zu erstellen, verwenden Sie den Vorgang CreateDeployStage. Geben Sie für das Attribut deployStageType den Wert COMPUTE_INSTANCE_GROUP_ROLLING_DEPLOYMENT an.