Configura contenedores

En esta página, se describe cómo configurar el comando y los argumentos de punto de entrada para un trabajo 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.

Ten en cuenta que puedes tener un máximo de 1,000 argumentos por contenedor para cada trabajo.

Roles obligatorios

Para obtener los permisos que necesitas para configurar los trabajos de Cloud Run, pídele a tu administrador que te otorgue los siguientes roles de IAM:

• Desarrollador de Cloud Run (roles/run.developer) en el trabajo de Cloud Run
• Usuario de la cuenta de servicio (roles/iam.serviceAccountUser) en la identidad del servicio

Para obtener una lista de los roles y los permisos de IAM asociados con Cloud Run, consulta Roles de IAM de Cloud Run y Permisos de IAM de Cloud Run. Si tu trabajo de Cloud Run interactúa con las APIs de Google Cloud, como las bibliotecas cliente de Cloud, consulta la guía de configuración de identidades del servicio. Para obtener más información sobre cómo otorgar roles, consulta permisos de implementación y administra el acceso.

Configura un punto de entrada y argumentos

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

Console

1. En la consola de Google Cloud, ve a la página de trabajos de Cloud Run:

   Ir a Cloud Run

2. Haz clic en Implementar contenedor y selecciona Trabajo para completar la página de configuración de trabajo inicial. Si quieres configurar un trabajo existente, selecciona el trabajo y, luego, haz clic 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.

   

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

5. Haz clic en Crear o Actualizar.

gcloud

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

   gcloud 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.

Para actualizar el comando y los argumentos de un trabajo existente, sigue estos pasos:

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

YAML

1. Si creas un trabajo nuevo, omite este paso. Si actualizas un trabajo existente, descarga su configuración de YAML:

   gcloud run jobs describe JOB_NAME --format export > job.yaml

2. Actualiza los atributos args: y command:

   apiVersion: run.googleapis.com/v1
   kind: Job
   metadata:
     name: JOB_NAME
   spec:
     template:
       spec:
         template:
           spec:
             containers:
             - args:
               - 'ARG1'
               - 'ARG-N'
               command:
               - COMMAND
               image: IMAGE

   Reemplazar

   • 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. De manera opcional, especifica argumentos adicionales en una línea separada.

   También puedes especificar más opciones de configuración, como variables de entorno o límites de memoria.

3. Actualiza la configuración del trabajo existente:

   gcloud run jobs replace job.yaml

Para borrar cualquier comando y argumento de punto de entrada que hayas configurado (restablecer a los valores predeterminados del contenedor), proporciona cadenas vacías de la siguiente manera:

gcloud run jobs update JOB_NAME --command "" --args "" 

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"

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 trabajo de Cloud Run, sigue estos pasos:

Console

1. En la consola de Google Cloud, ve a la página de trabajos de Cloud Run:

   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.

gcloud

1. Usa el siguiente comando:

   gcloud run jobs describe JOB_NAME

2. Busca la configuración de contenedores en la configuración mostrada.