AWS ParallelCluster Python ライブラリ API - AWS ParallelCluster
AWS ParallelCluster Python ライブラリの認可AWS ParallelCluster Python ライブラリをインストールするAWS ParallelCluster Python ライブラリ用 AWS Lambda

AWS ParallelCluster Python ライブラリ API

AWS ParallelCluster バージョン 3.5.0 以降では、AWS ParallelCluster Python ライブラリを使用して AWS ParallelCluster にアクセスできます。AWS ParallelCluster ライブラリには、pcluster 環境内または AWS Lambda ランタイム内からアクセスできます。AWS ParallelCluster Python ライブラリを使用して AWS ParallelCluster API にアクセスする方法を説明します。AWS ParallelCluster Python ライブラリは AWS ParallelCluster API が提供するのと同じ機能を提供します。

AWS ParallelCluster Python ライブラリのオペレーションとパラメータは、API パラメータを大文字なしの snake_case に変換したものです。

トピック

AWS ParallelCluster Python ライブラリの認可

boto3 で有効な標準的な方法のいずれかを使用して認証情報を指定します。詳細については、「Boto3 ドキュメント」を参照してください。

AWS ParallelCluster Python ライブラリをインストールする

  1. AWS ParallelCluster を設定する に記載されている手順に従って pcluster CLI バージョン 3.5.0 以降をインストールします。

  2. 次の例に示すように、pcluster モジュールをインポートし、ライブラリの使用を開始します。

    import pcluster.lib as pc
pc.create_cluster(cluster_name="mycluster", cluster_configuration="config.yaml"

AWS ParallelCluster Python ライブラリ用 AWS Lambda

Lambda レイヤーとランタイムをデプロイして AWS ParallelCluster Python ライブラリにアクセスできます。AWS ParallelCluster ZIP ファイルをホストしており、次の手順で説明するように zip ファイルへのリンクを入力すると使用できます。Lambda は zip ファイルを使用して Python ライブラリへのアクセスをサポートするランタイム環境を準備します。AWS ParallelCluster Python ライブラリは AWS ParallelCluster バージョン 3.5.0 で追加されました。このライブラリはバージョン 3.5.0 以降でのみ使用できます。

ホストされている ZIP ファイルの URL は次の形式です。s3://aws-region-id-aws-parallelcluster/parallelcluster/3.7.0/layers/aws-parallelcluster/lambda-layer.zip

AWS Lambda を使用して AWS ParallelCluster Python ライブラリへのアクセスを開始する

Lambda レイヤーを作成する

  1. AWS Management Console にログインし、AWS Lambda コンソールに移動します。

  2. ナビゲーションペインで [レイヤー] を選択し、[レイヤーの作成] を選択します。

  3. レイヤーの名前を入力し、[Amazon S3 からファイルをアップロードする] を選択します。

  4. zip ファイルの URL を入力します。s3://aws-region-id-aws-parallelcluster/parallelcluster/3.7.0/layers/aws-parallelcluster/lambda-layer.zip。

  5. [互換性のあるアーキテクチャ] で、[x86_64] アーキテクチャを選択します。

  6. [互換性のあるアーキテクチャ] で、[Python 3.9] ランタイムを選択します。

  7. [Create] (作成) を選択します。

Lambda レイヤーを使用する

  1. Lambda コンソールのナビゲーションペインで、[関数] を選択し、[関数の作成] を選択します。

  2. 関数の名前を入力します。

  3. [ランタイム] で、[Python 3.9] を選択します。

  4. [アーキテクチャ] で、[x86_64] アーキテクチャを選択します。

  5. [Create function (関数の作成)] を選択します。

  6. 関数が作成されたら、[レイヤー] を選択し、[レイヤーの追加] を選択します。

  7. [カスタムレイヤー] を選択し、前のステップで作成したレイヤーを選択します。

  8. レイヤーバージョンを選択します。

  9. [追加] を選択します。

  10. Lambda には、AWS ParallelCluster で作成されたクラスターを管理するためのアクセス許可が必要です。AWS ParallelCluster pcluster 基本ユーザーポリシー に一覧表示されているアクセス許可を使用して Lambda ロールを作成します。

これで、AWS ParallelCluster Python ライブラリ API で説明されているように Python ライブラリから AWS ParallelCluster にアクセスできるようになりました。