Como espelhar um repositório do Bitbucket

Neste tópico, você verá como espelhar um repositório do Bitbucket para o Cloud Source Repositories. Com essa configuração, as confirmações enviadas para o repositório do Bitbucket são copiadas ou espelhadas em um repositório hospedado no Cloud Source Repositories.

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

Se você estiver espelhando seu repositório do Bitbucket 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 Bitbucket Cloud.

Antes de começar

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

É recomendável criar uma conta do Bitbucket 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 Bitbucket

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

Criar um repositório espelhado

Nesse processo, você precisa das credenciais de usuário da máquina Bitbucket para conceder ao Google Cloud acesso de leitura ao repositório do Bitbucket.

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

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

  7. Clique em Conectar-se ao Bitbucket.

  8. Faça login no Bitbucket 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 ao seu repositório.

    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 Bitbucket

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

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

Fazer upgrade de uma conexão do Bitbucket

Se você espelha um repositório do Bitbucket usando uma interface anterior do Console do GCP, o Cloud Source Repositories solicitará o upgrade quando acessar o repositório espelhado no Console do GCP atual. Até que o upgrade seja concluído, essas solicitações ocorrerão sempre que você acessar o repositório.

É necessário ter o papel de administrador do repositório de origem para atualizar a conexão. O upgrade da conexão não altera o comportamento de espelhamento do repositório do Bitbucket.

  1. No Console do GCP, abra o Cloud Source Repositories.

    Abrir o Cloud Source Repositories

  2. Navegue até o repositório espelhado do Bitbucket.

  3. Quando solicitado, clique em Atualizar credenciais para fazer upgrade da sua conexão.

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

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