Share 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}. 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).

Nota

Somente os usuários que têm a função Usuário de Ambientes de Implantação, a função de Administrador de Projeto do DevCenter ou uma função interna com 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 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 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) 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 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

Nota

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 ter a função Usuário de Ambientes de Implantação, a função de Administrador de Projeto do DevCenter 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 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>

Eliminar um ambiente

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

Conteúdos relacionados