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

Administra revisiones de parches para instancias

Esta página brinda 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 y correcciones de errores importantes en tu individuales. Una revisión de parche solo aplica correcciones en la plataforma sin cambiar de 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 parches, revisa las notas de la versión para información sobre las correcciones específicas que incluye. Es importante comprender cómo podrían afectar a tus instancias.
Prepara el 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 más recientes, las mejoras de funciones y para mejorar el rendimiento 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 versión: instancias y canalizaciones.
Revisiones de parches: Estas versiones solo incluyen correcciones de errores y de seguridad importantes para la plataforma. y no cambie ni actualice la canalización ni las funciones del complemento.

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 Web de Cloud Data Fusion, virtual, 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. Verifica la actualización en el campo Versió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 del parche.

gcloud

Para actualizar a una revisión de parche disponible, ejecuta el siguiente comando: Comando de gcloud CLI desde una terminal local Sesión 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: 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 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:
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. Para obtener los detalles de la instancia, ejecuta el siguiente comando: Comando de gcloud CLI desde una terminal local Sesión de Cloud Shell:
```
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 se actualicen 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 si 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 de revisión de parche 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: 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 del por ejemplo, 6.7.3:

{
  "version": 6.7.3
}

Revierte 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: Comando de gcloud CLI desde una terminal local Sesión 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
```
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 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. Para obtener los detalles de la instancia, ejecuta el siguiente comando: Comando de gcloud CLI desde una terminal local Sesión de Cloud Shell:
```
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 haya revertido 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 en cualquier revisión de parche anterior y estable.

Ejemplo

En este ejemplo, se muestra cómo revertir una instancia del parche 6.7.3.1. a la revisión de 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á. a los que 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?

Administra las actualizaciones de versiones para las canalizaciones y las instancias.
Obtén más 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.