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

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

Pour en savoir plus sur les différences entre les révisions de correctif 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 que les correctifs sur la plate-forme, sans les modifier les pipelines ou les plug-ins. Le processus de mise à niveau implique l'instance et le pipeline les temps de pause.

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

Avant de commencer

  • Avant de procéder à la mise à niveau vers une révision de correctif, consultez les notes de version pour des informations sur les correctifs spécifiques qu’il inclut. Il est important de et comprendre leur impact sur vos instances.
  • Préparez votre environnement:
    • Planifiez un temps d'arrêt pour la révision du 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 Cloud Composer. Une fois la mise à niveau commencée, tous les pipelines en cours d'exécution s'arrêtent.

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

Mise à niveau de l'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 avec des modifications de plug-ins et nécessitent des mises à niveau du pipeline. Pour en savoir plus, consultez Mises à niveau de versions: instances et pipelines
Révisions de correctifs
Ces versions n'incluent que des corrections de bugs et de sécurité critiques pour la plate-forme. Elles ne modifient ni ne mettent à jour les fonctionnalités du pipeline et des plug-ins.

Mettre à niveau vers une révision de correctif pour une instance Cloud Data Fusion

Pour mettre à niveau votre instance Cloud Data Fusion vers une révision de correctif, procédez comme suit : ces étapes dans la console Google Cloud, Google Cloud CLI ou l'API REST.

Console

  1. Dans la console Google Cloud, 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 du correctif, puis cliquez sur Mettre à niveau.

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

  6. Pour vérifier que la mise à niveau a réussi, accédez à la console Google Cloud : Actualisez la page Détails de l'instance. Vérifiez la mise à jour dans le champ Version.

gcloud

  1. Pour effectuer la mise à jour vers une révision de correctif disponible, exécutez la commande suivante : Commande gcloud CLI depuis un terminal local Session 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

    Remplacez les éléments suivants :

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

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

    • Facultatif : si applicable à 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. Pour vérifier que la mise à niveau a bien été effectuée, procédez comme suit:

    1. Pour obtenir les détails de l'instance, exécutez la commande suivante : Commande gcloud CLI depuis un terminal local Session Cloud Shell:

      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 la révision du correctif de l'instance Cloud Data Fusion, appelez sa méthode patch() . 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.

Examples

Les exemples suivants montrent comment mettre à niveau une instance vers une version 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 en tant que 6.7.3.
  • PATCH_REVISION_NUMBER: version de révision du correctif vers laquelle effectuer la mise à niveau, par exemple 6.7.3.1. Consultez les révisions de correctif disponibles.

Par exemple, pour mettre à niveau une instance de version 6.7.3 vers la version 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 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 à un état antérieur 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 suivante : Commande gcloud CLI depuis un terminal local Session 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

    Remplacez les éléments suivants :

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

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

    • Facultatif: le cas échéant, ajoutez le paramètre --enable_stackdriver_logging, --enable_stackdriver_monitoring --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. Pour vérifier que le rollback a bien été effectué, procédez 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 le rollback d'une révision de correctif dans une instance Cloud Data Fusion, appelez sa méthode patch() . Définissez le champ patchRevision de la requête sur une valeur antérieure et stable. ou la révision de correctif.

Exemple

Cet exemple montre comment effectuer un rollback d'une instance à partir du correctif 6.7.3.1 vers la révision du 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 en tant que 6.7.3.
  • STABLE_PATCH_REVISION: révision de correctif à déployer à laquelle vous souhaitez revenir. Consultez les révisions de correctif disponibles.

Par exemple, pour effectuer un rollback de l'instance depuis 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