Funktion über eine Vorlage mit Codeeditor erstellen

Helloworld-Funktion mit dem Codeeditor aus einer Vorlage erstellen

So erstellen Sie mit dem Codeeditor eine neue Funktion in OCI Functions basierend auf einer Vorlagenfunktion:

1. Bestätigen Sie, dass Sie die Schritte in Functions QuickStart on Cloud Shell ausgeführt haben, um:
   • Richten Sie Ihren Mandanten mit Gruppen und Benutzern ein, erstellen Sie ein Compartment, in dem OCI Functions-Ressourcen erstellt werden, erstellen Sie ein VCN und Subnetze, und erstellen Sie eine IAM-Policy.
   • Richten Sie die Cloud Shell-Entwicklungsumgebung mit dem Fn-Projekt-CLI-Kontext ein, rufen Sie ein Authentifizierungstoken ab, und melden Sie sich bei der Docker-Registry an, die für den Fn-Projekt-CLI-Kontext angegeben ist.
2. Melden Sie sich als Funktionsentwickler in der Konsole an.

3. Erstellen Sie mit der Konsole eine neue Anwendung in OCI Functions:

   1. Öffnen Sie das Navigationsmenü , und wählen Sie Entwicklerservices aus. Wählen Sie unter Funktionen die Option Anwendungen aus.
   2. Wählen Sie die Region aus, die Sie für OCI Functions verwenden möchten.

      Es wird empfohlen, dass Sie dieselbe Region wie die Docker-Registry verwenden, die im Fn-Projekt-CLI-Kontext angegeben ist (siehe Fn-Projekt-CLI-Kontext für die Verbindung mit Oracle Cloud Infrastructure erstellen).

   3. Wählen Sie das Compartment aus, das im Fn-Projekt-CLI-Kontext angegeben wurde (siehe Fn-Projekt-CLI-Kontext für die Verbindung mit Oracle Cloud Infrastructure erstellen).

      Auf der Seite Anwendungen werden die bereits im Compartment definierten Anwendungen angezeigt.

   4. Wählen Sie Anwendung erstellen aus, und geben Sie Folgendes an:

      • Ein Name für die neue Anwendung. Beispiel: helloworld-java-app

      • VCN und Subnetz (bzw. Subnetze, bis zu drei sind möglich), in denen die Funktion ausgeführt werden soll. Es wird empfohlen, dass sich die Subnetze in derselben Region wie die Docker-Registry befinden sollten, die im Fn-Projekt-CLI-Kontext angegeben ist (siehe Fn-Projekt-CLI-Kontext für die Verbindung mit Oracle Cloud Infrastructure erstellen).

      Weitere Informationen zu den anderen Optionen für die Anwendungserstellung finden Sie unter Anwendung erstellen.

   5. Wählen Sie Erstellen aus, um die Anwendung zu erstellen.

4. Starten Sie den Codeeditor auf eine der folgenden Arten:

   • Auf der Listenseite Anwendungen wählen Sie die Anwendung, in der Sie die Funktion erstellen möchten. Wählen Sie auf der Seite "Anwendungsdetails" Funktionen aus. Wählen Sie auf der Registerkarte Funktionen die Option In Codeeditor erstellen aus. Mit dieser Methode wird der Code Editor in der gerade erstellten Anwendung geöffnet.
   • Wählen Sie die Option "Codeeditor" aus der Schaltfläche "Entwicklerwerkzeuge" in der Symbolleiste der Konsole aus.
5. Erstellen Sie eine neue Funktion aus einer Vorlage:
   1. Navigieren Sie im Bereich "Codeeditor - Oracle Cloud Infrastructure" zu der Anwendung, die Sie gerade in dem im Fn-Projekt-CLI-Kontext angegebenen Compartment erstellt haben. Beispiel: helloworld-java-app.
   2. Wenn der Anwendungsname markiert ist, wählen Sie im Kontextmenü die Option Funktion erstellen....
   3. Wählen Sie die Erstellungsmethode Aus Vorlage erstellen im Eingabefeld in der Menüleiste des Codeeditors aus.
   4. Wählen Sie eine Sprache aus der Sprachliste aus, und drücken Sie die Eingabetaste. Beispiel: Wählen Sie Java aus.
   5. Geben Sie in der Menüleiste des Codeeditors einen Namen für die neue helloworld-Funktion in das Eingabefeld ein, und drücken Sie die Eingabetaste. Beispiel: helloworld-func-java.
   6. Wählen Sie OK, um das Dialogfeld zu bestätigen, in dem Sie darüber informiert werden, dass Änderungen festgeschrieben und an eine Remoteverzweigung übertragen werden müssen, bevor die Funktion bereitgestellt werden kann.

      Ein nach der Funktion benanntes Verzeichnis wird im Verzeichnis /home/<username>/oci-ide-plugins/faas-artifacts/<app-ocid>/ erstellt. Beispiel: In /home/jdoe/oci-ide-plugins/faas-artifacts/ocid1.fnapp.oc1.iad.aaaaaa______76nf/helloworld-func-java,

      Wenn Sie die neue Funktion auf der Java-Vorlagenfunktion basieren, enthält das Verzeichnis:

      • func.yaml
      • pom.xml
      • ein /src-Verzeichnis
