Exercício – Configurar seu ambiente do Azure DevOps

• 8 minutos

Nesta unidade, você garantirá que a sua organização do Microsoft Azure DevOps esteja pronta para concluir o restante deste módulo.

Para fazer isso, você precisará:

Obter o projeto do Azure DevOps

Aqui, você verificará se a sua organização do Azure DevOps está configurada para concluir o restante deste módulo. É possível fazer isso executando um modelo que cria um projeto para você no Azure DevOps.

Os módulos deste roteiro de aprendizagem formam uma progressão, em que você segue a equipe da Tailspin ao longo da jornada de DevOps. Para fins de aprendizado, cada módulo tem um projeto do Azure DevOps associado.

Executar o modelo

Para configurar tudo para você em sua organização do Azure DevOps, execute um modelo.

No site do Azure DevOps Demo Generator, para executar o modelo, siga estas etapas.

1. Selecione Sign In e aceite os termos de uso.

2. Na página Create New Project, selecione sua organização do Azure DevOps e insira um nome de projeto. Por exemplo, insira Space Game – Web – Dependencies.

3. Selecione Sim, desejo criar um fork deste repositório e escolha Autorizar. Se uma janela aparecer, autorize o acesso à sua conta do GitHub.

   Importante

   Você precisa selecionar esta opção para o modelo se conectar ao seu repositório do GitHub. Selecione esta opção mesmo que já tenha criado o fork do projeto do site do Space Game. O modelo usa sua bifurcação existente.

4. Selecione Create Project.

   

   São necessários alguns instantes para o modelo ser executado.

5. Para acessar seu projeto no Azure DevOps, selecione Navegar para o projeto quando o projeto terminar de ser criado.

Definir a visibilidade do projeto

Inicialmente, o fork do repositório Space Game no GitHub é definido como público, ao passo que o projeto criado pelo modelo do Azure DevOps é 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ê escolhe compartilhá-lo. Da mesma forma, no Azure DevOps, os projetos públicos fornecem acesso somente leitura a usuários não autenticados, enquanto projetos privados exigem que os usuários tenham 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, em seus projetos pessoais, você precisa determinar a visibilidade e o acesso que deseja permitir às outras pessoas. Por exemplo, se o projeto for de código aberto, você poderá optar por tornar o repositório GitHub e o projeto do Azure DevOps públicos. Se o projeto for proprietário, normalmente, você tornará o repositório GitHub e o projeto do Azure DevOps privados.

Mais adiante você poderá se interessar pelos seguintes recursos para determinar qual opção é melhor para seu projeto:

• Usar projetos públicos e privados
• Guia de Início Rápido: Tornar público seu projeto privado
• Definir a visibilidade do repositório

Mover o item de trabalho para Executando

Nesta seção, você atribuirá a si mesmo um item de trabalho relacionado a este módulo no Azure Boards. Você também moverá o item de trabalho para o estado Executando. Na prática, você e sua equipe criarão itens de trabalho no início de cada sprint ou iteração de trabalho.

A atribuição de trabalho dessa maneira gera uma lista de verificação para seu uso. Isso dá às outras pessoas de sua equipe visibilidade daquilo em que você está trabalhando e de quanto trabalho resta fazer. Também ajuda a equipe a impor limites de trabalho em andamento para que ela não assuma trabalho demais ao mesmo tempo.

Lembre-se de que a equipe decidiu que estes são os sete problemas principais:

Aqui, você moverá o sexto item, Mover dados de modelo para um pacote próprio para a coluna Executando e atribuirá a si mesmo ao item de trabalho.

Lembre-se de que Move model data to its own package está relacionado a mover código reutilizável para o próprio pacote do NuGet para que esse pacote possa ser compartilhado entre vários aplicativos.

Para configurar o item de trabalho:

1. No Azure DevOps, acesse Boards e selecione Boards no menu.

   

2. No item de trabalho Mover dados do modelo para seu pacote, selecione a seta para baixo na parte inferior da cartão e atribua o item de trabalho a si mesmo.

   

3. Mova o item de trabalho da coluna Tarefa Pendente para a coluna Executando.

   

No final deste módulo, você moverá o cartão para a coluna Concluído depois de concluir a tarefa.

