Exercício - Configurar seu ambiente de DevOps do Azure

Nesta seção, você verificará se sua organização do Azure DevOps está configurada para concluir o restante deste módulo. Você também criará os ambientes do Serviço de Aplicativo do Azure nos quais será implantado.

Para configurar seu sistema, você:

Adicionar um usuário ao Azure DevOps

Para concluir este módulo, precisas da tua própria subscrição Azure . Pode começar a utilizar o Azure gratuitamente.

Embora você não precise de uma assinatura do Azure para trabalhar com o Azure DevOps, neste módulo você usará o Azure DevOps para implantar em recursos existentes em sua assinatura do Azure. Para simplificar o processo, você deve usar a mesma conta da Microsoft para entrar na sua assinatura do Azure e na sua organização do Azure DevOps.

Se você usar contas da Microsoft diferentes para entrar no Azure e no Azure DevOps, adicione um usuário à sua organização de DevOps na conta da Microsoft que você usa para entrar no Azure. Para obter mais informações, consulte Adicionar usuários à sua organização ou projeto. Ao adicionar o usuário, escolha o nível de acesso Básico.

Em seguida, saia do Azure DevOps e entre novamente na conta da Microsoft que você usa para entrar em sua assinatura do Azure.

Obtenha o projeto Azure DevOps

Aqui, você garantirá que sua organização do Azure DevOps esteja configurada para concluir o restante deste módulo. Você começará executando um modelo que cria seu projeto no Azure DevOps.

Os módulos neste caminho de aprendizagem fazem parte de uma progressão que segue a equipe da web da Tailspin durante sua jornada de DevOps. Para fins de aprendizagem, cada módulo tem um projeto de DevOps do Azure associado.

Executar o modelo

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

1. Obtenha e execute o projeto ADOGenerator no Visual Studio ou no IDE de sua escolha.

2. Quando solicitado a Inserir o número do modelo na lista de modelos, digite 33 para Executar testes não funcionais no Azure Pipelines e pressione Enter.

3. 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 configurar um PAT, certifique-se de autorizar as permissões necessárias. Para este módulo, você pode usar o acesso total, mas em uma situação do mundo real, você deve garantir que concede apenas os escopos necessários.

4. Insira o nome da organização do Azure DevOps e pressione Enter.

5. Se solicitado, insira seu PAT do Azure DevOps e pressione Enter.

6. Insira um nome de projeto, como Space Game - web - Nonfunctional tests (Jogo Espacial - Web - Testes não funcionais) e pressione Enter.

7. 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.

Fazer fork do repositório

Se ainda não o fez, crie uma bifurcação do repositório mslearn-tailspin-spacegame-web-deploy .

1. No GitHub, vá para o repositório mslearn-tailspin-spacegame-web-deploy .

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.

Defina a visibilidade do seu projeto

Inicialmente, sua bifurcação do repositório do Jogo Espacial no GitHub é definida como pública, enquanto o projeto criado pelo modelo de DevOps do Azure é definido como privado. Um repositório público no GitHub pode ser acessado por qualquer pessoa, enquanto um repositório privado só é acessível para você e para as pessoas com quem você escolher compartilhá-lo. Da mesma forma, no Azure DevOps, os projetos públicos fornecem acesso somente leitura a usuários não autenticados, enquanto os projetos privados exigem que os usuários recebam acesso e sejam autenticados para acessar os serviços.

No momento, não é necessário modificar nenhuma dessas configurações para os fins deste módulo. No entanto, para seus projetos pessoais, você deve determinar a visibilidade e o acesso que deseja conceder a outras pessoas. Por exemplo, se seu projeto for de código aberto, você pode optar por tornar público o repositório do GitHub e o projeto do Azure DevOps. Se seu projeto for proprietário, você normalmente tornará o repositório do GitHub e o projeto do Azure DevOps privados.

Mais tarde, você pode achar os seguintes recursos úteis para determinar qual opção é melhor para o seu projeto:

• Utilizar projetos privados e públicos
• Alterar a visibilidade do projeto para público ou privado
• Definindo a visibilidade do repositório

Configurar o projeto localmente

Aqui você carrega o projeto Space Game no Visual Studio Code, configura o Git, clona seu repositório localmente e define o controle remoto upstream para que você possa baixar o código inicial.

Abra o terminal integrado

O Visual Studio Code vem com um terminal integrado. Aqui você edita arquivos e trabalha a partir da linha de comando.

1. Inicie o Visual Studio Code.

2. No menu Ver, selecione Terminal.

