Compartilhar via

Criar e configurar um centro de desenvolvimento para ambientes de implantação do Azure usando a CLI do Azure

Neste início rápido, você criará e configurará um centro de desenvolvimento nos Ambientes de Implantação do Azure.

Uma equipe de engenharia de plataforma normalmente configura um centro de desenvolvimento, anexa catálogos externos ao centro de desenvolvimento, cria projetos e fornece acesso às equipes de desenvolvimento. As equipes de desenvolvimento podem criar ambientes usando definições de ambiente, conectar-se a recursos individuais e implantar aplicativos.

Pré-requisitos

Categoria Requisitos
Azul – Uma assinatura do Azure.
- Uma função de controle de acesso baseada em função do Azure que tem permissões para criar e gerenciar recursos na assinatura, como Colaborador ou Proprietário.
-A extensão do centro de desenvolvimento da CLI do Azure.
GitHub Uma conta do GitHub e um token de acesso pessoal com acesso ao repositório.

Criar um centro de desenvolvimento

Para criar e configurar um centro de desenvolvimento nos Ambientes de Implantação do Azure:

  1. Entre na CLI do Azure:

    az login

  2. Instale a extensão devcenter da CLI do Azure.

    az extension add --name devcenter --upgrade

  3. Configure a assinatura padrão como a assinatura na qual você deseja criar o centro de desenvolvimento:

    az account set --subscription <subscriptionName>

  4. Configure o local padrão em que você deseja criar o centro de desenvolvimento. Escolha uma região que dê suporte aos Ambientes de Implantação do Azure.

    az configure --defaults location=eastus

  5. Crie o grupo de recursos no qual você deseja criar o centro de desenvolvimento:

    az group create -n <resourceGroupName>

  6. Configure o grupo de recursos padrão como o grupo de recursos que você criou:

    az config set defaults.group=<resourceGroupName>

  7. Crie o centro de desenvolvimento:

    az devcenter admin devcenter create -n <devcenterName>

    Após alguns minutos, a saída indica que o centro de desenvolvimento foi criado:

    {
   "devCenterUri": "https://...",
   "id": "/subscriptions/.../<devcenterName>",
   "location": "eastus",
   "name": "<devcenter name>",
   "provisioningState": "Succeeded",
   "resourceGroup": "<resourceGroupName>",
   "systemData": {
      "createdAt": "...",
      "createdBy": "...",
      ...
   },
   "type": "microsoft.devcenter/devcenters"
}

Observação

Você pode usar --help para exibir mais detalhes sobre qualquer comando, argumentos aceitos e exemplos. Por exemplo, use az devcenter admin devcenter create --help para exibir mais detalhes sobre como criar um centro de desenvolvimento.

Adicionar um token de acesso pessoal ao Azure Key Vault

Você precisa de um Azure Key Vault para armazenar o PAT (token de acesso pessoal) do GitHub usado para conceder acesso ao Azure ao repositório GitHub.

  1. Crie um cofre de chaves:

    # Use a globally unique name
az keyvault create -n <keyvaultName>

    Observação

    Você pode receber o seguinte erro: Code: VaultAlreadyExists Message: The vault name 'kv-devcenter' is already in use. Vault names are globally unique so it is possible that the name is already taken. você deve usar um nome global exclusivo do cofre de chaves.

  2. Atribua a si mesmo a função RBAC de Oficial de segredos do cofre de chaves:

    az role assignment create --assignee <YourPrincipalId> --role "Key Vault Secrets Officer" --scope /subscriptions/<YourSubscriptionId>/resourceGroups/<YourResourceGroupName>/providers/Microsoft.KeyVault/vaults/<YourKeyVaultName>

  3. Adicione o GITHub PAT ao Key Vault como um segredo:

    az keyvault secret set --vault-name <keyvaultName> --name GHPAT --value <personalAccessToken>

Anexar uma identidade ao centro de desenvolvimento

Depois de criar um centro de desenvolvimento, anexe uma identidade ao centro de desenvolvimento. Você pode anexar uma identidade gerenciada atribuída pelo sistema ou uma identidade gerenciada atribuída pelo usuário. Para obter informações, consulte Adicionar uma identidade gerenciada.

