Como espelhar um repositório do GitHub

Neste tópico, você verá como espelhar um repositório do GitHub no Cloud Source Repositories. Com essa configuração, os commits enviados para o repositório do GitHub são copiados ou espelhados em um repositório hospedado no Cloud Source Repositories.

Somente os repositórios do Bitbucket Cloud e GitHub Cloud podem ser espelhados no Cloud Source Repositories. O espelhamento do Bitbucket e do GitHub não é compatível.

Se você estiver espelhando seu repositório do GitHub no Cloud Source Repositories para integração com o Cloud Build e não precisar de outros recursos do Cloud Source Repositories, siga as instruções do Cloud Build sobre como criar repositórios do GitHub.

Antes de começar

Ao espelhar um repositório, é preciso fornecer as credenciais de autenticação do GitHub. Essas credenciais permitem que o Cloud Source Repositories acesse o conteúdo do repositório do GitHub.

Se você estiver usando organizações GitHub, recomendamos usar uma conta de usuário de máquina (os dois links em inglês) especificamente dedicada a tarefas automatizadas, como o espelhamento de um repositório. Essa conta precisa ter acesso administrativo ao seu repositório.

Espelhar um repositório do GitHub

Nesta seção, mostramos como espelhar um repositório do GitHub no Cloud Source Repositories.

Criar um repositório espelhado

Neste processo, são necessárias as credenciais de usuário da máquina do GitHub para conceder ao Google Cloud acesso de leitura ao repositório do GitHub.

  1. No console do Google Cloud, abra o Cloud Source Repositories.

    Abrir o Cloud Source Repositories

  2. Clique em Adicionar repositório.

    A página Adicionar um repositório é aberta.

  3. Selecione Conectar repositório externo e clique em Continuar.

    A página Conectar repositório externo é aberta.

  4. Na lista suspensa Projeto, selecione o projeto do Google Cloud que inclui o repositório espelhado.

    Se você não tiver um projeto, clique em Criar projeto para criá-lo.

  5. Na lista suspensa Provedor do git, selecione GitHub.

  6. Marque a caixa de seleção para autorizar o Cloud Source Repositories a armazenar suas credenciais.

  7. Clique em Conectar-se ao GitHub.

  8. Faça login no GitHub com as credenciais de usuário da sua máquina.

  9. Clique em Autorizar GoogleCloudPlatform.

    Essa opção concede ao Google Cloud acesso de leitura a todos os repositórios na conta de usuário do GitHub.

    Quando a autorização for concluída, você retornará à página Conectar repositório externo. Uma lista de repositórios é exibida.

  10. Na lista de repositórios, selecione aquele que você quer espelhar.

  11. Clique em Conectar repositório selecionado.

    A página principal do repositório é aberta. Nela, há uma lista dos repositórios para este projeto do Google Cloud, incluindo o novo repositório que você acabou de criar.

Identificar repositórios do GitHub

O Cloud Source Repositories indica claramente quais dos seus repositórios são espelhos dos repositórios do GitHub:

  • Cada repositório do GitHub é representado com o logotipo do GitHub.
  • github_ é adicionado ao início do nome do repositório.

Forçar uma sincronização de repositório

Depois que você configurar o espelhamento, o Cloud Source Repositories sincronizará automaticamente seu repositório com o repositório espelhado quando um usuário confirmar uma alteração. O Cloud Source Repositories permite que você visualize a última vez que seu repositório espelhado foi sincronizado e force manualmente uma sincronização, se necessário.

  1. No Console do GCP, navegue até o repositório espelhado do GitHub.

  2. Clique em Configurações.

    O status de sincronização é exibido.

    Status de sincronização do repositório espelhado

  3. Para forçar manualmente uma sincronização dos repositórios, clique em Sincronizar do GitHub.