Conectar-se a um host do Bitbucket Server

Console

Para conectar seu host do Bitbucket Server ao Cloud Build usando o console Google Cloud :

1. Abra a página Repositórios no console do Google Cloud :

   Abrir a página Repositórios

2. Na parte de cima da página, selecione a guia 1ª geração.

3. Clique em Conectar host.

4. Selecione Bitbucket Server no menu suspenso.

   O painel Conectar host vai aparecer.

   Insira as seguintes informações para conectar sua instância do Bitbucket Server ao Cloud Build:

   • Região: selecione a região da conexão.

   • Nome: insira um nome para a conexão.

   1. URL do host: o URL do host da sua instância do Bitbucket Server. Por exemplo, https://bbs.example-test.com:7990.

   2. Google Cloud Chave de API: sua chave de API usada para autenticar suas credenciais.

   3. Certificado de CA: seu certificado autoassinado. Seu certificado não pode exceder 10 KB e deve estar no formato PEM (.pem, .cer ou .crt). Se esta seção for deixada em branco, um conjunto padrão de certificados será usado no lugar.

   4. Nome de usuário: seu nome de usuário da conta do Bitbucket Server. Essa conta precisa ter acesso de administrador aos repositórios que você quer conectar ao Cloud Build.

   5. Token de acesso de leitura: token de acesso pessoal da sua conta do Bitbucket Server com permissões de leitura.

   6. Token de acesso de administrador: token de acesso pessoal da sua conta do Bitbucket Server com permissões de administrador em projetos e repositórios.

   7. Em Tipo de rede, selecione uma das seguintes opções:

      1. Internet pública: selecione essa opção se a instância estiver acessível pela Internet pública.

      2. Rede particular: selecione essa opção se a instância estiver hospedada em uma rede particular.

         1. Projeto: selecione seu Google Cloud ID do projeto.

         2. Rede: selecione sua rede no menu suspenso. Se você ainda não criou uma rede, consulte Criar e gerenciar redes VPC para saber como fazer isso.

         3. Intervalo de IP: insira o intervalo de IP interno que pode ser atribuído às VMs no intervalo alocado de uma rede com peering.

            É possível especificar o intervalo usando a notação de roteamento entre domínios sem classe (CIDR) no formato STARTING_IP/SUBNET_PREFIX_SIZE. Por exemplo, 192.0.2.0/24 tem um comprimento de prefixo de 24. Os primeiros 24 bits do intervalo de IP são usados como a máscara de sub-rede (192.0.2.0), enquanto os possíveis endereços de hosts variam de 192.0.2.0 a 192.0.2.255.

            O valor do comprimento do prefixo não pode exceder /29. Se nenhum valor for especificado para o intervalo, um valor padrão de /24 será atribuído automaticamente. Se nenhum valor for especificado para o tamanho do prefixo, os endereços IP serão atribuídos automaticamente na rede VPC em peering. Se nenhum valor for especificado para o endereço IP, ele será automaticamente atribuído a um intervalo na rede VPC pareada.

5. Clique em Conectar host.

   Se a instância do Bitbucket Server estiver em uma rede com peering, a conexão do host poderá levar vários minutos para ser concluída.

   Você será redirecionado para o painel Conectar repositório.

   Depois de criar uma conexão de host, seus tokens de acesso pessoal e o secret do webhook serão armazenados com segurança no Secret Manager. Você pode acessar e gerenciar seus secrets na página Secret Manager (link em inglês).

gcloud

Para conectar seu host do Bitbucket Server ao Cloud Build usando comandos gcloud, execute o comando gcloud alpha builds enterprise-config bitbucketserver create no terminal. Ao contrário da conexão do host usando o consoleGoogle Cloud , você precisa armazenar manualmente seus tokens de acesso pessoal e o secret do webhook no Secret Manager antes de executar o seguinte comando:

gcloud alpha builds enterprise-config bitbucketserver create
    --name=BITBUCKET_SERVER_CONFIG_NAME \
    --user-name=USERNAME \
    --host-uri=HOST_URI \
    --admin-access-token-secret-version=ADMIN_ACCESS_TOKEN_SECRET_VERSION \
    --read-access-token-secret-version=READ_ACCESS_TOKEN_SECRET_VERSION \
    --webhook-secret-secret-version=WEBHOOK_SECRET_SECRET_VERSION \
    --api-key=API_KEY \
    --peered-network=PEERED_NETWORK \
    --peered-network-ip-range=PEERED_NETWORK_IP_RANGE \
    --ssl-ca-file=SSL_CA_FILE

Em que:

• BITBUCKET_SERVER_CONFIG_NAME é o nome da sua configuração do Bitbucket Server.
• USERNAME é seu nome de usuário do Bitbucket Server.
• HOST_URI é o URI do host da sua instância do Bitbucket Server.
• ADMIN_ACCESS_TOKEN_SECRET_VERSION é o nome do recurso do seu token de acesso de administrador armazenado no Secret Manager. O formato esperado para secrets armazenados no Secret Manager é projects/${PROJECT_ID}/secrets/${SECRET_NAME}/versions/${VERSION_NUMBER}. Especifique latest como sua versão para usar a mais recente do secret. Isso se aplica a cada recurso armazenado no Secret Manager.

