Schnellstart von Functions auf lokalem Host

Falls noch keine geeigneten Benutzer und Gruppen vorhanden sind:

1. Melden Sie sich als Mandantenadministrator bei der Konsole an.
2. Öffnen Sie das Navigationsmenü , und wählen Sie Identität und Sicherheit aus. Wählen Sie unter Identität die Option Domains aus.
3. Wählen Sie eine Domain aus, und wählen Sie die Registerkarte Benutzerverwaltung.
4. Erstellen Sie eine neue Gruppe, indem Sie im Abschnitt Gruppen die Option Gruppe erstellen auswählen.
5. Erstellen Sie einen neuen Benutzer, indem Sie im Abschnitt Benutzer die Option Erstellen auswählen.
6. Fügen Sie einen Benutzer zu einer Gruppe hinzu, indem Sie den Namen der Gruppe und dann auf der Registerkarte Benutzer die Option Benutzer zu Gruppe zuweisen auswählen.

Weitere Informationen finden Sie unter Konfigurationshinweise.

Wenn noch kein geeignetes Compartment zum Erstellen von Netzwerkressourcen und OCI Functions-Ressourcen vorhanden ist:

1. Melden Sie sich als Mandantenadministrator bei der Konsole an.
2. Öffnen Sie das Navigationsmenü , und wählen Sie Identität und Sicherheit aus. Wählen Sie unter Identität die Option Compartments aus.
3. Wählen Sie Compartment erstellen aus.

Weitere Informationen finden Sie unter Konfigurationshinweise.

Wenn noch kein geeignetes VCN zum Erstellen von Netzwerkressourcen vorhanden ist:

Weitere Informationen finden Sie unter Konfigurationshinweise.

Wenn mindestens ein OCI Functions-Benutzer kein Mandantenadministrator ist:

1. Melden Sie sich als Mandantenadministrator bei der Konsole an.
2. Öffnen Sie das Navigationsmenü , und wählen Sie Identität und Sicherheit aus. Wählen Sie unter Identität die Option Policys aus.

3. Wählen Sie Policy erstellen aus, geben Sie einen Namen und eine Beschreibung für die neue Policy an, und wählen Sie das Root Compartment des Mandanten aus.

4. Erstellen Sie die Policy mit Policy Builder. Wählen Sie in der Liste der Policy-Anwendungsfälle die Option Funktionen aus, und basieren Sie die Policy auf der Policy-Vorlage Erstellen, Bereitstellen und Verwalten von Funktionen und Anwendungen durch Benutzer zulassen.

   Die Policy-Vorlage umfasst die folgenden Policy-Anweisungen:

   • Allow group <group-name> to use cloud-shell in tenancy
   • Gruppe <group-name> das Verwalten von Repositorys im Mandanten erlauben
   • Allow group <group-name> to read objectstorage-namespaces in tenancy
   • Allow group <group-name> to manage logging-family in tenancy
   • Allow group <group-name> to read metrics in tenancy
   • Allow group <group-name> to manage functions-family in tenancy
   • Allow group <group-name> to use virtual-network-family in tenancy
   • Allow group <group-name> to use apm-domains in tenancy
   • Allow group <group-name> to read vaults in tenancy
   • Allow group <group-name> to use keys in tenancy
   • Allow service faas to use apm-domains in tenancy
   • Allow service faas to read repos in tenancy where request.operation='ListContainerImageSignatures'
   • Allow service faas to {KEY_READ} in tenancy where request.operation='GetKeyVersion'
   • Allow service faas to {KEY_VERIFY} in tenancy where request.operation='Verify'

   Bei Bedarf können Sie diese Policy-Anweisungen nach Compartment einschränken.

Weitere Informationen finden Sie unter Konfigurationshinweise.

1. Melden Sie sich als Funktionsentwickler in der Konsole an.
2. Öffnen Sie das Navigationsmenü , und wählen Sie Entwicklerservices aus. Wählen Sie unter Funktionen die Option Anwendungen aus.
3. Wählen Sie die Region aus, die Sie mit OCI Functions verwenden.
4. Wählen Sie Anwendung erstellen aus.
5. Geben Sie Folgendes an:
   • helloworld-app als Name für die neue Anwendung. Sie stellen Ihre erste Funktion in dieser Anwendung bereit und geben diese Anwendung beim Aufrufen der Funktion an.
   • Das VCN und das Subnetz, in denen die Funktion ausgeführt werden soll. Beachten Sie, dass für ein öffentliches Subnetz ein Internetgateway im VCN erforderlich ist und für ein privates Subnetz ein Servicegateway im VCN erforderlich ist.
6. Wählen Sie Erstellen.

Weitere Informationen finden Sie in detaillierte Anweisungen.

In einem Terminalfenster in Ihrer Entwicklungsumgebung:

1. Bestätigen Sie die Installation von Docker, indem Sie Folgendes eingeben:

   docker version

   Wenn eine Fehlermeldung angezeigt wird, die besagt, dass Docker nicht installiert ist, müssen Sie Docker installieren, bevor Sie fortfahren. Informationen zu Ihrer Plattform finden Sie in der Docker-Dokumentation (Oracle Linux finden Sie hier).

   Wenn Docker installiert ist, gehen Sie zum Abschnitt "Prerequisites" der Fn-Projekthomepage auf GitHub, und bestätigen Sie, dass die installierte Version von Docker mindestens die dort angegebene Mindestversion ist. Falls nicht, installieren Sie Docker neu, bevor Sie fortfahren.

2. Starten Sie das standardmäßige Docker-Image "hello-world" als Container, um zu bestätigen, dass Docker ausgeführt wird, indem Sie Folgendes eingeben:

   docker run hello-world

   Wenn eine Fehlermeldung angezeigt wird, die besagt, dass Docker nicht ausgeführt wird, müssen Sie den Docker-Daemon starten, bevor Sie fortfahren. Weitere Informationen finden Sie in der Docker-Dokumentation.

Weitere Informationen finden Sie unter Konfigurationshinweise.

1. Melden Sie sich als Funktionsentwickler in der Konsole an.
2. Wählen Sie im Navigationsmenü das Menü Profil aus, und wählen Sie je nach der angezeigten Option Benutzereinstellungen oder Mein Profil aus.
3. Wählen Sie die Registerkarte Token und Schlüssel, gehen Sie zum Abschnitt API-Schlüssel, und wählen Sie API-Schlüssel hinzufügen aus.
4. Wählen Sie im Bereich API-Schlüssel hinzufügen die Option API-Schlüsselpaar generieren aus.
5. Wählen Sie Private Key herunterladen, und speichern Sie die Private-Key-Datei (als .pem-Datei) im Verzeichnis ~/.oci. (Wenn das Verzeichnis ~/.oci noch nicht vorhanden ist, erstellen Sie es jetzt.)
6. Wählen Sie Hinzufügen aus, um den neuen API-Signaturschlüssel zu Ihren Benutzereinstellungen hinzuzufügen.

   Das Dialogfeld Vorschau der Konfigurationsdatei wird angezeigt. Es enthält ein Konfigurationsdatei-Snippet mit grundlegenden Authentifizierungsinformationen für ein Profil namens DEFAULT (einschließlich des Fingerprints des gerade erstellten API-Signaturschlüssels).

7. Kopieren Sie das im Textfeld gezeigte Konfigurationsdatei-Snippet, und schließen Sie das Dialogfeld Vorschau der Konfigurationsdatei.
8. Öffnen Sie in einem Texteditor die Datei ~/.oci/config, und fügen Sie das Snippet in die Datei ein. (Wenn die Datei ~/.oci/config noch nicht vorhanden ist, erstellen Sie sie jetzt.)
9. Ändern Sie im Texteditor das Profil in dem soeben eingefügten Snippet wie folgt:
   • Ändern Sie den Namen des Profils von [DEFAULT] in einen Namen Ihrer Wahl (z.B. [functions-developer-profile]). Beachten Sie, dass die Datei ~/.oci/config nicht zwei Profile mit demselben Namen enthalten darf.
   • Ändern Sie den Wert des Parameters key_file des Profils, um den Pfad der zuvor heruntergeladenen Private-Key-Datei (PEM-Datei) anzugeben.
10. Speichern Sie im Texteditor die Änderungen, die Sie an der Datei ~/.oci/config vorgenommen haben, und schließen Sie den Texteditor.
11. Ändern Sie in einem Terminalfenster die Berechtigungen für die Private-Key-Datei (PEM-Datei), um sicherzustellen, dass nur Sie sie lesen können, indem Sie Folgendes eingeben:

    chmod go-rwx ~/.oci/<private-key-file-name>.pem

Weitere Informationen zum Einrichten eines API-Signaturschlüssels und zum Erstellen eines Profils finden Sie in den Konfigurationshinweisen.

