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

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

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

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

始める前に

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

インテグレーションをアップグレードする

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

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

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

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

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

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

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

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

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

リモート エージェントを使用している場合は、エージェントと、そのエージェントで実行されているインテグレーションの両方を次のようにアップグレードする必要があります。

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

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

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

  1. [SOAR 設定] > [取り込み] > [コネクタ] に移動します。
  2. 画面上部の黄色の [更新] ボタンをクリックします。
  3. [保存] をクリックします。

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