Neste guia de início rápido, você configura uma identidade gerenciada atribuída pelo sistema para o centro de desenvolvimento.

Anexar uma identidade gerenciada atribuída pelo sistema

Anexe uma identidade gerenciada atribuída pelo sistema ao centro de desenvolvimento:

az devcenter admin devcenter update -n <devcenterName> --identity-type SystemAssigned

Conceda acesso à identidade gerenciada atribuída pelo sistema ao segredo do cofre de chaves

Verifique se a identidade tem acesso ao segredo do cofre de chaves que contém o PAT do GitHub para acessar seu repositório. Os cofres de chaves dão suporte a dois métodos de acesso: RBAC (controle de acesso baseado em função) do Azure e política de acesso do cofre. Neste início rápido, você usará o RBAC:

az role assignment create --role "Key Vault Secrets Officer" --assignee <devCenterManagedIdentityObjectID> --scope /subscriptions/<subscriptionID>/resourcegroups/<resourceGroupName>/providers/Microsoft.KeyVault/vaults/<keyVaultName>

Adicionar um catálogo ao centro de desenvolvimento

Os Ambientes de Implantação do Azure dão suporte à anexação de repositórios do Azure DevOps e repositórios do GitHub. Você pode armazenar um conjunto de modelos de IaC coletados em um repositório. Anexar o repositório a um centro de desenvolvimento como um catálogo concede às equipes de desenvolvimento acesso aos modelos e permite que eles criem ambientes consistentes rapidamente.

Neste início rápido, você anexa um repositório GitHub que contém exemplos criados e mantidos pela equipe de Ambientes de Implantação do Azure.

Para adicionar um catálogo ao centro de desenvolvimento, primeiro você precisa coletar algumas informações.

Coletar informações de repositório do GitHub

Para adicionar um catálogo, você deve especificar a URL do repositório GitHub, o branch e a pasta que contém suas definições de ambiente. Você pode coletar essas informações antes de iniciar o processo de adição do catálogo ao centro de desenvolvimento.

Você pode usar este catálogo de exemplo como seu repositório. Faça uma bifurcação do repositório para as etapas a seguir.

Dica

Se você estiver anexando um repositório do Azure DevOps, use estas etapas: Obter a URL de clone de um repositório do Azure DevOps.

  1. Navegue até o repositório, selecione <> Código e copie a URL do clone.

  2. Anote a ramificação na qual você está trabalhando.

  3. Anote a pasta que contém suas definições de ambiente.

    Captura de tela que mostra o repositório GitHub com ramificação, URL de cópia e pasta realçada.

Adicionar um catálogo ao centro de desenvolvimento

  1. Recuperar identificador de segredo:

    $SECRETID = az keyvault secret show --vault-name <keyvaultName> --name GHPAT --query id -o tsv
Write-Output $SECRETID

  2. Adicione o catálogo:

    # Sample catalog example
$REPO_URL = "<clone URL that you copied earlier>"
az devcenter admin catalog create --git-hub path="/Environments" branch="main" secret-identifier=$SECRETID uri=$REPO_URL -n <catalogName> -d <devcenterName>

  3. Confirme se o catálogo foi adicionado e sincronizado com êxito:

    az devcenter admin catalog list -d <devcenterName> -o table

Criar um tipo de ambiente

Use um tipo de ambiente para ajudar você a definir os diferentes tipos de ambientes que as equipes de desenvolvimento podem implantar. Você pode aplicar configurações diferentes para cada tipo de ambiente.

  1. Criar um tipo de ambiente:

    az devcenter admin environment-type create -d <devcenterName> -n <environmentTypeName>

  2. Confirme se o tipo de ambiente foi criado:

    az devcenter admin environment-type list -d <devcenterName> -o table

Próxima etapa

Neste início rápido, você criou um centro de desenvolvimento e o configurou com uma identidade, um catálogo e um tipo de ambiente. Para saber como criar e configurar um projeto, vá para o próximo início rápido:

Criar e configurar um projeto usando a CLI do Azure

  • Last updated on