Configurar o projeto localmente

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

Abrir o terminal integrado

O Visual Studio Code é fornecido com um terminal integrado para que você possa editar arquivos e trabalhar na linha de comando, tudo isso em um só lugar.

1. Inicie o Visual Studio Code.

2. No menu Exibir, selecione Terminal.

3. Na lista suspensa, escolha bash. Se você estiver familiarizado com outro shell do Unix que prefira usar, como Zsh, selecione esse shell.

   

   A janela de terminal permite que você escolha um shell que é instalado no sistema, como o Bash, o Zsh e o PowerShell.

   Aqui você usará o Bash. O Git para Windows fornece o Git Bash, o que facilita a execução de comandos 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 comando cd para navegar até o diretório no qual deseja trabalhar, como o diretório base (~). Você poderá escolher outro diretório se desejar.

   cd ~
   

Configurar o Git

Se você estiver usando o Git e o GitHub pela primeira vez, precisará primeiro executar alguns comandos para associar sua identidade ao Git e se autenticar no GitHub.

A seção Configurar o Git explica o processo mais detalhadamente.

No mínimo, você precisará concluir as etapas a seguir. Execute estes comandos no terminal integrado:

1. Defina o seu nome de usuário.
2. Defina seu endereço de email de commit.
3. Armazene em cache a sua senha do GitHub.

Configurar seu projeto no Visual Studio Code

Nesta parte, você clona o seu fork localmente para que seja possível fazer alterações e criar a sua configuração de pipeline.

Clonar o fork localmente

Agora você tem uma cópia do projeto Web Space Game em sua conta do GitHub. Agora, você baixará ou clonará uma cópia no computador para trabalhar com ela.

Um clone, assim como um fork, é uma cópia de um repositório. Ao clonar um repositório, você poderá fazer alterações, verificar se elas funcionam conforme o esperado e, em seguida, fará upload das alterações novamente no GitHub. Você também poderá sincronizar a cópia local com as alterações feitas por outros usuários autenticados na cópia do GitHub do repositório.

Para clonar o projeto Web Space Game no computador:

1. Acesse o fork do projeto Web do Space Game (mslearn-tailspin-spacegame-web) no GitHub.

2. Selecione Código. Em seguida, na guia HTTPS, clique no botão ao lado da URL mostrada a fim de copiá-la para a área de transferência.

   

3. No Visual Studio Code, acesse a janela do terminal.

4. No terminal, acesse o diretório do qual você deseja trabalhar, como o diretório base (~). Você poderá escolher outro diretório se desejar.

   cd ~
   

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

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

6. Acesse o diretório mslearn-tailspin-spacegame-web. Esse é o diretório raiz do repositório.

   cd mslearn-tailspin-spacegame-web
   

Definir o repositório remoto upstream

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

1. Execute este comando git remote para listar os seus repositórios remotos:

   git remote -v
   

   Você verá que tem acesso de fetch (download) e push (upload) ao repositório:

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

   Origem especifica o repositório no GitHub. Ao criar um fork do código de outro repositório, é comum nomear o repositório remoto original (aquele que é a origem do fork) upstream.

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

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

3. Execute git remote uma segunda vez para ver as alterações:

   git remote -v
   

   Você verá que ainda têm acesso de fetch (download) e push (upload) ao repositório. Agora você também tem acesso de fetch e push no repositório da Microsoft:

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

Abrir o projeto no Explorador de Arquivos

No Visual Studio Code, a janela do terminal aponta para o diretório raiz do projeto Web Space Game. Para exibir a estrutura dele e trabalhar com arquivos, no Explorador de Arquivos, agora 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 no terminal integrado:

   code -r .
   

   Você verá a árvore de diretórios e arquivos no Explorador de Arquivos.

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

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

1. No Visual Studio Code, selecione F1 ou Exibir>Paleta de Comandos para acessar a paleta de comandos.
2. Na paleta de comandos, insira Shell Command: Install 'code' command in PATH.
3. Repita o procedimento anterior para abrir o projeto no Explorador de Arquivos.

Agora você está preparado para trabalhar com o código-fonte do Space Game e a sua configuração do Azure Pipelines no ambiente de desenvolvimento local.