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.

Conclua as etapas a seguir na CLI do Azure para criar um ambiente e configurar recursos. 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 <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 <devcenterName> --project-name <projectName> -o table
   

8. Crie um ambiente usando um de definição de ambiente (um modelo de infraestrutura como código definido no arquivo environment.yaml) 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 o de definição de ambiente de específico exigir quaisquer 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 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: Dê acesso à equipe 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 <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