Compila contenedores

La entrega de Knative acepta imágenes de contenedor compiladas con cualquier herramienta capaz de compilar imágenes de contenedor, 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 inyecta automáticamente esta variable de entorno PORT 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.

Si deseas obtener instrucciones detalladas de Cloud Build, consulta Realiza la implementación en la entrega de Knative.

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.

Nota: 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. Después 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 paquetes de compilación compatibles con CNCF que compilan código fuente en imágenes de contenedor diseñadas para ejecutarse en plataformas de contenedores de Google Cloud, incluida la entrega de Knative.

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 la entrega de Knative, consulta Contrato del contenedor.

• Para implementar los contenedores compilados en la entrega de Knative, sigue los pasos en Implementa servicios.

• Para automatizar las compilaciones y las implementaciones de los servicios de entrega de Knative con activadores de Cloud Build, configura la implementación continua.