Oracle Cloud Infrastructure-Dokumentation

Funktion aufrufen

In dieser Phase wird eine Oracle Cloud Infrastructure-(OCI-)Funktion aufgerufen. In der Phase "Funktion aufrufen" kann Code oder benutzerdefinierte Logik serverlos ausgeführt werden. Sie können beispielsweise eine Funktion schreiben, die Ihre Anwendung in der Staging-Umgebung validiert, und die Anwendung bei Erfolg in der Produktionsumgebung bereitstellen.

Bevor Sie beginnen, müssen Sie eine Deployment-Pipeline definieren und eine Funktion erstellen, die beim Ausführen der Pipeline aufgerufen wird.

    1. Öffnen Sie das Navigationsmenü, und klicken Sie auf Entwicklerservices. Klicken Sie unter DevOps auf Projekte.
    2. Wählen Sie ein Projekt und eine diesem Projekt zugeordnete Pipeline aus.
    3. Um die Integrationsphase sequenziell oder parallel hinzuzufügen, klicken Sie auf das Plussymbol, und wählen Sie Phase hinzufügen aus.
    4. Wählen Sie Integrationen - Funktion aufrufen 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 Funktion aus, die aufgerufen werden soll.

      Im schreibgeschützten Feld Funktionsname wird die Funktion angezeigt, die in der Pipeline aufgerufen wird.

    7. (Optional) Um Artefakte auszuwählen und der Phase hinzuzufügen, klicken Sie auf Artefakt auswählen.

      Wählen Sie eine vorhandene Artefaktressource im DevOps-Projekt aus. Das Artefakt muss einen generischen Dateityp (Universal File Format, UFF) aufweisen. Parameter im Artefakt müssen im JSON-Format vorliegen und können Platzhalter enthalten. Wenn Sie die Artefaktressource DevOps konfigurieren, müssen Sie das Kontrollkästchen Parametrisierung zulassen auswählen, um die Platzhalter beim Deployment durch den Argumentwert zu ersetzen. Weitere Informationen finden Sie unter Parameter konfigurieren.

      Hier ist ein Beispiel für den Inhalt des generischen Artefakts, um zwei benutzerdefinierte Parameter und die zugehörigen Werte zu übergeben:
      • Parameter: test_name, app_version
      • Werte: {"test_name":"verify_production", "app_version":"${app_version}"}
    8. Wählen Sie unter Phasenausführungsmodus die asynchrone oder synchrone Ausführung aus.

      Wenn Sie Asynchron ausführen auswählen, ruft der Service die Funktion auf, wartet jedoch nicht, bis die Funktion abgeschlossen ist. Wenn Sie Synchron ausführen auswählen, ruft der Service die Funktion auf und wartet, bis die Funktion abgeschlossen ist.

    9. Deaktivieren oder aktivieren Sie die Validierung.

      Wenn die Validierung aktiviert ist, prüft der Service den Rückgabewert der Funktion. Der Rückgabewert ist ein UTF-8-Zeichenfolgenliteral, true oder false. Wenn der Rückgabewert true lautet, wird die Phase als Erfolgr. markiert. Andernfalls wird die Phase als Nicht erfolgreich markiert.

      Wenn die Validierung deaktiviert ist, prüft der Service den Rückgabewert nicht.

      Die Validierung erfolgt nur, wenn Sie die Option "Synchron ausführen" für den Phasenlaufmodus ausgewählt haben.

    10. (Optional) Um der Pipeline Tags hinzuzufügen, klicken Sie auf Taggingoptionen anzeigen. Tagging ist ein Metadatensystem, mit dem Sie die Ressourcen in Ihrem Mandanten organisieren und verfolgen können.

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

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

      Weitere Informationen finden Sie unter Ressourcentags.

    11. Um der Pipeline die Integrationsphase hinzuzufügen, klicken Sie auf Hinzufügen.
    Um die Build-Ausgabe in der Zielumgebung bereitzustellen, führen Sie die Deployment-Pipeline aus.

    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 Funktion in der Pipeline aufzurufen, führen Sie den Befehl create-invoke-function-stage aus:

    oci devops deploy-stage create-invoke-function-stage

    Erforderliche Parameter für den Befehl create-invoke-function-stage:

    • --function-environment-id
    • --is-async
    • --is-validation-enabled
    • --pipeline-id
    • --stage-predecessor-collection

    So rufen Sie alle Befehle für deploy-pipeline und deploy-stage ab:

    oci devops deploy-pipeline -h
    oci devops deploy-stage -h

    So erhalten Sie Hilfe für den Befehl create-invoke-function-stage:

    oci devops deploy-stage create-invoke-function-stage -h

  • Um eine Funktion in der Pipeline aufzurufen, verwenden Sie den Vorgang CreateDeployStage. Geben Sie für das Attribut deployStageType den Wert INVOKE_FUNCTION an.