6. Speichern Sie die Funktion in einem lokalen Git-Repository:
   1. Öffnen Sie ein Terminalfenster des Codeeditors, indem Sie in der Menüleiste des Codeeditors im Fenster Terminal die Option Neues Terminal auswählen.
   2. Ändern Sie im Terminalfenster des Codeeditors das Verzeichnis in das neu erstellte Verzeichnis, das die Datei func.yaml und die Quelldateien der Funktion enthält, indem Sie Folgendes eingeben:

      cd /home/<oci-username>/oci-ide-plugins/faas-artifacts/<application-OCID>/<function-name>

      Beispiel:

      cd /home/jdoe/oci-ide-plugins/faas-artifacts/ocid1.fnapp.oc1.iad.aaaaaaaa______76nf/helloworld-func-java

   3. Konvertieren Sie das nicht versionierte Verzeichnis (z.B. helloworld-func-java) in ein lokales Git-Repository, indem Sie Folgendes eingeben:

      git init

   4. Fügen Sie die Dateien im Verzeichnis der Staging Area hinzu, indem Sie Folgendes eingeben:

      git add .

   5. Speichern Sie den Inhalt der Staging Area im lokalen Git-Repository, indem Sie Folgendes eingeben:

      git commit

   6. Wenn Sie dazu aufgefordert werden, geben Sie eine Commit-Nachricht ein:
      1. Drücken Sie die i-Taste auf der Tastatur, um Text einzufügen.
      2. Geben Sie eine Commit-Nachricht ein. Beispiel:

         Adds hello-world files.

      3. Drücken Sie die Esc-Taste, geben Sie : w q ein, und drücken Sie die Eingabetaste.
7. Erstellen Sie ein neues Remote-Git-Repository. Beispiel: In GitHub als https://github.com/jdoe/template-java-helloworld-repo.
8. Funktion an das Remote-Git-Repository übergeben:
   1. Verbinden Sie im Terminalfenster des Codeeditors im Verzeichnis mit der Datei func.yaml und den Funktionsquelldateien das lokale Git-Repository mit dem soeben erstellten Remote-Git-Repository, indem Sie Folgendes eingeben:

      git remote add origin <remote-repository-url>

      Beispiel:

      git remote add origin https://github.com/jdoe/template-java-helloworld-repo.git

   2. Erstellen Sie eine neue Verzweigung namens "main" im lokalen Git-Repository, indem Sie Folgendes eingeben:

      git branch -M main

   3. Senden Sie Dateien an die main-Verzweigung im Remote-Git-Repository, indem Sie Folgendes eingeben:

      git push -u origin main

   4. Geben Sie bei entsprechender Aufforderung den Git-Benutzernamen und das Kennwort für das Remote-Git-Repository ein.

      Beachten Sie im Fall von GitHub, dass das Kennwort das persönliche Zugriffstoken GitHub ist.

9. Funktion in OCI Functions bereitstellen:

   1. Melden Sie sich im Terminalfenster des Codeeditors im Verzeichnis mit der Datei func.yaml und den Funktionsquelldateien bei der im Fn-Projekt-CLI-Kontext angegebenen Docker-Registry an. Wenn die Docker-Registry Oracle Cloud Infrastructure Registry ist, verwenden Sie den folgenden Befehl:

      docker login -u '<tenancy-namespace>/<user-name>' <region-key>.ocir.io

      Beispiel:

      docker login -u 'ansh81vru1zp/jdoe@acme.com' phx.ocir.io

   2. Wenn Sie zur Eingabe eines Kennworts aufgefordert werden, geben Sie Ihr OCI-Authentifizierungstoken ein.
   3. Stellen Sie im Terminalfenster des Codeeditors die Funktion in OCI Functions bereit, indem Sie Folgendes ausführen:

      fn -v deploy --app <application-name>

      Beispiel:

      fn -v deploy --app helloworld-java-app

