Compartilhar via

Criar parâmetros que abrangem vários ambientes para entradas de fluxo de trabalho nos Aplicativos Lógicos do Azure

  • Artigo

Aplica-se a: Aplicativos Lógicos do Azure (Consumo + Padrão)

Nos Aplicativos Lógicos do Azure, você pode abstrair valores que podem ser alterados em fluxos de trabalho entre ambientes de desenvolvimento, teste e produção definindo parâmetros. Ao usar parâmetros em vez de variáveis específicas do ambiente, você pode se concentrar mais na criação dos fluxos de trabalho no começo e inserir as variáveis específicas do ambiente mais tarde.

Este artigo apresenta como criar, usar e editar parâmetros para fluxos de trabalho de aplicativos lógicos de Consumo multilocatário e para fluxos de trabalho de aplicativos lógicos Standard de locatário único. Você também aprenderá a gerenciar variáveis de ambiente.

Para obter mais informações sobre os Aplicativos Lógicos do Azure multilocatário e de locatário único, consulte Locatário único versus multilocatário nos Aplicativos Lógicos do Azure.

Pré-requisitos

Parâmetros para fluxos de trabalho de aplicativo lógico de consumo versus Standard

Para os fluxos de trabalho de aplicativo lógico Standard e de consumo, você pode definir parâmetros usando o designer. Depois de definir o parâmetro, você pode fazer referência a esse parâmetro de qualquer fluxo de trabalho ou conexão que esteja no mesmo recurso de aplicativo lógico.

Em fluxos de trabalho de aplicativos lógicos de consumo multilocatário, depois de criar e usar parâmetros no designer, você define e configura as variáveis de ambiente no modelo do Azure Resource Manager (modelo do ARM) e nos arquivos de parâmetros do modelo. Nesse cenário, você precisa definir e configurar os parâmetros na implantação, o que significa que mesmo que você precise alterar apenas uma variável, é necessário reimplantar o modelo do ARM do aplicativo lógico.

Nos fluxos de trabalho de aplicativo lógico Standard de locatário único, você pode trabalhar com variáveis de ambiente no runtime e na implantação usando parâmetros e configurações de aplicativo. As configurações de aplicativo contêm opções de configuração global para todos os fluxos de trabalho no mesmo recurso de aplicativo lógico. Para obter mais informações, consulte Editar configurações de host e aplicativo para aplicativos lógicos com base em locatário único.

Importante

Quando houver informações confidenciais, como cadeias de conexão que incluam nomes de usuário e senhas, certifique-se de usar o fluxo de autenticação mais seguro disponível. Por exemplo, nos fluxos de trabalho de aplicativo lógico Standard, não há suporte para tipos de dados seguros, como securestring e secureobject. A Microsoft recomenda autenticar o acesso aos recursos do Azure com uma identidade gerenciada quando possível e atribuir uma função que tenha o privilégio mínimo necessário.

Se essa funcionalidade estiver indisponível, certifique-se de proteger as cadeias de conexão por meio de outras medidas, como o Azure Key Vault, que você pode usar com as configurações do aplicativo. Em seguida, você pode fazer referência direta a cadeias de caracteres seguras, como cadeias de conexão e chaves. De modo semelhante aos modelos do ARM, em que é possível definir variáveis de ambiente no momento da implantação, você pode definir as configurações de aplicativo na definição de fluxo de trabalho do aplicativo lógico. Em seguida, você pode capturar os valores da infraestrutura gerados dinamicamente, como pontos de extremidade de conexão, cadeias de caracteres de armazenamento, entre outros. Para obter mais informações, confira Tipos de aplicativo para a plataforma de identidade da Microsoft.

No entanto, as configurações de aplicativo têm limites de tamanho e não podem ser referenciadas em algumas áreas nos Aplicativos Lógicos do Azure. Os parâmetros oferecem uma variedade maior de casos de uso do que as configurações de aplicativo, como suporte para tamanhos de valor grande e objetos complexos.

