Referência de variáveis da CLI do Ambiente de Implantação do Azure

O ADE (Ambientes de Implantação do Azure) define muitas variáveis relacionadas ao seu ambiente que você pode referenciar ao criar imagens personalizadas. Você pode usar as variáveis abaixo nos scripts de operação (deploy.sh ou delete.sh) para tornar suas imagens flexíveis para o ambiente com o qual elas estão interagindo.

Para arquivos usados pelo ADE dentro do contêiner, todos existem em uma ade subpasta fora do diretório inicial.

Aqui está a lista de variáveis de ambiente disponíveis:

ADE_ERROR_LOG

Refere-se ao arquivo localizado em /ade/temp/error.log. O error.log arquivo armazena qualquer saída de erro padrão que preencha os detalhes de erro de um ambiente no resultado de uma implantação ou exclusão com falha. O arquivo é usado com ade execute, que registra qualquer saída padrão e conteúdo de erro padrão para um arquivo de log gerenciado por ADE. Ao usar o comando, redirecione o ade execute log de erros padrão para esse local de arquivo usando o seguinte comando:

ade execute --operation $ADE_OPERATION_NAME --command "{YOUR_COMMAND}" 2> >(tee -a $ADE_ERROR_LOG)

Usando esse método, você pode exibir o erro de implantação ou exclusão no portal do desenvolvedor. Isso leva a iterações de depuração mais rápidas e bem-sucedidas ao criar sua imagem personalizada e diagnóstico mais rápido da causa raiz da operação com falha.

ADE_OUTPUTS

Refere-se ao arquivo localizado em /ade/temp/output.json. O output.json arquivo armazena todas as saídas da implantação de um ambiente no armazenamento persistente, para que ele possa ser acessado usando a CLI do Azure em uma data posterior. Ao armazenar a saída em uma imagem personalizada, verifique se a saída foi carregada no arquivo especificado, conforme mostrado no exemplo a seguir:

echo "$deploymentOutput" > $ADE_OUTPUTS

ADE_STORAGE

Refere-se ao diretório localizado em /ade/storage. Durante o ponto de entrada da imagem principal, o ADE retira um arquivo especialmente nomeado storage.zip do contêiner de armazenamento do ambiente e preenche esse diretório e, após a conclusão da operação, recarrega o diretório como um arquivo zip de volta para o contêiner de armazenamento. Se você tiver arquivos que gostaria de referenciar em sua imagem personalizada em reimplantações subsequentes, como arquivos de estado, coloque-os dentro desse diretório.

ADE_CLIENT_ID

Refere-se à ID do objeto da MSI (Identidade de Serviço Gerenciado) do tipo de ambiente de projeto do ambiente. Essa variável pode ser usada para validar na CLI do Azure as permissões a serem utilizadas dentro do contêiner, como a implantação da infraestrutura.

ADE_TENANT_ID

Refere-se ao GUID do locatário do ambiente.

ADE_SUBSCRIPTION_ID

Refere-se ao GUID de assinatura do ambiente.

ADE_TEMPLATE_FILE

Refere-se ao local em que o arquivo de modelo principal especificado na propriedade 'templatePath' na definição de ambiente reside dentro do contêiner. Esse caminho espelha aproximadamente o controle de origem de onde o catálogo, dependendo do nível do caminho do arquivo no qual você conectou o catálogo. O arquivo está localizado em /ade/repository/{CATALOG_NAME}/{PATH_TO_TEMPLATE_FILE} ou em /ade/repository/{PATH_TO_TEMPLATE_FILE} se você tiver apenas um catálogo. Esse método é usado principalmente durante a etapa de implantação principal como o arquivo referenciado para basear a implantação desativada.

Veja um exemplo usando a CLI do Azure:

az deployment group create --subscription $ADE_SUBSCRIPTION_ID \
    --resource-group "$ADE_RESOURCE_GROUP_NAME" \
    --name "$deploymentName" \
    --no-prompt true --no-wait \
    --template-file "$ADE_TEMPLATE_FILE" \
    --parameters "$deploymentParameters" \
    --only-show-errors

Quaisquer arquivos adicionais, como o suporte a arquivos IaC ou arquivos que você gostaria de usar em sua imagem personalizada, são armazenados em seu local relativo para o arquivo de modelo dentro do contêiner, pois eles estão dentro do catálogo. Por exemplo, veja o seguinte diretório:

├───SampleCatalog
   ├───EnvironmentDefinition1
      │   file1.bicep
      │   main.bicep
      │   environment.yaml
      │
      └───TestFolder
              test1.txt
              test2.txt

Nesse caso, $ADE_TEMPLATE_FILE=/ade/repository/SampleCatalog/EnvironmentDefinition1/main.bicep. Além disso, arquivos como file1.bicep estariam localizados dentro do contêiner /ade/repository/SampleCatalog/EnvironmentDefinition1/file1.bicepe test2.txt estaria localizado em /ade/repository/SampleCatalog/EnvironmentDefinition1/TestFolder/test2.txt.

ADE_ENVIRONMENT_NAME

O nome do ambiente fornecido no momento da implantação.

ADE_ENVIRONMENT_LOCATION

O local onde o ambiente está sendo implantado. Esse local é a região do projeto.

ADE_RESOURCE_GROUP_NAME

O nome do grupo de recursos criado pelo ADE para o qual implantar seus recursos.

ADE_ENVIRONMENT_TYPE

O nome do tipo de ambiente do projeto que está sendo usado para implantar esse ambiente.

ADE_OPERATION_PARAMETERS

Um objeto JSON dos parâmetros fornecidos para implantar o ambiente. Um exemplo do objeto de parâmetros segue:

{
    "location": "locationInput",
    "name": "nameInput",
    "sampleObject": {
        "sampleProperty": "sampleValue"
    },
    "sampleArray": [
        "sampleArrayValue1",
        "sampleArrayValue2"
    ]
}

ADE_OPERATION_NAME

O tipo de operação que está sendo executada no ambiente. Hoje, esse valor é 'deploy' ou 'delete'.

ADE_HTTP__OPERATIONID

A ID da Operação atribuída à operação que está sendo executada no ambiente. A ID da Operação é usada como validação para usar a CLI do ADE e é o principal identificador na recuperação de logs de operações anteriores.

ADE_HTTP__DEVCENTERID

A ID do Centro de Desenvolvimento do ambiente. A ID do Centro de Desenvolvimento também é usada como validação para usar a CLI do ADE.