3. Na lista suspensa, selecione Git Bash. Se você estiver familiarizado com outro shell Unix que você prefere usar, selecione esse shell em vez disso.

   

   Na janela do terminal, você pode escolher qualquer shell instalado no seu sistema. Por exemplo, você pode escolher Git Bash, PowerShell ou outro shell.

   Aqui você usará o Git Bash, parte do Git para Windows, que facilita a execução de comandos do Git.

   Observação

   No Windows, se você não vir o Git Bash listado como uma opção, verifique se instalou o Git e reinicie o Visual Studio Code.

4. Execute o cd comando para ir para o diretório onde você deseja trabalhar. Escolha o seu diretório pessoal (~) ou um diretório diferente, se desejar.

   cd ~
   

Configurar o Git

Se você é novo no Git e no GitHub, primeiro execute alguns comandos para associar sua identidade ao Git e autenticar com o GitHub. Para obter mais informações, consulte Configurar o Git.

No mínimo, você precisa concluir as etapas a seguir. Execute os comandos a partir do terminal integrado.

1. Defina o seu nome de utilizador.
2. Defina seu endereço de e-mail de confirmação.
3. Armazene em cache a sua palavra-passe do GitHub.

Configurar seu projeto no Visual Studio Code

No percurso de aprendizagem Criar aplicações com o Azure DevOps, você fez um fork e clonou um repositório do Git. O repositório contém o código-fonte do site Space Game . O seu fork foi ligado aos seus projetos no Azure DevOps para que a build seja executada quando o utilizador fizer push de alterações para o GitHub.

Nesta parte, você clona o seu fork localmente para que possa alterar e expandir a sua configuração de pipeline.

Clonar o seu fork localmente

Agora você tem uma cópia do projeto web Space Game em sua conta do GitHub. Agora você vai baixar, ou clonar, uma cópia para o seu computador para que você possa trabalhar com ele.

Um clone, assim como uma ramificação, é uma cópia de um repositório. Ao clonar um repositório, você pode fazer alterações, verificar se elas funcionam como esperado e, em seguida, carregar essas alterações no GitHub. Você também pode sincronizar sua cópia local com as alterações que outros usuários autenticados fizeram na cópia do GitHub do seu repositório.

Para clonar o projeto web Space Game para o seu computador:

1. Vá para o seu fork do projeto Space Game web (mslearn-tailspin-spacegame-web-deploy) no GitHub.

2. Selecione Código. Em seguida, no separador HTTPS, selecione o botão ao lado do URL mostrado para copiar o URL para a sua área de transferência.

   

3. No Visual Studio Code, vá para a janela do terminal.

4. No terminal, mova para o diretório onde deseja trabalhar. Escolha o seu diretório pessoal (~) ou um diretório diferente, se desejar.

   cd ~
   

5. Execute o comando git clone. Substitua o URL mostrado aqui pelo conteúdo da área de transferência:

   git clone https://github.com/your-name/mslearn-tailspin-spacegame-web-deploy.git
   

6. Mover para o mslearn-tailspin-spacegame-web-deploy diretório. Este é o diretório raiz do seu repositório.

   cd mslearn-tailspin-spacegame-web-deploy
   

Configurar o controle remoto upstream

Um remoto é um repositório Git onde os membros da equipe colaboram (como um repositório no GitHub). Aqui você lista seus controles remotos e adiciona um controle remoto que aponta para a cópia da Microsoft do repositório para que você possa obter o código de exemplo mais recente.

1. Execute este git remote comando para listar seus controles remotos:

   git remote -v
   

   Você vê que tem acesso de busca (download) e push (upload) ao seu repositório:

   origin  https://github.com/username/mslearn-tailspin-spacegame-web-deploy.git (fetch)
   origin  https://github.com/username/mslearn-tailspin-spacegame-web-deploy.git (push)
   

   Origin especifica seu repositório no GitHub. Quando crias um fork do código de outro repositório, o repositório remoto original (aquele do qual criaste o fork) geralmente é chamado de upstream.

2. Execute este git remote add comando para criar um controle remoto chamado upstream que aponte para o repositório da Microsoft:

   git remote add upstream https://github.com/MicrosoftDocs/mslearn-tailspin-spacegame-web-deploy.git
   

3. Execute git remote novamente para ver as alterações:

   git remote -v
   

   Você vê que ainda tem acesso de busca (download) e acesso push (upload) ao seu repositório. Agora você também tem acesso de busca ao repositório da Microsoft:

   origin  https://github.com/username/mslearn-tailspin-spacegame-web-deploy.git (fetch)
   origin  https://github.com/username/mslearn-tailspin-spacegame-web-deploy.git (push)
   upstream        https://github.com/MicrosoftDocs/mslearn-tailspin-spacegame-web-deploy.git (fetch)
   

Abrir o projeto no explorador de ficheiros

No Visual Studio Code, sua janela de terminal aponta para o diretório raiz do projeto web Space Game. Para visualizar sua estrutura e trabalhar com arquivos, no explorador de arquivos, você abrirá o projeto.

