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á:

  • Configure um projeto do Azure DevOps para este módulo.
  • Mova o item de trabalho para este módulo no Azure Boards para a coluna Doing.
  • O seu projeto deve estar configurado localmente de modo que você possa efetuar push das alterações para o pipeline.

Obter o projeto do Azure DevOps

Aqui, você irá certificar-se que a sua organização do Azure DevOps esteja preparada para concluir o restante desse módulo. Você faz 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

Executar um modelo que configura tudo para você em sua organização do Azure DevOps.

Executar o modelo

Para executar o modelo, no site Azure DevOps Demo Generator, faça o seguinte:

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

  2. Na página Criar Projeto, selecione sua organização do Azure DevOps e insira um nome de projeto, como Space Game - Web - Fluxo de trabalho.

  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 um fork do projeto do site do Space Game. O modelo usa sua bifurcação existente.

  4. Selecione Create Project.

    Captura de tela do Azure DevOps Demo Generator mostra como criar um projeto.

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

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

Importante

A página Limpar seu ambiente do Azure DevOps neste módulo contém etapas de limpeza importantes. A limpeza ajuda a garantir que você não fique sem minutos de build livres. Execute as etapas de limpeza mesmo que não conclua este módulo.

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:

Mover o item de trabalho para Executando

Nessa seção, você atribuirá a si mesmo um item de trabalho relacionado a esse 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 WIP (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:

Captura de tela do Azure Boards mostra uma lista de pendências de problemas.

Observação

Em uma organização do Azure DevOps, os itens de trabalho são numerados em sequência. Em seu projeto, o número atribuído a cada item de trabalho pode não corresponder ao que você vê aqui.

Aqui, você irá mover o segundo item, Criar um fluxo de trabalho baseado em Git, para a coluna Em andamento e irá atribuir o item de trabalho a si mesmo.

Lembre-se de que Criar um fluxo de trabalho baseado em Git está relacionado passar a usar um fluxo de trabalho de código que permite uma melhor colaboração entre os membros da equipe.

Uma captura de tela do Azure Boards que mostra os detalhes do item de trabalho para o problema Criar um fluxo de trabalho baseado em Git.

Para configurar o item de trabalho:

  1. No Azure DevOps, selecione Boards no painel esquerdo e selecione Boards.

    Captura de tela do Azure DevOps mostra a localização do menu Boards.

  2. No item de trabalho Criar um fluxo de trabalho baseado no Git, selecione a seta para baixo em Lista de tarefas e atribua o item de trabalho a si próprio.

    Captura de tela do Azure Boards mostra a localização da seta para baixo.

  3. Arraste o item de trabalho da coluna Lista de tarefas para a coluna Em execução.

    Uma captura de tela do Azure Boards que mostra o item de trabalho na coluna Doing.

Ao final desse módulo, você irá mover o cartão para a coluna Concluídodepois 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.

Observação

Se você já tiver configurado o projeto mslearn-tailspin-spacegame-web localmente, prossiga para a próxima seção.

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.

    Captura de tela do Visual Studio Code mostrando a localização do shell Bash.

    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.

Observação

Se você já estiver usando a autenticação de dois fatores com o GitHub, crie um token de acesso pessoal e use o token no lugar da senha quando solicitado mais tarde.

Trate seu token de acesso como faria com uma senha. Guarde-o em um local seguro.

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.

Observação

Se você receber erros relacionados a nomes de arquivos muito longos ao clonar seu repositório, tente clonar o repositório em uma pasta que não tenha um nome longo ou que não esteja muito aninhada.

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.

    Localização da URL e do botão Copiar no repositório GitHub.

  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.