Configura contenedores

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

En esta página, se describe cómo configurar el puerto del contenedor, el comando de punto de entrada y los argumentos para los servicios de Cloud Run y cómo configurar el comando y los argumentos de punto de entrada para los trabajos de Cloud Run.

Cuando Cloud Run inicia un contenedor, ejecuta el comando entrypoint predeterminado y los argumentos del comando predeterminados de la imagen. Si deseas anular el entrypoint predeterminado y los argumentos del comando de la imagen, puedes usar los campos command y args en la configuración del contenedor. El campo command especifica el comando real que ejecuta el contenedor. El campo args especifica los argumentos que se pasan a ese comando.

Configura el puerto del contenedor (servicios)

Cualquier cambio en la configuración conlleva la creación de una revisión nueva. Las revisiones posteriores también adoptarán esta configuración de manera automática, a menos que realices actualizaciones explícitas para cambiarla.

En los servicios de Cloud Run, Cloud Run inserta la variable de entorno PORT en el contenedor. El contenedor debe escuchar en el puerto que define la variable de entorno PORT en lugar de un puerto codificado específico. Sin embargo, si esto no es posible, puedes configurar desde qué puerto se envían las solicitudes al contenedor. Ten en cuenta que la configuración de puertos no se aplica a los trabajos de Cloud Run.

Consola

  1. Ir a Cloud Run

  2. Haz clic en Crear servicio si quieres configurar un servicio nuevo en el que realizarás la implementación. Si quieres configurar un servicio existente, haz clic en el servicio y, luego, en Edit and Deploy New Revision.

  3. Si configuras un servicio nuevo, completa la página de configuración del servicio inicial como desees y haz clic en Contenedor, conexiones, seguridad para expandir la página de configuración del servicio.

  4. Haz clic en la pestaña Contenedor.

    image

  5. Especifica el puerto al que deseas que se envíen las solicitudes, si no es el valor predeterminado de “8080”. Con esto también se establece la variable de entorno “PORT”.

  6. Haz clic en Crear o Implementar.

Línea de comandos

Puedes actualizar la configuración del puerto de un servicio mediante el siguiente comando:

gcloud run services update SERVICE --port PORT

Reemplaza los siguientes elementos:

  • SERVICE por el nombre del servicio
  • PORT por el puerto al que se envían las solicitudes. Ten en cuenta que el puerto predeterminado es 8080

También puedes configurar puertos durante la implementación mediante el siguiente comando:

gcloud run deploy --image IMAGE_URL --port PORT

Reemplaza IMAGE_URL por una referencia a la imagen de contenedor, como us-docker.pkg.dev/cloudrun/container/hello:latest.

YAML

Puedes descargar y ver la configuración del servicio existente mediante el comando gcloud run services describe --format export, que genera resultados limpios en formato YAML. Luego, puedes modificar los campos que se describen a continuación y subir el YAML modificado mediante el comando gcloud run services replace. Asegúrate de modificar los campos tal como se indica en la documentación.

  1. Para ver y descargar la configuración, ejecuta el siguiente comando:

    gcloud run services describe SERVICE --format export > service.yaml
  2. Actualiza el atributo containerPort::

    apiVersion: serving.knative.dev/v1
    kind: Service
    metadata:
      name: SERVICE
    spec:
      template:
        metadata:
          name: REVISION
        spec:
          containers:
          - image: IMAGE_URL
            ports:
            - containerPort: PORT
    

    Reemplazar

    • SERVICE por el nombre del servicio de Cloud Run
    • IMAGE_URL por una referencia a la imagen de contenedor, como us-docker.pkg.dev/cloudrun/container/hello:latest
    • PORT por el puerto al que se envían las solicitudes
    • REVISION por un nombre de revisión nuevo o bórralo (si está presente). Si proporcionas un nuevo nombre de revisión, debe cumplir con los siguientes criterios:
      • Comienza con SERVICE-
      • Solo contiene letras minúsculas, números y -
      • No termina con -
      • No supera los 63 caracteres
  3. Reemplaza el servicio por la configuración nueva mediante el comando siguiente:

    gcloud run services replace service.yaml

Configura el comando y los argumentos del punto de entrada del contenedor

