Cómo configurar tu entorno

Antes de programar y ejecutar un trabajo cron, debes configurar tu proyecto y entorno de Google Cloudpara Cloud Scheduler.

Habilita la API de Cloud Scheduler

Sigue las instrucciones que se indican a continuación para crear o seleccionar un proyecto de Google Cloud y habilitar la API de Cloud Scheduler.

Console

  1. Accede a tu cuenta de Google Cloud . Si eres nuevo en Google Cloud, crea una cuenta para evaluar el rendimiento de nuestros productos en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.

  2. 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 role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

  4. Enable the Cloud Scheduler 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

  5. 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 role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  6. Verify that billing is enabled for your Google Cloud project.

  7. Enable the Cloud Scheduler 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

    8.

gcloud

  1. Accede a tu cuenta de Google Cloud . Si eres nuevo en Google Cloud, crea una cuenta para evaluar el rendimiento de nuestros productos en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.

  2. Instala Google Cloud CLI.

  3. Si usas un proveedor de identidad externo (IdP), primero debes acceder a la gcloud CLI con tu identidad federada.

  4. Para inicializar gcloud CLI, ejecuta el siguiente comando: 

    gcloud init

  5. Crea o selecciona un Google Cloud proyecto.

    Roles necesarios para seleccionar o crear un proyecto

    • Selecciona un proyecto: Para seleccionar un proyecto, no se requiere un rol de IAM específico. Puedes seleccionar cualquier proyecto en el que se te haya otorgado un rol.
    • Crear un proyecto: Para crear un proyecto, necesitas el rol de Creador de proyectos (roles/resourcemanager.projectCreator), que contiene el permiso resourcemanager.projects.create. Obtén más información para otorgar roles.

    • Crea un Google Cloud proyecto:

      gcloud projects create PROJECT_ID

      Reemplaza PROJECT_ID por un nombre para el proyecto Google Cloud que estás creando.

    • Selecciona el proyecto Google Cloud que creaste:

      gcloud config set project PROJECT_ID

      Reemplaza PROJECT_ID por el nombre de tu Google Cloud proyecto.

  6. Verifica que la facturación esté habilitada para tu proyecto de Google Cloud .

  7. Habilite la API de Cloud Scheduler:

    Roles necesarios para habilitar las APIs

    Para habilitar las APIs, necesitas el rol de IAM de administrador de Service Usage (roles/serviceusage.serviceUsageAdmin), que contiene el permiso serviceusage.services.enable. Obtén más información para otorgar roles. 

    gcloud services enable cloudscheduler.googleapis.com

  8. Instala Google Cloud CLI.

  9. Si usas un proveedor de identidad externo (IdP), primero debes acceder a la gcloud CLI con tu identidad federada.

  10. Para inicializar gcloud CLI, ejecuta el siguiente comando: 

    gcloud init

  11. Crea o selecciona un Google Cloud proyecto.

    Roles necesarios para seleccionar o crear un proyecto

    • Selecciona un proyecto: Para seleccionar un proyecto, no se requiere un rol de IAM específico. Puedes seleccionar cualquier proyecto en el que se te haya otorgado un rol.
    • Crear un proyecto: Para crear un proyecto, necesitas el rol de Creador de proyectos (roles/resourcemanager.projectCreator), que contiene el permiso resourcemanager.projects.create. Obtén más información para otorgar roles.

    • Crea un Google Cloud proyecto:

      gcloud projects create PROJECT_ID

      Reemplaza PROJECT_ID por un nombre para el proyecto Google Cloud que estás creando.

    • Selecciona el proyecto Google Cloud que creaste:

      gcloud config set project PROJECT_ID

      Reemplaza PROJECT_ID por el nombre de tu Google Cloud proyecto.

  12. Verifica que la facturación esté habilitada para tu proyecto de Google Cloud .

  13. Habilite la API de Cloud Scheduler:

    Roles necesarios para habilitar las APIs

    Para habilitar las APIs, necesitas el rol de IAM de administrador de Service Usage (roles/serviceusage.serviceUsageAdmin), que contiene el permiso serviceusage.services.enable. Obtén más información para otorgar roles. 

    gcloud services enable cloudscheduler.googleapis.com
    14.

Configura la autenticación

La forma en que te autenticas en Cloud Scheduler depende de la interfaz que usas para acceder a la API y del entorno en el que se ejecuta tu código.

Para obtener más información, consulta Autentícate en Cloud Scheduler y Usa la autenticación con destinos de HTTP.

Agrega una aplicación de App Engine

Si vas a usar un destino HTTP de App Engine, debes agregar una aplicación de App Engine a tu proyecto. Esta app funciona como la ubicación del servicio de Cloud Scheduler y del controlador de trabajos, que realiza el trabajo asociado con un trabajo de Cloud Scheduler y devuelve una confirmación en respuesta.

Si quieres tener un controlador de trabajos de App Engine que no esté en tu proyecto, debes seleccionar un destino HTTP. En este caso, no necesitas una app de App Engine en tu proyecto.

Console

  1. En la consola de Google Cloud , ve a la página App Engine.

    Ir a App Engine

  2. En el diálogo Bienvenido a App Engine, realiza una de las siguientes acciones:

    • Si ya creaste una aplicación de App Engine y se muestra el mensaje Se creó tu aplicación de App Engine, puedes omitir los pasos restantes de esta sección.

      o

    • Si aún no creaste una aplicación de App Engine, haz clic en Crear aplicación y continúa con los pasos restantes de esta sección.

  3. Selecciona una región para tu aplicación.

    Ten en cuenta que europe-west y us-central se llaman, respectivamente, europe-west1 y us-central1 en los comandos de Cloud Scheduler.

    Después de configurar una región para la app de App Engine, no podrás cambiarla.

  4. No selecciones una cuenta de servicio. Se usará la cuenta de servicio predeterminada de App Engine.

  5. Haz clic en Siguiente.

    La aplicación se configuró y creó. Este proceso puede tardar unos minutos.

  6. No descargues el SDK de Cloud. En su lugar, haz clic en Lo haré más tarde.

    Deberías ver el mensaje Se creó tu aplicación de App Engine.

gcloud

  1. Para crear una aplicación de App Engine, ejecuta el comando gcloud app create:

    gcloud app create --region=REGION

    Reemplaza REGION por la ubicación en la que se ejecuta la app. Ten en cuenta que europe-west y us-central se llaman, respectivamente, europe-west1 y us-central1 en los comandos de Cloud Scheduler.

    Después de configurar una región para la app de App Engine, no podrás cambiarla.

  2. Puedes verificar la región de una app existente con el siguiente comando:

    gcloud app describe

    El locationId indica la región. Por ejemplo: locationId: us-central