Utilizzare un compilatore specifico

I builder sono immagini con controllo delle versioni che contengono tutti i componenti necessari per creare un container eseguibile. Ogni builder utilizza una distribuzione specifica del sistema operativo come immagine di base, ad esempio Ubuntu 22, e supporta più versioni di linguaggi di programmazione.

Potresti dover personalizzare la versione del builder se hai bisogno di:

• Una dipendenza specifica del sistema operativo disponibile solo in una versione specifica del builder.
• Una versione specifica del linguaggio di programmazione disponibile solo in una versione specifica del builder.

Build locali

Per le build locali, devi aver installato Pack CLI e Docker.

Prima di iniziare

1. Installa Docker Community Edition (CE) sulla tua workstation. Docker viene utilizzato da pack come generatore di immagini OCI.
2. Installa Pack CLI.
3. Installa lo strumento di controllo del codice sorgente Git per recuperare l'applicazione di esempio da GitHub.

Specifica della versione del builder con pack

Puoi aggiungere il flag --builder al comando pack per specificare la versione di builder che vuoi utilizzare:

pack build SERVICE_IMAGE_NAME --builder=BUILDER_IMAGE_URL

Sostituisci:

• BUILDER_IMAGE_URL con l'URL del builder. Esempio: gcr.io/buildpacks/builder:google-24
• SERVICE_IMAGE_NAME con il nome che scegli per l'immagine dell'applicazione.

Per saperne di più sul comando pack, consulta la documentazione della CLI.

Specifica della versione del builder con project.toml

Puoi utilizzare un descrittore di progetto di buildpack (project.toml) per impostare il builder durante la creazione con pack

1. Nella directory root dell'applicazione, crea un file denominato project.toml con la seguente configurazione:

   [build]
   builder = "BUILDER_IMAGE_URL"

2. Crea l'applicazione eseguendo il comando `pack`:

   pack build SERVICE_IMAGE_NAME

Sostituisci quanto segue:

• BUILDER_IMAGE_URL: l'URL del builder, ad esempio gcr.io/buildpacks/builder:google-24
• SERVICE_IMAGE_NAME: il nome che scegli per l'immagine dell'applicazione.

Build remoti

Puoi utilizzare un builder specifico con Cloud Build aggiungendo il flag --pack quando invii il progetto.

Prima di iniziare

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Cloud Build and Artifact Registry APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

Install the Google Cloud CLI.

Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

Per inizializzare gcloud CLI, esegui questo comando:

gcloud init

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Cloud Build and Artifact Registry APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

Install the Google Cloud CLI.

Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

Per inizializzare gcloud CLI, esegui questo comando:

gcloud init

Se hai già installato Google Cloud CLI, assicurati di avere l'ultima versione disponibile eseguendo gcloud components update.

1. Assicurati che il tuo progetto Google Cloud abbia accesso a un repository di immagini container.

   Per configurare l'accesso a un repository Docker in Artifact Registry:

   1. Crea un nuovo repository Docker nella stessa posizione del progetto Google Cloud .

      gcloud artifacts repositories create REPO_NAME \
      --repository-format=docker \
      --location=REGION --description="DESCRIPTION"

      Sostituisci:
      • REPO_NAME con il nome che scegli per il repository Docker.
      • REGION con la posizione all'interno o più vicina alla posizione del tuo progetto Google Cloud .
      • DESCRIPTION con una descrizione a tua scelta.

      Ad esempio, per creare un repository docker in us-west2 con la descrizione "Docker repository", esegui:

      gcloud artifacts repositories create buildpacks-docker-repo --repository-format=docker \
      --location=us-west2 --description="Docker repository"

   2. Verifica che il repository sia stato creato:

      gcloud artifacts repositories list

      Dovresti vedere il nome che hai scelto per il repository Docker nell'elenco.

Crea l'applicazione utilizzando un builder specifico

1. Utilizza gcloud per inviare il codice sorgente dell'applicazione a Cloud Build:

   gcloud builds submit --pack builder=BUILDER_IMAGE_URL,image=LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/SERVICE_IMAGE_NAME

   Sostituisci:

   • BUILDER_IMAGE_URL con l'URL del builder. Esempio: gcr.io/buildpacks/builder:google-24
   • LOCATION con il nome della regione del tuo repository di container. Esempio: us-west2-docker.pkg.dev
   • PROJECT_ID: l'ID del tuo progetto Google Cloud .
   • REPO_NAME con il nome del tuo repository Docker.
   • SERVICE_IMAGE_NAME con il nome dell'immagine container che hai creato.

   Per saperne di più sul comando submit, consulta la documentazione di Cloud Build.

2. Verifica che l'applicazione di esempio sia stata pubblicata correttamente su REPO_NAME:

   gcloud artifacts docker images list LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME

   Sostituisci:

   • LOCATION con il nome della regione del repository di container. Esempio: us-west2-docker.pkg.dev
   • PROJECT_ID: l'ID del tuo progetto Google Cloud .
   • REPO_NAME con il nome del tuo repository Docker.

Esegui il deployment dall'origine con Cloud Run

Puoi utilizzare un file descrittore di progetto buildpack, ad esempio un file project.toml, per impostare il builder durante il deployment dal codice sorgente con Cloud Run.

1. Inizializza un file project.toml nella directory principale dell'applicazione e incolla la seguente configurazione:

   [build]
   builder = "BUILDER_IMAGE_URL"

2. Esegui il deployment dell'applicazione dall'origine

   gcloud run deploy --source . SERVICE_IMAGE_NAME

Sostituisci:

• BUILDER_IMAGE_URL con l'URL del builder. Esempio: gcr.io/buildpacks/builder:google-24
• SERVICE_IMAGE_NAME con il nome dell'immagine container che hai creato.