Llamada a función

Esta etapa llama a una función de Oracle Cloud Infrastructure (OCI). La etapa Llamada a función se puede utilizar para ejecutar código o lógica personalizada sin servidor. Por ejemplo, puede escribir una función que valide la aplicación en el entorno temporal y, si se realiza correctamente, desplegar la aplicación en el entorno de producción.

Antes de empezar, debe tener definido un pipeline de despliegue y debe crear una función que se llame al ejecutar el pipeline.

Abra el menú de navegación y haga clic en Servicios para desarrolladores. En DevOps, haga clic en Proyectos.

Seleccione un proyecto y un pipeline asociados a ese proyecto.

Para agregar la etapa Integraciones de forma secuencial o en paralelo, haga clic en el icono + y seleccione Agregar etapa.

Seleccione Integraciones: Llamar función y, a continuación, haga clic en Siguiente.

Introduzca un nombre y una descripción para la etapa. La adición de una descripción es opcional.

En Entorno, seleccione una función existente a la que llamar.
El campo Nombre de función de solo lectura muestra la función que se llama en el pipeline.

(Opcional) Para seleccionar y agregar artefactos a la etapa, haga clic en Seleccionar artefacto.
Seleccione un recurso de artefacto existente del proyecto de DevOps. El artefacto debe ser un tipo de archivo genérico (universal). Los parámetros del artefacto deben tener formato JSON y pueden tener marcadores de posición. Debe seleccionar la casilla de control Allow parameterization al configurar el recurso de artefacto DevOps para sustituir los marcadores de posición por el valor de argumento durante el despliegue. Para obtener más información, consulte Configuración de parámetros.
A continuación, se muestra un ejemplo del contenido del artefacto genérico para transferir dos parámetros definidos por el usuario y sus valores:

Parámetros: test_name, app_version

Valores: {"test_name":"verify_production", "app_version":"${app_version}"}

En Modo de ejecución de etapa, seleccione esta opción para ejecutar de forma asíncrona o síncrona.
Si selecciona Ejecutar de forma asíncrona, el servicio llama a la función, pero no espera a que se complete la función. Al seleccionar Ejecutar de forma síncrona, el servicio llama a la función y espera a que se complete la función.

Seleccione esta opción para desactivar o activar la validación.
Si la validación está activada, el servicio verifica el valor de retorno de la función. El valor de retorno es un literal de cadena UTF-8, true o false. Si el valor de retorno es true, la etapa se marca como Finalizada correctamente; de lo contrario, la etapa se marca como Con fallos.
Si la validación está desactivada, el servicio no verifica el valor de retorno.
La validación solo se produce si ha seleccionado la opción "Ejecutar de forma sincronizada" para el modo de ejecución temporal.

(Opcional) Para agregar etiquetas al pipeline, haga clic en Mostrar opciones de etiquetado. El etiquetado es un sistema de metadatos que permite organizar los recursos de su arrendamiento y realizar su seguimiento.
Si tiene permisos para crear un recurso, también los tiene para agregar etiquetas de formato libre a ese recurso.
Para agregar una etiqueta definida, debe tener permisos para utilizar el espacio de nombres de etiqueta.
Para obtener más información, consulte Etiquetas de recurso.

Para agregar la etapa Integraciones al pipeline, haga clic en Agregar.
Para desplegar la salida de creación en el entorno de destino, ejecute el pipeline de despliegue.
Para disparar automáticamente un despliegue desde el pipeline de creación, puede agregar una etapa Despliegue de disparador al pipeline de creación.
Para llamar a una función en el pipeline, ejecute el comando create-invoke-function-stage:
oci devops deploy-stage create-invoke-function-stage
Parámetros necesarios para el comando create-invoke-function-stage:
- --function-environment-id
- --is-async
- --is-validation-enabled
- --pipeline-id
- --stage-predecessor-collection
Para obtener todos los comandos para deploy-pipeline y deploy-stage:
```
oci devops deploy-pipeline -h
```
```
oci devops deploy-stage -h
```
Para obtener ayuda para el comando create-invoke-function-stage:
```
oci devops deploy-stage create-invoke-function-stage -h
```
Para llamar a una función en el pipeline, utilice la operación CreateDeployStage. Para el atributo deployStageType, especifique el valor INVOKE_FUNCTION.

Documentación de Oracle Cloud Infrastructure

Llamada a función