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

Administra las actualizaciones de versión de instancias y canalizaciones

En esta página, se describe cómo actualizar la versión de tus instancias o canalización por lotes.

Actualiza tus instancias y canalizaciones por lotes de Cloud Data Fusion a las versiones más recientes de la plataforma y los complementos para obtener las funciones, correcciones de errores y mejoras de rendimiento más recientes.

Antes de comenzar

Planifica un tiempo de inactividad programado para la actualización. Este proceso puede tardar hasta una hora.
In the Google Cloud console, activate Cloud Shell.

Activate Cloud Shell

Limitaciones

Después de crear una instancia de Cloud Data Fusion, no puedes cambiar su edición, ni siquiera mediante una operación de actualización.
No se admite la actualización de canalizaciones en tiempo real, excepto en las canalizaciones creadas en la versión 6.8.0 con una fuente de Kafka en tiempo real. Para obtener una solución alternativa, consulta Actualiza canalizaciones en tiempo real.
Cloud Data Fusion no reinicia las canalizaciones que se detienen como resultado de la operación de actualización.

Actualiza las instancias de Cloud Data Fusion

Actualizar una instancia de Cloud Data Fusion a una nueva versión, ve a la página Detalles de la instancia:

En Google Cloud Console, ve a la página de Cloud Data Fusion.
Haz clic en Instancias y, luego, en el nombre de la instancia para ir a la página Detalles de la instancia.

Ir a Instancias

Luego, realiza la actualización con la consola de Google Cloud Gcloud CLI:

Console

Haz clic en Actualizar para obtener una lista de las versiones disponibles.
Selecciona una versión.
Haz clic en Actualizar.
Verifica que la actualización se haya realizado correctamente:
1. Actualiza la página Detalles de la instancia.
2. Haz clic en Ver instancia para acceder a la instancia actualizada en la interfaz web de Cloud Data Fusion.
3. Haz clic en Administrador del sistema en la barra de menú.
  
  El número de la versión nueva aparecerá en la parte superior de la página.
Para evitar que tus canalizaciones se detengan cuando las ejecutas en el versión nueva, otorga los roles necesarios en tu versión actualizada instancia.

gcloud

Para actualizar a una nueva versión de Cloud Data Fusion, 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=AVAILABLE_INSTANCE_VERSION
```
- 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
Sigue estos pasos para verificar que la actualización se haya realizado correctamente:
1. En la consola de Google Cloud, ve a Cloud Data Fusion Instancias.
2. Haz clic en Ver instancia para acceder a la instancia actualizada en la interfaz web de Cloud Data Fusion.
3. Haz clic en System Admin en la barra de menú.
  
  El número de la versión nueva aparecerá en la parte superior de la página.
Para evitar que tus canalizaciones se bloqueen cuando las ejecutes en la versión nueva, otorga los roles necesarios en tu instancia actualizada.

Actualiza las canalizaciones por lotes

A fin de actualizar tus canalizaciones por lotes de Cloud Data Fusion para usar las versiones más recientes del complemento, sigue estos pasos:

Configura las variables de entorno.
Recomendación: Crea una copia de seguridad de todas las canalizaciones. Puedes crear copias de seguridad de las canalizaciones dos maneras:
- Sigue estos pasos para descargar el archivo ZIP:
  1. Para activar una descarga de archivo ZIP, crea una copia de seguridad de todas las canalizaciones con el siguiente comando:
```
echo $CDAP_ENDPOINT/v3/export/apps
```
  1. Copia el resultado de la URL en tu navegador.
  2. Extrae el archivo descargado y, luego, confirma que todas las canalizaciones y exportarse. Las canalizaciones se organizan por espacio de nombres.
- Crea copias de seguridad de las canalizaciones con la Administración de control de código fuente (SCM), disponible en la versión 6.9 y posteriores. SCM proporciona integración con GitHub, que puedes usar para crear copias de seguridad de las canalizaciones.
Sigue estos pasos para actualizar las canalizaciones:
1. Crea una variable que apunte al archivo pipeline_upgrade.json que que crearás en el siguiente paso para guardar una lista de canalizaciones.
```
export PIPELINE_LIST=PATH/pipeline_upgrade.json
```
  Reemplaza PATH por la ruta de acceso al archivo.
2. Crea una lista de todas las canalizaciones para una instancia y un espacio de nombres con el siguiente comando. El resultado se almacena en el archivo $PIPELINE_LIST en formato JSON. Puedes editar la lista para quitar las canalizaciones que no necesitan actualizaciones.
```
curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json" ${CDAP_ENDPOINT}/v3/namespaces/NAMESPACE_ID/apps -o $PIPELINE_LIST
```
  Reemplaza NAMESPACE_ID por el espacio de nombres en el que deseas que esté para hacer la actualización.
3. Actualiza las canalizaciones enumeradas en pipeline_upgrade.json. Inserta el NAMESPACE_ID de las canalizaciones que se actualizarán. El comando muestra una lista de canalizaciones actualizadas con su estado de actualización.
```
curl -N -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json" ${CDAP_ENDPOINT}/v3/namespaces/NAMESPACE_ID/upgrade --data @$PIPELINE_LIST
```
  Reemplaza NAMESPACE_ID por el ID del espacio de nombres de las canalización que se actualizarán.
Para evitar que tus canalizaciones se detengan cuando las ejecutas en el nuevo otorga los roles necesarios en tu instancia actualizada.

Actualiza las canalizaciones en tiempo real

No se admite la actualización de canalizaciones en tiempo real, excepto en las canalizaciones creadas en la versión 6.8.0 con una fuente en tiempo real de Kafka.

Para todo lo demás, haz lo siguiente:

Detén y exporta las canalizaciones.
Actualiza la instancia.
Importa las canalizaciones en tiempo real a tu instancia actualizada.

Actualiza para habilitar la replicación

La replicación se puede habilitar en entornos de Cloud Data Fusion 6.3.0 y versiones posteriores. Si tienes la versión 6.2.3, actualiza a 6.3.0 y, luego, a la versión más reciente. Luego, puedes habilitar la replicación.

Otorga roles para instancias actualizadas

Después de que se complete la actualización, otorga el rol de ejecutor de Cloud Data Fusion (roles/datafusion.runner) y el rol de administrador de Cloud Storage (roles/storage.admin) a la cuenta de servicio de Dataproc en tu proyecto.

¿Qué sigue?

Administra las revisiones de parches para instancias de Cloud Data Fusion.
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.