Probleme beim Bereitstellen von Anwendungen und Funktionen

Beim Bereitstellen einer Anwendung wird möglicherweise etwa folgende Meldung angezeigt:

$ fn -v deploy --app acme-app

Deploying go-app to app: acme-app
Bumped to version 0.0.2
Building image phx.ocir.io/ansh81vru1zp/acme-repo/go-app:0.0.2
FN_REGISTRY: phx.ocir.io/ansh81vru1zp/acme-repo
Current Context: acme-functions-compartment
Sending build context to Docker daemon 5.12kB
Step 1/10 : FROM fnproject/go:dev as build-stage
Get https://registry-1.docker.io/v2/fnproject/go/manifests/dev: unauthorized: incorrect username or password

Die Meldung gibt einen unnötigen und nicht erfolgreichen Versuch an, sich bei Docker Hub anzumelden. Um dieses Problem zu beheben, melden Sie sich mit dem folgenden Befehl von Docker ab:

docker logout

Nachdem Sie sich von Docker abgemeldet haben, führen Sie den Befehl zum Bereitstellen der Anwendung erneut aus.

Wenn beim Bereitstellen einer Funktion etwa folgende Meldung angezeigt wird, vergewissern Sie sich, dass die FN_REGISTRY-Umgebungsvariable für die Entwicklungsumgebung nicht auf Ihren Docker-Benutzernamen gesetzt ist:

