Exercício – Configurar seu ambiente

  • 4 minutos

Importante

É preciso ter uma assinatura do Azure para fazer esse exercício, e isso pode gerar encargos. Caso ainda não tenha uma assinatura do Azure, crie uma conta gratuita antes de começar.

Antes de começar a publicar o código Bicep reutilizável da empresa de brinquedos, você precisa configurar o 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ê verificará se a sua organização do Azure DevOps está preparada para concluir o restante deste módulo. Você a prepara executando um modelo que cria um projeto no Azure DevOps.

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

Dica

Mesmo que você tenha concluído o módulo anterior do roteiro de aprendizagem, siga estas instruções para criar um projeto. Dê um novo nome ao projeto.

Executar o modelo

Execute um modelo que configura seu projeto do Azure DevOps.

Executar o modelo

No site do Gerador de Demonstração do Azure DevOps:

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

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

    Captura de tela do painel do Gerador de Demonstração do Azure DevOps para criar um projeto.

  3. Selecione Create Project.

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

  4. Selecione Navigate to project para acessar o seu projeto no Azure DevOps.

Importante

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

Clonar o repositório

  1. Selecione Repos>Arquivos.

    Captura de tela do Azure DevOps que mostra o menu Repos, com a opção Arquivos realçada.

  2. Selecione Clonar.

    Captura de tela do Azure DevOps que mostra o repositório, com o botão Clonar realçado.

  3. Selecione Gerar credenciais do Git. Copie sua senha e salve-a. Você precisará dessa credencial ao autenticar em seu repositório quando confirmar as atualizações posteriormente em seus arquivos YAML.

    Captura de tela do Azure DevOps que mostra as configurações do repositório, com o botão Gerar Credenciais do Git realçado.

  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, com o botão Clonar no VS Code realçado.

  5. Crie uma pasta a ser usada para o repositório e selecione Selecionar Local do Repositório.

  6. Você está usando esse repositório pela primeira vez, portanto, talvez seja 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á alguns instantes.

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

    Captura de tela do Visual Studio Code que mostra um prompt para abrir o repositório clonado com o botão Abrir 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ê já 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.

    O shell padrão normalmente é pwsh, conforme mostrado no lado direito da janela do terminal.

    Captura de tela da janela do terminal do Visual Studio Code, em que pwsh é mostrado como a opção de shell.

  2. Selecione a lista suspensa Perfil de Inicialização e, em seguida, selecione Azure Cloud Shell (Bash).

    Captura de tela da janela do terminal do Visual Studio Code. A lista suspensa do shell do terminal e o item de menu do Azure Cloud Shell (Bash) são mostrados.

    Um novo shell é aberto.

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ê já instalou o Azure PowerShell.

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

    O shell padrão normalmente é pwsh, conforme mostrado no lado direito da janela do terminal.

    Captura de tela da janela do terminal do Visual Studio Code, em que pwsh é mostrado como a opção de shell.

  2. Selecione a lista suspensa Perfil de Inicialização e, em seguida, selecione Azure Cloud Shell (PowerShell).

    Captura de tela da janela do terminal do Visual Studio Code. A lista suspensa do shell do terminal e o item de menu do Azure Cloud Shell (PowerShell) são mostrados.

    Um novo shell é aberto.

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 ToyReusable --location westus3

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

New-AzResourceGroup -Name ToyReusable -Location westus3

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

Em seguida, crie uma conexão de serviço no Azure Pipelines. Esse processo cria automaticamente uma entidade de serviço no Azure. Isso também concede à entidade de serviço a função Contribuidor no grupo de recursos, o que permite que o pipeline faça a implantação no grupo de recursos.

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

    Captura de tela do Azure DevOps que mostra o menu, com o item Configurações do projeto realçado.

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

    Captura de tela do Azure DevOps que mostra o painel

  3. Selecione Azure Resource Manager>Avançar.

    Captura de tela do Azure DevOps que mostra o painel

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

    Captura de tela do Azure DevOps que mostra o painel Nova conexão de serviço do Azure, com a opção Entidade de serviço (automática) realçada.

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

    Se uma janela pop-up aparecer com uma mensagem solicitando que você entre no Azure, insira suas credenciais e entre.

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

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

    Captura de tela do Azure DevOps que mostra o painel

    Dica

    Neste exercício, para simplificar, você está permitindo que todos os pipelines acessem 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.