Gérer les révisions des 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 par rapport aux révisions de correctif.

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 des correctifs 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 Gestion des versions dans Cloud Data Fusion et les mises à niveau de révision de correctif disponibles.

Avant de commencer

  • Avant de passer à une version de correctif, consultez les notes de version pour en savoir plus sur les correctifs spécifiques qu'elle inclut. Il est important de comprendre comment ils peuvent affecter 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 par rapport à la révision de correctif

Mise à niveau d'une 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'instance sont associées à des modifications de plug-in et nécessitent des mises à niveau de pipeline. Pour en savoir plus, consultez la section Mettre à niveau les 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 une instance Cloud Data Fusion vers une révision de correctif

Pour passer à une version de correctif pour votre instance Cloud Data Fusion, suivez ces étapes dans la console Google Cloud, la 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 version 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 bien été effectuée, actualisez la page Détails de l'instance dans la console Google Cloud. Vérifiez la mise à jour dans le champ Version.

gcloud

  1. Pour passer à une version 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 du correctif à mettre à 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. 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 avec la version spécifiée.

API REST

Pour effectuer une révision de 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 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, telle 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 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 à un état stable antérieur en procédant comme suit.

gcloud

  1. Pour revenir à une version de correctif précédente, exécutez la commande CLI gcloud 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 du correctif à laquelle revenir.

    • 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. Vérifiez que le rollback a bien fonctionné 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 des détails de l'instance est rétabli à la version spécifiée.

API REST

Pour annuler 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 version de correctif antérieure et stable.

Exemple

Cet exemple montre comment rétablir une instance de la version de correctif 6.7.3.1 à la version 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 :

Par exemple, pour annuler la révision de correctif 6.7.3.1 de l'instance 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