Problemi relativi alla distribuzione di applicazioni e funzioni

Quando si distribuisce un'applicazione, è possibile che venga visualizzato un messaggio simile al seguente:

$ 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

Il messaggio indica un tentativo non necessario e non riuscito di eseguire il login a Docker Hub. Per risolvere questa situazione, eseguire il logout da Docker utilizzando il seguente comando:

docker logout

Dopo aver eseguito il logout da Docker, rieseguire il comando per distribuire l'applicazione.

Se durante la distribuzione di una funzione viene visualizzato un messaggio simile al seguente, verificare che la variabile di ambiente FN_REGISTRY nell'ambiente di sviluppo non sia impostata sul nome utente 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.
			

Se hai utilizzato la piattaforma Fn Project open source, potresti aver seguito le istruzioni nella documentazione di Fn Project per impostare la variabile di ambiente FN_REGISTRY sul tuo nome utente Docker per abilitare l'interazione con il registro Docker ufficiale (docker.io).

La variabile di ambiente FN_REGISTRY sostituisce il valore dell'opzione di registro nel contesto CLI di Fn Project.

Per utilizzare l'interfaccia CLI di Fn Project con OCI Functions, effettuare una delle operazioni riportate di seguito.

• Annullare l'impostazione della variabile di ambiente FN_REGISTRY.
• Eseguire l'override della variabile di ambiente FN_REGISTRY utilizzando l'opzione globale --registry ogni volta che si immette un comando CLI Fn Project che interagisce con Oracle Cloud Infrastructure Registry.

Quando si distribuisce una funzione creata in precedenza utilizzando una versione precedente dell'interfaccia CLI di Fn Project, è possibile che venga visualizzato un messaggio simile al seguente:

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

Questo messaggio indica che il file func.yaml della funzione contiene una o più definizioni di trigger HTTP. OCI Functions attualmente non supporta i trigger HTTP. Per distribuire la funzione, rimuovere la sezione triggers: dal file func.yaml.

Per evitare di creare nuovi file func.yaml contenenti definizioni di trigger, seguire le istruzioni in Installazione dell'interfaccia CLI di Fn Project per aggiornare l'interfaccia CLI di Fn Project alla versione più recente.

Quando si distribuisce una funzione utilizzando un'istanza di computazione Oracle Cloud Infrastructure come ambiente di sviluppo OCI Functions, potrebbe essere visualizzato un messaggio simile al seguente:

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.

Questo messaggio indica che l'istanza di computazione non dispone dell'accesso a Oracle Cloud Infrastructure Registry.

Verificare che nel compartimento radice della tenancy esista un'istruzione dei criteri (simile a quella riportata di seguito) per consentire a un gruppo dinamico che includa l'OCID dell'istanza di computazione di accedere a Oracle Cloud Infrastructure Registry:

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

Per ulteriori informazioni sull'uso di un'istanza di computazione Oracle Cloud Infrastructure come ambiente di sviluppo, vedere Opzioni diverse per gli ambienti di sviluppo delle funzioni.

Quando si distribuisce una funzione in OCI Functions, potrebbe essere visualizzato il seguente messaggio:

$ fn deploy --app joes-helloworld-app

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

Se viene visualizzato il messaggio Fn: Missing subnets annotation, confermare di aver immesso il nome corretto dell'applicazione. Ad esempio:

• l'applicazione potrebbe non trovarsi nel compartimento attualmente specificato dal contesto CLI di Fn Project
• l'applicazione potrebbe essere esistita in precedenza, ma è stata successivamente eliminata

Quando si distribuisce una funzione in OCI Functions, è possibile che venga visualizzato un messaggio simile al seguente:

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

Questo messaggio indica che l'immagine della funzione non include le dipendenze (immagini figlio) necessarie per la forma dell'applicazione. Una probabile causa del messaggio è l'uso di Fn Project CLI versione 0.6.24 (o precedente) per distribuire una funzione con un'immagine x86 in:

• un'applicazione con una forma multiarchitettura (ad esempio Generic_X86_ARM)
• un'applicazione con una singola forma di architettura non compatibile con un'immagine x86, ad esempio Generic_ARM;

A partire dalla versione 0.6.25 dell'interfaccia CLI di Fn Project, quando si utilizza il comando fn deploy --app <app-name> per creare una funzione e distribuirla in OCI Functions, l'interfaccia CLI di Fn Project crea l'immagine Docker della funzione con le dipendenze necessarie per la forma dell'applicazione. Se l'applicazione dispone di una forma multi-architettura (ad esempio Generic_X86_ARM, la forma predefinita dell'applicazione da settembre 2023), l'interfaccia CLI di Fn Project crea un'immagine multi-architettura per la funzione. L'immagine della funzione e la forma dell'applicazione sono sempre compatibili.

Tuttavia, Fn Project CLI versione 0.6.24 (e precedente) crea sempre immagini Docker con le dipendenze necessarie per una singola architettura, l'architettura x86. Come singola immagine di architettura, un'immagine x86 di questo tipo è compatibile solo con le applicazioni con la forma di architettura singola Generic_X86. L'immagine x86 non è compatibile con le applicazioni che dispongono dei seguenti elementi:

• una forma a più architetture (ad esempio, Generic_X86_ARM, la forma predefinita dell'applicazione da settembre 2023)
• una singola forma di architettura diversa da Generic_X86 (ad esempio Generic_ARM)

Per distribuire correttamente la funzione, è necessario fornire un'immagine compatibile con la forma dell'applicazione. Procedere in uno dei seguenti modi:

• Utilizzare Fn Project CLI versione 0.6.25 o successiva (consigliato).
• Distribuire la funzione in un'altra applicazione con una forma compatibile con l'immagine della funzione (se necessario, creare una nuova applicazione). Supponendo che si stia utilizzando Fn Project CLI versione 0.6.24 o precedente, distribuire sempre la funzione in un'applicazione con una forma Generic_X86.
• Utilizza Docker per creare un'immagine compatibile con la forma dell'architettura dell'applicazione.

Per ulteriori informazioni, vedere Specifica dell'architettura di calcolo su cui eseguire le funzioni.

Quando si distribuisce una funzione in OCI Functions nell'ambiente di sviluppo Cloud Shell, potrebbe essere visualizzato un messaggio simile al seguente:

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

Questo messaggio indica che la funzione si basa su un'immagine con più architetture, che l'applicazione ha una forma con più architetture o che la sessione Cloud Shell e l'applicazione hanno un'architettura diversa.

Nell'ambiente di sviluppo Cloud Shell, OCI Functions non supporta la creazione e la distribuzione di funzioni basate su immagini multi-architettura né di applicazioni con forme multi-architettura. Inoltre, l'architettura della sessione Cloud Shell deve essere uguale all'architettura dell'applicazione.

Ulteriori informazioni

• Per informazioni sulla creazione di una funzione basata su una singola immagine di architettura, in un'applicazione con una forma di architettura singola compatibile, vedere Specifica dell'architettura di calcolo su cui eseguire le funzioni.
• Informazioni sulla selezione dell'architettura della sessione Cloud Shell, vedere Architettura Cloud Shell.

Quando si distribuisce una funzione in OCI Functions, è possibile che venga visualizzato un messaggio simile al seguente:

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

Esistono una serie di possibili cause e soluzioni, come descritto in questa sezione.

docker version

docker manifest inspect --verbose <image-path>

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