Administra las revisiones de parches de las instancias

En esta página, se proporciona información y lineamientos para administrar las revisiones de parches de una instancia de Cloud Data Fusion.

Para obtener más información sobre cómo difieren las revisiones de parches de otras actualizaciones, consulta Actualizaciones de instancias en comparación con revisiones de parches.

Las revisiones de parches incluyen actualizaciones de seguridad críticas y correcciones de errores en tus instancias. Una revisión de parches solo aplica correcciones en la plataforma sin cambiar las canalizaciones ni los complementos. El proceso de actualización implica el tiempo de inactividad de la instancia y la canalización.

Para obtener más información sobre el control de versiones de Cloud Data Fusion, consulta Control de versiones en Cloud Data Fusion y actualizaciones de revisión de parches disponibles.

Antes de comenzar

  • Antes de actualizar a una revisión de parches, revisa las notas de la versión para obtener información sobre las correcciones específicas que incluye. Es importante comprender cómo podrían afectar tus instancias.
  • Prepara tu entorno:
    • Programa el tiempo de inactividad para la revisión de parches.
    • Recomendación: Antes de actualizar, detén todas las canalizaciones en ejecución e inhabilita los activadores ascendentes, como los activadores de Managed Service para Apache Airflow. Cuando comienza la actualización, se detienen todas las canalizaciones en ejecución.

Actualización de instancias en comparación con revisión de parches

Actualización de instancias
Estas versiones incluyen las funciones más recientes, mejoras de funciones y mejoras de rendimiento para la plataforma. Las actualizaciones de instancias están asociadas con cambios en los complementos y requieren actualizaciones de canalizaciones. Para obtener más información, consulta Actualizaciones de versiones: Instancias y canalizaciones.
Revisiones de parches
Estas versiones solo incluyen correcciones de seguridad críticas y de errores para la plataforma, y no cambian ni actualizan las funciones de canalización y complementos.

Actualiza a una revisión de parches para una instancia de Cloud Data Fusion

Para actualizar a una revisión de parches para tu instancia de Cloud Data Fusion, sigue estos pasos en la Google Cloud consola, Google Cloud CLI o la API de REST.

Console

  1. En la Google Cloud consola, ve a la página de Cloud Data Fusion.

  2. Haz clic en Instancias y selecciona la casilla de verificación junto al nombre de la instancia.

    Ir a Instancias

  3. Haz clic en Actualizar.

  4. Selecciona la revisión de parches más reciente y haz clic en Actualizar.

  5. Para acceder a la instancia actualizada en la interfaz web de Cloud Data Fusion, haz clic en Ver instancia.

  6. Para verificar que la actualización se haya realizado correctamente, en la Google Cloud consola, vuelve a cargar la página Detalles de la instancia. Verifica el campo Versión para la actualización.

gcloud

  1. Para actualizar a una revisión de parches disponible, ejecuta el siguiente comando de gcloud CLI desde una terminal local Cloud Shell sesión:

    gcloud beta data-fusion instances update INSTANCE_ID \
  --project=PROJECT_ID \
  --location=LOCATION_NAME \
  --version=CURRENT_INSTANCE_VERSION \
  --patch_revision=AVAILABLE_PATCH_REVISION

    Reemplaza lo siguiente:

    • INSTANCE_ID: El nombre de la instancia.
    • PROJECT_ID: El ID del proyecto que contiene la instancia de Cloud Data Fusion.
    • LOCATION_NAME: La ubicación de la instancia.
    • CURRENT_INSTANCE_VERSION: La versión actual.

    • AVAILABLE_PATCH_REVISION: La revisión de parches a la que se actualizará.

    • Opcional: Si corresponde a tu instancia, agrega los marcadores --enable_stackdriver_logging, --enable_stackdriver_monitoring y --labels.

    • Opcional: Puedes pasar las propiedades de CDAP, como enable.unrecoverable.reset, como --options.

    Para obtener más información, consulta la referencia de la CLI de gcloud.

  2. Para verificar que la actualización se haya realizado correctamente, sigue estos pasos:

    1. Para obtener los detalles de la instancia, ejecuta el siguiente comando de la gcloud CLI desde una sesión de Cloud Shell de terminal local:

      gcloud beta data-fusion instances describe \
  --project=PROJECT_ID \
  --location=LOCATION_NAME \
  INSTANCE_ID

    2. Verifica que el campo PATCH_REVISION en los detalles de la instancia se actualice a la versión especificada.

API de REST

Para realizar la revisión de parches de la instancia de Cloud Data Fusion, llama a su patch() método. Configura el campo opcional patchRevision en la solicitud. Si no especificas una revisión de parches, se usa la más reciente disponible.

Ejemplos

En los siguientes ejemplos, se muestra cómo actualizar una instancia a una revisión de parches con la API de REST.

