Richiama funzione
Questa fase richiama una funzione Oracle Cloud Infrastructure (OCI). La fase Richiama funzione può essere utilizzata per eseguire codice o logica personalizzata in modo serverless. Ad esempio, è possibile scrivere una funzione che convalida l'applicazione nell'ambiente temporaneo e, se l'operazione riesce, distribuirla nell'ambiente di produzione.
Prima di iniziare, è necessario definire una pipeline di distribuzione ed è necessario creare una funzione richiamata quando viene eseguita la pipeline.
- Aprire il menu di navigazione e fare clic su Servizi per sviluppatori. In DevOps fare clic su Progetti.
- Selezionare un progetto e una pipeline associati al progetto.
- Per aggiungere lo stadio Integrazioni in sequenza o in parallelo, fare clic sull'icona + e selezionare Aggiungi stadio.
- Selezionare Integrazioni - Richiama funzione, quindi fare clic su Avanti.
- Immettere un nome e una descrizione per lo stadio. L'aggiunta di una descrizione è facoltativa.
- Per Ambiente, selezionare una funzione esistente da richiamare.
Nel campo Nome funzione di sola lettura viene visualizzata la funzione richiamata nella pipeline.
- (Facoltativo) Per selezionare e aggiungere artifact allo stadio, fare clic su Seleziona artifact.
Selezionare una risorsa artifact esistente dal progetto DevOps. L'artifact deve essere di tipo file generico (universale). I parametri nell'artifact devono essere in formato JSON e possono avere segnaposto. È necessario selezionare la casella di controllo Consenti parametrizzazione quando si configura la risorsa artifact DevOps per sostituire i segnaposto con il valore dell'argomento durante la distribuzione. Per ulteriori informazioni, vedere Configurazione di parametri.
Di seguito è riportato un esempio del contenuto generico dell'artifact per il passaggio di due parametri definiti dall'utente e dei relativi valori.- Parametri:
test_name
,app_version
- Valori:
{"test_name":"verify_production", "app_version":"${app_version}"}
- Parametri:
- In Modalità di esecuzione stadio, selezionare per eseguire l'esecuzione in modo asincrono o sincrono.
Se si seleziona Esegui in modo asincrono, il servizio richiama la funzione ma non attende il completamento della funzione. Quando si seleziona Esegui in modo sincrono, il servizio richiama la funzione e attende il completamento della funzione.
- Selezionare per disabilitare o abilitare la convalida.
Se la convalida è abilitata, il servizio verifica il valore restituito della funzione. Il valore restituito è un valore di stringa UTF-8,
true
ofalse
. Se il valore restituito ètrue
, lo stadio viene contrassegnato come Riuscito, altrimenti lo stadio viene contrassegnato come Non riuscito.Se la convalida è disabilitata, il servizio non verifica il valore restituito.
La convalida viene eseguita solo se è stata selezionata l'opzione "Esegui in modo sincrono" per la modalità di esecuzione della fase.
- (Facoltativo) Per aggiungere tag alla pipeline, fare clic su Mostra opzioni di applicazione tag. L'applicazione di tag è un sistema di metadati che consente di organizzare e tenere traccia delle risorse nella tenancy.
Se si dispone delle autorizzazioni per creare una risorsa, si dispone anche delle autorizzazioni per aggiungere tag in formato libero a tale risorsa.
Per aggiungere una tag definita, è necessario disporre delle autorizzazioni per utilizzare lo spazio di nomi tag.
Per ulteriori informazioni, vedere Tag delle risorse.
- Per aggiungere lo stadio Integrazioni alla pipeline, fare clic su Aggiungi.
Per distribuire l'output della build nell'ambiente di destinazione, eseguire la pipeline di distribuzione. Per attivare automaticamente una distribuzione dalla pipeline di build, è possibile aggiungere una fase di distribuzione del trigger alla pipeline di build.
Per richiamare una funzione nella pipeline, eseguire il comando
create-invoke-function-stage
:oci devops deploy-stage create-invoke-function-stage
Parametri richiesti per il comando
create-invoke-function-stage
:--function-environment-id
--is-async
--is-validation-enabled
--pipeline-id
--stage-predecessor-collection
Per ottenere tutti i comandi per
deploy-pipeline
edeploy-stage
:oci devops deploy-pipeline -h
oci devops deploy-stage -h
Per ottenere assistenza per il comando
create-invoke-function-stage
:oci devops deploy-stage create-invoke-function-stage -h
Per richiamare una funzione nella pipeline, utilizzare l'operazione
CreateDeployStage
. Per l'attributodeployStageType
, specificare il valoreINVOKE_FUNCTION
.