Exercício – Publicar seu repositório

Concluído

Na empresa de brinquedos, os desenvolvedores do site se ofereceram para ajudá-lo a escrever o modelo Bicep. Você disse que está mantendo o código Bicep em um repositório e eles pediram para você publicar o repositório. Neste exercício, você publicará o repositório Git para que seus colegas possam ver os arquivos e colaborar com você.

Durante o processo, você vai:

• Crie um novo repositório remoto.
• Configure o repositório Git local para integrar com o repositório remoto.
• Efetue push das alterações do repositório local para o repositório remoto.
• Verifique se as alterações aparecem no repositório remoto.

Criar um repositório em GitHub

1. Em um navegador, vá para GitHub. Entre com sua conta do GitHub ou crie uma conta caso ainda não tenha uma.

2. Selecione o ícone de sinal de adição (+) no canto superior direito da janela e selecione Novo repositório.

   

3. Insira os detalhes do seu novo repositório:

   • Proprietário: selecione o nome de usuário do GitHub no menu suspenso. Na captura de tela, mygithubuser é o nome da conta do GitHub do proprietário do repositório. Você usará o nome da sua conta mais adiante neste módulo.
   • Nome do repositório: insira um nome significativo, mas curto. Para este módulo, use toy-website-workflow.
   • Descrição: inclua uma descrição para ajudar os demais a entenderem a finalidade do repositório.
   • Privado: você pode usar GitHub para criar repositórios públicos e privados. Crie um repositório privado, pois somente as pessoas dentro da sua organização devem acessar os arquivos do seu site de brinquedos. Posteriormente, você pode conceder acesso a outras pessoas.

   Quando terminar, a configuração do repositório deverá ser semelhante à seguinte captura de tela:

   

4. Selecione Criar repositório.

5. Na página de confirmação exibida, anote o URL do repositório. Use o botão Copiar para copiar a URL. Você o usará em breve.

   

Criar um repositório no Azure Repos

1. Em um navegador, vá para Azure DevOps. Entre ou crie uma nova conta.

2. Se você estiver criando uma nova conta, siga os prompts para criar uma organização do Azure DevOps. O Azure DevOps solicitará que você crie um novo projeto. Siga para a próxima etapa.

   Se você entrou em uma organização existente do Azure DevOps, selecione o botão Novo projeto para criar um novo projeto.

   

3. Insira os detalhes do seu novo projeto:

   • Nome do projeto: insira um nome significativo, mas curto. Para este módulo, use toy-website.
   • Descrição: inclua uma descrição para ajudar os demais a entenderem a finalidade do repositório.
   • Visibilidade: você pode usar o Azure DevOps para criar repositórios públicos e privados. Crie um repositório privado, pois somente as pessoas dentro da sua organização devem acessar os arquivos do seu site. Posteriormente, você pode conceder acesso a outras pessoas.

   Quando terminar, a configuração do projeto deverá ser semelhante à seguinte captura de tela:

   

4. Selecione Criar.

5. Na página do projeto em exibição, selecione o item de menu Repos.

   

6. Anote o URL do repositório. Use o botão Copiar para copiar a URL. Você o usará em breve.

   

Gerar uma senha do Git

Ao trabalhar com o Azure Repos pelo Visual Studio Code no macOS, você precisará usar uma senha especial que seja diferente da senha que você usa para entrar.

Observação

Se estiver usando Windows, vá para a próxima seção, Configurar o repositório Git local.

1. Selecione o botão Gerar credenciais do Git.

   O Azure Repos criará uma senha aleatória para você usar.

2. Anote o valor da Senha. Você o usará em breve.

Mantenha seu navegador aberto. Você verificará o repositório novamente mais tarde neste exercício.

Configurar o repositório Git local

1. Verifique se você está na ramificação principal digitando o seguinte comando no terminal do Visual Studio Code:

   git checkout main
   

2. Digite o comando a seguir para integrar o repositório local ao repositório remoto que você criou. Substitua YOUR_REPOSITORY_URL pelo URL que você salvou anteriormente.

   git remote add origin YOUR_REPOSITORY_URL
   

   Observe que você está usando o comando git remote add para criar uma nova referência a um repositório remoto. Você nomeou a referência como origin, que é o nome padrão.

3. Verifique se o remoto foi criado.

   git remote -v
   

   A saída se parecerá com o exemplo.

   origin  https://github.com/mygithubuser/toy-website.git (fetch)
   origin  https://github.com/mygithubuser/toy-website.git (push)
   

   origin https://myuser@dev.azure.com/myuser/toy-website/_git/toy-website (fetch)
   origin https://myuser@dev.azure.com/myuser/toy-website/_git/toy-website (push)
   

Envie por push suas alterações usando a CLI do Git

1. No terminal do Visual Studio Code, digite o seguinte comando:

   git push -u origin main
   

   Como o branch local atual é principal, esse comando informa ao Git que a ramificação principal local acompanha a ramificação principal no repositório remoto. Ele também efetua push dos commits de seu repositório local para o repositório remoto.

2. Esta é a primeira vez que você usou esse repositório remoto, portanto, o terminal solicita que você selecione o modo de autenticação. Escolha a opção para usar o navegador.

3. Siga as instruções no navegador para entrar e autorizar o Visual Studio Code a acessar o repositório de GitHub.