Por exemplo, se você usar o Visual Studio Code como sua ferramenta de desenvolvimento local para executar fluxos de trabalho localmente, no seu projeto de aplicativo lógico você poderá definir parâmetros usando o arquivo parameters.json. Então, você pode referenciar qualquer parâmetro neste arquivo de parâmetros a partir de qualquer fluxo de trabalho no arquivo workflow.json de seu projeto, ou de qualquer objeto de conexão no arquivo connections.json de seu projeto. A lista a seguir descreve alguns casos de uso comuns:

  • Ter um arquivo de parâmetros de teste que inclua todos os valores que você usa durante o teste. Na implantação, você pode substituir o arquivo de parâmetros de teste pelo arquivo de parâmetros de produção.

  • Parametrizar diferentes partes de seu arquivo connections.json. Em seguida, você pode verificar o arquivo connections.json no controle do código-fonte, e então gerenciar todas as conexões por meio do arquivo parameters.json.

  • Parametrizar objetos complexos, como o objeto JSON authentication. Por exemplo, é possível substituir o valor do objeto authentication por uma cadeia de caracteres que contenha uma única expressão de parâmetros, como @parameters('api-auth').

  • Revise e edite as configurações de aplicativo do arquivo local.settings.json de seu projeto. Você pode, em seguida, referenciar essas configurações de aplicativo em seus parâmetros.

Observação

Como recomendação geral, considere o uso de parâmetros como a forma padrão de parametrizar valores, e não configurações de aplicativo. Dessa forma, quando precisar armazenar chaves seguras ou cadeias de caracteres, você poderá seguir a recomendação para referenciar as configurações do aplicativo a partir de seus parâmetros. Se quiser, é possível usar ambas as opções em sua solução utilizando os parâmetros para referenciar as configurações do aplicativo.

Definir, usar e editar parâmetros

Portal do Azure

  1. No portal do Azure, abra o fluxo de trabalho do aplicativo lógico. Em Fluxos de Trabalho, selecione e abra seu fluxo de trabalho no designer.

  2. Na barra de ferramentas do designer, selecione Parâmetros.

    Captura de tela mostrando o portal do Azure, o designer de fluxo de trabalho e

  3. No painel Parâmetros, selecione Adicionar parâmetro.

  4. Forneça as seguintes informações sobre o parâmetro a ser criado:

    Propriedade Obrigatório Descrição
    Nome Sim O nome do parâmetro a ser criado.
    Tipo Sim O tipo de dados do parâmetro, como matriz, booliano, flutuante, int, objeto, objeto seguro, cadeia de caracteres segura e cadeia de caracteres.
    Valor padrão Sim O valor padrão do parâmetro. Você precisa especificar o valor padrão do parâmetro porque a lógica do fluxo de trabalho, as informações de conexão e os valores do parâmetro não existem em um só local. O designer precisa conseguir resolver os valores de parâmetro antes do carregamento.

    Importante: para os tipos de dados objeto seguro e cadeia de caracteres segura, evite definir um valor padrão, pois o valor é armazenado como texto sem formatação.
    Valor Real Não O valor real do parâmetro.

    O exemplo a seguir mostra uma definição para um parâmetro de cadeia de caracteres:

    Captura de tela mostrando o portal do Azure, o designer de fluxo de trabalho e o painel

  5. Se você tiver mais parâmetros a serem adicionados, selecione Adicionar parâmetro. Caso contrário, feche o painel de parâmetros, mas salve o fluxo de trabalho para salvar a nova definição de parâmetro.

  6. Para fazer referência ao parâmetro por meio de um gatilho ou uma ação que esteja no mesmo fluxo de trabalho, siga estas etapas:

    1. No designer, abra o fluxo de trabalho desejado e expanda o gatilho ou a ação.

    2. Clique dentro da caixa de edição da propriedade na qual você deseja usar o parâmetro.

    3. Na lista de conteúdo dinâmico que é aberta, em Parâmetros, selecione o parâmetro já criado, por exemplo:

      Captura de tela mostrando o designer do fluxo de trabalho de consumo e a ação de exemplo com o cursor na caixa de edição de propriedade, lista de conteúdo dinâmico expandida e parâmetro criado anteriormente selecionado.

  7. Para ver ou editar os parâmetros em um fluxo de trabalho de aplicativo lógico, siga estas etapas:

    1. Abra o fluxo de trabalho do aplicativo lógico no designer. Na barra de ferramentas do designer, selecione Parâmetros.

      O painel Parâmetros é aberto e exibe todos os parâmetros que você definiu para esse fluxo de trabalho.

    2. Faça as edições, feche o painel Parâmetros e salve o fluxo de trabalho do aplicativo lógico.

Conteúdo relacionado