Tutorial: Uso de variables con acciones de invocación de Lambda

Inicia sesión en AWS Management Console y abre la AWS Lambda consola en. https://console.aws.amazon.com/lambda/

Seleccione Crear función. Deje seleccionado Author from scratch (Crear desde cero).

En Function name (Nombre de la función), escriba el nombre de la función, como myInvokeFunction. En Runtime (Motor de ejecución), deje seleccionada la opción predeterminada.

Expanda Choose or create an execution role (Elegir o crear un rol de ejecución). Elija Create a new role with basic Lambda permissions (Crear un nuevo rol con permisos básicos de Lambda).

Seleccione Crear función.

Para usar una variable de otra acción, tendrá que pasar UserParameters a la configuración de acción de invocación de Lambda. Va a configurar la acción en nuestra canalización más adelante en el tutorial, pero agregará el código asumiendo que la variable se pasará.

const commitId =
event["CodePipeline.job"].data.actionConfiguration.configuration.UserParameters;

Para producir nuevas variables, establezca una propiedad llamada outputVariables en la entrada a putJobSuccessResult. Tenga en cuenta que no puede producir variables como parte de putJobFailureResult.

const successInput = {
  jobId: jobId,
  outputVariables: {
    testRunId: Math.floor(Math.random() * 1000).toString(),
    dateTime: Date(Date.now()).toString(),
    region: lambdaRegion
  }
};

En su nueva función, deje la opción Edit code-inline (Editar código insertado) seleccionada y pegue el siguiente código de ejemplo en index.js.

import { CodePipeline } from '@aws-sdk/client-codepipeline';

export const handler = async (event, context) => {
    const codepipeline = new CodePipeline({});
    
    // Retrieve the Job ID from the Lambda action
    const jobId = event["CodePipeline.job"].id;
    
    // Retrieve UserParameters
    const params = event["CodePipeline.job"].data.actionConfiguration.configuration.UserParameters;
    
    // The region from where the lambda function is being executed
    const lambdaRegion = process.env.AWS_REGION;
    
    // Notify CodePipeline of a successful job
    const putJobSuccess = async (message) => {
        const params = {
            jobId: jobId,
            outputVariables: {
                testRunId: Math.floor(Math.random() * 1000).toString(),
                dateTime: Date(Date.now()).toString(),
                region: lambdaRegion
            }
        };
        
        try {
            await codepipeline.putJobSuccessResult(params);
            return message;
        } catch (err) {
            throw err;
        }
    };
    
    // Notify CodePipeline of a failed job
    const putJobFailure = async (message) => {
        const params = {
            jobId: jobId,
            failureDetails: {
                message: JSON.stringify(message),
                type: 'JobFailed',
                externalExecutionId: context.invokeid
            }
        };
        
        try {
            await codepipeline.putJobFailureResult(params);
            throw message;
        } catch (err) {
            throw err;
        }
    };
    
    try {
        console.log("Testing commit - " + params);
        
        // Your tests here
        
        // Succeed the job
        return await putJobSuccess("Tests passed.");
    } catch (ex) {
        // If any of the assertions failed then fail the job
        return await putJobFailure(ex);
    }
};

Seleccione Guardar.

Copia el nombre del recurso de Amazon (ARN) en la parte superior de la pantalla.

Como último paso, abra la consola AWS Identity and Access Management (IAM) en https://console.aws.amazon.com/iam/. Modifique la función de ejecución de Lambda para añadir la siguiente política:. AWSCodePipelineCustomActionAccess Para consultar los pasos necesarios para crear un rol de ejecución de Lambda o modificar la política de rol, consulte Paso 2: Crear la función de Lambda.

Abra la CodePipeline consola en. https://console.aws.amazon.com/codepipeline/

Se muestran los nombres de todas las canalizaciones asociadas a tu AWS cuenta. Elija la canalización en la que desea agregar la acción.

Agregue la acción de prueba de Lambda a su canalización.

1. Para editar la canalización, elija Edit (Editar). Agregue una etapa después de la acción de origen en la canalización existente. Escriba un nombre para la etapa, por ejemplo Test.

2. En la nueva etapa, elija el icono para agregar una acción. En Action name (Nombre de la acción), escriba el nombre de la acción de invocación, como Test_Commit.

3. En Proveedor de acción, seleccione AWS Lambda.

4. En Input artifacts (Artefactos de entrada), elija el nombre del artefacto de salida de la acción de origen, como SourceArtifact.

5. En Nombre de la función, elija el nombre de la función de Lambda que ha creado.

6. En Parámetros de usuario, introduce la sintaxis de la variable para el ID de CodeCommit confirmación. Esto crea la variable de salida que se resuelve en la confirmación que se va a revisar y aprobar cada vez que se ejecuta la canalización.

   #{SourceVariables.CommitId}

7. En el Variable namespace (Espacio de nombres de la variable), agregue el nombre del espacio de nombres, como TestVariables.

8. Seleccione Listo.

Agregue la acción de aprobación manual a la canalización.

1. Con la canalización todavía en modo de edición, agregue una etapa después de la acción de invocación. Escriba un nombre para la etapa, por ejemplo Approval.

2. En la nueva etapa, elija el icono para agregar una acción. En Action name (Nombre de la acción), escriba el nombre de la acción de aprobación, como Change_Approval.

3. En Action provider (Proveedor de acciones), elija Manual approval (Aprobación manual).

4. URLPara repasarlo, construya el URL añadiendo la sintaxis de la region variable y la CommitId variable. Asegúrese de utilizar los espacios de nombres asignados a las acciones que proporcionan las variables de salida.

   En este ejemplo, la sintaxis URL con la variable para una CodeCommit acción tiene el espacio de nombres SourceVariables predeterminado. La variable de salida de región de Lambda tiene el espacio de nombres TestVariables. Se URL parece a lo siguiente.

   https://#{TestVariables.region}.console.aws.amazon.com/codesuite/codecommit/repositories/MyDemoRepo/commit/#{SourceVariables.CommitId}

   En Comments (Comentarios), cree el texto del mensaje de aprobación agregando la sintaxis de la variable para la variable testRunId. En este ejemplo, la sintaxis URL con la variable de testRunId salida Lambda tiene el TestVariables espacio de nombres. Escriba el siguiente mensaje.

   Make sure to review the code before approving this action. Test Run ID: #{TestVariables.testRunId}

Elija Done (Listo) para cerrar la pantalla de edición de la acción y, a continuación, elija Done (Listo) para cerrar la pantalla de edición de la etapa. Para guardar la canalización, elija Done (Listo). La canalización completada ahora contiene una estructura con etapas de origen, prueba, aprobación e implementación.

Elija Release change (Publicar modificación) para ejecutar el último cambio a través de la estructura de la canalización.

Cuando la canalización llegue a la etapa de aprobación manual, elija Review (Revisar). Las variables resueltas aparecen como las del ID URL de confirmación. El aprobador puede elegir esta opción URL para ver la confirmación.

Después de que la canalización se ejecute de forma satisfactoria, también puede consultar los valores de las variables en la página del historial de ejecución de acciones.