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 strumento di creazione 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 generatore. Esempio: gcr.io/buildpacks/builder:google-22
  • 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 del 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:

  • 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 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

  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.

    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. If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

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

    gcloud init

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

    Go to project selector

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

  10. Enable the Cloud Build and Artifact Registry APIs.

    Enable the APIs

  11. Install the Google Cloud CLI.

  12. If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

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

    gcloud init
  14. 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"
       Replace:
      • 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 "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

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

    15. 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 repository del container. 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 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 con l'ID del tuo progetto Google Cloud .
      • REPO_NAME con il nome del tuo repository Docker.

    Esegui il deployment da Source con Cloud Run

    Puoi utilizzare un file descrittore di progetto di buildpack, ad esempio project.toml, per impostare il builder durante il deployment dall'origine 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 generatore. Esempio: gcr.io/buildpacks/builder:google-22
    • SERVICE_IMAGE_NAME con il nome dell'immagine container che hai creato.