Exercício – Configurar o seu ambiente

  • 4 minutos

Importante

Você precisa de sua própria assinatura do Azure para concluir este exercício e pode incorrer em cobranças. Se você ainda não tiver uma assinatura 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 seção, você verificará se seus ambientes Azure e Azure DevOps estão configurados para concluir o restante deste módulo.

Para atingir esses objetivos, você:

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

Obtenha o projeto Azure DevOps

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

Os módulos deste percurso de aprendizagem fazem parte de uma progressão. 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 e garantir que lhe dá 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 é mais suportado, mas você ainda pode usá-lo para criar ambientes de demonstração. Atualmente, não há substituição, 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 lhe for perguntado se pretende criar um novo modelo ou utilizar o gerador de demonstrações, introduza 1 e, em seguida, selecione Enter.

  3. Quando solicitado a Inserir o número do modelo na lista de modelos acima, digite 41 para Testar seu código Bicep usando o Azure Pipelines e selecione Enter.

  4. Escolha o seu método de autenticação. Você pode configurar e usar um Token de Acesso Pessoal (PAT) ou usar o login 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 total, mas em uma situação do mundo real, você deve conceder apenas os escopos necessários.

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

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

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

  8. Depois que seu projeto for criado, vá para sua organização do Azure DevOps em seu 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.

Fazer fork do repositório

Se ainda não o fez, crie uma bifurcação do repositório mslearn-test-bicep-code-using-github-actions .

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

  2. Selecione Forquilha no canto superior direito da tela.

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

Clonar o repositório

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

    Captura de ecrã do Azure DevOps que mostra o menu Repos. Arquivos é realçado.

  2. Selecione Clonar.

    Captura de tela do Azure DevOps que mostra o repositório. O botão Clone 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 você for solicitado a permitir que o Visual Studio Code seja aberto, selecione Abrir.

    Captura de ecrã do Azure DevOps que mostra as definições do repositório. O botão para clonagem no Visual Studio Code é 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. Está a utilizar este repositório pela primeira vez, pelo que lhe será pedido para iniciar sessão.

    • Se estiver a utilizar o Windows, introduza as mesmas credenciais que utilizou para iniciar sessão no Azure DevOps anteriormente neste exercício.

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

  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.

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.

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

  3. Se um shell diferente de bash aparecer, selecione a seta da lista de opções do shell e, em seguida, selecione Git Bash.

    Captura de ecrã da janela do terminal do Visual Studio Code. A lista pendente do shell do terminal é apresentada e o Git Bash está selecionado.

  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 .

    Captura de tela da janela do terminal do Visual Studio Code. O terminal bash e o sinal de mais são destacados.

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.

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

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

    Captura de ecrã da janela do terminal do Visual Studio Code. O PowerShell está selecionado no menu pendente do shell do terminal.

  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 utilize o shell powershell ou pwsh.

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

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 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 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 projeto criado anteriormente, selecione Configurações do projeto.

    Captura de ecrã do Azure DevOps. O item de menu para configurações do projeto é realçado.

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

    Captura de ecrã do Azure DevOps que mostra os passos para criar uma ligação de serviço.

  3. Selecione Azure Resource Manager>Next.

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

  4. Selecione Registo da aplicação (automático).

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

    Uma janela pop-up pode solicitar que você entre no Azure. Em caso afirmativo, introduza as suas credenciais e inicie sessão.

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

  7. Em 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 esteja marcada.

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

    Gorjeta

    Por uma questão de simplicidade, 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 Salvar.