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 las diferencias entre las revisiones de parches y otras actualizaciones, consulta Actualizaciones de instancias en comparación con revisiones de parches.

Las revisiones de parches incluyen actualizaciones de seguridad fundamentales y correcciones de errores en tus instancias. Una revisión de parches solo aplica correcciones en la plataforma sin cambiar las canalización 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 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 el entorno:
- Programa el 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 canalización. 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. 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 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: 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 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 la CLI de gcloud.
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 la revisión de parches de la instancia de Cloud Data Fusion, llama a su método patch(). Configura 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: 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: 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 del parche 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
}

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 revertirla a un estado anterior y estable:

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: 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 debe volver.
- 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.
Para obtener más información, consulta la referencia de la CLI de gcloud.
Sigue estos pasos para verificar que la reversión se realizó 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 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 método 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 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: 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: La versión de la instancia, como 6.7.3.
STABLE_PATCH_REVISION: Es la revisión del parche a la que se debe 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 de 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 información sobre el control de versiones en Cloud Data Fusion.
Consulta las actualizaciones de versión y revisión de parches disponibles.
Soluciona problemas de actualizaciones.