Exercício – Configurar seu ambiente

  • 4 minutos

Importante

Você precisa de sua própria assinatura do Azure para concluir este exercício e pode incorrer em encargos. Caso ainda não tenha uma assinatura do Azure, crie uma conta gratuita antes de começar.

Antes de começar a trabalhar no pipeline do site da empresa de brinquedos, você precisa configurar seu ambiente. Nesta seção, você verificará se os ambientes do Azure e do Azure DevOps estão configurados para concluir o restante deste módulo.

Para atingir esses objetivos, você vai:

  • Configure um projeto do Azure DevOps para este módulo.
  • Clonar o repositório do projeto no computador.
  • Criar um grupo de recursos no Azure.
  • Criar uma conexão de serviço no Azure Pipelines.

Obter o projeto do Azure DevOps

Nesta seção, você garantirá que sua organização do Azure DevOps esteja configurada para concluir o restante deste módulo. Você a configurará executando um modelo que cria um projeto no Azure DevOps.

Os módulos neste roteiro de aprendizagem fazem parte de uma progressão. Cada módulo tem um projeto associado do Azure DevOps.

Dica

Mesmo que você tenha concluído o módulo anterior no roteiro de aprendizagem, siga estas instruções para criar um novo projeto e verifique se você lhe deu um novo nome.

Executar o modelo

Execute um modelo que configure sua organização do Azure DevOps.

Importante

