Functions: Erste Schritte mit Cloud Shell
In diesem Tutorial verwenden Sie einen Oracle Cloud Infrastructure-Account, um die Oracle Functions-Entwicklung mit Cloud Shell einzurichten. Anschließend erstellen Sie eine Funktionsanwendung und eine Funktion.
Zu den wichtigsten Aufgaben gehören:
- Authentifizierungstoken einrichten.
- Erforderliche Informationen erfassen.
- VCN einrichten.
- Bei OCI Registry (OCIR) anmelden.
- Cloud Shell für das Deployment von Funktionen konfigurieren.
- Fn-Kontext konfigurieren.
- Anwendung für Ihre Oracle-Funktion erstellen.
- Funktion erstellen.
- Funktion bereitstellen.
- Funktion testen.

Weitere Informationen finden Sie hier:
Bevor Sie beginnen
Für eine erfolgreiche Ausführung des Tutorials benötigen Sie Folgendes:
- Ein kostenpflichtiger Oracle Cloud Infrastructure-Account. Siehe Für Oracle Cloud Infrastructure registrieren.
- Ihr OCI-Account wurde so konfiguriert, dass er Oracle Functions-Entwicklung unterstützt. Siehe Kurzanleitung "Oracle Functions on Cloud Shell".
- OCI Cloud Shell ist in ihrem Account enthalten und umfasst Folgendes:
- OCI-CLI
- Docker
- Python 3.6+
- Java 1.8+
- Node.js 10+
1. Erforderliche Informationen erfassen
Erfassen Sie alle Informationen, die Sie für den Abschluss des Tutorials benötigen.
Bereiten Sie die benötigten Informationen in der OCI-Konsole vor.
- Suchen Sie unter Regionen und Availability-Domains nach der Regions-ID und dem Regionsschlüssel.
Beispiel:
us-ashburn-1
undiad
für Ashburn. - Erstellen Sie einen Registry-Projektnamen, um Ihre Funktionsimages in OCI Registry (OCIR) zu speichern.
Wenn Sie eine Funktion veröffentlichen, wird ein Docker-Image in OCIR erstellt. Ihr OCIR-Projektname wird Ihren Funktionsimages vorangestellt, damit Sie sie leichter finden. Beispiele:
- Registry-Projektname:
my-func-prj
- Funktionsname:
node-func
Ihr Funktionsimage würde dann in OCIR unter
my-func-prj/node-func
gespeichert werden. - Registry-Projektname:
Informationen zum Erstellen eines Compartments finden Sie unter Compartment erstellen. Nachdem das Compartment erstellt wurde, speichern Sie die Compartment-OCID.
So rufen Sie die Compartment-OCID aus einem vorhandenen Compartment ab:
- Öffnen Sie das Navigationsmenü, und klicken Sie auf Identität und Sicherheit. Klicken Sie unter Identität auf Compartments.
- Wählen Sie Ihr Compartment aus.
- Klicken Sie neben dem Feld "OCID" auf den Link Kopieren.
Erstellen Sie ein Autorisierungstoken für die Anmeldung bei OCI Registry. So erstellen Sie ein Autorisierungstoken:
Erfassen Sie alle Informationen, die Sie für den Abschluss des Tutorials benötigen. Kopieren Sie die folgenden Informationen in Notepad.
2. Virtuelles Cloud-Netzwerk (VCN) erstellen
Richten Sie ein VCN ein, um Ihre Linux-Instanz mit dem Internet zu verbinden.
Führen Sie zum Konfigurieren des virtuellen Cloud-Netzwerks die folgenden Schritte aus.
Um einen anderen Port zu öffnen, ersetzen Sie 80 im letzten Schritt durch die Portnummer.
3. Bei OCI Registry anmelden
Als Nächstes melden Sie Docker bei OCI Registry (OCIR) an.
- Rufen Sie die zuvor erfassten Informationen ab.
- Öffnen Sie ein Terminalfenster.
- Melden Sie sich bei OCIR an:
docker login <region-key>.ocir.io
Sie werden zur Eingabe Ihres Anmeldenamens und Kennwortes aufgefordert.
- Benutzer:
<tenancy-name>/<user-name>
- Kennwort:
<auth-token>
- Benutzer:
Sie haben Ihre Instanz bei OCIR angemeldet.
4. Functions konfigurieren
Damit Sie Oracle Functions verwenden können, müssen Sie den Fn-Anwendungskontext konfigurieren. Der Kontext speichert die Werte, die für die Verbindung mit dem Oracle Functions-Service erforderlich sind. Mit Fn-Clientbefehlen werden die erforderlichen Konfigurationsdaten hinzugefügt.
Sie benötigen die Informationen, die Sie zuvor erfasst haben. Verwenden Sie Fn-Clientbefehle, um Fn zu konfigurieren.
Kontext anzeigen/bearbeiten
Ihre Fn-Kontextdateien befinden sich im Verzeichnis ~/.fn/contexts
. Jeder Kontext wird in einer .yaml
-Datei gespeichert. Beispiel: Die Datei us-phoenix-1.yaml
könnte wie folgt aussehen:
api-url: https://functions.us-phoenix-1.oci.oraclecloud.com
oracle.compartment-id: ocid1.compartment.oc1..aaaaaaaarvdfa72n...
provider: oraclecs
registry: phx.ocir.io/my-tenancy/my-func-prj
Sie können die Datei bei Bedarf direkt mit einem Editor bearbeiten.
Eine detaillierte Erläuterung der einzelnen Schritte finden Sie unter: Kurzanleitung "Oracle Functions on Cloud Shell"
Sie haben jetzt den Fn-Kontext für Ihre Instanz eingerichtet.
5. Funktion erstellen und bereitstellen
Erstellen Sie nach Abschluss der Konfiguration eine Funktion, und stellen Sie diese bereit.
Eine Anwendung ist der Hauptspeichercontainer für Funktionen. Jede Funktion muss über eine Anwendung für das Deployment verfügen. So erstellen Sie die Anwendung:
- Öffnen Sie das Navigationsmenü, und klicken Sie auf Entwicklerservices. Klicken Sie unter Functions auf Anwendungen.
- Klicken Sie auf Anwendung erstellen.
Geben Sie die Formulardaten ein.
- Name: <your-app-name>
- VCN: <your-VCN>
- Subnetze: <your-public-subnet> oder <your-private-subnet>
Hinweis
Wählen Sie entweder ein öffentliches oder ein privates Subnetz aus. - Klicken Sie auf Erstellen.
Ihre Anwendung wird erstellt.
Sprache auswählen
Wählen Sie eine der folgenden Sprachen aus, um eine Funktion zu erstellen und bereitzustellen. Wenn Sie möchten, können Sie alle drei auswählen.
Nachdem Ihre Anwendung erstellt wurde, können Sie eine Java-Funktion bereitstellen. So erstellen Sie eine "Hello World"-Java-Funktion:
Sie können die folgenden Schritte nur ausführen, wenn Java 8+ installiert ist.
Sie haben erfolgreich eine Java-Funktion bereitgestellt und getestet.
Nachdem Ihre Anwendung erstellt wurde, können Sie eine Python-Funktion bereitstellen. So erstellen Sie eine "Hello World"-Python-Funktion:
Sie haben erfolgreich eine Python-Funktion bereitgestellt und getestet.
Nachdem Ihre Anwendung erstellt wurde, können Sie eine Node-Funktion bereitstellen. So erstellen Sie eine "Hello World"-Node-Funktion:
Sie können die folgenden Schritte nur ausführen, wenn Node.js 10+ installiert ist.
Sie haben erfolgreich eine Node-Funktion bereitgestellt und getestet.
6. Funktionsinformationen prüfen
Sobald Ihre Funktionen ausgeführt werden, sind Informationen zu ihnen in der OCI-Konsole verfügbar.
Beim Deployment wird die Funktion hochgeladen und in OCIR gespeichert. Sie können zu OCIR navigieren und die Funktionsimages prüfen.
- Öffnen Sie das Navigationsmenü, und klicken Sie auf Entwicklerservices. Klicken Sie unter Container und Artefakte auf Container Registry.
- Suchen Sie nach
<your-repository-project-name>
. - Unter Ihrem Projektnamen wird für jede von Ihnen bereitgestellte Funktion ein Eintrag angezeigt.
- Klicken Sie auf den Link neben einem Image, zu dem Sie Informationen anzeigen möchten.
Sobald Sie eine Funktion ausführen, können Sie Metriken zu dieser Funktion anzeigen.
- Öffnen Sie das Navigationsmenü, und klicken Sie auf Entwicklerservices. Klicken Sie unter Functions auf Anwendungen. Ihre Anwendungen werden auf der Seite aufgeführt.
- Klicken Sie auf den Link zur Anwendung, die Sie erstellt haben.
- Klicken Sie auf den Link zur Funktion, die Sie prüfen möchten.
Es werden Metrikinformationen zu Ihrer Funktion angezeigt.
So aktivieren Sie das Logging für eine Anwendung:
- Öffnen Sie das Navigationsmenü, und klicken Sie auf Entwicklerservices. Klicken Sie unter Functions auf Anwendungen. Ihre Anwendungen werden auf der Seite aufgeführt.
- Klicken Sie auf den Link zur Anwendung, die Sie erstellt haben.
- Klicken Sie auf der linken Seite der Anwendungsseite auf den Link Logs.
- Klicken Sie auf Deaktiviert, um das Logging für Ihre Anwendung zu aktivieren.
- Das Dialogfeld Log aktivieren wird angezeigt. Geben Sie die folgenden Informationen ein:
- Compartment: <your-compartment-name>
- Loggruppe: Übernehmen Sie den Standardwert
Auto-Create a Default Log Group
. - Logname:
<take-default>
- Logerhaltung:
<take-default>
- Klicken Sie auf Log aktivieren.
Warten Sie einen Moment, bis das Log erstellt wird.
Um das Log anzuzeigen, klicken Sie auf den durch die vorangegangenen Schritte erstellten Link mit dem Lognamen.
Weitere Schritte
Sie haben erfolgreich eine Funktion erstellt und in Oracle Functions bereitgestellt.
Weitere Informationen zur Entwicklung mit Oracle-Produkten finden Sie auf folgenden Websites: