Compila contenedores

Knative serving acepta imágenes de contenedor compiladas con cualquier herramienta apta, siempre que respeten el contrato del contenedor. En particular, tu código debe escuchar las solicitudes HTTP en el puerto que define la variable de entorno PORT. Knative serving inserta esta variable de entorno PORT de forma automática en tu contenedor.

En esta página, se describen varias formas de compilar imágenes de contenedor:

• Usa un Dockerfile
• Usa Buildpacks

Compila mediante un Dockerfile

Si usas Dockerfiles, puedes usar cualquiera de los siguientes métodos para compilar:

• Compila mediante Cloud Build
• Compila de forma local mediante Docker

Compila mediante Cloud Build

Para compilar tu imagen en Google Cloud, sigue estos pasos:

1. Navega a la carpeta que contiene tus fuentes y el Dockerfile.

2. Ejecuta este comando:

   gcloud builds submit --tag IMAGE_URL

   Reemplaza IMAGE_URL por una referencia a la imagen de contenedor, como gcr.io/cloudrun/hello.

Para obtener instrucciones detalladas sobre Cloud Build, consulta Implementa en Knative serving.

Si deseas obtener sugerencias para mejorar el rendimiento de la compilación, consulta Acelera las compilaciones.

Realiza compilaciones de forma local y haz el envío mediante Docker

Si tienes Docker instalado de manera local, puedes usar docker build en lugar de Cloud Build o Buildpacks.

Antes de compilar las fuentes en una imagen de contenedor (“alojamiento en contenedores”) mediante Docker, debe haber un Dockerfile presente, además de las fuentes. En las siguientes instrucciones, se usa Container Registry como el registro de imágenes.

Precaución: Container Registry está obsoleto y se programó para el cierre. Las organizaciones que no usaron Container Registry antes del 8 de enero de 2024 tendrán nuevos repositorios de gcr.io alojados en Artifact Registry de forma predeterminada. A partir del 15 de mayo de 2024, los proyectos de Google Cloud sin uso anterior de Container Registry solo admitirán el hosting y la administración de imágenes para el dominio gcr.io en Artifact Registry.

Container Registry está programado para cerrarse el 18 de marzo de 2025. Para obtener detalles sobre la baja, consulta Baja de Container Registry.

Para compilar tu imagen de contenedor mediante Docker, sigue estos pasos:

1. Navega a la carpeta que contiene tus fuentes y el Dockerfile.

2. Ejecuta este comando:

   docker build . --tag IMAGE_URL

   Reemplaza IMAGE_URL por una referencia a la imagen de contenedor, como gcr.io/cloudrun/hello.

3. Si aún no configuraste Docker para usar Google Cloud CLI a fin de autenticar solicitudes a Container Registry, hazlo ahora mediante el siguiente comando:

   gcloud auth configure-docker

   Debes hacer esto antes de enviar o extraer imágenes mediante Docker. Solo debes hacerlo una vez.

4. Envía la imagen de contenedor a Container Registry:

   docker push IMAGE_URL

   Reemplaza IMAGE_URL por una referencia a la imagen de contenedor, como gcr.io/cloudrun/hello.

Para excluir archivos locales de este proceso, sigue las instrucciones del archivo de configuración .dockerignore.

Compila mediante Buildpacks

Para obtener información completa sobre Buildpacks, consulta el sitio web de Buildpacks. Google proporciona un conjunto de Buildpacks compatibles con CNCF que compilan código fuente en imágenes de contenedor diseñadas para ejecutarse en plataformas de contenedores de Google Cloud, incluido Knative serving.

Las siguientes plataformas son compatibles en este momento:

• Go
• Node.js
• Python
• Java
• .NET Core

Compila con Buildpacks mediante Cloud Build

Sigue estos pasos para compilar con un Buildpack:

1. Navega a la carpeta que contiene tus fuentes.

2. Ejecuta este comando:

   gcloud builds submit --pack image=IMAGE_URL

   Reemplaza IMAGE_URL por la URL de la imagen de contenedor, como gcr.io/myproject/myservice.

3. Espera a que se complete la compilación.

Realiza compilaciones con Buildpacks mediante la línea de comandos pack

Sigue estos pasos para realizar una compilación mediante el comando pack:

1. Si aún no lo hiciste, instala Docker.

2. Si aún no configuraste Docker para usar Google Cloud CLI a fin de autenticar solicitudes a Container Registry, hazlo ahora mediante el siguiente comando:

   gcloud auth configure-docker

   Debes hacer esto antes de enviar o extraer imágenes mediante Docker. Solo debes hacerlo una vez.

3. Si aún no lo hiciste, instala pack.

4. Navega a la carpeta que contiene tus fuentes.

5. Ejecuta el siguiente comando para compilar y enviar a tu Container Registry:

   pack build --publish IMAGE_URL

   Reemplaza IMAGE_URL por una referencia a la imagen de contenedor, como gcr.io/cloudrun/hello.

6. Espera a que pack finalice.

Para obtener más información, lee las instrucciones provistas en Compila una aplicación.

¿Qué sigue?

• Si deseas obtener más información sobre el contrato que deben cumplir tus contenedores para implementarse en Knative serving, consulta Contrato de contenedores.

• Para implementar en Knative serving tus contenedores compilados, sigue los pasos de Implementa servicios.

• Para automatizar las compilaciones y las implementaciones de tus servicios de Knative serving mediante activadores de Cloud Build, configura la implementación continua.