Exercício – Configurar o seu ambiente
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, você:
- 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.
- Remova os recursos que você não precisa no projeto de DevOps do Azure pré-criado.
Obtenha o projeto Azure DevOps
Certifique-se de 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 percurso de aprendizagem, siga estas instruções para criar um novo projeto. Certifique-se de dar-lhe um novo nome.
Executar o modelo
Execute um modelo que configure seu projeto do Azure DevOps.
No site do Gerador de Demonstração do Azure DevOps, siga estas etapas:
Selecione Entrar e aceite os termos de uso.
Na página Criar Novo Projeto, selecione sua organização do Azure DevOps. Em seguida, insira um nome de projeto, como toy-website-environments.
Selecione Criar projeto.
O modelo leva alguns minutos para ser executado. Ele cria automaticamente um pipeline e um arquivo Bicep para você trabalhar nos exercícios subsequentes.
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
Selecione Arquivos de repos>.
Selecione Clonar.
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 algum lugar seguro.
Selecione Clonar no VS Code. Se você for solicitado a permitir que o Visual Studio Code seja aberto, selecione Abrir.
Se uma caixa de diálogo for exibida, solicitando que você permita que uma extensão abra o URI do repositório, selecione Abrir.
Crie uma pasta para usar no repositório e escolha Selecionar local do repositório.
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á alguns instantes.
O Visual Studio Code solicita que você abra o repositório. Selecione Abrir.
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.
No menu Terminal, selecione Novo Terminal. A janela do terminal geralmente abre na metade inferior da tela.
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.
Se um shell diferente de bash aparecer, selecione a lista suspensa do shell e, em seguida, selecione Git Bash (Padrão).
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 .
Entrar no Azure usando a CLI do Azure
No terminal do Visual Studio Code, execute o seguinte comando para entrar no Azure:
az login
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.
No menu Terminal, selecione Novo Terminal. A janela do terminal geralmente abre na metade inferior da tela.
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.
Se um shell diferente de powershell ou pwsh for exibido, selecione a lista suspensa de shell e selecione PowerShell.
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 .
Iniciar sessão no Azure com o Azure PowerShell
No terminal do Visual Studio Code, execute o seguinte comando para entrar no Azure:
Connect-AzAccount
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.
No navegador, selecione Configurações do projeto.
Selecione Conexões>de serviço Criar conexão de serviço.
Selecione Azure Resource Manager>Next.
Selecione Entidade de serviço (automática)>Seguinte.
Na lista suspensa Assinatura, selecione sua assinatura do Azure.
Uma janela pop-up pode aparecer, solicitando que você entre no Azure. Em caso afirmativo, introduza as suas credenciais e inicie sessão.
Na lista suspensa Grupo de recursos, selecione ToyWebsiteTest.
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 está marcada e selecione Salvar.
Gorjeta
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.
Repita o processo anterior para criar outra nova conexão de serviço chamada ToyWebsiteProduction, que é implantada no grupo de recursos chamado ToyWebsiteProduction.
Se a lista de grupos de recursos não for atualizada, atualize a página no navegador e tente novamente.
Criar ambientes no Azure Pipelines
No navegador, vá para Ambientes de Pipelines>.
Selecione Novo ambiente.
Insira Test como o nome do ambiente.
Deixe a descrição em branco. Em Recurso, selecione Nenhum. Depois, selecione Criar.
Nota
No Azure Pipelines, os ambientes são usados para habilitar recursos de implantação. Alguns desses recursos se aplicam somente quando você está implantando no Kubernetes ou em máquinas virtuais. Neste módulo, não usamos esses recursos e você pode ignorá-los.
Antes que um pipeline possa usar o ambiente, você deve conceder-lhe permissão. Para simplificar, você permite que todos os pipelines acessem o ambiente. Em seus próprios pipelines, você deve restringir o acesso aos ambientes apenas aos pipelines que o exigem.
Selecione o botão com três pontos e selecione Segurança.
Na seção chamada Permissões de pipeline, se houver um botão intitulado Restringir permissão, selecione-o.
Selecione o botão com três pontos. Selecione Acesso aberto.
Selecione a seta para a esquerda duas vezes para retornar à lista de ambientes.
Repita o processo para criar outro ambiente chamado Production. Lembre-se de defini-lo para acesso aberto.
Deixe a página do ambiente de produção aberta.
Adicionar uma verificação de aprovação ao ambiente de produção
Perto do canto superior direito da página, selecione o botão com três pontos e selecione Aprovações e verificações no menu pop-up.
Selecione Aprovações.
Na caixa de texto Aprovadores , digite seu próprio nome e selecione-se .
Selecione o botão de seta ao lado de Avançado.
Observe que, por padrão, os aprovadores têm permissão para aprovar as execuções que acionaram. Como você é a única pessoa que usa esse pipeline, deixe esta caixa de seleção marcada. Em outras organizações, talvez seja necessário especificar um aprovador diferente para atender aos requisitos de conformidade.
Selecione Criar.
Excluir o ambiente antigo
Nas versões anteriores do pipeline, você usava um único ambiente chamado Website. Agora que você criou ambientes de pipeline que representam seus novos ambientes, você pode excluir o ambiente de pipeline antigo.
Vá para Ambientes de Pipelines>.
Selecione o ambiente do site .
Perto do canto superior direito da página, selecione o botão com três pontos e selecione Excluir no menu pop-up.
Selecione Eliminar para confirmar a eliminação.
Excluir as variáveis antigas
Nas versões anteriores do pipeline, você usava um único conjunto de variáveis para definir os parâmetros e a configuração de implantação. Agora que você está implantando em vários ambientes, pode excluir essas variáveis e substituí-las por conjuntos de variáveis específicas do ambiente em breve.
Vá para Pipelines>Pipelines.
Selecione o pipeline toy-website-environments .
Selecione o botão Editar.
Selecione o botão Variáveis .
Selecione o botão Excluir variável para cada uma das três variáveis.
Selecione Guardar.