Exercício – configurar o ambiente do Azure DevOps

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

Obtenha o projeto Azure DevOps

Aqui, você garantirá que sua organização do Azure DevOps esteja configurada para concluir o restante deste módulo. Para fazer isso, execute 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

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 Digite o número do modelo na lista de modelos, digite 23 para Implementar um fluxo de trabalho de código em seu pipeline de compilação usando o Git e o GitHub 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.

   Nota

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

Fork o repositório

Se ainda não o fez, bifurque o repositório mslearn-tailspin-spacegame-web .

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

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
• Setting repository visibility (Definir a visibilidade de repositórios)

Mover o item de trabalho para Em Curso

Nesta seção, você atribuirá a si mesmo um item de trabalho relacionado a este módulo nos Painéis do Azure. Também irá passar o item de trabalho para o estado Doing (Em Curso). Na prática, você e sua equipe criariam itens de trabalho no início de cada sprint ou iteração de trabalho.

Atribuir trabalho desta forma dá-lhe uma lista de verificação a partir da qual trabalhar. Possibilita a outras pessoas na sua equipa ter visibilidade sobre aquilo em que está a trabalhar e a quantidade de trabalho que resta. Ele também ajuda a equipe a impor limites de trabalho em processo (WIP) para que a equipe não assuma muito trabalho ao mesmo tempo.

Lembre-se que a equipe resolveu estas sete questões principais:

Aqui, você moverá o segundo item, Criar um fluxo de trabalho baseado em Git, para a coluna Fazer e atribuir-se ao item de trabalho.

Lembre-se de que Criar um fluxo de trabalho baseado no Git está relacionado com mudar para um fluxo de trabalho de código que permite uma maior colaboração entre os membros da equipa.

Para configurar o item de trabalho:

1. No Azure DevOps, selecione Painéis no painel esquerdo e, em seguida, selecione Painéis.

   

2. No item de trabalho Criar um fluxo de trabalho baseado em Git, selecione a seta para baixo junto a A Fazer e atribua o item de trabalho a si mesmo.

   

3. Arraste o item de trabalho da coluna Tarefas Pendentes para a coluna Fazer .

   

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

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.

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 Ver, 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 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 a sua palavra-passe do GitHub.

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 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 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 Space Game 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, no separador HTTPS, selecione o botão ao lado da URL apresentada para copiar a URL para a área de transferência.

   

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 faz um fork do código de outro repositório, é comum nomear o repositório remoto original (aquele do qual fez o fork) 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 para buscar (download) e carregar (upload) no 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 > 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á 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.