Usar un creador específico

Los compiladores son imágenes versionadas que contienen todos los componentes necesarios para crear un contenedor ejecutable. Cada compilador usa una distribución de SO específica como imagen base, como Ubuntu 22, y admite varias versiones de lenguajes de programación.

Es posible que tengas que personalizar la versión del compilador si necesitas lo siguiente:

• Una dependencia específica del SO que solo está disponible en una versión concreta del compilador.
• Una versión específica de un lenguaje de programación que solo está disponible en una versión específica de un creador.

Compilaciones locales

Para las compilaciones locales, debes tener instaladas la CLI de Pack y Docker.

Antes de empezar

1. Instala Docker Community Edition (CE) en tu estación de trabajo. pack usa Docker como compilador de imágenes OCI.
2. Instala Pack CLI.
3. Instala la herramienta de control de versiones de Git para obtener la aplicación de ejemplo de GitHub.

Especificar la versión del compilador con pack

Puedes añadir la marca --builder al comando pack para especificar la versión del compilador que quieras usar:

pack build SERVICE_IMAGE_NAME --builder=BUILDER_IMAGE_URL

Sustituye:

• BUILDER_IMAGE_URL con la URL del creador. Ejemplo: gcr.io/buildpacks/builder:google-22
• SERVICE_IMAGE_NAME con el nombre que elijas para la imagen de tu aplicación.

Para obtener más información sobre el comando pack, consulta la documentación de la CLI.

Especificar la versión del compilador con project.toml

Puedes usar un descriptor de proyecto (project.toml) de buildpacks para definir el compilador al compilar con pack.

1. En el directorio raíz de tu aplicación, crea un archivo llamado project.toml con la siguiente configuración:

   [build]
   builder = "BUILDER_IMAGE_URL"

2. Compila tu aplicación ejecutando el comando `pack`:

   pack build SERVICE_IMAGE_NAME

Sustituye:

• BUILDER_IMAGE_URL con la URL del creador, por ejemplo, gcr.io/buildpacks/builder:google-22
• SERVICE_IMAGE_NAME con el nombre que elijas para la imagen de tu aplicación.

Compilaciones remotas

Puedes usar un compilador específico con Cloud Build añadiendo la marca --pack al enviar tu proyecto.

Antes de empezar

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.

Si utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la CLI de gcloud con tu identidad federada.

Para inicializar gcloud CLI, ejecuta el siguiente 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.

Si utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la CLI de gcloud con tu identidad federada.

Para inicializar gcloud CLI, ejecuta el siguiente comando:

gcloud init

Si ya has instalado la CLI de Google Cloud, asegúrate de tener la última versión disponible ejecutando gcloud components update.

1. Asegúrate de que tu proyecto Google Cloud tiene acceso a un repositorio de imágenes de contenedor.

   Para configurar el acceso a un repositorio de Docker en Artifact Registry, sigue estos pasos:

   1. Crea un repositorio de Docker en la misma ubicación que tu Google Cloud proyecto.

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

      Reemplazar:
      • REPO_NAME por el nombre que elijas para tu repositorio de Docker.
      • REGION con la ubicación del proyecto o la más cercana. Google Cloud
      • DESCRIPTION con la descripción que quieras.

      Por ejemplo, para crear un repositorio docker en us-west2 con la descripción "Repositorio de Docker", ejecuta el siguiente comando:

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

   2. Verifica que se haya creado el repositorio:

      gcloud artifacts repositories list

      Debería ver el nombre que elija para su repositorio de Docker en la lista.

Compilar la aplicación con un compilador específico

1. Usa gcloud para enviar el código fuente de la aplicación a Cloud Build:

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

   Sustituye:

   • BUILDER_IMAGE_URL con la URL del creador. Ejemplo: gcr.io/buildpacks/builder:google-22
   • LOCATION con el nombre de la región de tu repositorio de contenedores. Ejemplo: us-west2-docker.pkg.dev
   • PROJECT_ID por el ID de tu Google Cloud proyecto.
   • REPO_NAME con el nombre de tu repositorio de Docker.
   • SERVICE_IMAGE_NAME con el nombre de la imagen de contenedor que has creado.

   Para obtener más información sobre el comando submit, consulta la documentación de Cloud Build.

2. Comprueba que la aplicación de ejemplo se haya publicado correctamente en REPO_NAME:

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

   Sustituye:

   • LOCATION con el nombre de la región de tu repositorio de contenedores. Ejemplo: us-west2-docker.pkg.dev
   • PROJECT_ID por el ID de tu Google Cloud proyecto.
   • REPO_NAME con el nombre de tu repositorio de Docker.

Desplegar desde el código fuente con Cloud Run

Puedes usar un archivo de descriptor de proyecto de buildpacks, como project.toml, para definir el compilador al desplegar desde el código fuente con Cloud Run.

1. Inicializa un archivo project.toml en el directorio raíz de tu aplicación y pega la siguiente configuración:

   [build]
   builder = "BUILDER_IMAGE_URL"

2. Desplegar una aplicación desde el código fuente

   gcloud run deploy --source . SERVICE_IMAGE_NAME

Sustituye:

• BUILDER_IMAGE_URL con la URL del creador. Ejemplo: gcr.io/buildpacks/builder:google-22
• SERVICE_IMAGE_NAME con el nombre de la imagen de contenedor que has creado.