In einem Terminalfenster in Ihrer Entwicklungsumgebung:

1. Installieren Sie die Fn-Projekt-CLI mit den entsprechenden Anweisungen unten für Ihre Umgebung:
   • Linux oder MacOS: Geben Sie Folgendes ein:

     curl -LSs https://raw.githubusercontent.com/fnproject/cli/master/install | sh

   • MacOS mit Homebrew: Geben Sie Folgendes ein:

     brew update && brew install fn

   • Windows: Befolgen Sie die Anweisungen unter Fn-Client auf GitHub installieren.
   • Linux, MacOS oder Windows: Laden Sie die Binärdatei von der Seite Fn-Projektreleases auf GitHub herunter, und führen Sie sie aus.
2. Prüfen Sie, ob die Fn-Projekt-CLI installiert wurde, indem Sie Folgendes eingeben:

   fn version

Weitere Informationen finden Sie unter Konfigurationshinweise.

In einem Terminalfenster in Ihrer Entwicklungsumgebung:

1. Erstellen Sie einen neuen Fn-Projekt-CLI-Kontext, indem Sie Folgendes eingeben:

   fn create context <my-context> --provider oracle

   Beachten Sie, dass Sie --provider oracle angeben, um die Authentifizierung und Autorisierung mit der Oracle Cloud Infrastructure-Anforderungssignatur, privaten Schlüsseln, Benutzergruppen und Policys, die diesen Benutzergruppen Berechtigungen erteilen, zu aktivieren.

2. Geben Sie an, dass die Fn-Projekt-CLI den neuen Kontext verwenden soll. Geben Sie dazu Sie Folgendes ein:

   fn use context <my-context>

3. Konfigurieren Sie den neuen Fn-Projekt-CLI-Kontext mit dem Namen des OCI-Profils, das Sie zur Verwendung mit OCI Functions erstellt haben (z.B. [functions-developer-profile]), indem Sie Folgendes eingeben:

   fn update context oracle.profile <profile-name>

Weitere Informationen finden Sie unter Konfigurationshinweise.

In einem Terminalfenster in Ihrer Entwicklungsumgebung:

1. Konfigurieren Sie den neuen Fn-Projekt-CLI-Kontext mit der OCID des Compartments, für das Sie bereitgestellte Funktionen besitzen möchten

   fn update context oracle.compartment-id <compartment-ocid>

2. Konfigurieren Sie den neuen Kontext mit dem API-URL-Endpunkt, der beim Aufrufen der OCI-API verwendet werden soll. Geben Sie dazu Folgendes ein:

   fn update context api-url <api-endpoint>

   Dabei ist <api-endpoint> einer der Endpunkte in der Liste der Functions-Endpunkte in der Functions-API im Format https://functions.<region-identifier>.oci.oraclecloud.com. Beispiel:

   fn update context api-url https://functions.us-phoenix-1.oci.oraclecloud.com

3. Konfigurieren Sie den Fn-Projekt-CLI-Kontext mit der Oracle Cloud Infrastructure Registry-Adresse in der aktuellen Region und dem aktuellen Mandanten, die Sie mit OCI Functions verwenden möchten:

   fn update context registry <region-key>.ocir.io/<tenancy-namespace>/<repo-name-prefix>

   Dabei ist <repo-name-prefix> ein Präfix Ihrer Wahl für das Oracle Cloud Infrastructure Registry-Repository, in dem Images für die Funktion gespeichert werden sollen. Beispiel:

   fn update context registry phx.ocir.io/ansh81vru1zp/acme-repo

4. Konfigurieren Sie den Fn-Projekt-CLI-Kontext mit der OCID des Compartments für Repositorys, an die und von denen OCI Functions Funktionsimages übertragen und abrufen soll, indem Sie Folgendes eingeben:

   fn update context oracle.image-compartment-id <compartment-ocid>

   Beispiel:

   fn update context oracle.image-compartment-id ocid1.compartment.oc1..aaaaaaaaquqe______z2q

   Wenn Sie keinen Wert für oracle.image-compartment-id angeben, überträgt und ruft OCI Functions Images in und aus Repositorys im Root Compartment ab.

Weitere Informationen finden Sie unter Konfigurationshinweise.

