Se usó la API de Cloud Translation para traducir esta página.

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 la diferencia entre las revisiones de parches y otras actualizaciones, consulta Actualizaciones de instancias frente a revisiones de parches.

Las revisiones de parches incluyen actualizaciones de seguridad fundamentales y correcciones de errores en tus instancias. Una revisión de parche solo aplica correcciones en la plataforma sin cambiar las canalizaciones o 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 las 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 podrían afectar tus instancias.
Prepara tu entorno:
- Programar tiempo de inactividad para la revisión de parches
- Recomendación: Antes de la actualización, detén todas 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 en comparación con la revisión de parches

Actualización de instancias: Estas versiones incluyen las funciones, las mejoras de funciones y las mejoras de rendimiento más recientes de la plataforma. Las actualizaciones de instancias están asociadas con cambios en los complementos y requieren actualizaciones de las canalizaciones. Para obtener más información, consulta Actualizaciones de versiones: Instancias y canalizaciones.
Revisiones de 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 los 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 consola de Google Cloud, Google Cloud CLI o la API de REST.

Console

En la consola de Google Cloud, ve a la página de Cloud Data Fusion.
Haz clic en Instancias y selecciona la casilla de verificación junto al nombre de la instancia.

Ir a Instancias
Haz clic en Actualizar.
Selecciona la revisión de parche más reciente y haz clic en Actualizar.
Para acceder a la instancia actualizada en la interfaz web de Cloud Data Fusion, haz clic en Ver instancia.
Para verificar que la actualización se realizó correctamente, en la consola de Google Cloud, vuelve a cargar la página Detalles de la instancia. Revisa el campo Versión para ver la actualización.

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

gcloud

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 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
```
Reemplaza lo siguiente:
- INSTANCE_ID: El nombre de la instancia.
- PROJECT_ID: El ID del proyecto que 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 los que quieres realizar la actualización.
- Opcional: Si corresponde a 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 revisión de parche más reciente disponible.

Para obtener más información, consulta la referencia de gcloud CLI.
Sigue estos pasos para verificar que la actualización se haya realizado correctamente:
1. Ejecuta el siguiente comando de la CLI de gcloud desde una sesión de Cloud Shell de la terminal local para obtener los detalles de la instancia:
```
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 realizar una revisión de parches de la instancia de Cloud Data Fusion, llama a patch() . Establece el campo opcional patchRevision en la solicitud. Si no especificas una revisión de parche, se usará 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 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: 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 como 6.7.3.
PATCH_REVISION_NUMBER: Es la versión de la revisión del parche. a los que deseas actualizar; por ejemplo, 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. revisión, 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
}

Cómo revertir una revisión de parche

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

gcloud

Para revertir a una revisión de parche anterior, ejecuta el siguiente comando de la CLI de gcloud 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: El ID del proyecto que 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 revertir.
- Opcional: Si corresponde a tu instancia, agrega el --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 gcloud CLI.
Sigue estos pasos para verificar que la reversión se haya realizado correctamente:
1. Ejecuta el siguiente comando de la CLI de gcloud desde una sesión de Cloud Shell de la terminal local para obtener los detalles de la instancia:
```
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 sea 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 patch() . Establece el campo patchRevision en la solicitud a cualquier valor anterior y estable. revisión de parches.

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 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: 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 como 6.7.3.
STABLE_PATCH_REVISION: Es la revisión del parche que se lanzará. puedes volver. Consulta las revisiones de parches disponibles.

Por ejemplo, para revertir la instancia de la revisión de 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?

Cómo administrar las actualizaciones de versiones para las canalizaciones y las instancias.
Obtén información sobre el control de versiones en Cloud Data Fusion.
Consulta las actualizaciones de versiones y revisiones de parches disponibles.
Soluciona problemas de actualizaciones.