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

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
   

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"
   

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: