Exercício – Adicionar um destaque de compilação

  • 7 minutos

É importante que os membros da equipe saibam o status da compilação. Uma maneira fácil de determinar rapidamente o status da compilação é adicionar um selo de compilação ao arquivo README.md no GitHub. Vamos verificar a equipe para ver como é feito.

O Guilherme está na secretária a fazer a triagem das mensagens de e-mail. Ele está respondendo ao terceiro e-mail relacionado ao status de construção do site Space Game .

Andy: Tem que haver alguma maneira de automatizar uma mensagem de status. Temos o pipeline, por isso, devemos ser capazes de colocar um estado em algum lugar. Talvez a Teresa saiba como fazê-lo.

O Guilherme vai à sala de convívio e encontra a Teresa e a Mariana a falarem.

Andy: Olá, Amita. Posso levar a Teresa por um segundo?

Amita: Eu tenho que chegar a uma reunião de qualquer maneira. Leve-a.

Mara: Olá Andy. O que se passa?

Andy: Eu realmente gosto das alterações que fizemos em nosso pipeline de compilação usando o Azure Pipelines, e o Git é um ótimo sistema de controle de versão. Eu estava me perguntando, existe uma maneira de informar as pessoas sobre o status da construção?

Mara: Sim, na verdade. Podemos utilizar um destaque de compilação.

O que é um destaque de compilação?

Um selo faz parte do Microsoft Azure Pipelines. Tem métodos que pode utilizar para adicionar uma imagem SVG que mostra o estado da compilação no repositório do GitHub.

A maioria dos repositórios do GitHub inclui um arquivo chamado README.md, que é um arquivo Markdown que inclui detalhes essenciais e documentação sobre seu projeto. O GitHub compõe este ficheiro na home page do projeto.

Veja a seguir um exemplo de destaque de compilação:

Captura de tela do GitHub mostrando o selo de compilação. O status mostra que a compilação mais recente foi bem-sucedida.

Para este exercício, você torna seu selo de construção visível para todos. Isso pode não ser uma boa ideia para seus projetos privados, porque suas informações de construção serão disponibilizadas ao público.

Para verificar se o selo de compilação está visível:

  1. No Azure DevOps, navegue até sua organização.

  2. Selecione Configurações da organização no canto inferior.

  3. Em Pipelines, selecione Configurações.

  4. Desative Desativar acesso anônimo a selos.

    Captura de ecrã do Azure DevOps a mostrar como desativar o acesso anónimo a selos.

Você precisa fazer uma alteração semelhante ao seu projeto:

  1. Vá para o seu projeto.
  2. Navegue até Configurações do projeto no canto inferior.
  3. Em Pipelines, selecione Configurações.
  4. Desative Desativar acesso anônimo a selos.

Adicionar o destaque de compilação

Até agora, criou os ramos Git localmente para realizar as alterações ao projeto Space Game. Também pode propor alterações diretamente através do GitHub. Nesta seção, você faz isso para configurar seu selo de status.

  1. No Azure DevOps, no painel esquerdo, selecione Pipelines e, em seguida, selecione seu pipeline.

  2. Selecione as reticências (...) no canto superior direito e, em seguida, selecione Emblema de estado.

    Captura de tela do Azure Pipelines mostrando o menu de opções para definir o selo de compilação.

  3. Em Exemplo de Markdown, selecione o botão Copiar para copiar o código Markdown para a área de transferência.

  4. No GitHub, vá para o seu projeto.

  5. Certifique-se de que está no ramo main. Na área de arquivos, abra o arquivo README.md .

  6. Selecione Editar este arquivo (o ícone de lápis) para abrir o arquivo no editor.

  7. Na parte superior da página, adicione uma linha em branco e cole o conteúdo da área de transferência.

  8. Selecione a guia Visualizar para ver as alterações propostas.

    O GitHub compõe o ficheiro Markdown e mostra-lhe o destaque de compilação.

    Captura de tela do GitHub mostrando uma visualização do selo de compilação.

Confirme suas alterações na principal

Nesta seção, você confirma main suas alterações na ramificação no GitHub.

  1. Selecione Confirmar alterações.

  2. Na área Mensagem de confirmação, especifique uma mensagem de confirmação, como "Adicionar selo de compilação".

    Captura de tela do GitHub mostrando a mensagem de confirmação.

  3. Deixe a opção Confirmar diretamente na main ramificação selecionada e, em seguida, selecione Confirmar alterações para confirmar as alterações na main ramificação.

    Seu selo é exibido na página README.md.

    Captura de ecrã do emblema de compilação final tal como aparece na página LEIA-ME.

    Este processo é uma forma mais básica de intercalar código no GitHub. Em vez de consolidar diretamente, poderia ter criado um pedido Pull com as suas alterações para outros analisarem.

    Na prática, você alternaria para a main ramificação e extrairia as alterações mais recentes do GitHub na próxima vez que precisar adicionar um recurso ou resolver um bug.

Andy: Mara, você acabou de fazer uma alteração diretamente para main. Por que não utiliza o fluxo que me ensinou? Ou seja, com os ramos de funcionalidade.

Mara: Poderíamos ter feito isso. Mas, às vezes, quando as pessoas estão alterando apenas o arquivo LEIA-ME ou outros arquivos de documentação, elas se comprometem a fazê-lo main naquele momento. Além disso, pudemos verificar o trabalho em conjunto antes de intercalarmos a alteração.

Mas isto levanta uma boa questão. Se todos pudermos nos comprometer quando main quisermos, podemos estar deixando problemas no código entrarem em nossa main filial.

Andy: Eu tenho falado com você sobre isso.

Enquanto regressam aos seus escritórios, o Guilherme e a Teresa continuam esta conversa.