10. Rufen Sie die soeben bereitgestellte Funktion auf:
    1. Rufen Sie im Terminalfenster des Codeeditors im Verzeichnis mit der Datei func.yaml und den Funktionsquelldateien die Funktion auf, indem Sie Folgendes ausführen:

       fn invoke <application-name> <function-name>

       Beispiel:

       fn invoke helloworld-java-app helloworld-func-java

       Wenn eine Meldung zurückgegeben wird, in der die Funktion nicht gefunden wird, liegt eine mögliche Ursache in einer Unstimmigkeit zwischen dem Namen der Funktion, die Sie im Codeeditor erstellt haben, und dem Namen der Funktion, die in func.yaml angegeben ist. Wiederholen Sie die vorherigen Schritte, um eine Funktion im Codeeditor zu erstellen, die denselben Namen hat wie in der Datei func.yaml im Remote-Git-Repository angegeben.

       Wenn die neue Funktion auf der Java-Vorlagenfunktion basiert, wird die folgende Meldung angezeigt:

       Hello World !

11. (Optional) Wenn Sie die neue Funktion in den vorherigen Schritten auf einer Java-Vorlagenfunktion namens helloworld-func-java basieren, wird in diesem optionalen Schritt beschrieben, wie Sie den Text der Meldung ändern, die beim Aufrufen der Funktion angezeigt wird. Sie aktualisieren den Nachrichtentext im lokalen Git-Repository, übertragen das Update in das Remote-Git-Repository und stellen die Funktion dann bereit und rufen sie auf.

    1. Im Bereich "Codeeditor Oracle Cloud Infrastructure" unter der soeben erstellten Funktion helloworld-func-java:
       • Klicken Sie auf die Datei /src/main/java/com/example/fn/HelloFunction.java, und ändern Sie die Zeile:

         return "Hello, " + name + "!";

         zum Lesen:

         return "Hi, " + name + "!";

       • Wählen Sie in der Datei /test/java/com/example/fn/HelloFunctionTest.java aus, und ändern Sie die Zeile:

         assertEquals("Hello, world!", result.getBodyAsString());

         zum Lesen:

         assertEquals("Hi, world!", result.getBodyAsString());

    2. Wählen Sie im Codeeditor-Navigator das Quellsteuerelement aus, klicken Sie auf die Schaltfläche "Weitere Aktionen", und wählen Sie im Menü Festschreiben die Option Festschreiben.
    3. Wenn Sie zur Bereitstellung von Änderungen aufgefordert werden, wählen Sie Ja aus.
    4. Geben Sie eine Commit-Nachricht ein (z.B. Changes-Hello-to-Hi), und drücken Sie die Eingabetaste.
    5. Wählen Sie die Schaltfläche "Weitere Aktionen", und wählen Sie im Menü Abrufen, Push die Option Push aus.
    6. Geben Sie bei entsprechender Aufforderung den Git-Benutzernamen und das Kennwort für das Remote-Git-Repository ein.

       Beachten Sie im Fall von GitHub, dass das Kennwort das persönliche Zugriffstoken GitHub ist.

    7. Wenn ein Dialogfeld mit der Meldung "Möchten Sie, dass der Codeeditor regelmäßig "Git fetch" ausführt?" angezeigt wird, wählen Sie Später fragen aus.

    8. Stellen Sie im Terminalfenster des Codeeditors im Verzeichnis mit der Datei func.yaml und den Funktionsquelldateien die Funktion in OCI Functions bereit, indem Sie Folgendes eingeben:

       fn -v deploy --app <application-name>

       Beispiel:

       fn -v deploy --app helloworld-java-app

    9. Rufen Sie im Terminalfenster des Code Editors die Funktion auf, indem Sie Folgendes eingeben:

       fn invoke <application-name> <function-name>

       Beispiel:

       fn invoke helloworld-java-app helloworld-func-java

       Die folgende Meldung wird angezeigt:

       Hi World !

    Die aktualisierte Nachricht bestätigt, dass Sie den Funktionsquellcode im lokalen Git-Repository erfolgreich geändert, das Update in das Remote-Git-Repository übertragen und die Funktion dann bereitgestellt und aufgerufen haben.