Programar compilaciones

En esta página, se explica cómo ejecutar compilaciones según un programa predefinido con la consola de Google Cloud. Para programar compilaciones, debes crear un activador manual y, luego, invocarlo con Cloud Scheduler.

Antes de comenzar

  • Habilita la API de Cloud Build.

    Habilita la API

  • Ten listo tu código fuente.
  • Si aún no lo has hecho, crea un activador manual. Solo puedes programar compilaciones si tu activador es manual.

Programa compilaciones

Después de crear un activador manual, estarás listo para programar tu compilación.

Para programar tu compilación, haz lo siguiente:

  1. Abrir la página Activadores:

    Abrir la página Activadores

  2. Ubica la fila que contiene el nombre del activador manual que desees ejecutar según la programación.

  3. Haz clic en el menú (puntos suspensivos verticales) ubicado en el extremo derecho de la fila que contiene el activador.

  4. Haz clic en Ejecutar a la programación para programar la compilación.

    Verás el panel Ejecutar el activador según la programación en el lado derecho.

  5. Habilitar la API de Cloud Scheduler.

    Solo se te solicitará que habilites la API de Cloud Scheduler la primera vez que programas una compilación.

  6. Selecciona la cuenta de servicio que deseas que use Cloud Scheduler cuando invoque el activador.

    Te recomendamos seleccionar la cuenta de servicio de programación predeterminada, que tiene el siguiente formato, en el que PROJECT_ID es el ID del proyecto:

     cloud-build-trigger-scheduler@PROJECT_ID.iam.gserviceaccount.com
    

    Cuando selecciones la cuenta de servicio de programación predeterminada, se creará automáticamente con la función de IAM de editor de Cloud Build otorgada. Te recomendamos que no borres esta cuenta de servicio, ya que Cloud Scheduler la usa para programar compilaciones. Si borras esta cuenta de servicio por accidente o revocas cualquiera de sus permisos de IAM, puedes navegar a la página de IAM para agregar manualmente la cuenta de servicio y otorgarle el rol de Editor de Cloud Build. Es posible que debas esperar hasta una hora para que se reanuden los trabajos existentes de Cloud Scheduler después de volver a crear la cuenta de servicio.

  7. Haz clic en Continuar.

    Si no seleccionaste una región, es posible que se te solicite seleccionar una región para tus trabajos de Cloud Scheduler antes de continuar con el siguiente paso. Cuando seleccionas una región, se creará automáticamente una aplicación de App Engine en tu proyecto. No podrás cambiar la región del proyecto más adelante. Para obtener más información, consulta Regiones admitidas.

  8. Ingresa la siguiente configuración de trabajo de Cloud Scheduler:

    • Nombre: es un nombre para tu trabajo de Cloud Scheduler.
    • Descripción (opcional): es una descripción para tu trabajo de Cloud Scheduler.
    • Frecuencia: selecciona la frecuencia con la que deseas que se ejecute tu activador. Puedes elegir una frecuencia del menú desplegable o ingresar un valor personalizado mediante la sintaxis de cron. Por ejemplo, si deseas que tu activador manual se ejecute todos los días a las 6 a.m., puedes especificar tu frecuencia en la sintaxis de cron como 0 6 * * *. Para obtener más información sobre la sintaxis de cron, consulta Configura programas de trabajos cron.
    • Zona horaria: selecciona tu zona horaria.
  9. Haz clic en Crear para crear tu trabajo de Cloud Scheduler.

    Puedes crear varios trabajos del programador para cada activador manual.

  10. Si deseas ver tu trabajo de Cloud Scheduler, haz clic en Ver. De lo contrario, haz clic en Listo para cerrar el panel.

Actualiza tu trabajo de Cloud Scheduler

Si actualizas el campo Revisión de tu activador manual, deberás actualizar de forma manual el trabajo de Cloud Scheduler asociado con tu activador. Por ejemplo, si actualizas el nombre de la rama para tu activador manual, deberás actualizar el nombre de la rama en tu trabajo de forma manual.

Para actualizar el trabajo de Cloud Scheduler, sigue estos pasos:

  1. Abrir la página de Cloud Scheduler:

    Abrir la página de Cloud Scheduler

    Verás una lista de tus trabajos de Cloud Scheduler.

  2. Identifica el trabajo de Cloud Scheduler asociado con tu activador (opcional):

    1. Obtén el ID del activador mediante la ejecución del siguiente comando, en el que TRIGGER_NAME es el nombre del activador:

      gcloud builds triggers describe TRIGGER_NAME
      
    2. Anota el ID del activador.

    3. Ingresa tu ID de activador en la barra de filtros ubicada en la parte superior de la tabla.

    Verás la lista de los trabajos de Cloud Scheduler asociados con tu activador.

  3. Haz clic en la fila que contiene el nombre del trabajo que deseas actualizar.

  4. Haz clic en Editar en la parte superior de la página.

    Verás un formulario para actualizar tu trabajo de Cloud Scheduler.

  5. En el campo Body, actualiza la revisión.

  6. Haz clic en Actualizar.

Ya actualizaste la revisión asociada con tu activador para tu trabajo de Cloud Scheduler.

Quita el trabajo de Cloud Scheduler

Borrar o inhabilitar el activador no borrará ni inhabilitará de forma automática todos los trabajos de Cloud Scheduler que se crearon automáticamente cuando programaste el activador. Tus trabajos existirán y es posible que se sigan invocando las compilaciones.

Para asegurarte de que el activador ya no se ejecute en un momento específico, borra el trabajo de Cloud Scheduler.

Próximos pasos