Puedes configurar argumentos y comandos del punto de entrada para trabajos y servicios de Cloud Run.

Para servicios de Cloud Run

Cualquier cambio en la configuración conlleva la creación de una revisión nueva. Las revisiones posteriores también adoptarán esta configuración de manera automática, a menos que realices actualizaciones explícitas para cambiarla.

El comando y los argumentos del contenedor especificados anulan las imágenes predeterminadas ENTRYPOINT y CMD.

Puedes establecer argumentos y comandos entrypoint con la consola de Google Cloud, la línea de comandos de gcloud o un archivo .yaml cuando creas un servicio nuevo o implementas una revisión nueva:

Console

  1. Ir a Cloud Run

  2. Haz clic en Crear servicio si quieres configurar un servicio nuevo en el que realizarás la implementación. Si quieres configurar un servicio existente, haz clic en el servicio y, luego, en Edit and Deploy New Revision.

  3. Si configuras un servicio nuevo, completa la página de configuración del servicio inicial como desees y haz clic en Contenedor, conexiones, seguridad para expandir la página de configuración del servicio.

  4. Haz clic en la pestaña Contenedor.

    image

  5. Especifica el comando que deseas que ejecute el contenedor, si no es el comando definido en tu contenedor y, de manera opcional, especifica los argumentos para el comando del entrypoint.

  6. Haz clic en Crear o Implementar.

Línea de comandos

Puedes actualizar el comando de inicio y los argumentos de un servicio determinado mediante el siguiente comando:

gcloud run services update SERVICE --command COMMAND --args ARG1,ARG-N

Reemplaza los siguientes elementos:

  • COMMAND por el comando que usará el contenedor si no usas el comando predeterminado
  • ARG1 por el argumento que envías al comando del contenedor; usa una lista delimitada por comas cuando haya más de un argumento

También puedes especificar un entrypoint y argumentos durante la implementación mediante el siguiente comando:

gcloud run deploy --image IMAGE_URL --command COMMAND --args ARG1,ARG-N

Reemplaza IMAGE_URL por una referencia a la imagen de contenedor, como us-docker.pkg.dev/cloudrun/container/hello:latest

YAML

Puedes descargar y ver la configuración del servicio existente mediante el comando gcloud run services describe --format export, que genera resultados limpios en formato YAML. Luego, puedes modificar los campos que se describen a continuación y subir el YAML modificado mediante el comando gcloud run services replace. Asegúrate de modificar los campos tal como se indica en la documentación.

  1. Para ver y descargar la configuración, ejecuta el siguiente comando:

    gcloud run services describe SERVICE --format export > service.yaml
  2. Actualiza los atributos command y args:

    spec:
      containers:
      - image: IMAGE_URL
        command:
        - COMMAND
        args:
        - "ARG1"
        - "ARG-N"
    

    Reemplazar

    • IMAGE_URL por una referencia a la imagen de contenedor, como us-docker.pkg.dev/cloudrun/container/hello:latest
    • COMMAND por el comando que usará el contenedor si no usas el comando predeterminado
    • ARG1 por el argumento que envías al comando del contenedor; usa una lista delimitada por comas cuando haya más de un argumento
  3. Reemplaza el servicio por la configuración nueva mediante el siguiente comando:

    gcloud run services replace service.yaml

Terraform

Agrega el siguiente código a un recurso google_cloud_run_service en tu configuración de Terraform. Reemplaza /server por el comando que se usa para iniciar el contenedor y agrega los argumentos necesarios al array args.

