Criar e acessar um ambiente usando a CLI do Azure

Este artigo explica como criar e aceder a um ambiente num projeto existente de Ambientes de Implementaçã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, complete os seguintes passos na CLI do Azure. Você pode exibir as saídas conforme definido no modelo específico do Azure Resource Manager (modelo ARM).

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 que estão 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 ficheiro environment.yaml . Crie um ambiente utilizando uma definição de ambiente da 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 específica do ambiente* exigir algum parâmetro, use --parameters e forneça os parâmetros como uma string JSON ou ficheiro 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 um erro de permissões

Você deve ter a função Deployment Environments User, 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. Veja Dar acesso à equipa de desenvolvimento.

Aceder a um ambiente

Para aceder a um ambiente:

1. Liste 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 do modelo ARM.

3. Acesse os recursos específicos usando 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>

Eliminar 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