Como criar ações de extensibilidade

Com o Automation Assembler, você pode criar ações de extensibilidade para uso em assinaturas de extensibilidade.

Ações de extensibilidade são maneiras altamente personalizáveis, leves e flexíveis para estender ciclos de vida de aplicativos usando códigos de script e modelos de ação definidos pelo usuário. Os modelos de ação contêm parâmetros predefinidos que ajudam a configurar a base da ação de extensibilidade.

Existem dois métodos para criar uma ação de extensibilidade:

• Gravar um código definido pelo usuário para um script de ação de extensibilidade.
  Observação: Escrever código definido pelo usuário no editor de ação de extensibilidade pode exigir uma conexão ativa com a Internet.
• Importar um pacote de implantação como um pacote ZIP para uma ação de extensibilidade. Para obter informações sobre como criar um pacote ZIP para ações de extensibilidade, consulte Criar um pacote ZIP para ações de extensibilidade de tempo de execução do Python, Criar um pacote ZIP para ações de extensibilidade de tempo de execução do Node.js ou Criar um pacote ZIP para ações de extensibilidade de tempo de execução do PowerShell.

As etapas a seguir descrevem o procedimento para criar uma ação de extensibilidade que usa a Amazon Web Services como um provedor de FaaS.

Pré-requisitos

• Associação em um projeto ativo e válido.
• Função do Amazon Web Services configurada para funções do Lambda. Por exemplo, AWSLambdaBasicExecutionRole.
• Função de administrador de nuvem ou permissões de iam:PassRole habilitadas.

Procedimento

1. Selecione Extensibilidade > Biblioteca > Ações.
2. Clique em Nova Ação.
3. Insira um nome para a ação e selecione um projeto.
4. (Opcional) Adicione uma descrição para a sua ação.
5. Clique em Seguinte.
6. Pesquise e selecione um modelo de ação.
   Observação: Para criar uma ação personalizada sem usar um modelo de ação, selecione Script personalizado.
   Novos parâmetros configuráveis são exibidos.
7. Selecione Script de Gravação ou Importar pacote.
8. Selecione o tempo de execução da ação.
9. Insira um nome de Função principal para o ponto de entrada da ação.
   Observação: Para ações importadas de um pacote ZIP, a função principal também deve incluir o nome do arquivo de script que contém o ponto de entrada. Por exemplo, se o arquivo de script principal se chamar main.py e seu ponto de entrada for handler (context, inputs), o nome da função principal deverá ser main.handler.
10. Defina os parâmetros de entrada e saída da ação.
11. (Opcional) Adicione segredos ou constantes de ação de extensibilidade às suas entradas padrão.
    Observação: Para obter mais informações sobre segredos e constantes de ação de extensibilidade, consulte Como posso criar segredos para uso em ações de extensibilidade e Como posso criar constantes de ação de extensibilidade.
12. (Opcional) Adicione dependências de aplicativos à ação.
    Observação: Para scripts do PowerShell, você pode definir suas dependências de aplicativos para que elas sejam resolvidas em relação ao repositório da Galeria do PowerShell. Para definir as dependências do aplicativo de forma que elas sejam resolvidas no repositório público, use o seguinte formato:

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

    Observação: Para ações importadas de um pacote ZIP, dependências de aplicativos são adicionadas automaticamente.
13. Para definir limites de memória e tempo limite, habilite a opção Definir limites e tempo limite personalizados.
    O valor máximo de tempo limite para ações de tipo de script é de 15 minutos. O valor máximo de tempo limite para ações de tipo de fluxo é de cinco horas. Para ações de tipo de fluxo, você também pode deixar a caixa de texto de tempo limite em branco, o que significa que não há tempo limite. Se você não definir um tempo limite, a execução da ação terminará quando todos os elementos do fluxo terminarem suas tarefas ou se um erro ocorrer.
14. Para testar a ação, clique em Salvar e Testar.

O que Fazer Depois

Depois que a ação de extensibilidade for criada e verificada, será possível atribuí-la a uma assinatura.

Observação: Assinaturas de extensibilidade usam a versão mais recente de uma ação de extensibilidade. Depois de criar uma nova versão de uma ação, clique em Versões no canto superior direito da janela do editor. Para liberar a versão da ação que você deseja usar na sua assinatura, clique em Liberar.