Configura períodos de mantenimiento

En esta página, se explica cómo definir períodos de mantenimiento para instancias de Cloud Data Fusion.

Los períodos de mantenimiento son compatibles con las instancias de Cloud Data Fusion en las versiones 6.8.0 y posteriores.

Información acerca de los períodos de mantenimiento

Un período de mantenimiento en Cloud Data Fusion es un período en el que permites que realice operaciones de mantenimiento, lo que reduce el riesgo de interrupciones del servicio durante los momentos de mayor uso. La programación de los períodos de mantenimiento durante las horas de baja actividad o los momentos en los que la actividad es más baja minimiza el impacto en tus instancias de Cloud Data Fusion y las ejecuciones de las canalizaciones.

La configuración de los períodos de mantenimiento te permite controlar cuándo ocurren las operaciones de mantenimiento en tu instancia:

  • Si se define el período de mantenimiento, Cloud Data Fusion realiza las operaciones de mantenimiento dentro de los períodos definidos.
  • Si el período de mantenimiento no está definido, el mantenimiento se puede realizar en cualquier momento.

Información acerca de las operaciones de mantenimiento

Para garantizar la seguridad del sistema y el cumplimiento, Cloud Data Fusion realiza operaciones de mantenimiento con regularidad. Estas operaciones incluyen la aplicación de actualizaciones importantes y parches de seguridad para mitigar las vulnerabilidades y proteger los datos del usuario. Los períodos de mantenimiento programados garantizan que las actualizaciones se apliquen de forma eficiente, lo que preserva la integridad del sistema y minimiza la interrupción en las instancias y ejecuciones de canalizaciones.

  • Cuando configuras los períodos de mantenimiento, debes asignar al menos 12 horas por semana para las operaciones de mantenimiento. Cada período debe durar entre 4 y 12 horas.

  • Durante las horas del período de mantenimiento, algunas operaciones pueden verse afectadas. Recomendamos realizar períodos de mantenimiento durante los períodos de menor uso. La operación de mantenimiento puede afectar a Cloud Data Fusion de las siguientes maneras:

    • Es posible que la interfaz de Cloud Data Fusion Studio no esté disponible temporalmente.
    • La ejecución de la canalización podría verse afectada, lo que podría causar fallas.
    • Es posible que los servicios de Cloud Data Fusion estén inactivos temporalmente, lo que provoca que las llamadas a la API fallen.
    • Es posible que las instancias no funcionen por completo hasta por una hora durante las horas del período de mantenimiento. Te recomendamos que configures períodos de mantenimiento cuando tus canalizaciones no estén en ejecución o no estén programadas para ejecutarse.

Especifica períodos de mantenimiento mientras creas una instancia

Console

Para configurar el período de mantenimiento cuando creas una instancia, sigue estos pasos:

  1. Ve a la página Instancias de Cloud Data Fusion y haz clic en Crear instancia.

    Crear una instancia

  2. Ingresa el Nombre de la instancia y la Edición. Para obtener más información sobre cada campo, consulta Crea una instancia.
  3. Expande la sección Opciones avanzadas.
  4. Expande la sección Mantenimiento y sigue estos pasos:
    1. Selecciona la casilla de verificación Habilitar período de mantenimiento.
    2. En el campo Hora de inicio, ingresa una hora en un formato compatible.
    3. En la lista TimeZone, selecciona una zona horaria.
    4. En las listas Días y Duración, selecciona los días de la semana y la duración del período. Para obtener más información sobre esta configuración, consulta Acerca de las operaciones de mantenimiento.
    5. Haz clic en Crear.

Para obtener más información, consulta Configura los plazos y la recurrencia del período de mantenimiento (RRULE).

API de REST

  1. Establece la configuración de Instance con la API de instance.create:
{
  "name": string,
  "description": string,
  …
  …
  "maintenancePolicy": {
    "maintenanceWindow": {
      "recurringTimeWindow": {
        "window": {
            "startTime": "START_TIME",
            "endTime": "END_TIME"
        },
        "recurrence": "MAINTENANCE_RECURRENCE"
      }
    },
  }
}

Reemplaza lo siguiente:

  • START_TIME: Es la hora de inicio del período, en el formato RFC 3339.
  • END_TIME: Es la hora de finalización del período, en el formato RFC 3339.

  • MAINTENANCE_RECURRENCE: Es un RRULE para la recurrencia del período de mantenimiento. Cloud Data Fusion solo admite los siguientes formatos:

    • FREQ=WEEKLY;BYDAY=SU,MO,TU,WE,TH,FR,SA o BYDAY=SU,MO,TU,WE,TH,FR,SA,MO;FREQ=WEEKLY. Esto especifica la recurrencia semanal del período en los días seleccionados, a partir del startTime y durante la duración especificada.

Para obtener más información, consulta Configura los plazos y la recurrencia del período de mantenimiento (RRULE).

En el siguiente ejemplo, se crea una instancia con un período de mantenimiento de seis horas entre las 10 a.m. y las 4 p.m. (UTC) los sábados y domingos de cada semana. Para obtener más información, consulta la documentación de la API de instancias.

