Criar parâmetros entre 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 em ambientes de desenvolvimento, teste e produção definindo parâmetros. Quando você usa parâmetros em vez de variáveis específicas do ambiente, inicialmente pode se concentrar mais na criação de seus fluxos de trabalho e inserir variáveis específicas do ambiente mais tarde.

Este artigo apresenta como criar, usar e editar parâmetros para fluxos de trabalho de aplicativo lógico de consumo multilocatário e para fluxos de trabalho de aplicativo lógico padrão de locatário único. Você também aprenderá a gerenciar variáveis de ambiente.

Para obter mais informações sobre 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 consumo versus fluxos de trabalho de aplicativos lógicos padrão

Para fluxos de trabalho do aplicativo lógico Consumo e Padrão, 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.

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

Em fluxos de trabalho de aplicativo lógico padrão de locatário único, você pode trabalhar com variáveis de ambiente tanto no tempo de execução quanto na implantação usando parâmetros e configurações do aplicativo. As configurações do 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 baseados em locatário único.

Importante

Quando você tiver informações confidenciais, como cadeias de conexão que incluem nomes de usuário e senhas, certifique-se de usar o fluxo de autenticação mais seguro disponível. Por exemplo, em fluxos de trabalho de aplicativos lógicos padrão, não há suporte para tipos de dados seguros, como securestring e secureobject, . A Microsoft recomenda que você autentique o acesso aos recursos do Azure com uma identidade gerenciada quando possível e atribua uma função que tenha o menor privilégio necessário.

Se esse recurso não estiver disponível, certifique-se de proteger as cadeias de conexão por meio de outras medidas, como o Cofre da Chave do Azure, 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. Semelhante aos modelos ARM, onde você pode definir variáveis de ambiente no momento da implantação, você pode definir as configurações do aplicativo dentro da definição do fluxo de trabalho do aplicativo lógico. Em seguida, você pode capturar valores de infraestrutura gerados dinamicamente, como pontos de extremidade de conexão, cadeias de caracteres de armazenamento e muito mais. Para obter mais informações, consulte Tipos de aplicativo para a plataforma de identidade da Microsoft.

No entanto, as configurações do aplicativo têm limites de tamanho e não podem ser referenciadas de determinadas áreas nos Aplicativos Lógicos do Azure. Os parâmetros oferecem uma gama mais ampla de casos de uso do que as configurações do 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, em seu projeto de aplicativo lógico, poderá definir parâmetros usando o arquivo parameters.json . Em seguida, você pode fazer referência a qualquer parâmetro nesse arquivo de parâmetros de qualquer fluxo de trabalho no arquivo de workflow.json do projeto ou de qualquer objeto de conexão no arquivo connections.json do projeto. A lista a seguir descreve alguns casos de uso comuns:

  • Tenha 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.

  • Parametrize diferentes partes do seu arquivo connections.json . Em seguida, você pode verificar seu arquivo connections.json no controle do código-fonte e, em seguida, gerenciar todas as conexões através do arquivo parameters.json .

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

  • Revise e edite as configurações do aplicativo no arquivo local.settings.json do seu projeto. Em seguida, você pode fazer referência a essas configurações do aplicativo em seus parâmetros.

Nota

Como recomendação geral, considere o uso de parâmetros como a maneira padrão de parametrizar valores, não as configurações do aplicativo. Dessa forma, quando precisar armazenar chaves ou strings seguras, você pode seguir a recomendação de fazer referência às configurações do aplicativo a partir de seus parâmetros. Se desejar, você pode usar ambas as opções em sua solução usando parâmetros para fazer referência às 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 fluxo de trabalho do designer para Consumo e

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

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

    Property Necessário Description
    Nome Sim O nome do parâmetro a ser criado.
    Tipo Sim O tipo de dados para o parâmetro, como Array, Bool, Float, Int, Object, Secure Object, Secure String e String.
    Valor padrão Sim O valor padrão para o parâmetro. Você precisa especificar o valor do parâmetro padrão porque a lógica do fluxo de trabalho, as informações de conexão e os valores dos parâmetros não existem em um único local. O designer deve ser capaz de resolver os valores dos parâmetros antes de carregar.

    Importante: Para os tipos de dados Secure Object e Secure String , evite definir um valor padrão porque o valor é armazenado como texto sem formatação.
    Valor real Não O valor real para o parâmetro.

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

    Captura de ecrã a mostrar o portal do Azure, o designer para o fluxo de trabalho de Consumo e o painel

  5. Se você tiver mais parâmetros para adicionar, selecione Adicionar parâmetro. Caso contrário, feche o painel de parâmetros, mas certifique-se de salvar seu fluxo de trabalho para salvar sua nova definição de parâmetro.

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

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

    2. Na propriedade onde você deseja usar o parâmetro, clique dentro da caixa de edição dessa propriedade.

    3. Na lista de conteúdo dinâmico que se abre, em Parâmetros, selecione o parâmetro criado anteriormente, por exemplo:

      Captura de tela mostrando o designer para fluxo de trabalho de consumo e 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 exibir 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 definidos para esse fluxo de trabalho.

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

Conteúdos relacionados