Exercício – Configurar o seu ambiente

  • 5 minutos

Importante

Precisa da sua própria subscrição do Azure para executar este exercício e poderá incorrer em custos. Se ainda não tiver uma subscrição do Azure, crie uma conta gratuita antes de começar.

Antes de começar a trabalhar no pipeline de sites da sua empresa de brinquedos, você precisa configurar seu ambiente. Nesta unidade, você garante que seus ambientes Azure e Azure DevOps estejam configurados para concluir o restante deste módulo.

Para atingir esses objetivos, execute as seguintes tarefas:

  • Configure um projeto de DevOps do Azure para este módulo.
  • Clone o repositório do projeto para o seu computador.
  • Crie dois grupos de recursos no Azure.
  • Crie duas conexões de serviço e ambientes no Azure Pipelines.

Obtenha o projeto Azure DevOps

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

Os módulos deste percurso de aprendizagem fazem parte de uma progressão. Para fins de aprendizagem, cada módulo tem um projeto de DevOps do Azure associado.

Gorjeta

Mesmo que tenha concluído o módulo anterior no caminho de aprendizagem, siga estas instruções para criar um novo projeto. Certifique-se de dar um novo nome ao projeto.

Executar o modelo

Execute um modelo que configure seu projeto do Azure DevOps.

Executar o modelo

No site do Gerador de Demonstração do Azure DevOps, execute as seguintes etapas:

  1. Selecione Entrar e concorde com os termos de uso do site selecionando Aceitar.

  2. Na página Criar Novo Projeto, selecione sua organização do Azure DevOps e, na caixa Novo Nome do Projeto, insira um nome de projeto, como toy-website-end-to-end.

    Screenshot of the Azure DevOps Demo Generator pane for creating a new project.

  3. Selecione Criar projeto.

    O modelo leva alguns minutos para ser executado. Ele cria automaticamente um pipeline e um arquivo Bicep para você trabalhar nos próximos exercícios.

  4. Selecione Navegar para o projeto para ir para o seu projeto no Azure DevOps.

Importante

O exercício final deste módulo contém etapas de limpeza importantes. Certifique-se de seguir as etapas de limpeza, mesmo que não conclua este módulo.

Clonar o repositório

  1. Selecione Arquivos de repos>.

    Screenshot of Azure DevOps that shows the Repos menu, with Files highlighted.

  2. Selecione Clonar.

    Screenshot of Azure DevOps showing the repository, with the Clone button highlighted.

  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 para um lugar seguro.

  4. Selecione Clonar no VS Code. Se você for solicitado a permitir que o código do Visual Studio (VS) seja aberto, selecione Abrir.

    Screenshot of Azure DevOps that shows the repository settings, with the Clone in VS Code button highlighted.

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

  6. Crie uma pasta para usar no repositório e selecione Selecionar local do repositório.

  7. Se for a primeira vez que está a utilizar este repositório, poderá ser-lhe pedido para iniciar sessão.

    • Para Windows, insira as mesmas credenciais que você usou para entrar no Azure DevOps anteriormente neste exercício.

    • Para macOS, digite o nome de usuário e a senha do Git que você gerou há alguns instantes.

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

    Screenshot of Visual Studio Code that shows a prompt to open the cloned repository, with the Open button highlighted.

Iniciar sessão no Azure

Para trabalhar com grupos de recursos no Azure, inicie sessão na sua conta do Azure a partir do terminal do Visual Studio Code. Certifique-se de ter instalado as ferramentas da CLI do Azure.

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

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

    Screenshot of the Visual Studio Code terminal window, with the bash option shown.

  3. Se um shell diferente de bash aparecer, selecione a lista suspensa do shell e, em seguida, selecione Git Bash (Padrão).

    Screenshot of the Visual Studio Code terminal window, with the terminal shell dropdown shown and Git Bash Default selected.

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

    Screenshot of the Visual Studio Code terminal window, with the bash terminal and the plus sign selected.

