Problèmes de déploiement d'applications et de fonctions

Lors du déploiement d'une application, un message similaire à celui qui suit est affiché :

$ 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

Le message indique une tentative de connexion inutile et infructueuse à Docker Hub. Pour résoudre ce problème, déconnectez-vous de Docker à l'aide de la commande suivante :

docker logout

Après vous être déconnecté de Docker, exécutez de nouveau la commande pour déployer l'application.

Si vous voyez un message similaire à celui qui suit lors du déploiement d'une fonction, vérifiez que votre environnement de développement ne comporte pas la variable d'environnement FN_REGISTRY réglée à votre nom d'utilisateur Docker :

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.
			

Si vous avez utilisé la plate-forme Fn Project à source ouverte, vous avez peut-être suivi des instructions dans la documentation sur Fn Project pour régler la variable d'environnement FN_REGISTRY à votre nom d'utilisateur Docker afin de permettre l'interaction avec le registre Docker officiel (docker.io).

La variable d'environnement FN_REGISTRY remplace la valeur de l'option de registre dans votre contexte d'interface de ligne de commande Fn Project.

Pour utiliser l'interface de ligne de commande Fn Project avec le service des fonctions pour OCI, procédez de l'une des façons suivantes :

• Annulez la définition de la variable d'environnement FN_REGISTRY.
• Remplacez la variable d'environnement FN_REGISTRY à l'aide de l'option globale --registry chaque fois que vous entrez une commande d'interface de ligne de commande Fn Project qui interagit avec Oracle Cloud Infrastructure Registry.

Lors du déploiement d'une fonction que vous avez précédemment créée à l'aide d'une version antérieure de l'interface de ligne de commande Fn Project, vous pourriez voir un message similaire à celui qui suit :

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

Ce message indique que le fichier func.yaml de la fonction contient une ou plusieurs définitions de déclencheur HTTP. Le service des fonctions pour OCI ne prend pas en charge les déclencheurs HTTP actuellement. Pour déployer la fonction, supprimez la section triggers: du fichier func.yaml.

Pour ne pas créer de nouveaux fichiers func.yaml contenant des définitions de déclencheur, suivez les instructions sous Installation de l'interface de ligne de commande Fn Project pour mettre à jour l'interface de ligne de commande Fn Project vers la version la plus récente.

Lors du déploiement d'une fonction à l'aide d'une instance de calcul Oracle Cloud Infrastructure en tant qu'environnement de développement du service des fonctions pour OCI, vous pourriez voir un message similaire à celui qui suit :

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.

Ce message indique que l'instance de calcul n'a pas accès à Oracle Cloud Infrastructure Registry.

Vérifiez qu'un énoncé de politique (similaire à celui ci-dessous) existe dans le compartiment racine de la location pour permettre à un groupe dynamique qui inclut l'OCID de l'instance de calcul d'accéder à Oracle Cloud Infrastructure Registry :

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

Pour plus d'informations sur l'utilisation d'une instance de calcul Oracle Cloud Infrastructure comme environnement de développement, voir Options différentes pour les environnements de développement de fonction.

Lorsque vous déployez une fonction dans le service des fonctions pour OCI, vous pourriez voir le message suivant :

$ fn deploy --app joes-helloworld-app

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

Si vous voyez le message Fn: Missing subnets annotation, vérifiez que vous avez entré un nom d'application correct. Par exemple :

• L'application pourrait ne pas se trouver dans le compartiment actuellement spécifié par le contexte de l'interface de ligne de commande Fn Project.
• Il est possible que l'application ait déjà existé mais qu'elle ait été ensuite supprimée.

Lorsque vous déployez une fonction dans le service des fonctions pour OCI, vous pourriez voir le message suivant :

Getting image source signatures Error: trying to reuse blob ... at destination: checking whether a blob ... exists in .... :StatusCode: 403, Fn: error running docker push: exit status 125

Ce message indique que, bien que votre location soit fédérée avec Oracle Identity Cloud Service, le nom d'utilisateur que vous avez fourni lors de votre connexion à Oracle Cloud Infrastructure Registry n'incluait pas de nom de domaine d'identité.

Vous avez probablement fourni un nom d'utilisateur au format <tenancy-namespace>/<user-name>, dans une commande telle que :

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

Par exemple :

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