4. Na janela do seu terminal, o Git exibe uma saída semelhante ao seguinte exemplo:

   Enumerating objects: 16, done.
   Counting objects: 100% (16/16), done.
   Delta compression using up to 8 threads
   Compressing objects: 100% (11/11), done.
   Writing objects: 100% (16/16), 2.30 KiB | 785.00 KiB/s, done.
   Total 16 (delta 2), reused 0 (delta 0), pack-reused 0
   remote: Resolving deltas: 100% (2/2), done.
   To https://github.com/mygithubuser/toy-website.git
    * [new branch]      main -> main
   Branch 'main' set up to track remote branch 'main' from 'origin'.
   

   Essa saída indica que o Git enviou com êxito o conteúdo do seu repositório para o repositório remoto.

1. No terminal do Visual Studio Code, digite o seguinte comando:

   git push -u origin main
   

   Como o branch local atual é principal, esse comando informa ao Git que a ramificação principal local acompanha a ramificação principal no repositório remoto. Ele também efetua push dos commits de seu repositório local para o remoto.

2. Esta é a primeira vez que você usou esse repositório, então você será solicitado a entrar.

   Se estiver usando Windows, insira as mesmas credenciais que usou para entrar no Azure DevOps anteriormente neste exercício.

   Se você estiver usando o macOS, cole a senha que você gerou anteriormente neste exercício.

3. Na janela do seu terminal, o Git exibe uma saída semelhante ao seguinte exemplo:

   Enumerating objects: 16, done.
   Counting objects: 100% (16/16), done.
   Delta compression using up to 8 threads
   Compressing objects: 100% (11/11), done.
   Writing objects: 100% (16/16), 2.30 KiB | 785.00 KiB/s, done.
   Total 16 (delta 2), reused 0 (delta 0), pack-reused 0
   remote: Analyzing objects... (16/16) (5 ms)
   remote: Storing packfile... done (165 ms)
   remote: Storing index... done (75 ms)
   To https://dev.azure.com/myuser/toy-website/_git/toy-website
    * [new branch]      main -> main
   Branch 'main' set up to track remote branch 'main' from 'origin'.
   

   Essa saída indica que o Git enviou com êxito o conteúdo do seu repositório para o repositório remoto.

Adicionar um arquivo LEIAME

Agora que seus colegas usarão seu repositório, é importante criar um arquivo LEIAME.MD para ajudá-los a entender a finalidade do repositório e como eles podem começar.

1. Abra o Explorer no Visual Studio Code.

2. Adicione um novo arquivo na raiz da sua estrutura de pastas atual e nomeie-o como LEIAME.md.

3. Copie o seguinte texto para o arquivo:

   # Toy company's website
   
   This repository contains the website for our toy company.
   
   ## How to use
   
   The Azure infrastructure is defined using [Bicep](/azure/azure-resource-manager/bicep).
   
   To deploy the website's Azure resources, use the _deploy/main.bicep_ file.
   

   Dica

   Esse é um arquivo LEIAME de espaço reservado e, portanto, não tem muito conteúdo útil. Ao trabalhar com seus próprios repositórios Git, crie um arquivo LEIAME que ajuda outra pessoa a entender como começar a usar seu código. Imagine-o como um manual básico para seu projeto.

4. Salve o arquivo.

5. Prepare e faça commit do arquivo para seu repositório Git local. Você pode escolher se deseja fazer commit usando a CLI do Git ou usando o Controle do Código-Fonte no Visual Studio Code.

Enviar por push novamente usando Visual Studio Code

Agora que você fez commit de um novo arquivo, é necessário efetuar push das alterações novamente para que o remoto tenha os arquivos mais recentes. Desta vez, você usará o Visual Studio Code para efetuar push para o repositório remoto.

1. Abra Controle do Código-Fonte no Visual Studio Code.

2. Selecione o ícone com três pontos no lado direito da barra de ferramentas Controle do Código-Fonte e, em seguida, selecione Push.

   

   Observe que você não é solicitado a entrar novamente. Suas credenciais são compartilhadas entre a CLI do Git e o Visual Studio Code.

Verificar as alterações no GitHub

Agora que você efetuou push das alterações para o repositório remoto, poderá inspecionar o conteúdo do repositório no GitHub.

1. No navegador, atualize a página do repositório.

2. Observe que os arquivos que você criou agora estão listados e seu arquivo LEIAME.md é exibido.

   

3. Navegue pela interface do GitHub para explorar os arquivos e observe que todas as alterações são exibidas. Como o GitHub tem a lista completa de alterações em cada arquivo, você pode até mesmo exibir o histórico de um arquivo, assim como ao trabalhar no Visual Studio Code.

Verificar as alterações no Azure Repos

Agora que você efetuou push das alterações para o repositório remoto, poderá inspecionar o conteúdo do repositório no Azure Repos.

1. No navegador, atualize a página Repos.

2. Observe que os arquivos que você criou agora estão listados e seu arquivo LEIAME.md é exibido.

   

3. Navegue pela interface do Azure Repos para explorar os arquivos e observe que todas as suas alterações são exibidas. Como o Azure Repos tem a lista completa de alterações em cada arquivo, você pode até mesmo exibir o histórico de um arquivo, da mesma forma que pode quando trabalha no Visual Studio Code.