Connettiti a un host GitLab Enterprise Edition

Console

Per connettere l'host GitLab Enterprise Edition a Cloud Build:

1. Apri la pagina Repository nella console Google Cloud .

   Apri la pagina Repository

   Viene visualizzata la pagina Repository.

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

3. Nel selettore di progetti nella barra superiore, seleziona il tuo Google Cloud progetto.

4. Fai clic su Crea connessione host per connettere un nuovo host a Cloud Build.

5. Nel riquadro a sinistra, seleziona GitLab come provider di origine.

6. Nella sezione Configura connessione, inserisci le seguenti informazioni:

   1. Regione: seleziona una regione per la connessione.

   2. Name (Nome): inserisci un nome per la connessione.

7. Nella sezione Dettagli host, seleziona o inserisci le seguenti informazioni:

   1. Provider GitLab: seleziona GitLab Enterprise Edition autogestito come provider.

   2. URL host: inserisci l'URL host per la connessione. Ad esempio, https://my-gle-server.net.

   3. Certificato CA: fai clic su Sfoglia per caricare il certificato autofirmato.

   4. In Tipo di connessione, seleziona una delle seguenti opzioni:

      1. Internet pubblico: seleziona questa opzione se la tua istanza è accessibile tramite internet pubblico.

      2. Accesso alla rete privata: seleziona questa opzione se la tua istanza è ospitata in una rete privata.

      3. Nella sezione Servizio Service Directory, seleziona la località del servizio:

         • Nel progetto your-project
         • In un altro progetto
         • Inserisci manualmente

         1. Se selezioni In un altro progetto o Inserisci manualmente, inserisci le seguenti informazioni:

            • Progetto: inserisci o seleziona l'ID progetto Google Cloud dal menu a discesa.

            • Regione: questo campo pre-seleziona la regione della connessione. La regione specificata per il tuo servizio deve corrispondere alla regione associata alla tua connessione.

         2. Spazio dei nomi: seleziona lo spazio dei nomi del tuo servizio.

         3. Servizio: seleziona il nome del servizio nel tuo spazio dei nomi.

8. Nella sezione Personal access tokens (Token di accesso personale), inserisci le seguenti informazioni:

   1. Token di accesso all'API: inserisci il token con accesso all'ambito api. Questo token viene utilizzato per collegare e scollegare i repository.

   2. Token di accesso alle API in lettura: inserisci il token con accesso all'ambito read_api. I trigger di Cloud Build utilizzano questo token per accedere al codice sorgente nei repository.

9. Fai clic su Connetti.

   Dopo aver fatto clic sul pulsante Connetti, i token di accesso personali vengono archiviati in modo sicuro in Secret Manager. Dopo la connessione host, Cloud Build crea anche un secret webhook per tuo conto. Puoi visualizzare e gestire i secret nella pagina Secret Manager. Puoi visualizzare e gestire i tuoi secret nella pagina Secret Manager.

Ora hai creato correttamente una connessione GitLab Enterprise Edition.

gcloud

Prima di connettere l'host GitLab Enterprise Edition a Cloud Build, completa i seguenti passaggi per archiviare le credenziali:

1. Archivia il token in Secret Manager.

2. Crea un secret webhook in Secret Manager eseguendo il seguente comando:

    cat /proc/sys/kernel/random/uuid | tr -d '\n' | gcloud secrets create my-gle-webhook-secret --data-file=- 

3. Se memorizzi i tuoi secret in un progetto Google Cloud diverso da quello che prevedi di utilizzare per creare una connessione host, inserisci il seguente comando per concedere al tuo progetto l'accesso all'agente di servizio Cloud Build:

   PN=$(gcloud projects describe PROJECT_ID --format="value(projectNumber)") CLOUD_BUILD_SERVICE_AGENT="service-${PN}@gcp-sa-cloudbuild.iam.gserviceaccount.com" gcloud projects add-iam-policy-binding PROJECT_ID \   --member="serviceAccount:${CLOUD_BUILD_SERVICE_AGENT} \   --role="roles/secretmanager.admin" 

   Dove:

   • PROJECT_ID è l'ID progetto Google Cloud .

Ora puoi procedere per connettere l'host GitLab Enterprise Edition a Cloud Build.

Completa i seguenti passaggi:

1. Inserisci il comando seguente per creare una connessione GitLab Enterprise Edition:

   gcloud builds connections create gitlab CONNECTION_NAME \   --host-uri=HOST_URI \   --project=PROJECT_ID \   --region=REGION \   --authorizer-token-secret-version=projects/PROJECT_ID/secrets/API_TOKEN/versions/SECRET_VERSION \   --read-authorizer-token-secret-version=projects/PROJECT_ID/secrets/READ_TOKEN/versions/SECRET_VERSION \   --webhook-secret-secret-version=projects/PROJECT_ID/secrets/WEBHOOK_SECRET/versions/SECRET_VERSION 

   Dove:

   • CONNECTION_NAME è un nome per la connessione in Cloud Build.
   • HOST_URI è l'URI della tua istanza GitLab Enterprise Edition. Ad esempio, https://my-gle-server.net.
   • PROJECT_ID è l'ID progetto Google Cloud .
   • REGION è la regione per la tua connessione.
   • API_TOKEN è il nome del tuo token con ambito api.
   • READ_TOKEN è il nome del tuo token con ambito read_api.
   • SECRET_VERSION è la versione del secret.
   • WEBHOOK_SECRET è il secret webhook.