Toutefois, comme votre location est fédérée avec Oracle Identity Cloud Service, vous devez utiliser un format de commande légèrement différent qui inclut le nom du domaine d'identité, dans le format <tenancy-namespace>/<domain-name>/<user-name>.

Par exemple :

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

Pour déployer la fonction, entrez de nouveau la commande docker login et spécifiez le nom d'utilisateur dans le format correct, y compris le nom du domaine d'identité.

Pour plus d'informations, voir Connexion à Oracle Cloud Infrastructure Registry.

Lorsque vous déployez une fonction dans le service des fonctions pour OCI, vous pourriez voir un message similaire à celui qui suit :

$ 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:...

Ce message indique que l'image de la fonction n'inclut pas les dépendances nécessaires (images enfants) pour la forme de l'application. Une cause probable du message est l'utilisation de l'interface de ligne de commande Fn Project version 0.6.24 (ou antérieure) pour déployer une fonction avec une image x86 pour :

• une application ayant une forme multiarchitecture (par exemple, Generic_X86_ARM)
• une application ayant une forme d'architecture unique qui n'est pas compatible avec une image x86 (par exemple, Generic_ARM)

À partir de la version 0.6.25 de l'interface de ligne de commande Fn Project, lorsque vous utilisez la commande fn deploy --app <app-name> pour créer une fonction et la déployer dans le service des fonctions pour OCI, l'interface de ligne de commande Fn Project crée l'image Docker de la fonction avec les dépendances nécessaires pour la forme de l'application. Si l'application a une forme à architecture multiple (par exemple, Generic_X86_ARM, la forme d'application par défaut depuis septembre 2023), l'interface de ligne de commande Fn Project crée une image à architecture multiple pour la fonction. L'image de la fonction et la forme de l'application sont toujours compatibles.

Toutefois, l'interface de ligne de commande Fn Project version 0.6.24 (et antérieure) crée toujours des images Docker avec les dépendances nécessaires pour une architecture unique, l'architecture x86. En tant qu'image d'architecture unique, une telle image x86 n'est compatible qu'avec les applications ayant la forme d'architecture unique Generic_X86. L'image x86 est incompatible avec les applications qui ont :

• une forme à architecture multiple (par exemple, Generic_X86_ARM, la forme d'application par défaut depuis septembre 2023)
• une forme d'architecture unique qui n'est pas Generic_X86 (par exemple, Generic_ARM)

Pour déployer la fonction avec succès, vous devez fournir une image compatible avec la forme de l'application. Effectuez l'une des actions suivantes :

• Utilisez l'interface de ligne de commande Fn Project version 0.6.25 ou ultérieure (recommandé).
• Déployez la fonction dans une autre application ayant une forme compatible avec l'image de la fonction (créez une nouvelle application si nécessaire). En supposant que vous utilisez l'interface de ligne de commande Fn Project version 0.6.24 ou antérieure, déployez toujours la fonction dans une application ayant une forme Generic_X86.
• Utilisez Docker pour créer une image compatible avec la forme d'architecture de l'application.

Pour plus d'informations, voir Spécification de l'architecture de calcul sur laquelle exécuter les fonctions.

Lorsque vous déployez une fonction dans le service des fonctions pour OCI dans l'environnement de développement Cloud Shell, vous pouvez voir un message similaire à ce qui suit :

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

Ce message indique que la fonction est basée sur une image multiarchitecture, ou que l'application a une forme multiarchitecture, ou que la session Cloud Shell et l'application ont une architecture différente.

Dans l'environnement de développement Cloud Shell, OCI Functions ne prend pas en charge la création et le déploiement de fonctions basées sur des images à plusieurs architectures, ni d'applications avec des formes à plusieurs architectures. En outre, l'architecture de la session Cloud Shell doit être identique à celle de l'application.

Pour plus d'informations :

• Pour créer une fonction basée sur une seule image d'architecture, dans une application qui a une forme d'architecture unique compatible, voir Spécification de l'architecture de calcul sur laquelle exécuter des fonctions.
• À propos de la sélection de l'architecture de la session Cloud Shell, voir Architecture Cloud Shell.

Lorsque vous déployez une fonction dans le service des fonctions pour OCI, vous pourriez voir un message similaire à ce qui suit :

$ 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.

Il existe un certain nombre de causes et de solutions possibles, comme décrit dans cette section.

docker version

docker manifest inspect --verbose <image-path>

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