Cómo crear acciones de extensibilidad

Con Automation Assembler, puede crear acciones de extensibilidad para utilizarlas en suscripciones de extensibilidad.

Las acciones de extensibilidad constituyen una forma altamente personalizable, ligera y flexible de ampliar los ciclos de vida de las aplicaciones mediante códigos de script definidos por el usuario y plantillas de acciones. Las plantillas de acciones contienen parámetros predefinidos que ayudan a configurar la base de la acción de extensibilidad.

Existen dos métodos para crear una acción de extensibilidad:

• Escritura de código definido por el usuario para un script de acción de extensibilidad.
• Importación de un paquete de implementación como un paquete ZIP para una acción de extensibilidad. Para obtener información sobre la creación de un paquete ZIP para las acciones de extensibilidad, consulte Crear un paquete ZIP para las acciones de extensibilidad en tiempo de ejecución de Python, Crear un paquete ZIP para las acciones de extensibilidad en tiempo de ejecución de Node.js o Crear un paquete ZIP para las acciones de extensibilidad en tiempo de ejecución de PowerShell.

En los siguientes pasos, se describe el procedimiento para crear una acción de extensibilidad que utilice Amazon Web Services como proveedor FaaS.

Requisitos previos

• Pertenencia a un proyecto activo válido.
• Función de Amazon Web Services configurada para funciones de Lambda. Por ejemplo, AWSLambdaBasicExecutionRole.
• Función de administrador de nube o permisos iam:PassRole habilitados.
• Para usar el tiempo de ejecución de PowerShell, configure una integración de extensibilidad local basada en acciones. Consulte Configurar una integración local de extensibilidad basada en acciones en Automation Assembler.

Procedimiento

1. Seleccione Extensibilidad > Biblioteca > Acciones.
2. Haga clic en Nueva acción.
3. Introduzca un nombre para la acción y seleccione un proyecto.
4. (opcional) Agregue una descripción para la acción.
5. Haga clic en Siguiente.
6. Busque y seleccione una plantilla de acción.
   Nota: Para crear una acción personalizada sin usar una plantilla de acción, seleccione Script personalizado.
   Aparecen nuevos parámetros configurables.
7. Seleccione Escribir script o Importar paquete.
8. Seleccione el tiempo de ejecución de la acción.
9. Introduzca un nombre de Función principal para el punto de entrada de la acción.
   Nota: Para las acciones importadas desde un paquete ZIP, la función principal también debe incluir el nombre del archivo de script que contiene el punto de entrada. Por ejemplo, si el archivo de script principal se denomina main.py y el punto de entrada es handler (context, inputs), el nombre de la función principal debe ser main.handler.
10. Defina los parámetros de entrada y de salida de la acción.
11. (opcional) Agregue secretos o constantes de acciones de extensibilidad a las entradas predeterminadas.
    Nota: Para obtener más información sobre secretos y constantes de acciones de extensibilidad, consulte Cómo crear secretos para usarlos en acciones de extensibilidad y Cómo se pueden crear constantes de acciones de extensibilidad.
12. (opcional) Agregue dependencias de aplicaciones a la acción.
    Nota: Para los scripts de PowerShell, puede definir las dependencias de aplicaciones de modo que se resuelvan desde el repositorio de la galería de PowerShell. Para definir las dependencias de aplicaciones de modo que puedan resolverse desde el repositorio público, utilice el siguiente formato:

    @{
                    Name = 'Version'
     }
     
     e.g.
     
    @{
        Pester = '4.3.1'
    }
    

    Nota: En el caso de acciones importadas desde un paquete ZIP, las dependencias de aplicaciones se agregan automáticamente.
13. Para definir el tiempo de espera y los límites de memoria, habilite la opción Establecer el tiempo de espera y los límites personalizados.
    El valor máximo de tiempo de espera para las acciones de scripting es de 15 minutos. El valor máximo de tiempo de espera para las acciones de flujo es de cinco horas. Para las acciones de flujo, también puede dejar el cuadro de texto de tiempo de espera en blanco, en cuyo caso no habrá límite de tiempo de espera. Si no establece un límite de tiempo de espera, la ejecución de la acción finaliza cuando todos los elementos de flujo finalizan sus tareas o se produce un error.
14. Para probar la acción, haga clic en Guardar y, a continuación, en Probar.

Qué hacer a continuación

Tras crear y comprobar la acción de extensibilidad, puede asignarla a una suscripción.

Nota: Las suscripciones de extensibilidad utilizan la versión publicada más reciente de una acción de extensibilidad. Después de crear una nueva versión de una acción, haga clic en Versiones en la parte superior derecha de la ventana del editor. Para publicar la versión de la acción que desea utilizar en su suscripción, haga clic en Publicar.