• READ_ACCESS_TOKEN_SECRET_VERSION é o nome do recurso do token de acesso de leitura armazenado no Secret Manager.
• WEBHOOK_SECRET_SECRET_VERSION é o nome do recurso do secret do webhook armazenado no Secret Manager.
• API_KEY é a chave de API Google Cloud .

• [Opcional] PEERED_NETWORK é a rede VPC a que você se conecta para suas instâncias do Bitbucket Server no local. Para saber mais, consulte Criar repositórios do Bitbucket Server em uma rede particular.

• [Opcional] PEERED_NETWORK_IP_RANGE é o intervalo de IP interno que pode ser atribuído às VMs no intervalo alocado de uma rede com peering.

• SSL_CA_FILE é o caminho para um arquivo local que contém o certificado SSL a ser usado em solicitações ao Bitbucket Server. O certificado precisa estar no formato PEM.

API

Para conectar seu host do Bitbucket Server ao Cloud Build usando a API, use o seguinte modelo JSON. Ao contrário da conexão do host usando o console Google Cloud , você precisa armazenar manualmente seus tokens de acesso pessoal e o secret do webhook no Secret Manager antes de chamar a API:

  {
      "hostUri": "HOST_URI",
      "username": "USERNAME",
      "apiKey": "API_KEY",
      "secrets": {
        "adminAccessTokenVersionName": "ADMIN_ACCESS_TOKEN_SECRET_VERSION",
        "readAccessTokenVersionName": "READ_ACCESS_TOKEN_SECRET_VERSION",
        "webhookSecretVersionName": "WEBHOOK_SECRET_SECRET_VERSION",
      },
      "peeredNetwork": "PEERED_NETWORK",
      "peeredNetworkIpRange": "PEERED_NETWORK_IP_RANGE",
      "sslCa": "SSL_CERTIFICATE"
  }

Em que:

• HOST_URI é o URI do host da sua instância do Bitbucket Server.
• USERNAME é seu nome de usuário do Bitbucket Server.
• API_KEY é a chave de API Google Cloud .

• ADMIN_ACCESS_TOKEN_SECRET_VERSION é o nome do recurso do seu token de acesso de administrador armazenado no Secret Manager. Talvez seja necessário conceder o papel de Acessador do secret do Secret Manager ao agente de serviço do Cloud Build, service-${PROJECT_NUMBER}@gcp-sa-cloudbuild.iam.gserviceaccount.com. Para saber mais, consulte Como conceder o papel de Secret Manager à conta de serviço.

• READ_ACCESS_TOKEN_SECRET_VERSION é o nome do recurso do token de acesso de leitura armazenado no Secret Manager.

• WEBHOOK_SECRET_SECRET_VERSION é o nome do recurso do secret do webhook armazenado no Secret Manager.

• [Opcional] PEERED_NETWORK é a rede VPC para fazer peering com as instâncias do Bitbucket Server no local.

  É possível especificar o intervalo usando a notação de roteamento entre domínios sem classe (CIDR) no formato STARTING_IP/SUBNET_PREFIX_SIZE. Por exemplo, 192.0.2.0/24 tem um comprimento de prefixo de 24. Os primeiros 24 bits do intervalo de IP são usados como a máscara de sub-rede (192.0.2.0), enquanto os possíveis endereços de hosts variam de 192.0.2.0 a 192.0.2.225.

• [Opcional] PEERED_NETWORK_IP_RANGE é o intervalo de IP interno que pode ser atribuído às VMs no intervalo alocado de uma rede com peering.

• [Opcional] SSL_CERTIFICATE é o certificado SSL usado para suas instâncias do Bitbucket Server no local.

Insira o seguinte comando curl no terminal:

  curl -X POST -H "Authorization: Bearer "$(gcloud auth print-access-token) -H "Content-Type: application/json; charset=utf-8"  -H "x-goog-user-project: PROJECT_NUMBER" https://cloudbuild.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/bitbucketServerConfigs/?bitbucketServerConfigId=BITBUCKET_SERVER_CONFIG_NAME -d @config.json

Em que:

• PROJECT_NUMBER é o número do projeto do Cloud.
• PROJECT_ID é seu ID do projeto do Cloud.
• REGION é a região associada à configuração do Bitbucket Server.
• BITBUCKET_SERVER_CONFIG_NAME é o nome da sua configuração do Bitbucket Server.

Se a solicitação for bem-sucedida, o corpo da resposta incluirá uma instância de Operation.

Insira o seguinte comando curl no terminal:

  curl -X GET -H "Authorization: Bearer "$(gcloud auth print-access-token) -H "Content-Type: application/json; charset=utf-8"  -H "x-goog-user-project: PROJECT_NUMBER" https://cloudbuild.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/operations/OPERATION_ID

Em que:

• PROJECT_NUMBER é o número do projeto do Cloud.
• PROJECT_ID é seu ID do projeto do Cloud.
• REGION é a região associada à configuração do Bitbucket Server.
• OPERATION_ID é o ID da operação de criação da configuração do Bitbucket Server.

Talvez seja necessário continuar executando o comando da API GetOperation até que a resposta contenha done: true, o que indica que a operação foi concluída. Se a configuração do Bitbucket Server for criada corretamente, ela vai aparecer no campo response.value. Caso contrário, consulte o campo error para um relatório de erros detalhado.