1. Melden Sie sich als Funktionsentwickler in der Konsole an.
2. Wählen Sie im Navigationsmenü das Menü Profil aus, und wählen Sie je nach der angezeigten Option Benutzereinstellungen oder Mein Profil aus.
3. Wählen Sie die Registerkarte Token und Schlüssel aus, gehen Sie zum Abschnitt Authentifizierungstoken, und wählen Sie Token generieren aus.
4. Geben Sie im Dialogfeld Token generieren eine aussagekräftige Beschreibung für das Authentifizierungstoken ein, und wählen Sie Token generieren aus. Das neue Authentifizierungstoken wird angezeigt.
5. Kopieren Sie das Authentifizierungstoken sofort in einen sicheren Speicherort, aus dem Sie es später abrufen können, da das Authentifizierungstoken nicht mehr in der Konsole angezeigt wird.
6. Schließen Sie das Dialogfeld Token generieren.

Weitere Informationen finden Sie unter Konfigurationshinweise.

Gehen Sie im Bereich Lokales Setup in der Konsole wie folgt vor:

1. Kopieren 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

   Wenn Ihr Mandant mit Oracle Identity Cloud Service föderiert wird, unterscheidet sich das Format geringfügig. Beispiel:

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

2. Fügen Sie im Terminalfenster den soeben kopierten Befehl ein, und führen Sie ihn aus.

3. Wenn Sie zur Eingabe eines Kennworts aufgefordert werden, geben Sie das Oracle Cloud Infrastructure-Authentifizierungstoken ein, das Sie zuvor erstellt und kopiert haben. Beispiel: 6aN...6MqX

   Sie können jetzt mit dem Erstellen, Bereitstellen und Aufrufen von Funktionen beginnen.

Weitere Informationen finden Sie unter Konfigurationshinweise.

Im Terminalfenster:

1. Erstellen Sie eine helloworld-java-Funktion, indem Sie Folgendes eingeben:

   fn init --runtime java hello-java

   Es wird ein Verzeichnis namens hello-java erstellt, das Folgendes enthält:

   • eine Funktionsdefinitionsdatei mit dem Namen func.yaml
   • ein/src-Verzeichnis mit Quelldateien und Verzeichnissen für die helloworld-Funktion
   • eine Maven-Konfigurationsdatei mit dem Namen pom.xml, in der die zum Kompilieren der Funktion erforderlichen Abhängigkeiten angegeben sind

   Java ist nur eine von mehreren unterstützten Sprachen.

   Weitere Informationen finden Sie in detaillierte Anweisungen.

Im Terminalfenster:

1. Wechseln Sie in das im vorherigen Schritt erstellte Verzeichnis hello-java:

   cd hello-java

2. Geben Sie den folgenden einzelnen Fn-Projektbefehl ein, um die Funktion und ihre Abhängigkeiten als Docker-Image mit dem Namen "hello-java" zu erstellen, das Image in die angegebene Docker-Registry zu übertragen und die Funktion in OCI Functions in der zuvor erstellten Anwendung "helloworld-app" bereitzustellen:

   fn -v deploy --app helloworld-app

3. (Optional) Bestätigen Sie, dass die Funktion in OCI Functions bereitgestellt wurde. Wählen Sie dazu die Registerkarte Funktionen (auf der Detailseite für die helloworld-app-Anwendung) aus, und beachten Sie, dass die hello-java-Funktion jetzt angezeigt wird.

Weitere Informationen finden Sie in detaillierte Anweisungen.

Im Terminalfenster:

1. Rufen Sie die hello-java-Funktion auf, indem Sie Folgendes eingeben:

   fn invoke helloworld-app hello-java

   Die Meldung "Hello world!" wird angezeigt.

2. Rufen Sie die hello-java-Funktion mit dem Parameter 'John' auf, indem Sie Folgendes eingeben:

   echo -n 'John' | fn invoke helloworld-app hello-java

   Die Meldung "Hello John!" wird angezeigt.

Herzlichen Glückwunsch! Sie haben gerade Ihre erste Funktion mit OCI Functions erstellt, bereitgestellt und aufgerufen.

Weitere Informationen finden Sie in detaillierte Anweisungen.

Nachdem Sie eine Funktion erstellt, bereitgestellt und aufgerufen haben, lernen Sie Folgendes:

• Funktionslogs im Oracle Cloud Infrastructure Logging-Service anzeigen oder eine Syslog-URL konfigurieren (siehe Funktionslogs speichern und anzeigen)
• OCI Functions mit Beispielen auf GitHub untersuchen (siehe Oracle Functions-Beispiele)
• Funktion mit SDKs aufrufen (siehe Funktionen mit SDKs aufrufen)

Sie sind fertig!