Création d'actions d'extensibilité

Avec Automation Assembler, vous pouvez créer des actions d'extensibilité à utiliser dans les abonnements d'extensibilité.

Hautement personnalisables, légères et flexibles, les actions d'extensibilité sont idéales pour étendre le cycle de vie des applications à l'aide d'un code de script et de modèles d'action définis par l'utilisateur. Les modèles d'action contiennent des paramètres prédéfinis qui facilitent la configuration de la base de votre action d'extensibilité.

Il existe deux méthodes de création d'une action d'extensibilité :

• Écriture d'un code défini par l'utilisateur pour un script d'action d'extensibilité.
• Importation d'un module de déploiement sous la forme d'un module ZIP pour une action d'extensibilité. Pour plus d'informations sur la création d'un module ZIP pour les actions d'extensibilité, consultez Créer un module ZIP pour les actions d'extensibilité du composant d'exécution Python, Créer un module ZIP pour les actions d'extensibilité d'exécution Node.js ou Créer un module ZIP pour les actions d'extensibilité d'exécution PowerShell.

La procédure ci-dessous permet de créer une action d'extensibilité qui utilise Amazon Web Services comme fournisseur FaaS.

Conditions préalables

• Appartenance à un projet actif et valide.
• Rôle Amazon Web Services configuré pour les fonctions Lambda. Par exemple, AWSLambdaBasicExecutionRole.
• Rôle d'administrateur de cloud ou autorisations iam:PassRole activées.
• Pour utiliser l'exécution PowerShell, configurez une intégration d'extensibilité basée sur l'action sur site. Reportez-vous à la section Configurer une intégration d'extensibilité basée sur des actions sur site dans Automation Assembler.

Procédure

1. Sélectionnez Extensibilité > Bibliothèque > Actions.
2. Cliquez sur Nouvelle action.
3. Entrez le nom que vous souhaitez attribuer à l'action et sélectionnez un projet.
4. (Facultatif) Ajoutez une description pour votre action.
5. Cliquez sur Suivant.
6. Recherchez et sélectionnez un modèle d'action.
   Note : Pour créer une action personnalisée sans utiliser de modèle d'action, sélectionnez Script personnalisé.
   De nouveaux paramètres configurables s'affichent.
7. Sélectionnez Écrire un script ou Importer un module.
8. Sélectionnez l'exécution de l'action.
9. Entrez un nom de Fonction principale pour le point d'entrée de l'action.
   Note : Pour les actions importées à partir d'un module ZIP, la fonction principale doit également inclure le nom du fichier de script qui contient le point d'entrée. Par exemple, si votre fichier de script principal est intitulé main.py et que votre point d'entrée est handler (context, inputs), le nom de la fonction principale doit être main.handler.
10. Définissez les paramètres d'entrée et de sortie de l'action.
11. (Facultatif) Ajoutez des secrets ou des constantes d'action d'extensibilité à vos entrées par défaut.
    Note : Pour plus d'informations sur les secrets et les constantes d'actions d'extensibilité, consultez Création de secrets à utiliser dans les actions d'extensibilité et Création de constantes d'action d'extensibilité.
12. (Facultatif) Ajoutez des dépendances d'application à l'action.
    Note : Pour les scripts PowerShell, vous pouvez définir vos dépendances d'application afin qu'elles soient résolues par rapport au référentiel de la galerie PowerShell. Pour définir vos dépendances d'application afin qu'elles puissent être résolues à partir du référentiel public, utilisez le format suivant :

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

    Note : Pour les actions importées à partir d'un module ZIP, les dépendances d'application sont ajoutées automatiquement.
13. Pour définir le délai d'expiration et les limites de mémoire, activez l'option Définir le délai d'expiration et les limites personnalisés.
    La valeur de délai d'expiration maximale pour les actions de type script est de 15 minutes. La valeur de délai d'expiration maximale pour les actions de type de flux est de cinq heures. Pour les actions de type de flux, vous pouvez également laisser la zone de texte de délai d'expiration vide, auquel cas il n'y a pas de limite de délai d'expiration. Si vous ne définissez pas de limite de délai d'expiration, l'exécution de l'action se termine lorsque tous les éléments de flux terminent leurs tâches ou qu'une erreur se produit.
14. Pour tester votre action, cliquez sur Enregistrer, puis sur Test.

Que faire ensuite

Une fois votre action d'extensibilité créée et vérifiée, vous pouvez l'attribuer à un abonnement.

Note : Les abonnements d'extensibilité utilisent la dernière version publiée d'une action d'extensibilité. Après avoir créé une nouvelle version d'une action, cliquez sur Versions, en haut à droite dans la fenêtre de l'éditeur. Pour publier la version de l'action que vous souhaitez utiliser dans votre abonnement, cliquez sur Publier.