// POST https://datafusion.googleapis.com/v1/projects/example-project/locations/us-central1/instances?instanceID=example-instance

{
  "maintenancePolicy": {
      "maintenanceWindow": {
          "recurringTimeWindow": {
              "window": {
                  "startTime": "2024-01-01T10:00:00Z",
                  "endTime": "2024-01-01T16:00:00Z",
              },
              "recurrence": "FREQ=WEEKLY;BYDAY=SA,SU"
          }
      },
  }
}

Actualiza los períodos de mantenimiento de una instancia

Console

Para actualizar el período de mantenimiento en una instancia existente en la consola de Google Cloud, sigue estos pasos:

  1. Ve a la página de Instancias de Cloud Data Fusion.

    Ir a Instancias

  2. Haz clic en el nombre de la instancia para ver sus detalles.
  3. En la página Detalles de la instancia, navega al campo Período de mantenimiento y haz clic en Editar.
  4. Los campos del período de mantenimiento se abren en el modo de edición. Actualiza los valores según sea necesario:
    1. Selecciona la casilla de verificación Habilitar período de mantenimiento.
    2. En el campo Hora de inicio, ingresa una hora en un formato compatible.
    3. En la lista TimeZone, selecciona una zona horaria.
    4. En las listas Días y Duración, selecciona los días de la semana y la duración del período. Para obtener más información sobre esta configuración, consulta Acerca de las operaciones de mantenimiento.
  5. Haz clic en Guardar.

Para obtener más información, consulta Configura los plazos y la recurrencia del período de mantenimiento (RRULE).

API de REST

Para las instancias existentes, actualiza los períodos de mantenimiento mediante la solicitud a la API instances.patch. Esto anula la configuración del período de mantenimiento existente, si está presente. De lo contrario, se establece una configuración nueva, como se menciona en el cuerpo de la solicitud.

Crea una solicitud a la API de la siguiente manera:

  1. En el parámetro updateMask, especifica la máscara maintenance_policy.
  2. En el cuerpo de la solicitud, especifica el período de mantenimiento en la configuración de la política de mantenimiento:
{
  "maintenancePolicy": {
    "maintenanceWindow": {
        "recurringTimeWindow": {
          "window": {
              "startTime": "START_TIME",
              "endTime": "END_TIME"
          },
          "recurrence": "MAINTENANCE_RECURRENCE"
        }
    },
  }
}

Para obtener más información, consulta Configura los plazos y la recurrencia del período de mantenimiento (RRULE).

En el siguiente ejemplo, se actualiza la configuración de la política de mantenimiento de la instancia con un período de mantenimiento de cuatro horas entre las 11 a.m. y las 3 p.m. (UTC) los viernes, sábado y domingo de cada semana.

// PATCH https://datafusion.googleapis.com/v1/projects/example-project/locations/us-central1/instances/example-instance?updateMask=maintenance_policy

{
"maintenancePolicy": {
  "maintenanceWindow": {
    "recurringTimeWindow": {
      "window": {
          "startTime": "2024-01-01T11:00:00Z",
          "endTime": "2024-01-01T15:00:00Z",
        },
      "recurrence": "FREQ=WEEKLY;BYDAY=FR,SA,SU"
    }
  },
}
}

Configurar los plazos y la recurrencia del período de mantenimiento (RRULE)

Cuando configuras las horas de inicio y finalización del período de mantenimiento, se ignoran los componentes de fecha de las marcas de tiempo proporcionadas. Solo se consideran el momento del día y la duración entre las horas de inicio y finalización. Los horarios se almacenan en UTC, pero puedes usar UTC o el desplazamiento de zona horaria cuando programas períodos de mantenimiento con la API.

Cuando configures la recurrencia, ten en cuenta que RRULE sigue los días UTC, por lo que debes realizar los ajustes según corresponda si tu zona horaria difiere. Por ejemplo, si tu zona horaria es PDT (UTC-7) y deseas que un período de mantenimiento comience a las 21:00 los miércoles en tu zona horaria (que corresponde a las 4:00 UTC de los jueves), especifica TH en lugar de WE en la opción BYDAY de la RRULE.

Borra el período de mantenimiento de una instancia

Console

Para borrar el período de mantenimiento de una instancia existente en la consola de Google Cloud, sigue estos pasos:

  1. Ve a la página de Instancias de Cloud Data Fusion.

    Ir a Instancias

  2. Haz clic en el nombre de la instancia para ver sus detalles.
  3. En la página Detalles de la instancia, navega al campo Período de mantenimiento y haz clic en Editar.
  4. Para quitar el período de mantenimiento de la instancia, desmarca la casilla de verificación Habilitar período de mantenimiento.
  5. Haz clic en Guardar.

API de REST

Para quitar el período de mantenimiento de una instancia, pasa un objeto de política de mantenimiento vacío en el cuerpo de la solicitud.

// PATCH https://datafusion.googleapis.com/v1/projects/example-project/locations/us-central1/instances/example-instance?updateMask=maintenance_policy

{
    "maintenancePolicy": {}
}

¿Qué sigue?