Crear y ejecutar tareas en Cloud Run

Crear y ejecutar tareas en Cloud Run

En esta página se muestra cómo crear un trabajo en Cloud Run con un contenedor de ejemplo, ejecutar el trabajo y ver los registros del trabajo.

Antes de empezar

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
Roles required to select or create a project
• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.
Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.
Go to project selector
Verify that billing is enabled for your Google Cloud project.
Enable the Cloud Run Admin API.
Roles required to enable APIs
To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.
Enable the API
Make sure that you have the following role or roles on the project: Cloud Run Developer, Logs Viewer
Check for the roles
1. In the Google Cloud console, go to the IAM page.

   Go to IAM
2. Select the project.

3. In the Principal column, find all rows that identify you or a group that you're included in. To learn which groups you're included in, contact your administrator.

4. For all rows that specify or include you, check the Role column to see whether the list of roles includes the required roles.
Grant the roles
1. In the Google Cloud console, go to the IAM page.

   Ir a IAM
2. Selecciona el proyecto.
3. Haz clic en Conceder acceso.

4. En el campo Nuevos principales, introduce tu identificador de usuario. Normalmente, se trata de la dirección de correo de una cuenta de Google.

5. En la lista Selecciona un rol, elige un rol.
6. Para conceder más roles, haz clic en Añadir otro rol y añade cada rol adicional.
7. Haz clic en Guardar.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Cloud Run Admin API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

Make sure that you have the following role or roles on the project: Cloud Run Developer, Logs Viewer

Check for the roles

1. In the Google Cloud console, go to the IAM page.

   Go to IAM
2. Select the project.

3. In the Principal column, find all rows that identify you or a group that you're included in. To learn which groups you're included in, contact your administrator.

4. For all rows that specify or include you, check the Role column to see whether the list of roles includes the required roles.

Grant the roles

1. In the Google Cloud console, go to the IAM page.

   Ir a IAM
2. Selecciona el proyecto.
3. Haz clic en Conceder acceso.

4. En el campo Nuevos principales, introduce tu identificador de usuario. Normalmente, se trata de la dirección de correo de una cuenta de Google.

5. En la lista Selecciona un rol, elige un rol.
6. Para conceder más roles, haz clic en Añadir otro rol y añade cada rol adicional.
7. Haz clic en Guardar.

1. Asegúrate de que tienes asignado el rol Usuario de cuenta de servicio en la identidad de servicio. De forma predeterminada, la identidad de servicio es la cuenta de servicio predeterminada de Compute Engine.

   Conceder los roles

   Para conceder acceso al recurso de identidad de servicio, usa el comando gcloud iam service-accounts add-iam-policy-binding y sustituye las variables destacadas por los valores correspondientes:

         gcloud iam service-accounts add-iam-policy-binding SERVICE_ACCOUNT_EMAIL \
             --member=user:PRINCIPAL \
             --role=roles/iam.serviceAccountUser
         

   Haz los cambios siguientes:

   • SERVICE_ACCOUNT_EMAIL: la dirección de correo de la cuenta de servicio que usas como identidad de servicio, como:
     • Cuenta de servicio predeterminada de Compute Engine: [e-mail]
     • Una cuenta de servicio que has creado: SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com
   • PRINCIPAL: el identificador de usuario. Normalmente, se trata de la dirección de correo de la cuenta de Google que está desplegando el recurso de Cloud Run.
2. Consulta los precios de Cloud Run o calcula los costes con la calculadora de precios.

Crear una tarea

Para crear un trabajo, sigue estos pasos:

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

   Ir a Cloud Run

2. Selecciona Trabajos en el menú y haz clic en Desplegar contenedor para abrir el formulario Crear trabajo.

3. Haz clic en Probar con un contenedor de ejemplo.

4. En el menú desplegable Región, selecciona la región en la que quieras ejecutar el trabajo.

5. Haz clic en Crear para crear el trabajo.

El trabajo se crea y está listo para ejecutarse.

Ejecutar el trabajo

Una vez que hayas creado un trabajo, podrás ejecutarlo de las siguientes formas:

1. En la pestaña Tareas, haz clic en la tarea que acabas de crear para abrir la página Detalles de la tarea.

2. Haz clic en la opción para ejecutar.

3. Los registros de la tarea están disponibles en cuanto empieza la ejecución. Haz clic en la pestaña Registros para ver los registros del trabajo.

Éxito: has creado y ejecutado una tarea en Cloud Run.

Ubicaciones de Cloud Run

Cloud Run es regional, lo que significa que la infraestructura que ejecuta tus servicios de Cloud Run se encuentra en una región específica y Google la gestiona para que esté disponible de forma redundante en todas las zonas de esa región.



Cumplir tus requisitos de latencia, disponibilidad o durabilidad son factores primordiales para seleccionar la región en la que se ejecutan tus servicios de Cloud Run. Por lo general, puedes seleccionar la región más cercana a tus usuarios, pero debes tener en cuenta la ubicación de los otros Google Cloudproductos que utiliza tu servicio de Cloud Run. Usar Google Cloud productos juntos en varias ubicaciones puede afectar a la latencia y al coste de tu servicio.



