Criar e acessar um ambiente usando a CLI do Azure

Este artigo explica como criar e acessar um ambiente em um projeto existente de Ambientes de Implantação do Azure usando a CLI do Azure.

Pré-requisitos

Criar um ambiente

A criação de um ambiente cria automaticamente os recursos necessários e um grupo de recursos para armazená-los. O nome do grupo de recursos segue o padrão {projectName}-{environmentName}. Você pode exibir o grupo de recursos no portal do Azure.

Para criar um ambiente e configurar recursos, conclua as etapas a seguir no CLI do Azure. Você pode exibir as saídas conforme definido no modelo específico do ARM (Azure Resource Manager).

1. Entre na CLI do Azure:

   az login
   

2. Instale ou atualize a extensão do Centro de Desenvolvimento do Azure para a CLI:

   az extension add --name devcenter --upgrade
   

3. Liste todos os projetos de Ambientes de Implantação do Azure aos quais você tem acesso:

   az graph query -q "Resources | where type =~ 'microsoft.devcenter/projects'" -o table
   

4. Configure a assinatura padrão como a assinatura que contém o projeto:

   az account set --subscription <subscriptionName>
   

5. Configure o grupo de recursos padrão como o grupo de recursos que contém o projeto:

   az config set defaults.group=<resourceGroupName>
   

6. Liste o tipo de ambientes que você pode criar em um projeto específico:

   az devcenter dev environment-type list --dev-center-name <devcenterName> --project-name <projectName> -o table
   

7. Liste as definições de ambiente disponíveis para um projeto específico:

   az devcenter dev environment-definition list --dev-center-name <devcenterName> --project-name <projectName> -o table
   

8. Uma definição de ambiente é um modelo de infraestrutura como código definido no arquivo environment.yaml . Crie um ambiente usando uma definição de ambiente na lista de definições de ambiente disponíveis:

   az devcenter dev environment create --dev-center-name <devcenterName>
       --project-name <projectName> --environment-name <environmentName> --environment-type <environmentType>
       --environment-definition-name <environmentDefinitionName> --catalog-name <catalogName>
   

   Se a definição de ambiente específica* exigir parâmetros, use --parameters e forneça os parâmetros como uma cadeia de caracteres JSON ou um arquivo JSON. Por exemplo:

   $params = "{ 'name': 'firstMsi', 'location': 'northeurope' }"
   az devcenter dev environment create --dev-center-name <devcenterName>
       --project-name <projectName> --environment-name <environmentName> --environment-type <environmentType>
       --environment-definition-name <environmentDefinitionName> --catalog-name <catalogName>
       --parameters $params
   

Solucionar problemas de erro de permissões

Você deve ter a função de Usuário de Ambientes de Implantação , a função DevCenter Project Admin ou uma função interna que tenha as permissões necessárias para criar um ambiente.

Se você não tiver as permissões corretas, o ambiente não será criado. Uma mensagem de erro como o exemplo a seguir pode aparecer:

(EnvironmentNotFound) The environment resource was not found.
Code: EnvironmentNotFound
Message: The environment resource was not found.

Para resolver o problema, atribua as permissões corretas. Consulte Conceder acesso à equipe de desenvolvimento.

Acessar um ambiente

Para acessar um ambiente:

1. Listar os ambientes existentes que estão disponíveis em um projeto específico:

   az devcenter dev environment list --dev-center-name <devcenterName> --project-name <projectName>
   

2. Exiba os pontos de extremidade de acesso a vários recursos, conforme definido nas saídas de modelo do ARM.

3. Acesse os recursos específicos utilizando os endpoints.

Implantar um ambiente

az devcenter dev environment deploy --action-id "deploy" --dev-center-name <devcenterName> \
    -g <resourceGroupName> --project-name <projectName> --environment-name <environmentName> --parameters <parametersJsonString>

Excluir um ambiente

az devcenter dev environment delete --dev-center-name <devcenterName>  --project-name <projectName> --environment-name <environmentName> --user-id "me"

Conteúdo relacionado

• Adicionar e configurar um catálogo do GitHub ou do Azure DevOps
• Adicionar e configurar uma definição de ambiente