template {
  spec {
    containers {
      image = "us-docker.pkg.dev/cloudrun/container/hello"

      # Container "entry-point" command
      # https://cloud.google.com/run/docs/configuring/containers#configure-entrypoint
      command = ["/server"]

      # Container "entry-point" args
      # https://cloud.google.com/run/docs/configuring/containers#configure-entrypoint
      args = []
    }
  }

Para aplicar tu configuración de Terraform en un proyecto de Google Cloud, completa los siguientes pasos:

  1. Inicia Cloud Shell
  2. Establece el proyecto de Google Cloud en el que deseas aplicar la configuración de Terraform:
    export GOOGLE_CLOUD_PROJECT=PROJECT_ID
    
  3. Crea un directorio y abre un archivo nuevo en ese directorio. El nombre del archivo debe tener la extensión .tf, por ejemplo main.tf:
    mkdir DIRECTORY && cd DIRECTORY && nano main.tf
    
  4. Copia la muestra en main.tf.
  5. Revisa y modifica los parámetros de muestra que se aplicarán a tu entorno.
  6. Para guardar los cambios, presiona Ctrl-x y, luego, y.
  7. Inicializa Terraform mediante este comando:
    terraform init
  8. Revisa la configuración y verifica que los recursos que creará o actualizará Terraform coincidan con tus expectativas:
    terraform plan

    Corrige la configuración según sea necesario.

  9. Para aplicar la configuración de Terraform, ejecuta el siguiente comando y, luego, ingresa yes cuando se te solicite:
    terraform apply

    Espera hasta que Terraform muestre el mensaje “Apply complete!”.

  10. Abre tu proyecto de Google Cloud para ver los resultados. En la consola de Google Cloud, navega a tus recursos en la IU para asegurarte de que Terraform los haya creado o actualizado.

Para trabajos de Cloud Run

A fin de configurar el punto de entrada del comando y los argumentos para los trabajos, haz lo siguiente:

Consola

  1. Ir a Cloud Run

  2. Si quieres configurar un nuevo trabajo, haz clic en la pestaña Trabajos y completa la página de configuración de trabajo inicial como desees. Si quieres configurar un trabajo existente, haz clic en el trabajo y, luego, en Editar.

  3. Haz clic en Contenedor, variables y secretos, conexiones y seguridad para expandir la página de propiedades del trabajo.

  4. Haz clic en la pestaña General.

    imagen

  5. Especifica el comando que deseas que ejecute el contenedor, si no es el comando definido en tu contenedor y, de manera opcional, especifica los argumentos para el comando del entrypoint.

  6. Haz clic en Crear o Actualizar.

Línea de comandos

  1. A fin de configurar el comando de inicio y los argumentos para un trabajo nuevo, sigue estos pasos:

    gcloud beta run jobs create JOB_NAME --image IMAGE_URL --command COMMAND --args ARG1,ARG-N

    Reemplazar

    • JOB_NAME por el nombre de tu trabajo.
    • COMMAND por el comando que usará el contenedor si no usas el comando predeterminado
    • ARG1 por el argumento que envías al comando del contenedor o usa una lista delimitada por comas cuando haya más de un argumento
    • Reemplaza IMAGE_URL por una referencia a la imagen de contenedor, como us-docker.pkg.dev/cloudrun/container/job:latest.
  2. Para actualizar el comando y los argumentos de un trabajo existente, sigue estos pasos:

    gcloud beta run jobs update JOB_NAME --command COMMAND --args ARG1,ARG-N 

Usa signos igual o comas en argumentos

Si usas el signo igual en tus argumentos, proporciónalos con el siguiente formato:

gcloud run deploy  \
  --args="--repo-allowlist=github.com/example/example_demo" \
  --args="--gh-webhook-secret=XX" \

Si se usan comas en los argumentos, consulta Configura variables de entorno para obtener detalles sobre cómo escapar comas.

Visualiza la configuración del contenedor

Para ver la configuración actual del contenedor de tu servicio de Cloud Run, sigue estos pasos:

Consola

  1. Ir a Cloud Run

  2. Haz clic en el servicio que te interesa para abrir la página Detalles del servicio.

  3. Haz clic en la pestaña Revisiones.

  4. En el panel de detalles a la derecha, la configuración de contenedores aparece en la pestaña General.

Línea de comandos

  1. Usa el siguiente comando:

    gcloud run services describe SERVICE
  2. Busca la configuración de contenedores en la configuración mostrada.

Para ver la configuración actual del contenedor de tu trabajo de Cloud Run, sigue estos pasos:

Consola

  1. Ir a Trabajos de Cloud Run

  2. Haz clic en el trabajo que te interesa para abrir la página Detalles del trabajo.

  3. Haz clic en la pestaña Configuración.

  4. Ubica la configuración del contenedor en los detalles de configuración.

Línea de comandos

  1. Usa el siguiente comando:

    gcloud beta run jobs describe JOB_NAME
  2. Busca la configuración de contenedores en la configuración mostrada.