1. A maneira mais fácil de abrir o projeto é reabrir o Visual Studio Code no diretório atual. Para fazer isso, execute o seguinte comando a partir do terminal integrado:

   code -r .
   

   Você vê o diretório e a árvore de arquivos no explorador de arquivos.

2. Reabra o terminal integrado. O terminal coloca você na raiz do seu projeto web.

Se o code comando falhar, você precisará adicionar o Visual Studio Code ao PATH do sistema. Para tal:

1. No Visual Studio Code, selecione F1 ou View>Command Palette para acessar a paleta de comandos.
2. Na paleta de comandos, digite Comando de Shell: Instalar comando 'code' em PATH.
3. Repita o procedimento anterior para abrir o projeto no explorador de arquivos.

Agora você está configurado para trabalhar com o código-fonte do Jogo Espacial e sua configuração do Azure Pipelines a partir do seu ambiente de desenvolvimento local.

Criar os ambientes do Serviço de Aplicativo do Azure

Aqui, você criará os ambientes que definem os estágios do pipeline. Você criará uma instância do Serviço de Aplicativo que corresponde a cada estágio: Desenvolvimento, Teste e Preparo.

Nos módulos anteriores, você usava a CLI do Azure para criar suas instâncias do Serviço de Aplicativo. Aqui, você fará o mesmo.

Abrir o Cloud Shell através do portal do Azure

1. Vá para o portal do Azure e entre.
2. Na barra de menus, selecione Cloud Shell. Quando solicitado, selecione a experiência Bash.

Selecione uma região do Azure

Aqui você especifica a região padrão, ou localização geográfica, onde seus recursos do Azure devem ser criados.

1. No Cloud Shell, execute o seguinte az account list-locations comando para listar as regiões disponíveis na sua assinatura do Azure.

   az account list-locations \
     --query "[].{Name: name, DisplayName: displayName}" \
     --output table
   

2. Na coluna Nome na saída, escolha uma região próxima a você. Por exemplo, escolha eastasia ou westus2.

3. Execute az configure para definir sua região padrão. Substitua <REGION> pelo nome da região escolhida.

   az configure --defaults location=<REGION>
   

   Aqui está um exemplo que define westus2 como a região padrão:

   az configure --defaults location=westus2
   

Criar as instâncias do App Service

Aqui, você criará as instâncias do Serviço de Aplicativo para os três estágios nos quais será implantado: Desenvolvimento, Teste e Preparo.

1. No Cloud Shell, gere um número aleatório que torna o nome de domínio do seu aplicativo Web exclusivo.

   webappsuffix=$RANDOM
   

2. Execute o seguinte az group create comando para criar um grupo de recursos chamado tailspin-space-game-rg.

   az group create --name tailspin-space-game-rg
   

3. Execute o comando seguinte az appservice plan create para criar um plano do Serviço de Aplicativo chamado tailspin-space-game-asp.

   az appservice plan create \
     --name tailspin-space-game-asp \
     --resource-group tailspin-space-game-rg \
     --sku B1 \
     --is-linux
   

   O --sku argumento especifica o plano B1 , que é executado na camada Básica . O argumento --is-linux especifica a utilização de trabalhadores Linux.

   Importante

   Se a SKU B1 não estiver disponível como parte da sua assinatura do Azure, escolha um plano diferente, como o S1 (Standard).

4. Execute os comandos a seguir az webapp create para criar as três instâncias do Serviço de Aplicativo, uma para cada um dos ambientes de Desenvolvimento, Teste e Preparo.

   az webapp create \
     --name tailspin-space-game-web-dev-$webappsuffix \
     --resource-group tailspin-space-game-rg \
     --plan tailspin-space-game-asp \
     --runtime "DOTNET|6.0"
   
   az webapp create \
     --name tailspin-space-game-web-test-$webappsuffix \
     --resource-group tailspin-space-game-rg \
     --plan tailspin-space-game-asp \
     --runtime "DOTNET|6.0"
   
   az webapp create \
     --name tailspin-space-game-web-staging-$webappsuffix \
     --resource-group tailspin-space-game-rg \
     --plan tailspin-space-game-asp \
     --runtime "DOTNET|6.0"
   

   Para fins de aprendizagem, aqui, você aplica o mesmo plano do Serviço de Aplicativo, B1 Basic, a cada instância do Serviço de Aplicativo. Na prática, você atribuiria um plano que correspondesse à sua carga de trabalho esperada.

5. Execute o comando a seguir az webapp list para listar o nome do host e o estado de cada instância do Serviço de Aplicativo.

   az webapp list \
     --resource-group tailspin-space-game-rg \
     --query "[].{hostName: defaultHostName, state: state}" \
     --output table
   

   Observe o nome do host para cada serviço em execução. Você precisará desses nomes de host mais tarde quando verificar seu trabalho. Aqui está um exemplo:

   HostName                                                 State
   -------------------------------------------------------  -------
   tailspin-space-game-web-dev-21017.azurewebsites.net      Running
   tailspin-space-game-web-test-21017.azurewebsites.net     Running
   tailspin-space-game-web-staging-21017.azurewebsites.net  Running
   

