Mettre à niveau la version de Python

Compatible avec :

Ce document explique comment mettre à niveau les intégrations certifiées et personnalisées, les agents distants et les connecteurs du Content Hub vers la dernière version de Python. Les anciennes versions de Python étant obsolètes, les intégrations utilisant des versions non compatibles doivent être mises à jour pour continuer à fonctionner. Après avoir mis à jour l'intégration vers la dernière version de Python, vous devez également mettre à niveau chaque connecteur.

Si votre code d'intégration certifié ou personnalisé utilise une version de Python obsolète, vous devez le mettre à jour manuellement. Utilisez le mode Préproduction de l'IDE pour mettre à jour le code d'intégration sans impacter les environnements de production.

Avant de commencer

Assurez-vous que votre groupe d'autorisations inclut l'accès à Tous les environnements. Pour en savoir plus, consultez Utiliser des groupes d'autorisations.

Mettre à niveau les intégrations

  1. Accédez à Automation > IDE. Si des intégrations utilisent des versions obsolètes de Python, une bannière s'affiche sur les pages IDE, Content Hub et Playbooks.
  2. Cliquez sur Afficher l'intégration pour afficher la liste des intégrations.
  3. Cliquez sur Fermer pour fermer la bannière.
  4. Dans la liste des intégrations, sélectionnez l'intégration à mettre à niveau.
  5. Cliquez sur more_vert  Plus > Transférer vers l'environnement de préproduction. Cette étape crée une copie de l'intégration à des fins de test.
  6. Cliquez sur le bouton Production pour passer de Production à Staging.
  7. Sur la même intégration, cliquez sur more_vert  Plus > Configurer l'instance.
  8. Poursuivez avec l'un des chemins de mise à niveau suivants :

Pour savoir comment configurer des instances, consultez Configurer des instances. Cela crée une instance de préproduction qui n'apparaît pas dans la liste de configuration principale. Une seule instance de préproduction est autorisée par intégration.

Veillez également à mettre à jour chaque connecteur.

Mettre à niveau les intégrations certifiées vers la dernière version de Python

  1. Dans Automatisation > IDE, cliquez sur Mettre à niveau pour passer l'intégration et ses dépendances à la dernière version de Python.
  2. Si cette intégration inclut des éléments personnalisés, mettez à jour leur code en conséquence.
  3. Dans la section Tests, saisissez les paramètres requis, y compris l'instance de préproduction que vous avez configurée précédemment.
  4. Vérifiez qu'il n'y a pas d'erreur dans la sortie de débogage.
  5. Sur la même intégration, cliquez sur more_vert Plus > Envoyer en production.
  6. Si nécessaire, cliquez sur le bouton Production pour revenir au mode Production.

Mettre à niveau les intégrations personnalisées vers la dernière version de Python

Suivez cette procédure pour mettre à jour les dépendances de script dans les intégrations personnalisées.

  1. Cliquez sur more_vert Plus > Configurer l'intégration personnalisée.
  2. Dans la boîte de dialogue Exécution sur Python, remplacez le champ Exécution sur Python par la dernière version de Python (par exemple, Python 3.11).
  3. Sous Script Dependencies (Dépendances du script), copiez et enregistrez les noms des dépendances localement.
  4. Supprimez ces dépendances de la liste, puis cliquez sur Enregistrer.
  5. Copiez chacun des noms de dépendance (sans la version ni l'OS cible) de votre fichier dans le champ Bibliothèques, puis cliquez sur Ajouter. Par exemple, remplacez requests-2.27.1-none-any.whl par requests, puis ajoutez-le au champ Bibliothèques. La plate-forme télécharge chaque dépendance avec la dernière version de Python déjà configurée.

Mettre à niveau les agents distants

Si vous utilisez des agents distants, vous devez mettre à niveau l'agent et ses intégrations, en les exécutant comme suit :

  1. Accédez à Paramètres > Administration > Agents distants SOAR.
  2. Cliquez sur Mise à jour disponible.
  3. Mettez à niveau l'agent à l'aide de la méthode appropriée :
  4. Après avoir mis à niveau l'agent, suivez les étapes de mise à niveau de l'intégration décrites dans ce document.

Mettre à niveau des connecteurs

Vous devez mettre à niveau les connecteurs, qu'ils soient personnalisés ou commerciaux, vers les dernières versions de Python.

  1. Accédez à Paramètres > Gestion des données > Connecteurs.
  2. Cliquez sur le bouton jaune Mettre à jour en haut de l'écran.
  3. Cliquez sur Enregistrer.

Vous avez encore besoin d'aide ? Obtenez des réponses de membres de la communauté et de professionnels Google SecOps.