Exercício – configurar o ambiente do Azure DevOps

Concluído

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

Para fazer isso, você:

  • Configure um projeto de DevOps do Azure para este módulo.
  • Certifique-se de que seu projeto esteja configurado localmente para que você possa enviar as alterações para o pipeline.

Obtenha o projeto Azure DevOps

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

Os módulos neste percurso de aprendizagem formam uma progressão, onde segue a equipa Web da Tailspin através do respetivo percurso do DevOps. Para fins de aprendizagem, cada módulo tem um projeto de DevOps do Azure associado.

Executar o modelo

Executar um modelo que configura tudo automaticamente na sua organização do Azure DevOps.

Para executar o modelo, faça o seguinte no site do Gerador de Demonstração do Azure DevOps:

  1. Selecione Entrar e aceite os termos de uso.

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

  3. Selecione Fork repository no GitHub e, em seguida, selecione Authorize. Se for apresentada uma janela, autorize o acesso à sua conta do GitHub.

    Importante

    Tem de selecionar esta opção para o modelo se ligar ao seu repositório do GitHub. Selecione-o mesmo que você já tenha bifurcado o projeto do site Space Game . O modelo utiliza o seu fork existente.

  4. Selecione Criar projeto.

    A screenshot of the Azure DevOps Demo Generator Create New Project screen with the Create Project button highlighted.

    O modelo demora alguns momentos a ser executado.

  5. Selecione Navegar para o projeto para ir para o seu projeto no Azure DevOps.

Importante

A página Limpar o ambiente do Azure DevOps neste módulo contém passos de limpeza importantes. A limpeza ajuda a garantir que não fica sem minutos de compilação gratuitos. Certifique-se de que executa os passos de limpeza, mesmo que não conclua este módulo.

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 possa baixar o código inicial.

Nota

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

Abra o terminal integrado

O Visual Studio Code vem com um terminal integrado, para que você possa editar arquivos e trabalhar a partir da linha de comando em um só lugar.

  1. Inicie o Visual Studio Code.

  2. No menu Exibir, selecione Terminal.

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

    A screenshot of Visual Studio Code showing the location of the Bash shell.

    A janela do terminal permite que você escolha qualquer shell instalado em seu sistema, como Bash, Zsh e PowerShell.

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

    Nota

    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 navegar até o diretório a partir do qual você deseja trabalhar, como seu diretório base (~). Você pode escolher um diretório diferente, se desejar.

    cd ~
    

Configurar o Git

Se você é novo no Git e no GitHub, primeiro precisa executar alguns comandos para associar sua identidade ao Git e autenticar com o GitHub.

Configurar o Git explica o processo com mais detalhes.

No mínimo, você precisará concluir as etapas a seguir. Execute estes 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 sua senha do GitHub.

Nota

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

Trate o seu token de acesso como se fosse uma palavra-passe. Mantenha-o num local seguro.

Configurar seu projeto no Visual Studio Code

Nesta parte, você clona sua bifurcação localmente para que possa fazer alterações e construir 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 bifurcaçã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 de volta para o GitHub. Você também pode sincronizar sua cópia local com as alterações que outros usuários autenticados fizeram na cópia do repositório do GitHub.

Para clonar o projeto Web do Jogo Espacial para o seu computador:

  1. Vá para a sua bifurcação do projeto web Space Game (mslearn-tailspin-spacegame-web) no GitHub.

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

    Locating the URL and copy button from the GitHub repository.

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

  4. No terminal, mova para o diretório a partir do qual deseja trabalhar, como o diretório base (~). Você pode escolher 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.git
    
  6. Mover para o mslearn-tailspin-spacegame-web diretório. Este é o diretório de raiz do seu repositório.

    cd mslearn-tailspin-spacegame-web
    

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.git (fetch)
    origin  https://github.com/username/mslearn-tailspin-spacegame-web.git (push)
    

    Origin especifica seu repositório no GitHub. Quando você bifurca o código de outro repositório, é comum nomear o controle remoto original (aquele do qual você se bifurcou) como 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.git
    
  3. Execute git remote uma segunda vez para ver as alterações:

    git remote -v
    

    Você vê que ainda tem acesso de busca (download) e push (upload) ao seu repositório. Agora você também tem acesso de busca e envio por push ao 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 ficheiros

No Visual Studio Code, a janela do terminal aponta para o diretório de 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 .
    

    Verá o diretório e a árvore de ficheiros no explorador de ficheiros.

  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 Shell Command: Install 'code' command in 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.