Cloud Run está disponible en las siguientes regiones:

Con sujeción a los precios del nivel 1

• asia-east1 (Taiwán)
• asia-northeast1 (Tokio)
• asia-northeast2 (Osaka)
• asia-south1 (Bombay, la India)
• europe-north1 (Finlandia) CO₂ bajo
• europe-north2 (Estocolmo) CO₂ bajo
• europe-southwest1 (Madrid) CO₂ bajo
• europe-west1 (Bélgica) CO₂ bajo
• europe-west4 (Países Bajos) CO₂ bajo
• europe-west8 (Milán)
• europe-west9 (París) CO₂ bajo
• me-west1 (Tel Aviv)
• northamerica-south1 (México)
• us-central1 (Iowa) CO₂ bajo
• us-east1 (Carolina del Sur)
• us-east4 (Norte de Virginia)
• us-east5 (Columbus)
• us-south1 (Dallas) CO₂ bajo
• us-west1 (Oregón) CO₂ bajo

Con sujeción a los precios del nivel 2

• africa-south1 (Johannesburgo)
• asia-east2 (Hong Kong)
• asia-northeast3 (Seúl, Corea del Sur)
• asia-southeast1 (Singapur)
• asia-southeast2 (Yakarta)
• asia-south2 (Delhi, la India)
• australia-southeast1 (Sídney)
• australia-southeast2 (Melbourne)
• europe-central2 Varsovia (Polonia)
• europe-west10 (Berlín) CO₂ bajo
• europe-west12 (Turín)
• europe-west2 (Londres, Reino Unido) CO₂ bajo
• europe-west3 (Fráncfort, Alemania)
• europe-west6 (Zúrich, Suiza) CO₂ bajo
• me-central1 (Doha)
• me-central2 (Dammam)
• northamerica-northeast1 (Montreal) CO₂ bajo
• northamerica-northeast2 (Toronto) CO₂ bajo
• southamerica-east1 (São Paulo, Brasil) CO₂ bajo
• southamerica-west1 (Santiago, Chile) CO₂ bajo
• us-west2 (Los Ángeles)
• us-west3 (Salt Lake City)
• us-west4 (Las Vegas)

Si ya has creado un servicio de Cloud Run, puedes ver la región en el panel de control de Cloud Run de la Google Cloud consola.

Aceptar

Limpieza

Para evitar que se apliquen cargos adicionales a tu cuenta de Google Cloud , elimina todos los recursos que hayas implementado con esta guía de inicio rápido.

Eliminar un repositorio

Cloud Run solo cobra por el tiempo que se ejecuta tu trabajo. Sin embargo, es posible que se te cobre por almacenar la imagen de contenedor en Artifact Registry. Para eliminar repositorios de Artifact Registry, sigue los pasos que se indican en el artículo Eliminar repositorios de la documentación de Artifact Registry.

Eliminar un trabajo

Los trabajos de Cloud Run solo generan costes cuando se ejecuta una tarea. Para eliminar tu trabajo de Cloud Run, sigue uno de estos pasos:

Consola

Para eliminar un trabajo, sigue estos pasos:

1. En la Google Cloud consola, ve a Cloud Run:

   Ir a Cloud Run

2. Busca el trabajo que quieras eliminar en la lista de trabajos y haz clic en la casilla para seleccionarlo.

3. Haz clic en Eliminar. De esta forma, se finalizan todas las ejecuciones de trabajos en curso y todas las instancias de contenedor en ejecución.

gcloud

Para eliminar un trabajo, ejecuta el siguiente comando:

gcloud run jobs delete JOB_NAME

Sustituye JOB_NAME por el nombre del trabajo.

Eliminar un proyecto de prueba

Si eliminas tu proyecto de Google Cloud , se detendrá la facturación de todos los recursos de ese proyecto. Para liberar todos los recursos de tu proyecto, sigue estos pasos: Google Cloud

Precaución: Eliminar un proyecto tiene los siguientes efectos:
• Se elimina todo el contenido del proyecto. Si has usado un proyecto que ya existía para las tareas de este documento, cuando lo elimines, también se eliminará cualquier otro trabajo que hayas realizado en él.
• Se pierden los IDs de proyecto personalizados. Cuando creaste este proyecto, es posible que hayas creado un ID de proyecto personalizado que quieras usar en el futuro. Para conservar las URLs que usan el ID del proyecto, como una URL appspot.com, elimina los recursos seleccionados dentro del proyecto en lugar de eliminar todo el proyecto.
1. In the Google Cloud console, go to the Manage resources page.

   Go to Manage resources

2. In the project list, select the project that you want to delete, and then click Delete.
3. In the dialog, type the project ID, and then click Shut down to delete the project.

Siguientes pasos

• Crear y ejecutar trabajos (Node.js)
• Crear y ejecutar tareas (Go)
• Compilar y ejecutar trabajos (Python)
• Compilar y ejecutar tareas (Java)
• Gestionar empleos
• Gestionar ejecuciones de trabajos
• Ejecutar tareas
• Ejecutar tareas según una programación