The push refers to repository [docker.io. ...
.
.
.
denied: requested access to the resource is denied
Fn: error running docker push, are you logged into docker?: exit status 1
See fn <command> --help’ for more information.
			

Wenn Sie die Open-Source-Plattform Fn Project verwendet haben, haben Sie möglicherweise die Anweisungen in der Fn-Projekt-Dokumentation zum Festlegen der FN_REGISTRY-Umgebungsvariablen auf Ihren Docker-Benutzernamen befolgen, um eine Interaktion mit der offiziellen Docker-Registry zu ermöglichen (docker.io).

Die FN_REGISTRY-Umgebungsvariable setzt den Wert der Registry-Option im Fn-Projekt-CLI-Kontext außer Kraft.

So verwenden Sie die Fn-Projekt-CLI mit OCI Functions:

• Heben Sie die Festlegung der FN_REGISTRY-Umgebungsvariablen auf.
• Setzen Sie die FN_REGISTRY-Umgebungsvariable mit der globalen Option --registry außer Kraft, wenn Sie einen Fn-Projekt-CLI-Befehl eingeben, der mit Oracle Cloud Infrastructure Registry interagiert.

Wenn Sie eine Funktion bereitstellen, die Sie vorher mit einer früheren Version der Fn-Projekt-CLI erstellt haben, wird möglicherweise etwa folgende Meldung angezeigt:

Fn: [GET /triggers][500] ListTriggers default  &{Fields: Message:Internal server error}

Diese Meldung gibt an, dass die Datei "func.yaml" der Funktion mindestens eine HTTP-Triggerdefinition enthält. OCI Functions unterstützt derzeit keine HTTP-Trigger. Um die Funktion bereitzustellen, entfernen Sie den Abschnitt triggers: aus der Datei "func.yaml".

Um zu vermeiden, dass neue func.yaml-Dateien mit Triggerdefinitionen erstellt werden, befolgen Sie die Anweisungen unter Fn-Projekt-CLI installieren, um ein Upgrade der Fn-Projekt-CLI auf die neueste Version auszuführen.

Beim Bereitstellen einer Funktion mit einer Oracle Cloud Infrastructure-Compute-Instanz als OCI Functions-Entwicklungsumgebung wird möglicherweise eine ähnliche Meldung wie die folgende angezeigt:

Fn: Image phx.ocir.io/ansh81vru1zp/acme-repo/helloworld-func:0.0.2 does not exist or you do not have access to use it.

Diese Meldung gibt an, dass die Compute-Instanz keinen Zugriff auf Oracle Cloud Infrastructure Registry hat.

Prüfen Sie, ob eine Policy-Anweisung (ähnlich wie unten angegeben) im Root-Compartment des Mandanten vorhanden ist, damit eine dynamische Gruppe, die die OCID der Compute-Instanz enthält, auf Oracle Cloud Infrastructure Registry zugreifen kann:

 Allow dynamic-group <dynamic-group-name> to read repos in tenancy

Weitere Informationen zur Verwendung einer Oracle Cloud Infrastructure-Compute-Instanz als Entwicklungsumgebung finden Sie unter Verschiedene Optionen für Funktionsentwicklungsumgebungen.

Wenn Sie eine Funktion in OCI Functions bereitstellen, wird möglicherweise die folgende Meldung angezeigt:

$ fn deploy --app joes-helloworld-app

Deploying helloworld-func to app: joes-helloworld-app
.
.
.
Fn: Missing subnets annotation

Wenn die Meldung Fn: Missing subnets annotation angezeigt wird, bestätigen Sie, dass Sie den richtigen Anwendungsnamen eingegeben haben. Beispiel:

• Die Anwendung ist möglicherweise nicht im aktuell im Fn-Projekt-CLI-Kontext angegebenen Compartment enthalten.
• Die Anwendung war möglicherweise zuvor vorhanden, wurde jedoch später gelöscht.

Wenn Sie eine Funktion in OCI Functions bereitstellen, wird möglicherweise eine Meldung wie die Folgende angezeigt:

$ fn deploy --app joes-helloworld-app

Deploying helloworld-func to app: joes-helloworld-app
.
.
.
Fn: Service error:InvalidParameter. Invalid Invalid image - Function's image architecture 'x86' is incompatible with the application's shape type 'GENERIC_X86_ARM'. http status code: 400. Opc request id:...

Diese Meldung gibt an, dass das Image der Funktion nicht die erforderlichen Abhängigkeiten (untergeordnete Bilder) für die Ausprägung der Anwendung enthält. Eine wahrscheinliche Ursache für die Meldung ist die Verwendung der Fn-Projekt-CLI-Version 0.6.24 (oder früher), um eine Funktion mit einem x86-Image bereitzustellen, um:

• eine Anwendung mit einer Ausprägung mit mehreren Architekturen (wie Generic_X86_ARM)
• eine Anwendung mit einer einzelnen Architekturausprägung, die nicht mit einem x86-Image kompatibel ist (wie Generic_ARM)

Wenn Sie ab Fn-Projekt-CLI-Version 0.6.25 mit dem Befehl fn deploy --app <app-name> eine Funktion erstellen und in OCI Functions bereitstellen, erstellt die Fn-Projekt-CLI das Docker-Image der Funktion mit den erforderlichen Abhängigkeiten für die Ausprägung der Anwendung. Wenn die Anwendung eine Ausprägung mit mehreren Architekturen aufweist (z.B. Generic_X86_ARM, die Standardanwendungsausprägung seit September 2023), erstellt die Fn-Projekt-CLI ein Image mit mehreren Architekturen für die Funktion. Das Image der Funktion und die Ausprägung der Anwendung sind immer kompatibel.

Die Fn-Projekt-CLI-Version 0.6.24 (und früher) erstellt jedoch immer Docker-Images mit den erforderlichen Abhängigkeiten für eine einzelne Architektur, die Architektur x86. Als einzelnes Architekturimage ist ein solches x86-Image nur mit Anwendungen kompatibel, die über die einzelne Architekturausprägung Generic_X86 verfügen. Das Abbild x86 ist nicht mit Anwendungen kompatibel, die Folgendes aufweisen:

• eine Ausprägung mit mehreren Architekturen (wie Generic_X86_ARM, die Standardanwendungsausprägung seit September 2023)
• eine einzelne Architekturausprägung, die nicht Generic_X86 ist (wie Generic_ARM)

Um die Funktion erfolgreich bereitzustellen, müssen Sie ein Image angeben, das mit der Ausprägung der Anwendung kompatibel ist. Führen Sie einen der folgenden Schritte aus:

• Verwenden Sie die Fn-Projekt-CLI-Version 0.6.25 oder höher (empfohlen).
• Stellen Sie die Funktion in einer anderen Anwendung mit einer Ausprägung bereit, die mit dem Image der Funktion kompatibel ist (erstellen Sie bei Bedarf eine neue Anwendung). Angenommen, Sie verwenden die Fn-Projekt-CLI-Version 0.6.24 oder früher, stellen Sie die Funktion immer in einer Anwendung mit einer Ausprägung Generic_X86 bereit.
• Mit Docker können Sie ein Image erstellen, das mit der Architekturausprägung der Anwendung kompatibel ist.

Weitere Informationen finden Sie unter Compute-Architektur für die Ausführung von Funktionen angeben.

Wenn Sie eine Funktion in OCI Functions in der Cloud Shell-Entwicklungsumgebung bereitstellen, wird möglicherweise eine Meldung wie die Folgende angezeigt:

OL8 CloudShell does not support cross-compilation and multi-arch functions builds. Please ensure the architecture of your App matches the CloudShell architecture.

Diese Meldung gibt an, dass die Funktion auf einem Image mit mehreren Architekturen basiert, dass die Anwendung eine Ausprägung mit mehreren Architekturen aufweist oder dass die Cloud Shell-Session und die Anwendung eine andere Architektur aufweisen.

In der Cloud Shell-Entwicklungsumgebung unterstützt OCI Functions weder das Erstellen und Deployment von Funktionen auf Basis von Images mit mehreren Architekturen noch Anwendungen mit Ausprägungen mit mehreren Architekturen. Darüber hinaus muss die Architektur der Cloud Shell-Session mit der Architektur der Anwendung identisch sein.

Weitere Informationen:

• Informationen zum Erstellen einer Funktion, die auf einem einzelnen Architekturimage basiert, in einer Anwendung mit einer kompatiblen Ausprägung einer einzelnen Architektur finden Sie unter Compute-Architektur angeben, auf der Funktionen ausgeführt werden sollen.
• Informationen zum Auswählen der Architektur der Cloud Shell-Session finden Sie unter Cloud Shell-Architektur.

Wenn Sie eine Funktion in OCI Functions bereitstellen, wird möglicherweise eine Meldung wie die Folgende angezeigt:

$ fn -v deploy --app acme-app

Fn: Service error:InvalidParameter. Invalid or unsupported image manifest. Unable to get architecture from the OCIR Manifest/Headers. http status code: 400.

Es gibt eine Reihe von möglichen Ursachen und Lösungen, wie in diesem Abschnitt beschrieben.

docker version

docker manifest inspect --verbose <image-path>

docker manifest inspect --verbose phx.ocir.io/ansh81vru1zp/acme-repo/acme-func:0.0.3