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

Cette page fournit des informations et des consignes sur la gestion des révisions de correctif pour 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 correctif.

Les révisions de correctif 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 modifier les pipelines ou 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 page 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 obtenir des informations sur les correctifs spécifiques qu'elles incluent. 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 de mettre à niveau, arrêtez les pipelines en cours d'exécution et désactivez tous les déclencheurs en amont, tels que les déclencheurs Cloud Composer. Lorsque la mise à niveau commence, 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, améliorations de fonctionnalités et améliorations des performances de la plate-forme. Les mises à niveau d'instances sont associées aux modifications de plug-ins et nécessitent des mises à niveau du pipeline. Pour en savoir plus, consultez la page Mises à niveau de version: instances et pipelines.
Révisions de correctif
Ces versions n'incluent que les correctifs de sécurité et de bugs critiques de la plate-forme. Elles ne modifient ni ne mettent à jour les fonctionnalités de pipeline et de plug-in.

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, suivez 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 concernée.

    Accéder à la page "Instances"

  3. Cliquez sur Mettre à jour.

  4. Sélectionnez la dernière révision de 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, actualisez la page Détails de l'instance dans la console Google Cloud. Recherchez 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 gcloud CLI suivante à partir d'une session de terminal local 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: le cas échéant, ajoutez les indicateurs --enable_stackdriver_logging, --enable_stackdriver_monitoring et --labels.

    • Facultatif: vous pouvez transmettre les propriétés CDAP, telles que enable.unrecoverable.reset, à l'aide de l'option --options.

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

  2. Vérifiez que la migration a bien été effectuée en procédant comme suit:

    1. Pour obtenir les détails de l'instance, exécutez 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 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 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 la révision de correctif à mettre à niveau, telle que 6.7.3.1. Consultez les révisions de correctif disponibles.

Par exemple, pour mettre à niveau une instance de la 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 le rollback d'une révision de correctif

Si vous rencontrez des problèmes imprévus après l'intégration d'une révision de correctif, rétablissez son état antérieur et stable en suivant les étapes ci-dessous.

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 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 à laquelle effectuer le rollback.

    • Facultatif: le cas échéant, ajoutez les indicateurs --enable_stackdriver_logging, --enable_stackdriver_monitoring et --labels.

    • Facultatif: vous pouvez transmettre les propriétés CDAP, telles que enable.unrecoverable.reset, à l'aide de l'option --options.

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

  2. Vérifiez que le rollback a bien été effectué en procédant comme suit:

    1. Pour obtenir les détails de l'instance, exécutez 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 a été 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 n'importe quelle révision de correctif stable antérieure.

Exemple

Cet exemple montre comment effectuer le rollback d'une instance de la révision de correctif 6.7.3.1 vers la révision 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 :

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
}

Étapes suivantes