Ora hai creato correttamente una connessione GitLab Enterprise Edition.

Terraform

Puoi connettere il tuo host GitLab Enterprise Edition a Cloud Build utilizzando Terraform.

Nel seguente esempio, lo snippet di codice esegue queste operazioni:

• Configura il provider Google Terraform
• Crea un secret per archiviare il token di accesso personale di GitLab Enterprise Edition
• Concede all'agente di servizio Cloud Build le autorizzazioni necessarie per accedere ai secret

• Crea una connessione GitLab Enterprise Edition

  // Configure the Terraform Google provider terraform {   required_providers {     google = {}   } }  // Create secrets and grant permissions to the Cloud Build service agent resource "google_secret_manager_secret" "api-pat-secret" {     project = "PROJECT_ID"     secret_id = "GITLAB_PAT_API"      replication {         auto {}      }  }   resource "google_secret_manager_secret_version" "api-pat-secret-version" {      secret = google_secret_manager_secret.api-pat-secret.id      secret_data = "GITLAB_API_TOKEN"  }   resource "google_secret_manager_secret" "read-pat-secret" {      project = "PROJECT_ID"      secret_id = "GITLAB_PAT_READ"       replication {          auto {}      } }  resource "google_secret_manager_secret_version" "read-pat-secret-version" {     secret = google_secret_manager_secret.pat-secret.id     secret_data = "GITLAB_API_TOKEN" }  resource "google_secret_manager_secret" "webhook-secret-secret" {     project = "PROJECT_ID"     secret_id = "WEBHOOK_SECRET"      replication {         auto {}     } }  resource "google_secret_manager_secret_version" "webhook-secret-secret-version" {     secret = google_secret_manager_secret.webhook-secret-secret.id     secret_data = "WEBHOOK_SECRET_VALUE" }  data "google_iam_policy" "serviceagent-secretAccessor" {     binding {         role = "roles/secretmanager.secretAccessor"         members = ["serviceAccount:service-PROJECT_NUMBER@gcp-sa-cloudbuild.iam.gserviceaccount.com"]     } }  resource "google_secret_manager_secret_iam_policy" "policy-pak" {   project = google_secret_manager_secret.private-key-secret.project   secret_id = google_secret_manager_secret.private-key-secret.secret_id   policy_data = data.google_iam_policy.serviceagent-secretAccessor.policy_data }  resource "google_secret_manager_secret_iam_policy" "policy-rpak" {   project = google_secret_manager_secret.webhook-secret-secret.project   secret_id = google_secret_manager_secret.webhook-secret-secret.secret_id   policy_data = data.google_iam_policy.serviceagent-secretAccessor.policy_data }  resource "google_secret_manager_secret_iam_policy" "policy-whs" {   project = google_secret_manager_secret.webhook-secret-secret.project   secret_id = google_secret_manager_secret.webhook-secret-secret.secret_id   policy_data = data.google_iam_policy.serviceagent-secretAccessor.policy_data }  // Create the connection and add the repository resource resource "google_cloudbuildv2_connection" "my-connection" {     project = "PROJECT_ID"     location = "REGION"     name = "CONNECTION_NAME"      gitlab_config {         authorizer_credential {             user_token_secret_version = google_secret_manager_secret_version.pat-secret-version.id         }         read_authorizer_credential {              user_token_secret_version = google_secret_manager_secret_version.pat-secret-version.id         }         webhook_secret_secret_version = google_secret_manager_secret_version.webhook-secret-secret-version.id     }      depends_on = [         google_secret_manager_secret_iam_policy.policy-pak,         google_secret_manager_secret_iam_policy.policy-rpak,         google_secret_manager_secret_iam_policy.policy-whs     ] } 

Dove:

• PROJECT_ID è l'ID progetto Google Cloud .
• GITLAB_PAT_API è il tuo token di accesso personale con accesso api.
• GITLAB_API_TOKEN è il tuo token di accesso personale.
• GITLAB_PAT_READ è il tuo token di accesso personale con accesso read_api.
• WEBHOOK_SECRET è il nome del secret contenente il valore del secret del webhook.
• WEBHOOK_SECRET_VALUE è il valore del secret webhook.
• REGION è la regione per la tua connessione.
• CONNECTION_NAME è un nome per la connessione all'host GitLab Enterprise Edition in Cloud Build.
• URI è l'URI della tua connessione. Ad esempio, https://my-gitlab-enterprise-server.net. Ora hai creato correttamente una connessione GitLab Enterprise Edition.