Python のバージョンをアップグレードする

以下でサポートされています。

このドキュメントでは、Content Hub の認定済み統合、カスタム統合、リモート エージェント、コネクタを最新の Python バージョンにアップグレードする方法について説明します。古いバージョンの Python は非推奨となるため、サポートされていないバージョンを使用している統合は、運用を継続できるように更新する必要があります。統合を最新の Python バージョンに更新したら、各コネクタもアップグレードする必要があります。

認定済みまたはカスタムの統合コードで、非推奨の Python バージョンを使用している場合は、手動で更新する必要があります。IDE ステージング モードを使用すると、本番環境に影響を与えることなく統合コードを更新できます。

始める前に

権限グループにすべての環境へのアクセス権が含まれていることを確認します。詳細については、権限グループを操作するをご覧ください。

統合をアップグレードする

  1. [Automation] > [IDE] に移動します。古い Python バージョンを使用している統合がある場合は、IDE、Content Hub、Playbooks のページにバナーが表示されます。
  2. [統合を表示] をクリックして、統合のリストを表示します。
  3. [閉じる] をクリックしてバナーを閉じます。
  4. 統合リストで、アップグレードする統合を選択します。
  5. more_vert [その他] > [ステージングに push] をクリックします。このステップでは、テスト用の統合のコピーを作成します。
  6. [Production] の切り替えボタンをクリックして、[Production] から [Staging] に切り替えます。
  7. 同じ統合で、 more_vert [その他> インスタンスを構成] をクリックします。
  8. 次のいずれかのアップグレード パスに進みます。

インスタンスの構成方法については、インスタンスを構成するをご覧ください。これにより、メインの構成リストに表示されないステージング インスタンスが作成されます。統合ごとに許可されるステージング インスタンスは 1 つのみです。

各コネクタも必ず更新してください。

認定インテグレーションを最新の Python バージョンにアップグレードする

  1. [Automation] > [IDE] で、[Upgrade] をクリックして、統合とその依存関係を最新の Python バージョンに切り替えます。
  2. この統合にカスタム要素が含まれている場合は、それに応じてコードを更新します。
  3. [テスト] セクションで、前に構成したステージング インスタンスなどの必須パラメータを入力します。
  4. [Debug Output] にエラーがないことを確認します。
  5. 同じ統合で、 more_vert [その他] > [本番環境に push] をクリックします。
  6. 必要に応じて、[本番環境] をクリックして本番環境モードに戻します。

カスタム統合を最新の Python バージョンにアップグレードする

カスタム統合のスクリプト依存関係を更新する手順は次のとおりです。

  1. more_vert [その他] > [カスタム統合を構成する] をクリックします。
  2. ダイアログの [Running on Python] フィールドで、[Running on Python] フィールドを最新の Python バージョン(Python 3.11 など)に変更します。
  3. [Script Dependencies] で、依存関係の名前をコピーしてローカルに保存します。
  4. リストからこれらの依存関係を削除し、[保存] をクリックします。
  5. ファイルから各依存関係の名前(バージョンまたはターゲット OS を除く)を [Libraries] フィールドにコピーし、[Add] をクリックします。たとえば、requests-2.27.1-none-any.whl を requests に変更して、[ライブラリ] フィールドに追加します。プラットフォームは、最新の Python バージョンがすでに構成されている各依存関係をダウンロードします。

リモート エージェントをアップグレードする

リモート エージェントを使用している場合は、エージェントとその統合の両方をアップグレードする必要があります。

  1. [設定] > [管理] > [SOAR リモート エージェント] に移動します。
  2. [アップデート利用可能] をクリックします。
  3. 適切な方法でエージェントをアップグレードします。
  4. エージェントをアップグレードしたら、このドキュメントで説明されている統合のアップグレード手順に沿って操作します。

コネクタをアップグレードする

カスタム コネクタと商用コネクタの両方を最新の Python バージョンにアップグレードする必要があります。

  1. [設定] > [データ マネジメント] > [コネクタ] に移動します。
  2. 画面上部にある黄色の [更新] ボタンをクリックします。
  3. [保存] をクリックします。

さらにサポートが必要な場合 コミュニティ メンバーや Google SecOps のプロフェッショナルから回答を得ることができます。