Actualiza una instancia a una versión específica de revisión de parches

Llama al método patch() de la siguiente forma:

PATCH https://datafusion.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_NAME/instances/INSTANCE_ID

Reemplaza lo siguiente:

  • PROJECT_ID: El ID del proyecto que contiene la instancia de Cloud Data Fusion.
  • LOCATION_NAME: La ubicación de la instancia.
  • INSTANCE_ID: El nombre de la instancia.

Usa el siguiente cuerpo de solicitud JSON:

{
  "version": VERSION_NUMBER,
  "patchRevision": PATCH_REVISION_NUMBER
}

Reemplaza lo siguiente:

  • VERSION_NUMBER: La versión de la instancia, como 6.7.3.
  • PATCH_REVISION_NUMBER: La versión de revisión de parches a la que se actualizará, como 6.7.3.1. Consulta las revisiones de parches disponibles.

Por ejemplo, para actualizar una instancia de la versión 6.7.3 a la revisión de parches 6.7.3.1, usa el siguiente cuerpo de solicitud JSON:

{
  "version": 6.7.3,
  "patchRevision": 6.7.3.1
}

Actualiza una instancia a la versión predeterminada de revisión de parches

Llama al método patch() de la siguiente forma:

PATCH https://datafusion.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_NAME/instances/INSTANCE_ID

Usa el siguiente cuerpo de solicitud JSON:

{
  "version": VERSION_NUMBER
}

Reemplaza VERSION_NUMBER por la versión de la instancia, como 6.7.3:

{
  "version": 6.7.3
}

Revierte una revisión de parches

Si experimentas problemas imprevistos después de incorporar una revisión de parches, revierte la revisión de parches a un estado anterior y estable siguiendo estos pasos.

gcloud

  1. Para revertir a una revisión de parches anterior, ejecuta el siguiente comando de la gcloud CLI desde una terminal local Cloud Shell sesión:

    gcloud beta data-fusion instances update INSTANCE_ID \
  --project=PROJECT_ID \
  --location=LOCATION_NAME \
  --version=CURRENT_INSTANCE_VERSION \
  --patch_revision=STABLE_PATCH_REVISION

    Reemplaza lo siguiente:

    • INSTANCE_ID: El nombre de la instancia.
    • PROJECT_ID: El ID del proyecto que contiene la instancia de Cloud Data Fusion.
    • LOCATION_NAME: La ubicación de la instancia.
    • CURRENT_INSTANCE_VERSION: La versión actual.

    • STABLE_PATCH_REVISION: La revisión de parches a la que se revertirá.

    • Opcional: Si corresponde a tu instancia, agrega los marcadores --enable_stackdriver_logging, --enable_stackdriver_monitoring y --labels.

    • Opcional: Puedes pasar las propiedades de CDAP, como enable.unrecoverable.reset, como --options.

    Para obtener más información, consulta la referencia de la CLI de gcloud.

  2. Para verificar que la reversión se haya realizado correctamente, sigue estos pasos:

    1. Para obtener los detalles de la instancia, ejecuta el siguiente comando de la gcloud CLI desde una sesión de Cloud Shell de terminal local:

      gcloud beta data-fusion instances describe \
  --project=PROJECT_ID \
  --location=LOCATION_NAME \
  INSTANCE_ID

    2. Verifica que el campo PATCH_REVISION en los detalles de la instancia se revierta a la versión especificada.

API de REST

Para revertir una revisión de parches en una instancia de Cloud Data Fusion, llama a su patch() método. Configura el campo patchRevision en la solicitud a cualquier revisión de parches anterior y estable.

Ejemplo

En este ejemplo, se muestra cómo revertir una instancia de la revisión de parches 6.7.3.1 a la revisión de parches 6.7.3 con la API de REST.

Llama al método patch() de la siguiente forma:

PATCH https://datafusion.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_NAME/instances/INSTANCE_ID

Reemplaza lo siguiente:

  • PROJECT_ID: El ID del proyecto que contiene la instancia de Cloud Data Fusion.
  • LOCATION_NAME: La ubicación de la instancia.
  • INSTANCE_ID: El nombre de la instancia.

Usa el siguiente cuerpo de solicitud JSON:

{
  "version": VERSION_NUMBER,
  "patchRevision": STABLE_PATCH_REVISION
}

Reemplaza lo siguiente:

  • VERSION_NUMBER: La versión de la instancia, como 6.7.3.
  • STABLE_PATCH_REVISION: La revisión de parches a la que se revertirá. Consulta las revisiones de parches disponibles.

Por ejemplo, para revertir la instancia de la revisión de parches 6.7.3.1 a la revisión de parches 6.7.3, usa el siguiente cuerpo de solicitud JSON:

{
  "version": 6.7.3,
  "patchRevision": 6.7.3
}

¿Qué sigue?