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

Lors du déploiement d'une application, un message semblable au suivant peut s'afficher :

$ 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 signale une tentative inutile et infructueuse de connexion à Docker Hub. Pour résoudre ce problème, déconnectez-vous de Docker à l'aide de la commande suivante :

docker logout

Une fois déconnecté de Docker, réexécutez la commande pour déployer l'application.

Si un message semblable au suivant s'affiche lors du déploiement d'une fonction, vérifiez que la variable d'environnement FN_REGISTRY n'est pas définie sur votre nom utilisateur Docker dans l'environnement de développement :

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 du projet Fn open source, vous aurez peut-être suivi les instructions de la documentation du projet Fn pour définir la variable d'environnement FN_REGISTRY sur votre nom utilisateur Docker afin d'activer 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 du projet Fn.

Pour utiliser l'interface de ligne de commande du projet Fn avec OCI Functions, effectuez l'une des opérations 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 dès que vous entrez une commande d'interface de ligne de commande du projet Fn 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 du projet Fn, un message semblable au suivant peut s'afficher :

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

Ce message indique que le fichier func.yaml de la fonction contient au moins une définition de déclencheur HTTP. OCI Functions ne prend actuellement pas en charge les déclencheurs HTTP. Pour déployer la fonction, enlevez la section triggers: du fichier func.yaml.

Pour éviter de créer des fichiers func.yaml contenant des définitions de déclencheur, suivez les instructions dans Installation de l'interface de ligne de commande du projet Fn afin de mettre à niveau l'interface de ligne de commande du projet Fn vers la version la plus récente.

Lors du déploiement d'une fonction avec une instance de calcul Oracle Cloud Infrastructure en tant qu'environnement de développement OCI Functions, un message semblable au suivant peut s'afficher :

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'une instruction de stratégie (semblable à celle ci-dessous) existe dans le compartiment racine de la location pour permettre à un groupe dynamique incluant 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 en tant qu'environnement de développement, reportez-vous à Dautres options pour les environnements de développement de fonctions.

Lorsque vous déployez une fonction vers OCI Functions, le message suivant peut apparaître :

$ fn deploy --app joes-helloworld-app

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

Si le message Fn: Missing subnets annotation s'affiche, vérifiez que vous avez saisi le nom d'application correct. Par exemple :

• L'application ne se trouve peut-être pas dans le compartiment actuellement indiqué par le contexte de l'interface de ligne de commande du projet Fn.
• L'application a peut-être existé, mais elle a ensuite été supprimée.

Lorsque vous déployez une fonction vers OCI Functions, le message suivant peut s'afficher :

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, même si votre location est fédérée avec Oracle Identity Cloud Service, le nom utilisateur que vous avez fourni lors de votre connexion à Oracle Cloud Infrastructure Registry n'a pas inclus de nom de domaine d'identité.

Vous avez probablement fourni un nom 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é, au 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 avec succès, entrez de nouveau la commande docker login et indiquez le nom utilisateur dans le format correct, y compris le nom de domaine d'identité.

Pour plus d'informations, reportez-vous à Connexion à Oracle Cloud Infrastructure Registry.

Lorsque vous déployez une fonction vers OCI Functions, un message semblable au suivant peut s'afficher :

$ 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 (images enfant) nécessaires pour la forme de l'application. Une cause probable du message est l'utilisation de la version 0.6.24 (ou antérieure) de l'interface de ligne de commande du projet Fn pour déployer une fonction avec une image x86 afin de :

• une application ayant une forme multiarchitecture (telle que Generic_X86_ARM)
• une application disposant d'une seule forme d'architecture non compatible avec une image x86 (telle que Generic_ARM)

A partir de la version 0.6.25 de l'interface de ligne de commande du projet Fn, lorsque vous utilisez la commande fn deploy --app <app-name> pour créer une fonction et la déployer vers OCI Functions, l'interface de ligne de commande du projet Fn crée l'image Docker de la fonction avec les dépendances nécessaires pour la forme de l'application. Si l'application possède une forme à plusieurs architectures (telle que Generic_X86_ARM, forme d'application par défaut depuis septembre 2023), l'interface de ligne de commande du projet Fn crée une image à plusieurs architectures pour la fonction. L'image de la fonction et la forme de l'application sont toujours compatibles.

Cependant, la version 0.6.24 (et antérieure) de la CLI du projet Fn 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 disposent des éléments suivants :

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

Pour déployer la fonction correctement, vous devez fournir une image compatible avec la forme de l'application. Effectuez l'une des opérations suivantes :

• Utilisez la version 0.6.25 ou ultérieure de la CLI du projet Fn (recommandé).
• Déployez la fonction sur une autre application dont la forme est compatible avec l'image de la fonction (créez une nouvelle application si nécessaire). En supposant que vous utilisez la version 0.6.24 ou une version antérieure de l'interface de ligne de commande du projet Fn, déployez toujours la fonction vers 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, reportez-vous à Spécification de l'architecture de calcul sur laquelle exécuter des fonctions.

Lorsque vous déployez une fonction vers OCI Functions dans l'environnement de développement Cloud Shell, un message semblable au suivant peut s'afficher :

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 multi-architecture, que l'application a une forme multi-architecture 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 multi-architectures, ni d'applications avec des formes multi-architectures. En outre, l'architecture de la session Cloud Shell doit être identique à celle de l'application.

Informations supplémentaires :

• A propos de la création d'une fonction basée sur une image d'architecture unique, dans une application dotée d'une forme d'architecture unique compatible, reportez-vous à Spécification de l'architecture de calcul sur laquelle exécuter des fonctions.
• A propos de la sélection de l'architecture de la session Cloud Shell, reportez-vous à Architecture Cloud Shell.

Lorsque vous déployez une fonction vers OCI Functions, un message semblable au suivant peut s'afficher :

$ 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