Entrar no Azure usando a CLI do Azure

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

    az login

  2. No browser que se abre, inicie sessão na sua conta do Azure.

Para trabalhar com grupos de recursos no Azure, inicie sessão na sua conta do Azure a partir do terminal do Visual Studio Code. Certifique-se de que instalou o Azure PowerShell.

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

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

    Screenshot of the Visual Studio Code terminal window, with the p w s h option displayed in the shell dropdown.

  3. Se um shell diferente de powershell ou pwsh for exibido, selecione a lista suspensa de shell e selecione PowerShell.

    Screenshot of the Visual Studio Code terminal window, with the terminal shell dropdown shown and powershell selected.

  4. Na lista de shells de terminal, selecione powershell ou pwsh e, em seguida, selecione o sinal de adição para abrir um novo terminal que use o shell powershell ou pwsh .

    Screenshot of the Visual Studio Code terminal window, with the powershell terminal and the plus sign selected.

Iniciar sessão no Azure com o Azure PowerShell

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

    Connect-AzAccount

  2. No browser que se abre, inicie sessão na sua conta do Azure.

Criar dois grupos de recursos no Azure

Para criar os dois novos grupos de recursos, execute os seguintes comandos da CLI do Azure no terminal do Visual Studio Code:

az group create --name ToyWebsiteTest --location westus3
az group create --name ToyWebsiteProduction --location westus3

Para criar os dois novos grupos de recursos, execute os seguintes comandos do Azure PowerShell no terminal do Visual Studio Code:

New-AzResourceGroup -Name ToyWebsiteTest -Location westus3
New-AzResourceGroup -Name ToyWebsiteProduction -Location westus3

Criar conexões de serviço no Azure Pipelines

Em seguida, crie duas conexões de serviço no Azure Pipelines, uma para seu ambiente de teste e outra para seu ambiente de produção. Esse processo cria automaticamente uma entidade de serviço no Azure. Ele também concede à entidade de serviço a função de Colaborador em seu grupo de recursos, o que permite que seu pipeline seja implantado no grupo de recursos.

  1. No navegador, selecione Configurações do projeto.

    Screenshot of Azure DevOps that shows the menu, with the Project settings item highlighted.

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

    Screenshot of Azure DevOps that shows the Service connections pane, with the Create service connection button highlighted.

  3. Selecione Azure Resource Manager>Next.

    Screenshot of Azure DevOps that shows the Service connections pane, with the Azure Resource Manager service connection type highlighted.

  4. Selecione Entidade de serviço (automática)>Seguinte.

    Screenshot of Azure DevOps that shows the New Azure service connection pane, with the Service principal (automatic) option highlighted.

  5. Na lista suspensa Assinatura, selecione sua assinatura do Azure.

    Se aparecer uma janela pop-up com uma mensagem a pedir-lhe para iniciar sessão no Azure, introduza as suas credenciais e inicie sessão.

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

  7. Na caixa Nome da conexão de serviço, digite ToyWebsiteTest. Verifique se a caixa de seleção Conceder permissão de acesso a todos os pipelines está marcada.

    Screenshot of Azure DevOps that shows the New Azure service connection pane for the test environment, with the details completed and the Save button highlighted.

    Gorjeta

    Neste exercício, 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 deles.

  8. Selecione Guardar.

  9. Repita as etapas 1 a 8 para criar outra nova conexão de serviço chamada ToyWebsiteProduction, que é implantada no grupo de recursos chamado ToyWebsiteProduction:

    Screenshot of Azure DevOps that shows the New Azure service connection pane for the production environment, with the details completed and the Save button highlighted.

    Se a lista de grupos de recursos não for mostrada, atualize a página no navegador, insira suas credenciais, se solicitado, e tente novamente.

Nota

Nos módulos anteriores deste caminho de aprendizagem, você adicionou uma verificação de aprovação ao seu ambiente de produção. Neste módulo, para simplificar, você está ignorando a verificação de aprovação. No entanto, você mesmo pode adicionar a verificação de aprovação, se desejar.