Gérer les révisions des correctifs pour les instances

Cette page fournit des informations et des consignes pour gérer les révisions de correctifs d'une instance Cloud Data Fusion.

Pour en savoir plus sur la différence entre les révisions de correctifs et les autres mises à niveau, consultez la section Mises à niveau d'instances et révisions de correctifs.

Les révisions de correctifs incluent des mises à jour de sécurité critiques et des corrections de bugs sur vos instances. Une révision de correctif n'applique des corrections que sur la plate-forme, sans modifier les pipelines ni les plug-ins. Le processus de mise à niveau implique des temps d'arrêt des instances et des pipelines.

Pour en savoir plus sur la gestion des versions de Cloud Data Fusion, consultez la section Gestion des versions dans Cloud Data Fusion et mises à niveau de révisions de correctifs disponibles.

Avant de commencer

  • Avant de passer à une révision de correctif, consultez les notes de version pour en savoir plus sur les corrections spécifiques qu'elle inclut. Il est important de comprendre comment elles peuvent affecter vos instances.
  • Préparez votre environnement :
    • Planifiez un temps d'arrêt pour la révision de correctif.
    • Recommandé : Avant la mise à niveau, arrêtez tous les pipelines en cours d'exécution et désactivez tous les déclencheurs en amont, tels que les déclencheurs Managed Service pour Apache Airflow. Une fois la mise à niveau commencée, tous les pipelines en cours d'exécution s'arrêtent.

Mise à niveau d'instance et révision de correctif

Mise à niveau d'instance
Ces versions incluent les dernières fonctionnalités, les améliorations de fonctionnalités et les améliorations des performances de la plate-forme. Les mises à niveau d'instances sont associées à des modifications de plug-ins et nécessitent des mises à niveau de pipelines. Pour en savoir plus, consultez la section Mises à niveau de versions : instances et pipelines.
Révisions de correctifs
Ces versions n'incluent que des corrections de sécurité et de bugs critiques pour la plate-forme, et ne modifient ni ne mettent à jour les fonctionnalités des pipelines et des plug-ins.

Passer à une révision de correctif pour une instance Cloud Data Fusion

Pour passer à une révision de correctif pour votre instance Cloud Data Fusion, suivez ces étapes dans la Google Cloud console, Google Cloud CLI ou l'API REST.

Console

  1. Dans la Google Cloud console, accédez à la page Cloud Data Fusion.

  2. Cliquez sur Instances , puis cochez la case à côté du nom de l'instance.

    Accéder à la page "Instances"

  3. Cliquez sur Mettre à jour.

  4. Sélectionnez la dernière révision de correctif, puis cliquez sur Mettre à jour.

  5. Pour accéder à l'instance mise à niveau dans l'interface Web Cloud Data Fusion, cliquez sur Afficher l'instance.

  6. Pour vérifier que la mise à niveau a réussi, dans la Google Cloud console, actualisez la page Détails de l'instance. Recherchez la mise à jour dans le champ Version.

gcloud

  1. Pour passer à une révision de correctif disponible, exécutez la commande gcloud CLI suivante à partir d'une session Cloud Shell de 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

    Remplacez les éléments suivants :

    • INSTANCE_ID : nom de l'instance.
    • PROJECT_ID: ID du projet contenant l'instance Cloud Data Fusion.
    • LOCATION_NAME : emplacement de l'instance.
    • CURRENT_INSTANCE_VERSION : version actuelle.

    • AVAILABLE_PATCH_REVISION: révision de correctif vers laquelle effectuer la mise à niveau.

    • Facultatif : si cela s'applique à votre instance, ajoutez les options --enable_stackdriver_logging, --enable_stackdriver_monitoring et --labels.

    • Facultatif : vous pouvez transmettre les propriétés CDAP, telles que enable.unrecoverable.reset, en tant que --options.

    Pour en savoir plus, consultez la documentation de référence de gcloud CLI.

  2. Vérifiez que la mise à niveau a réussi en procédant comme suit :

    1. Obtenez les détails de l'instance en exécutant la commande gcloud CLI suivante à partir d'une session Cloud Shell de terminal local :

      gcloud beta data-fusion instances describe \
  --project=PROJECT_ID \
  --location=LOCATION_NAME \
  INSTANCE_ID

    2. Vérifiez que le champ PATCH_REVISION dans les détails de l'instance est mis à jour vers la version spécifiée.

API REST

Pour effectuer une révision de correctif d'une instance Cloud Data Fusion, appelez sa patch() méthode. Définissez le champ facultatif patchRevision dans la requête. Si vous ne spécifiez pas de révision de correctif, la dernière disponible est utilisée.

Exemples

