Gestionar revisiones de parches de instancias

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

Para obtener más información sobre las diferencias entre las revisiones de parches y otras actualizaciones, consulta Actualizaciones de instancias y revisiones de parches.

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

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

Antes de empezar

• Antes de actualizar a una revisión de parche, consulta las notas de la versión para obtener información sobre las correcciones específicas que incluye. Es importante que sepas cómo pueden afectar a tus instancias.
• Prepara tu entorno:
  • Programa el tiempo de inactividad de la revisión del parche.
  • Recomendación: Antes de actualizar, detenga las canalizaciones en ejecución e inhabilite los activadores upstream, como los de Cloud Composer. Cuando empiece la actualización, se detendrán todas las canalizaciones en ejecución.

Diferencias entre la actualización de una instancia y la revisión de un parche

Mejora de la instancia

Estas versiones incluyen las funciones más recientes, mejoras de funciones y mejoras de rendimiento de la plataforma. Las actualizaciones de instancias están asociadas a cambios en los complementos y requieren actualizaciones de la canalización. Para obtener más información, consulta Actualizaciones de versiones: instancias y flujos de trabajo.

Revisar parches

Estas versiones solo incluyen correcciones de errores y de seguridad críticas para la plataforma, y no cambian ni actualizan las funciones de la canalización y del complemento.

Actualizar a una revisión de parche de una instancia de Cloud Data Fusion

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

Consola

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

2. Haz clic en Instancias y selecciona la casilla situada junto al nombre de la instancia.

   Ir a Instancias

3. Haz clic en Actualizar.

4. Selecciona la revisión del parche 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. Consulta el campo Versión para ver si hay alguna actualización.

   Nota: El número de versión que aparece en la parte superior de la página Administración del sistema de la interfaz web de Cloud Data Fusion no muestra el número de revisión del parche.

gcloud

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

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

   Haz los cambios siguientes:

   • 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: revisión del parche para actualizar.

   • Opcional: si procede en tu instancia, añade las marcas --enable_stackdriver_logging, --enable_stackdriver_monitoring y --labels.

   • Opcional: puede transferir las propiedades de CDAP, como enable.unrecoverable.reset, como --options.

   Nota: El argumento patch_revision es opcional. Si no se especifica, se usa la revisión de parche más reciente disponible.

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

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

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

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

   2. Comprueba que el campo PATCH_REVISION de los detalles de la instancia se haya actualizado a la versión especificada.

API REST

Para aplicar una revisión a una instancia de Cloud Data Fusion, llama a su método patch(). Define el campo patchRevision opcional en la solicitud. Si no especificas una revisión de parche, se usará la última disponible.

Ejemplos

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

Actualizar una instancia a una versión de revisión de parche específica

Llama al método patch():

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

Haz los cambios siguientes:

• 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
}

Haz los cambios siguientes:

• VERSION_NUMBER: la versión de la instancia, como 6.7.3.
• PATCH_REVISION_NUMBER: la versión de revisión del parche a la que se va a 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 al parche 6.7.3.1, usa el siguiente cuerpo de solicitud JSON:

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

Actualizar una instancia a la versión de revisión de parche predeterminada

Llama al método patch():

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
}

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

{
  "version": 6.7.3
}

Restaurar una revisión de parche

Si tienes problemas imprevistos después de incorporar una revisión de un parche, vuelve a una versión anterior y estable siguiendo estos pasos.

gcloud

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

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

   Haz los cambios siguientes:

   • 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 del parche a la que se va a revertir.

   • Opcional: si procede en tu instancia, añade las marcas --enable_stackdriver_logging, --enable_stackdriver_monitoring y --labels.

   • Opcional: puede transferir 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 ha realizado correctamente, sigue estos pasos:

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

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

   2. Comprueba que el campo PATCH_REVISION de los detalles de la instancia se haya revertido a la versión especificada.

API REST

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

Ejemplo

En este ejemplo se muestra cómo revertir una instancia de la revisión del parche 6.7.3.1 a la revisión del parche 6.7.3 mediante la API REST.

Llama al método patch():

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

Haz los cambios siguientes:

• 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
}

Haz los cambios siguientes:

• VERSION_NUMBER: la versión de la instancia, como 6.7.3.
• STABLE_PATCH_REVISION: la revisión del parche a la que se va a volver. Consulta las revisiones de parches disponibles.

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

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

Siguientes pasos

• Gestionar las actualizaciones de versiones de las canalizaciones y las instancias.
• Consulta información sobre el control de versiones en Cloud Data Fusion.
• Consulta las versiones y revisiones de parches disponibles.
• Solucionar problemas con las actualizaciones