O Gerador de Demonstração do Azure DevOps não tem mais suporte, mas você ainda pode usá-lo para criar ambientes de demonstração. Atualmente, não há nenhum substituto, e seus recursos ou disponibilidade podem mudar no futuro.

  1. Obtenha e execute o projeto ADOGenerator no Visual Studio ou em outro IDE.

  2. Quando for perguntado se deseja criar um novo modelo ou usar o gerador de demonstração, insira 1 e selecione Enter.

  3. Quando solicitado a inserir o número do modelo na lista de modelos acima, insira41 para testar o código Bicep usando o Azure Pipelines e selecione Enter.

  4. Escolha seu método de autenticação. Você pode configurar e usar um PAT (Token de Acesso Pessoal) ou usar o logon do dispositivo.

    Observação

    Se você configurar um PAT, certifique-se de autorizar os escopos necessários. Para este módulo, você pode usar o acesso completo, mas em uma situação real, você deve conceder apenas os escopos necessários.

  5. Insira o nome da sua organização do Azure DevOps e selecione Enter.

  6. Se solicitado, insira o PAT do Azure DevOps e selecione Enter.

  7. Insira um nome de projeto, como toy-website-test e, em seguida, selecione Enter.

  8. Depois que o projeto for criado, acesse sua organização do Azure DevOps no navegador (em https://dev.azure.com/<your-organization-name>/) e selecione o projeto.

  9. No Azure DevOps, crie um agente auto-hospedado no pool Padrão.

Bifurcar o repositório

Caso ainda não tenha feito isso, crie uma bifurcação do repositório mslearn-test-bicep-code-using-github-actions .

  1. No GitHub, acesse o repositório mslearn-test-bicep-code-using-github-actions.

  2. Selecione Fork no canto superior direito da tela.

  3. Escolha sua conta do GitHub como o Proprietário e, em seguida, selecione Criar fork.

Clonar o repositório

  1. No Azure DevOps, selecione Repositórios>Arquivos.

    Captura de tela do Azure DevOps que mostra o menu Repos. Os arquivos são realçados.

  2. Selecione Clonar.

    Captura de tela do Azure DevOps que mostra o repositório. O botão Clonar está realçado.

  3. Se você estiver usando o macOS, precisará de uma senha especial para clonar o repositório Git. Selecione Gerar Credenciais do Git e copie o nome de usuário e a senha exibidos em algum lugar seguro.

  4. Selecione Clonar no VS Code. Se um prompt aparecer solicitando a abertura do Visual Studio Code, selecione Abrir.

    Captura de tela do Azure DevOps que mostra as configurações do repositório. O botão para clonagem no Visual Studio Code está realçado.

  5. Se uma caixa de diálogo solicitar que você permita que uma extensão abra o URI do repositório, selecione Abrir.

  6. Crie uma pasta a ser usada para o repositório e clique em Selecionar como destino do repositório.

  7. Você está usando esse repositório pela primeira vez, portanto, será solicitado que você entre.

    • Se estiver usando Windows, insira as mesmas credenciais que usou para entrar no Azure DevOps anteriormente neste exercício.

    • Se você estiver usando o macOS, insira o nome de usuário e a senha do Git que você gerou há algum tempo.

  8. O Visual Studio Code solicita que você abra o repositório. Selecione Abrir.

    Captura de tela do prompt do Visual Studio Code para abrir o repositório clonado. O botão Abrir está realçado.

Entrar no Azure

Para trabalhar com grupos de recursos no Azure, entre na sua conta do Azure usando o terminal do Visual Studio Code. Verifique se você instalou as ferramentas da CLI do Azure.

  1. No menu Terminal, selecione Novo Terminal. A janela do terminal geralmente é aberta na metade inferior da tela.

  2. Se o shell mostrado no lado direito da janela do terminal for o bash, o shell correto será aberto e você poderá passar para a próxima seção.

    Captura de tela da janela do terminal do Visual Studio Code. A opção bash está realçada.

  3. Se aparecer um shell diferente do bash, selecione a seta da lista de seleção do shell e selecione Git Bash.

    Captura de tela da janela do terminal do Visual Studio Code. A lista suspensa de shells do terminal é mostrada e o Git Bash está selecionado.

  4. Na lista de shells de terminal, selecione bash e selecione o sinal de adição para abrir um novo terminal que usa o shell bash.

    Captura de tela da janela do terminal do Visual Studio Code. O terminal bash e o sinal de adição estão destacados.

Entrar no Azure usando a CLI do Azure

  1. No terminal no Visual Studio Code, execute o seguinte comando para entrar no Azure:

    az login

  2. No navegador que é aberto, entre em sua conta do Azure.

Para trabalhar com grupos de recursos no Azure, entre na sua conta do Azure usando o terminal do Visual Studio Code. Verifique se você instalou o Azure PowerShell.

  1. No menu Terminal, selecione Novo Terminal. A janela do terminal geralmente é aberta na metade inferior da tela.

  2. Se o shell mostrado no lado direito da janela do terminal for o powershell ou pwsh, o shell correto será aberto e você poderá passar para a próxima seção.

    Captura de tela da janela do terminal do Visual Studio Code. A opção pwsh está realçada.

  3. Se aparecer um shell diferente do powershell ou pwsh, selecione a seta da lista de seleção do shell e escolha PowerShell.

    Captura de tela da janela do terminal do Visual Studio Code. O PowerShell está selecionado na lista suspensa de shells do terminal.

  4. Na lista de shells de terminal, selecione powershell ou pwsh e depois selecione o sinal de mais para abrir um novo terminal que usa o shell do powershell ou pwsh.

    Captura de tela da janela do terminal do Visual Studio Code. O terminal do PowerShell e o sinal de adição estão selecionados.

Entrar no Azure usando o Azure PowerShell

  1. No terminal no Visual Studio Code, execute o seguinte comando para entrar no Azure:

    Connect-AzAccount

  2. No navegador que é aberto, entre em sua conta do Azure.

Criar um grupo de recursos no Azure

Para criar um grupo de recursos, execute este comando da CLI do Azure no terminal do Visual Studio Code:

az group create --name ToyWebsiteTest --location westus3

Para criar um grupo de recursos, execute este comando do Azure PowerShell no terminal do Visual Studio Code:

New-AzResourceGroup -Name ToyWebsiteTest -Location westus3

Criar uma conexão de serviço no Azure Pipelines

Em seguida, crie uma conexão de serviço no Azure Pipelines. Essa conexão criará automaticamente um principal de serviço no Azure. Também concederá à entidade de serviço a função Colaborador no seu grupo de recursos, o que permite que o pipeline seja implantado no grupo de recursos.

  1. No projeto que você criou anteriormente, selecione as configurações do Projeto.

    Captura de tela do Azure DevOps. O item de menu para as configurações do projeto está realçado.

  2. Selecione Conexões de serviço>Criar conexão de serviço.

    Captura de tela do Azure DevOps que mostra as etapas para criar uma conexão de serviço.

  3. Selecione Azure Resource Manager>Avançar.

    Captura de tela do Azure DevOps. O tipo de conexão de serviço do Azure Resource Manager está selecionado.

  4. Selecione Registro de aplicativo (automático).

  5. No menu suspenso Assinatura, selecione sua assinatura do Azure.

    Uma janela pop-up pode solicitar que você entre no Azure. Se for o caso, insira suas credenciais e entre.

  6. Na lista suspensa Grupo de recursos, selecione ToyWebsiteTest.

  7. No Nome da Conexão de Serviço, insira ToyWebsiteTest. Verifique se a caixa de seleção Conceder permissão de acesso para todos os pipelines está selecionada.

    Captura de tela que mostra as etapas para criar uma conexão de serviço.

    Dica

    Para simplificar, você está dando a cada pipeline acesso à sua conexão de serviço. Ao criar conexões de serviço reais que funcionam com recursos de produção, considere restringir o acesso apenas aos pipelines que precisam delas.

  8. Selecione Salvar.