Les exemples suivants montrent comment mettre à niveau une instance vers une révision de correctif avec l'API REST.

Mettre à niveau une instance vers une version de révision de correctif spécifique

Appelez la méthode patch() :

PATCH https://datafusion.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_NAME/instances/INSTANCE_ID

Remplacez les éléments suivants :

  • PROJECT_ID: ID du projet contenant l'instance Cloud Data Fusion.
  • LOCATION_NAME : emplacement de l'instance.
  • INSTANCE_ID : nom de l'instance.

Utilisez le corps de requête JSON suivant :

{
  "version": VERSION_NUMBER,
  "patchRevision": PATCH_REVISION_NUMBER
}

Remplacez les éléments suivants :

  • VERSION_NUMBER: version de l'instance, par exemple 6.7.3.
  • PATCH_REVISION_NUMBER: version de révision de correctif vers laquelle effectuer la mise à niveau, par exemple 6.7.3.1. Consultez les révisions de correctifs disponibles.

Par exemple, pour mettre à niveau une instance de version 6.7.3 vers la révision de correctif 6.7.3.1, utilisez le corps de requête JSON suivant :

{
  "version": 6.7.3,
  "patchRevision": 6.7.3.1
}

Mettre à niveau une instance vers la version de révision de correctif par défaut

Appelez la méthode patch() :

PATCH https://datafusion.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_NAME/instances/INSTANCE_ID

Utilisez le corps de requête JSON suivant :

{
  "version": VERSION_NUMBER
}

Remplacez VERSION_NUMBER par la version de l'instance, par exemple 6.7.3 :

{
  "version": 6.7.3
}

Effectuer un rollback d'une révision de correctif

Si vous rencontrez des problèmes imprévus après avoir intégré une révision de correctif, rétablissez la révision de correctif à un état antérieur et stable en procédant comme suit.

gcloud

  1. Pour effectuer un rollback vers une révision de correctif précédente, exécutez la commande gcloud CLI suivante à partir d'une session Cloud Shell de 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

    Remplacez les éléments suivants :

    • INSTANCE_ID : nom de l'instance.
    • PROJECT_ID: ID du projet contenant l'instance Cloud Data Fusion.
    • LOCATION_NAME : emplacement de l'instance.
    • CURRENT_INSTANCE_VERSION : version actuelle.

    • STABLE_PATCH_REVISION: révision de correctif vers laquelle effectuer un rollback.

    • Facultatif : si cela s'applique à votre instance, ajoutez les options --enable_stackdriver_logging, --enable_stackdriver_monitoring et --labels.

    • Facultatif : vous pouvez transmettre les propriétés CDAP, telles que enable.unrecoverable.reset, en tant que --options.

    Pour en savoir plus, consultez la documentation de référence de gcloud CLI.

  2. Vérifiez que le rollback a réussi en procédant comme suit :

    1. Obtenez les détails de l'instance en exécutant la commande gcloud CLI suivante à partir d'une session Cloud Shell de terminal local :

      gcloud beta data-fusion instances describe \
  --project=PROJECT_ID \
  --location=LOCATION_NAME \
  INSTANCE_ID

    2. Vérifiez que le champ PATCH_REVISION dans les détails de l'instance est rétabli à la version spécifiée.

API REST

Pour effectuer un rollback d'une révision de correctif dans une instance Cloud Data Fusion, appelez sa patch() méthode. Définissez le champ patchRevision dans la requête sur une révision de correctif antérieure et stable.

Exemple

Cet exemple montre comment effectuer un rollback d'une instance de la révision de correctif 6.7.3.1 vers la révision de correctif 6.7.3 à l'aide de l'API REST.

Appelez la méthode patch() :

PATCH https://datafusion.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_NAME/instances/INSTANCE_ID

Remplacez les éléments suivants :

  • PROJECT_ID: ID du projet contenant l'instance Cloud Data Fusion.
  • LOCATION_NAME : emplacement de l'instance.
  • INSTANCE_ID : nom de l'instance.

Utilisez le corps de requête JSON suivant :

{
  "version": VERSION_NUMBER,
  "patchRevision": STABLE_PATCH_REVISION
}

Remplacez les éléments suivants :

  • VERSION_NUMBER: version de l'instance, par exemple 6.7.3.
  • STABLE_PATCH_REVISION: révision de correctif vers laquelle effectuer le rollback. Consultez les révisions de correctifs disponibles.

Par exemple, pour effectuer un rollback de l'instance de la révision de correctif 6.7.3.1 vers la révision de correctif 6.7.3, utilisez le corps de requête JSON suivant :

{
  "version": 6.7.3,
  "patchRevision": 6.7.3
}

Étape suivante