Administra revisiones de parches para instancias

En esta página, se proporciona información y lineamientos a fin de administrar las revisiones de parches para 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 frente a 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 parche, revisa las notas de la versión para obtener información sobre las correcciones específicas que incluye. Es importante comprender cómo pueden afectar a las instancias.
• Prepara tu entorno:
  • Programar tiempo de inactividad para la revisión de parches.
  • Recomendación: Antes de actualizar, detén las canalizaciones en ejecución y, luego, inhabilita los activadores ascendentes, como los activadores de Cloud Composer. Cuando comienza la actualización, se detienen todas las canalizaciones en ejecución.

Actualización de instancias frente a revisión de parches

Actualización de instancias

Estas versiones incluyen las funciones más recientes, así como las mejoras de funciones y de rendimiento de la plataforma. Las actualizaciones de instancias están asociadas con cambios de complementos y requieren actualizaciones de la canalización. Para obtener más información, consulta Actualizaciones de versión: instancias y canalizaciones.

Revisiones de parches

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

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

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

Console

1. En la consola de Google Cloud, 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 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 realizó de forma correcta, vuelve a cargar la página Detalles de la instancia en la consola de Google Cloud. Verifica el campo Versión para la actualización.

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

gcloud

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

   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: Es el ID del proyecto que contiene la instancia de Cloud Data Fusion.
   • LOCATION_NAME: Es la ubicación de la instancia.
   • CURRENT_INSTANCE_VERSION: Es la versión actual.

   • AVAILABLE_PATCH_REVISION: Es la revisión del parche a la que se actualizará.

   • Opcional: Si corresponde para tu instancia, agrega las marcas --enable_stackdriver_logging, --enable_stackdriver_monitoring, y --labels.

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

   Nota: Pasar el argumento patch_revision es opcional. Si no se especifica, se usa la última revisión de parche disponible.

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

2. Sigue estos pasos para verificar si la actualización se realizó correctamente:

   1. Para obtener los detalles de la instancia, ejecuta el siguiente comando de gcloud CLI desde una sesión de Cloud Shell de la 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 esté actualizado a la versión especificada.

API de REST

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

Ejemplos

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

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

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: Es el ID del proyecto que contiene la instancia de Cloud Data Fusion.
• LOCATION_NAME: Es 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: Es la versión de la instancia, como 6.7.3.
• PATCH_REVISION_NUMBER: Es la versión de revisión del parche 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 de revisión de parches predeterminada

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
}

Cómo revertir una revisión de parche

Si experimentas problemas imprevistos después de incorporar una revisión de parche, sigue estos pasos para revertir la revisión del parche a un estado anterior estable.

gcloud

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

   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: Es el ID del proyecto que contiene la instancia de Cloud Data Fusion.
   • LOCATION_NAME: Es la ubicación de la instancia.
   • CURRENT_INSTANCE_VERSION: Es la versión actual.

   • STABLE_PATCH_REVISION: Es la revisión del parche a la que se revertirá.

   • Opcional: Si corresponde para tu instancia, agrega las marcas --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. Sigue estos pasos para verificar si la reversión se realizó con éxito:

   1. Para obtener los detalles de la instancia, ejecuta el siguiente comando de gcloud CLI desde una sesión de Cloud Shell de la 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 parche en una instancia de Cloud Data Fusion, llama a su método patch(). Establece el campo patchRevision de la solicitud en una revisión de parche anterior y estable.

Ejemplo

En este ejemplo, se muestra cómo revertir una instancia de la revisión de parches de 6.7.3.1 a la revisión de parche 6.7.3 mediante 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: Es el ID del proyecto que contiene la instancia de Cloud Data Fusion.
• LOCATION_NAME: Es 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: Es la versión de la instancia, como 6.7.3.
• STABLE_PATCH_REVISION: Es la revisión del parche a la que se revertirá. 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
}

¿Qué sigue?

• Administra las actualizaciones de versión de las instancias y canalizaciones.
• Obtén más información sobre el control de versiones en Cloud Data Fusion.
• Consulta las actualizaciones disponibles de la versión y la revisión de parches.
• Soluciona problemas relacionados con las actualizaciones.