6. Como etapa opcional, vá para um ou mais dos nomes listados para verificar se eles estão em execução e se a página inicial padrão aparece.

   Você vê esta página:

   

Criar variáveis de pipeline no Azure Pipelines

Em Executar testes funcionais no Azure Pipelines, você adicionou uma variável para cada uma das instâncias do Serviço de Aplicativo. As instâncias correspondem aos estágios de desenvolvimento, teste e preparo em seu pipeline. Aqui, você seguirá o mesmo padrão.

Cada estágio na configuração do pipeline usa as variáveis para identificar em qual instância do Serviço de Aplicativo implantar.

Para adicionar as variáveis:

1. No Azure DevOps, vá até o seu projeto Space Game - Web - testes não funcionais.

2. Em Pipelines, selecione Biblioteca.

3. Selecione + Grupo de variáveis.

4. Para o nome do grupo de variáveis, em Propriedades, insira Release.

5. Em Variáveis, selecione + Adicionar.

6. Para o nome da variável, digite WebAppNameDev. Para seu valor, insira o nome da instância do Serviço de Aplicativo que corresponde ao seu ambiente de Desenvolvimento , como tailspin-space-game-web-dev-1234.

7. Repita as etapas 5 e 6 mais duas vezes para criar variáveis para seus ambientes de teste e preparação , conforme mostrado nesta tabela:

   Nome da variável	Valor de Exemplo
   WebAppNameTest	tailspin-space-game-web-teste-1234
   WebAppNameStaging	tailspin-espaço-jogo-web-teste-1234

   Certifique-se de substituir cada valor de exemplo pela instância do Serviço de Aplicativo que corresponde ao seu ambiente.

   Importante

   Certifique-se de definir o nome da instância do Serviço de Aplicativo, não seu nome de host. Neste exemplo, você digitaria tailspin-space-game-web-dev-1234 e não tailspin-space-game-web-dev-1234.azurewebsites.net.

8. Para salvar sua variável no pipeline, selecione Salvar na parte superior da página.

   Seu grupo de variáveis é semelhante a este:

   

Crie os ambientes de desenvolvimento, teste e preparo

Em Executar testes funcionais no Azure Pipelines, você criou ambientes para os ambientes de desenvolvimento, teste e preparação . Aqui, você repetirá o processo.

Para criar os ambientes de desenvolvimento, teste e preparação :

1. Em Azure Pipelines, selecione Environments.

   

2. Para criar o ambiente de desenvolvimento :

   1. Selecione Criar ambiente.
   2. Em Nome, insira dev.
   3. Deixe os campos restantes em seus valores padrão.
   4. Selecione Criar.

3. Para criar o ambiente de teste :

   1. Regresse à página Ambientes .
   2. Selecione Novo ambiente.
   3. Em Nome, insira teste.
   4. Selecione Criar.

4. Para criar o ambiente de preparação :

   1. Regresse à página Ambientes .
   2. Selecione Novo ambiente.
   3. Em Nome, insira staging.
   4. Selecione Criar.

Criar uma conexão de serviço

Aqui, você criará uma conexão de serviço que permite que o Azure Pipelines acesse sua assinatura do Azure. O Azure Pipelines usa essa conexão de serviço para implantar o site no Serviço de Aplicativo. Você criou uma conexão de serviço semelhante no módulo anterior.

1. No Azure DevOps, vá até o seu projeto Space Game - Web - testes não funcionais.

2. No canto inferior da página, selecione Configurações do projeto.

3. Em Pipelines, selecione Conexões de serviço.

4. Selecione Nova conexão de serviço, escolha Gerenciador de Recursos do Azure e selecione Avançar.

5. Próximo ao topo da página, principal de serviço (automático). Em seguida, selecione Seguinte.

6. Preencha estes campos:

   Campo	Valor
   Nível de âmbito	Subscrição
   Subscrição	A sua subscrição do Azure
   Grupo de Recursos	tailspin-jogo-espacial-rg
   Nome da conexão de serviço	Gestor de Recursos - Tailspin - Jogo Espacial

   Durante o processo, poderá ser-lhe pedido para iniciar sessão na sua conta Microsoft.

7. Verifique se a opção Conceder permissão de acesso a todos os pipelines está selecionada.

8. Selecione Guardar.

   O Azure DevOps executa uma conexão de teste para verificar se ele pode se conectar à sua assinatura do Azure. Se o Azure DevOps não puder se conectar, você terá a chance de entrar pela segunda vez.