Compartilhar via

Criar e acessar um ambiente usando a CLI do Azure

  • Artigo

Este guia 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}. Será possível exibir o grupo de recursos no portal do Azure.

Complete as etapas a seguir na CLI do Azure para criar um Ambiente e configurar recursos. Você poderá exibir as saídas conforme definido no modelo específico do ARM (Azure Resource Manager).

Observação

Somente os usuários que têm a função de Usuário de Ambientes de Implantação, a função DevCenter Project Admin ou uma função interna que tenha permissões apropriadas podem criar um ambiente. Os usuários que têm a função Leitor de Ambientes de Implantação podem exibir seus próprios ambientes e ambientes criados por outras pessoas.

  1. Entre na CLI do Azure:

    az login

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

    az extension add --name devcenter --upgrade

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

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

  4. Configure a assinatura padrão para 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 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 uma definição de ambiente (uma infraestrutura como modelo de código definido no arquivo environment.yaml) a partir 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 o environment-definition específico exigir algum parâmetro, 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

Observação

Você pode usar --help para exibir mais detalhes sobre qualquer comando, argumentos aceitos e exemplos. Por exemplo, use az devcenter dev environment create --help para exibir mais detalhes sobre a criação de um ambiente.

Solucionar um erro de permissões

Você deve a função de Usuário de Ambientes de Implantação, a função de Administrador de Projetos do DevCenter ou uma função interna com as permissões apropriadas 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.

Acessar um ambiente

Para acessar um ambiente:

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

  3. Acesse recursos específicos usando os pontos de extremidade.

Implantar um ambiente

az devcenter dev environment deploy-action --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