Configura contenedores

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

Funciones obligatorias

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 los roles de IAM de Cloud Run y los 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 el punto de entrada y los argumentos

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

Consola

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

Ir a Cloud Run
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.
Haz clic en Contenedor, variables y secretos, conexiones y seguridad para expandir la página de propiedades del trabajo.
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.
Haz clic en Crear o Actualizar.

Línea de comandos

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

Descarga y visualiza la configuración del trabajo existente mediante el comando gcloud run jobs describe --format export, que genera resultados limpios en formato YAML. Luego, modifica los campos que se describen a continuación y sube el YAML modificado mediante el comando gcloud run jobs replace. Asegúrate de modificar los campos tal como se indica en la documentación.

Para ver y descargar la configuración, ejecuta el siguiente comando:
```
gcloud run jobs describe JOB_NAME --format export > job.yaml
```
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.
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:

Consola

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

Ir a Trabajos de Cloud Run
Haz clic en el trabajo que te interesa para abrir la página Detalles del trabajo.
Haz clic en la pestaña Configuración.
Ubica la configuración del contenedor en los detalles de configuración.

Línea de comandos

Usa el siguiente comando:
```
gcloud run jobs describe JOB_NAME
```
Busca la configuración de contenedores en la configuración mostrada.