Utilizzare un builder specifico

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

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

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

Build locali

Per le build locali, devi aver installato l'interfaccia a riga di comando Pack 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 il controllo del codice sorgente Git per recuperare l'applicazione di esempio da GitHub.

Specifica la versione del builder con pack

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

pack build SERVICE_IMAGE_NAME --builder=BUILDER_IMAGE_URL

Sostituisci:

• BUILDER_IMAGE_URL con l'URL dello strumento di creazione. Esempio: gcr.io/buildpacks/builder:google-22
• SERVICE_IMAGE_NAME con il nome che hai scelto per l'immagine dell'applicazione.

Per scoprire di più sul comando pack, consulta la documentazione dell'interfaccia a riga di comando

Specifica la versione del builder con project.toml

Puoi utilizzare un descrittore del progetto buildpack (project.toml) per impostare il builder quando crei con pack

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

   [build]
   builder = "BUILDER_IMAGE_URL"

2. Crea la tua applicazione eseguendo il comando "pack":

   pack build SERVICE_IMAGE_NAME

Sostituisci:

• BUILDER_IMAGE_URL con l'URL dello strumento di creazione, ad esempio gcr.io/buildpacks/builder:google-22
• SERVICE_IMAGE_NAME con il nome che hai scelto per l'immagine dell'applicazione.

Build remote

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

Prima di iniziare

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

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

   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

3. Make sure that billing is enabled for your Google Cloud project.

4. Enable the Cloud Build and Artifact Registry APIs.

   Enable the APIs

5. Install the Google Cloud CLI.

6. To initialize the gcloud CLI, run the following command:

   gcloud init

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

   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

8. Make sure that billing is enabled for your Google Cloud project.

9. Enable the Cloud Build and Artifact Registry APIs.

   Enable the APIs

10. Install the Google Cloud CLI.

11. To initialize the gcloud CLI, run the following command:

    gcloud init

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

12. 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 hai scelto per il tuo repository Docker.
       • REGION con località in o più vicina alla località del progetto Google Cloud.
       • DESCRIPTION con una descrizione a tua scelta.

       Ad esempio, per creare un repository docker in us-west2 con la descrizione "Repository Docker", 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

       Nell'elenco dovresti vedere il nome scelto per il tuo repository Docker.

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-22
   • LOCATION con il nome della regione del container repository Git. Esempio: us-west2-docker.pkg.dev
   • PROJECT_ID con 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 scoprire di più sul comando submit, consulta la documentazione di Cloud Build.

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

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

   Sostituisci:

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

Esegui il deployment da sorgente con Cloud Run

Puoi utilizzare un file descrittore del progetto di Buildpacks, ad esempio project.toml, per impostare lo strumento di creazione durante il deployment dal codice sorgente con Cloud Run.

1. Inizializza un file project.toml nella directory principale della tua applicazione e incollaci la configurazione seguente:

   [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 generatore. Esempio: gcr.io/buildpacks/builder:google-22
• SERVICE_IMAGE_NAME con il nome dell'immagine container che hai creato.