Exercício – Configurar o seu ambiente

  • 15 minutos

A equipe tem integrado lentamente uma estratégia de DevOps em seus processos. Nesta seção, você garante que seu ambiente reflita os esforços da equipe até agora.

Para fazer isso, você:

  • Adicione um usuário para garantir que o Azure DevOps possa se conectar à sua assinatura do Azure.
  • Configure um projeto de DevOps do Azure para este módulo.
  • Adicione o pipeline de compilação.

Adicionar um usuário ao Azure DevOps

Para concluir este módulo, você precisa de sua própria assinatura do Azure. Pode começar a utilizar o Azure gratuitamente.

Embora você não precise de uma assinatura para usar o Azure DevOps para trabalhar nele, aqui você usará o Azure DevOps para implantar nos recursos do Azure que existem em sua assinatura do Azure. Para simplificar o processo, entre na sua assinatura do Azure e na sua organização do Azure DevOps na mesma conta da Microsoft.

Se utilizar contas Microsoft diferentes para iniciar sessão no Azure e no Azure DevOps, adicione um utilizador à sua organização de DevOps na conta Microsoft que utiliza para iniciar sessão no Azure. Para obter mais informações, veja Adicionar utilizadores da organização e gerir o acesso. Ao adicionar o usuário, escolha o nível de acesso Básico .

Em seguida, saia do Azure DevOps e entre novamente na conta da Microsoft que você usa para entrar em sua assinatura do Azure.

Obtenha o projeto Azure DevOps

Verifique se sua organização do Azure DevOps está configurada para concluir o restante deste módulo. Você fará isso executando um modelo que cria um projeto para você no Azure DevOps.

Os módulos neste caminho de aprendizagem formam uma progressão à medida que você segue a equipe da web do Tailspin em sua jornada de 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.

Executar o modelo

No site do Gerador de Demonstração do Azure DevOps, siga estas etapas para executar o modelo:

  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 - Release.

    Screenshot of the Azure DevOps Demo Generator web site showing the process to create the project.

  3. Selecione Sim, quero bifurcar este repositório>Autorizar. Se for apresentada uma janela, autorize o acesso à sua conta do GitHub.

    Importante

    Você precisa selecionar essa opção para que o modelo se conecte ao seu repositório 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. O modelo leva alguns minutos para 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.

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:

Preparar o Visual Studio Code

Configure o Visual Studio Code para que você possa criar o site localmente e usar os arquivos de origem.

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

  1. Inicie o Visual Studio Code.

  2. Selecione Terminal e, em seguida, selecione Novo Terminal.

  3. Na lista suspensa, selecione Git bash. Se você estiver familiarizado com outro shell Unix que você prefere usar, como Zsh, selecione esse shell em vez disso. 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 seguinte comando para navegar até o diretório inicial .

    cd ~

Configurar o Git

Se você é novo no Git e no GitHub, primeiro precisará executar alguns comandos para associar sua identidade ao Git e autenticar com o GitHub. Para obter mais informações, consulte Configurar o Git.

No mínimo, você precisará concluir as seguintes etapas:

  1. Baixe e instale a versão mais recente do Git.
  2. Defina o seu nome de utilizador.
  3. Defina seu endereço de e-mail de confirmação.

Nota

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

Trate seu token de acesso como trataria uma senha. Mantenha-o num local seguro.

Configurar seu projeto no Visual Studio Code

Quando você executou o modelo para configurar seu projeto de DevOps do Azure, o processo bifurcou o repositório mslearn-tailspin-spacegame-web-deploy automaticamente para você. Agora você vai baixar, ou clonar, uma cópia para o seu computador para que você possa trabalhar com ele.

Clonar o seu fork localmente

  1. No GitHub, vá para a bifurcação do projeto Web Space Game (mslearn-tailspin-spacegame-web-deploy).

  2. Selecione Código e, na guia HTTPS , selecione o botão Copiar para copiar o URL para a área de transferência.

    Screenshot that shows how to locate the URL and copy button from the GitHub repository.

  3. No Visual Studio Code, vá para a janela do terminal que você abriu anteriormente.

  4. 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-deploy.git

  5. Mova para o diretório mslearn-tailspin-spacegame-web-deploy . Este diretório é a raiz do seu repositório.

    cd mslearn-tailspin-spacegame-web-deploy

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

    Origin especifica seu repositório no GitHub. Quando você bifurca o código de outro repositório, o controle remoto original (aquele do qual você se bifurcou) é comumente chamado upstream.

  2. Execute o seguinte comando para criar um remoto chamado upstream que aponte para o repositório da Microsoft:

    git remote add upstream https://github.com/MicrosoftDocs/mslearn-tailspin-spacegame-web-deploy.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 do repositório da Microsoft:

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

Abra o projeto no Visual Studio Code

  1. Execute o seguinte comando a partir do diretório raiz do seu projeto.

    code .

  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. Digite o comando shell e localize o comando Shell Command: Install 'code' no comando PATH .
  3. Reinicie o terminal para que o novo PATH entre em vigor.

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.

Obter o ramo do GitHub

  1. No Visual Studio Code, abra o terminal integrado.

  2. Execute os comandos a seguir para buscar a ramificação do pipeline de liberação do repositório do MicrosoftDocs e faça check-out de uma nova ramificação upstream/release-pipeline.

    git fetch upstream release-pipeline
git checkout -B release-pipeline upstream/release-pipeline

  3. Como uma etapa opcional, no Visual Studio Code, abra o arquivo azure-pipelines.yml e familiarize-se com a configuração inicial do pipeline YAML.

Executar o pipeline

Neste ponto, você tem:

  • Uma bifurcação do repositório mslearn-tailspin-spacegame-web-deploy na sua conta do GitHub.
  • O repositório mslearn-tailspin-spacegame-web-deploy clonado localmente.
  • Uma ramificação chamada release-pipeline que contém o código-fonte do site e uma configuração inicial do Azure Pipelines.

Em seguida, você acionará manualmente o pipeline para ser executado. Esta etapa garante que seu projeto esteja configurado para ser compilado a partir do repositório GitHub. A configuração inicial do pipeline cria o aplicativo e produz um artefato de compilação.

  1. Navegue até seu projeto no Azure Devops e selecione Pipelines.

  2. Selecione o pipeline mslearn-tailspin-spacegame-web-deploy . Se solicitado, certifique-se de selecionar Autorizar recursos para autorizar a conexão de serviço.

    Screenshot of Azure Pipelines showing the pipeline for this project. The pipeline has no runs.

  3. Selecione Executar pipeline e, em seguida, selecione a ramificação do pipeline de liberação no menu suspenso Ramificação/marca . Selecione Executar.

    Screenshot of Azure Pipelines showing the location of the Run pipeline button.

  4. Na página Resumo, selecione seu trabalho de pipeline para exibir os logs.

    Screenshot of Azure Pipelines showing the running job.

  5. Após a conclusão da compilação, selecione o botão Voltar para retornar à página de resumo.

    Screenshot of Azure Pipelines showing how to navigate to the summary page.

  6. Selecione o artefato publicado.

    Screenshot of Azure Pipelines showing the location of the link to the published artifact.

  7. O Tailspin.Space.Game.Web.zip é o seu artefato de construção. Este arquivo contém seu aplicativo construído e suas dependências.

    Screenshot of Azure Pipelines showing the published artifact. The artifact includes a .zip file.

Agora você tem um pipeline de construção para o projeto web Space Game. Em seguida, você adicionará um estágio de implantação para implantar seu artefato de compilação no Serviço de Aplicativo do Azure.