Crie e configure um projeto usando o Azure CLI

Neste início rápido, você cria um projeto nos Ambientes de Implementação do Azure. Depois, associa o projeto ao centro de desenvolvimento que criaste em Criar e configurar um centro de desenvolvimento utilizando a Azure CLI.

Uma equipa de engenharia de plataformas normalmente cria projetos e concede acesso a projetos às equipas de desenvolvimento. As equipas de desenvolvimento criam ambientes utilizando definições de ambientes, conectam-se a recursos individuais e implementam aplicações.

Pré-requisitos

Categoria	Requisito
Subscrição	Uma conta do Azure com uma assinatura ativa. Crie uma conta gratuitamente.
Permissões	Funcionalidade de controlo de acesso baseado em funções no Azure com permissões para criar e gerir recursos na subscrição, como Colaborador ou Proprietário.
Recurso	- Um centro de desenvolvimento.

Criar um projeto

Para criar um projeto no seu centro de desenvolvimento:

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 subscrição predefinida como a subscrição onde o seu centro de desenvolvimento se encontra:

   az account set --subscription <subscriptionName>
   

4. Configure o grupo de recursos padrão como o grupo de recursos onde o seu centro de desenvolvimento reside.

   az configure --defaults group=<resourceGroupName>
   

5. Configure a localização predefinida como o local onde o seu centro de desenvolvimento está localizado. A localização do projeto deve coincidir com a localização do centro de desenvolvimento.

   az configure --defaults location=eastus
   

6. Recuperar o ID do recurso do centro de desenvolvimento:

   $DEVCID = az devcenter admin devcenter show -n <devcenterName> --query id -o tsv
   Write-Output $DEVCID
   

7. Crie o projeto no centro de desenvolvimento.

   az devcenter admin project create -n <projectName> `
   --description "My first project." `
   --dev-center-id $DEVCID
   

8. Confirme que o projeto foi criado com sucesso.

   az devcenter admin project show -n <projectName>
   

Atribuir o papel de Proprietário a uma identidade gerida

Antes de poder criar tipos de ambiente, deve conceder à identidade gerida que representa o seu centro de desenvolvimento acesso às subscrições onde configura os tipos de ambiente do projeto.

Neste guia rápido, atribui a função de Proprietário à identidade gerida atribuída ao sistema que configurou anteriormente: Anexar uma identidade gerida atribuída ao sistema.

1. Recuperar o ID da subscrição:

   $SUBID = az account show --name <subscriptionName> --query id -o tsv
   Write-Output $SUBID
   

2. Recupere o ID do objeto da identidade do centro de desenvolvimento usando o nome do recurso do centro de desenvolvimento.

   $OID = az ad sp list --display-name <devcenterName> --query [].id -o tsv
   Write-Output $OID
   

3. Atribua o papel de Proprietário ao centro de desenvolvimento na subscrição:

   az role assignment create --assignee $OID `
   --role "Owner" `
   --scope "/subscriptions/$SUBID"
   

Configurar um projeto

Para configurar um projeto, adicione um project environment type:

1. Recuperar o ID da função do proprietário da subscrição:

   # Remove the group default scope for next the command. 
   az configure --defaults group=
   
   $ROID = az role definition list -n "Owner" --scope /subscriptions/$SUBID --query [].name -o tsv
   Write-Output $ROID
   
   # Set the default resource group again.
   az configure --defaults group=<resourceGroupName>
   

2. Mostrar os tipos de ambiente permitidos para o projeto.

   az devcenter admin project-allowed-environment-type list --project <projectName> --query [].name
   

3. Escolha um tipo de ambiente e crie-o para o projeto:

   $roles = "{`"$($ROID)`":{}}"
   az devcenter admin project-environment-type create `
       -n <availableEnvironmentType> `
       --project <projectName> `
       --identity-type "SystemAssigned" `
       --roles $roles `
       --deployment-target-id "/subscriptions/$SUBID" `
       --status Enabled
   

Observação

Pelo menos uma identidade (atribuída ao sistema ou atribuída pelo usuário) deve ser habilitada para identidade de implantação. A identidade é utilizada para realizar a implementação do ambiente em nome do desenvolvedor. Além disso, a identidade associada ao centro de desenvolvimento deve ser atribuída ao papel de Proprietário para acesso à assinatura de implementação para cada tipo de ambiente.

Atribuir acesso ao ambiente

Neste guia rápido, você concede acesso ao seu próprio ID. Opcionalmente, pode substituir o valor de --assignee nos seguintes comandos por um ID de objeto de outro membro.

1. Recupere o seu próprio ID de objeto

   $MYOID = az ad signed-in-user show --query id -o tsv
   Write-Output $MYOID
   

2. Atribuir acesso de administrador

   az role assignment create --assignee $MYOID `
   --role "DevCenter Project Admin" `
   --scope "/subscriptions/$SUBID"
   

3. Opcionalmente, pode atribuir a função de Utilizador do Ambiente de Desenvolvimento.

   az role assignment create --assignee $MYOID `
   --role "Deployment Environments User" `
   --scope "/subscriptions/$SUBID"
   

Observação

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.

Próximo passo

Neste guia rápido, criou um projeto e concedeu acesso ao projeto à sua equipa de desenvolvimento. Para aprender como os membros da sua equipa de desenvolvimento podem criar ambientes, aceda ao próximo tutorial rápido:

Criar e acessar um ambiente usando a CLI do Azure