Connettersi a un repository Bitbucket Server

Questa pagina spiega come connettere un repository Bitbucket Server a Cloud Build.

Prima di iniziare

  • Enable the Cloud Build, Secret Manager, and Compute Engine APIs.

    Enable the APIs

Connessione a un repository Bitbucket Server

Console

Per collegare un repository Bitbucket Server a Cloud Build utilizzando la console Google Cloud :

  1. Apri la pagina Repository nella console Google Cloud .

    Apri la pagina Repositori

  2. Nella parte superiore della pagina, seleziona la scheda 1ª gen..

  3. Fai clic su Connetti repository.

  4. Seleziona Bitbucket Server.

    Viene visualizzato il riquadro Connetti repository. Completa i seguenti passaggi per collegare il repository Bitbucket Server:

    1. Regione: seleziona la regione in cui si trova la connessione.

    2. In Seleziona il provider di gestione del codice sorgente, seleziona Bitbucket Server.

    3. Connessione host: seleziona il nome della connessione host dal menu a discesa.

    4. Fai clic su Continua.

    5. In Seleziona repository, seleziona i repository Bitbucket Server che vuoi connettere a Cloud Build.

    6. Dopo aver selezionato l'account e i repository Bitbucket Server, leggi il disclaimer per il consenso e seleziona la casella di controllo accanto per indicare che accetti i termini presentati.

    7. Fai clic su Connetti per connettere i tuoi repository.

    Quando un repository è connesso, Cloud Build configura un webhook nel repository nell'istanza di Bitbucket Server. Il repository invia quindi webhook per invocare gli attivatori di Bitbucket Server corrispondenti quando apporti modifiche al repository. Un repository può anche essere collegato più volte con più connessioni host. Per scoprire come gestire gli webhook, consulta Gestire gli webhook.

    Per trovare il webhook, devi disporre dell'ID webhook. L'ID webhook per ogni repository collegata è disponibile in BitbucketServerConfig.

    Inserisci il seguente comando per recuperare l'ID webhook:

      gcloud alpha builds enterprise-config bitbucketserver describe CONFIG_NAME  --region=REGION

    Dove:

    • CONFIG_NAME è il nome della configurazione di Bitbucket Server
    • REGION è la regione della connessione all'host di Bitbucket Server

  5. Fai clic su Fine. Se vuoi, fai clic su Crea un trigger per creare un trigger.

API

Per collegare il repository Bitbucket Server a Cloud Build utilizzando l'API, completa i seguenti passaggi:

  1. Utilizza il seguente modello JSON per connettere il tuo repository:

    {
  "parent": "projects/PROJECT_NUMBER/locations/REGION/bitbucketServerConfigs/BITBUCKET_SERVER_CONFIG_NAME",
  "requests": {
    "parent": "projects/PROJECT_NUMBER/locations/REGION/bitbucketServerConfigs/BITBUCKET_SERVER_CONFIG_NAME",
   "bitbucketServerConnectedRepository": {
      "parent": "projects/PROJECT_NUMBER/locations/REGION/bitbucketServerConfigs/BITBUCKET_SERVER_CONFIG_NAME",
      "repo": {
        "projectKey": "PROJECT_KEY",
        "repoSlug": "REPO_SLUG"
       }
     }
  }
}

    Dove:

    • PROJECT_NUMBER è il numero del progetto Cloud.
    • REGION è la regione associata alla configurazione di Bitbucket Server.
    • BITBUCKET_SERVER_CONFIG_NAME è il nome della configurazione di Bitbucket Server.
    • PROJECT_KEY è la chiave del progetto Bitbucket Server. Se vuoi collegare un repository personale, la chiave del progetto deve contenere il simbolo tilde (~) prima del nome utente. Ad esempio, ~${USERNAME}. L'URL completo di un repository host potrebbe avere questo aspetto: https://${HOST_URI}/projects/~${USER_NAME}/repos/${REPO_SLUG}.
    • REPO_SLUG è lo slug del tuo repository Bitbucket Server.

  2. Inserisci il seguente comando curl nel terminale:

    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/BITBUCKET_SERVER_CONFIG_NAME/connectedRepositories:batchCreate -d @requests.json

    Dove:

    • PROJECT_NUMBER è il numero del tuo progetto Cloud.
    • PROJECT_ID è il tuo ID progetto Cloud.
    • REGION è la regione associata alla configurazione di Bitbucket Server.
    • BITBUCKET_SERVER_CONFIG_NAME è il nome della configurazione di Bitbucket Server.

    In caso di esito positivo, il corpo della risposta contiene un'istanza di Operation appena creata.

  3. Inserisci il seguente comando curl nel terminale:

    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

    Dove:

    • PROJECT_NUMBER è il numero del tuo progetto Cloud.
    • PROJECT_ID è il tuo ID progetto Cloud.
    • REGION è la regione associata alla configurazione di Bitbucket Server.
    • OPERATION_ID è l'ID dell'operazione di creazione della configurazione di Bitbucket Server. Puoi trovare l'ID operazione nel campo name della risposta. Il formato del campo name nella risposta è simile al seguente: projects/project-id/locations/region/operations/operation-id.

    Potresti dover continuare a eseguire il comando dell'API GetOperation finché la risposta non contiene done: true, che indica il completamento dell'operazione. Se il repository Bitbucket Server è stato collegato correttamente, puoi visualizzarlo nel campo response.bitbucketServerConnectedRepositories. In caso contrario, consulta il campo error per un report dettagliato sugli errori.

Passaggi successivi