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

  • 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.
  • Verifique se o projeto está configurado localmente para que você possa efetuar push das alterações para o pipeline.

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.

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 Create New Project, selecione sua organização do Azure DevOps e insira um nome de projeto, como Space Game – Web – Testes.

  3. Selecione a caixa ao lado de Sim, quero bifurcar este repositório e, em seguida, selecione 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 da tela Criar Projeto do Azure DevOps Demo Generator com o botão Criar Projeto realçado.

    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:

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.