翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

PCS AWSのノードライフサイクルアクションにメンテナンスされたスクリプト AWS を使用する

AWS は、一般的なライフサイクルアクション用に管理されたスクリプトを発行します。メンテナンススクリプトは、コンピューティングノードグループ設定から直接参照します。スクリプトはべき等であり、起動するたびに安全に実行できます。

AWS は、各 のパブリックで管理 AWSされた Amazon S3 バケットからスクリプトを配布します AWS リージョン。Amazon S3 URI でスクリプトを参照します。保守スクリプトは、独自のスクリプトを参照するのと同じ方法で参照します。スクリプトは、 AWSマネージドバケットから直接参照できます。

使用可能なスクリプト

スクリプトを参照する

ライフサイクルアクションの scriptLocationフィールドで Amazon S3 URI でスクリプトを参照します。スクリプトは、各 の AWSマネージドaws-pcs-repo-regionバケットのaws-pcs-node-lifecycle-scriptsプレフィックスの下に保存されます AWS リージョン。クラスター AWS リージョン と同じ で バケットを使用します。

s3://aws-pcs-repo-region/aws-pcs-node-lifecycle-scripts/script-vversion.sh

各スクリプトはセマンティックバージョニングでバージョニングされます。特定のバージョンを固定したり、メジャーバージョン内の最新リリースを追跡したりできます。

すべてのスクリプトには、同じ場所にサフィックス (例: ) .sha256 が付いたコンパニオン SHA-256 チェックサムファイルがありますmount-efs-v1.0.0.sh.sha256。.sha256 値を読み取り、スクリプトの として設定しますchecksum。エージェントは、ダウンロード時にスクリプトの整合性を検証します。詳細については、「スクリプトの整合性 (チェックサム)」を参照してください。

使用可能なスクリプトバージョン

AWS は、各スクリプトを個別にバージョン化します。次の表に、各スクリプトの使用可能なバージョンを示します。「」で説明されているように、スクリプトの Amazon S3 URI でバージョンを使用しますスクリプトを参照する。

mount-efs.sh

mount-fsx-lustre.sh

configure-efs-homes.sh

configure-ldaps.sh

configure-cloudwatch-logs.sh

例: メンテナンスされたスクリプトを使用して EFS ファイルシステムをマウントする

次の例では、 で管理されているmount-efs.shスクリプトを参照していますus-west-2 AWS リージョン。引数は名前付きフラグとして渡します。スクリプトの引数については、「」を参照してくださいスクリプト引数。

aws pcs update-compute-node-group \
  --cluster-identifier my-cluster \
  --compute-node-group-identifier my-cng \
  --node-lifecycle-actions '{
    "stages": {
      "nodeBootstrapped": [
        {
          "name": "Mount EFS home directory",
          "scriptSource": {
            "scriptLocation": "s3://aws-pcs-repo-us-west-2/aws-pcs-node-lifecycle-scripts/mount-efs-v1.0.0.sh"
          },
          "arguments": ["--file-system-id", "fs-12345678", "--mount-point", "/shared"],
          "onError": "TERMINATE",
          "executionPolicy": "EVERY_BOOT"
        }
      ]
    }
  }'

ノードのインスタンスロールには、スクリプトオブジェクトに対するs3:GetObjectアクセス許可が必要です。プライベートサブネット内のノードは、S3 ゲートウェイ VPC エンドポイントを介してバケットに到達できます。詳細については、「スクリプトストレージの場所」を参照してください。

スクリプト引数

各スクリプトは名前付きフラグ引数を取ります。各フラグとその値をarguments配列の個別の要素 (例: ) として渡します["--file-system-id", "fs-12345678"]。すべてのスクリプトは として実行rootされ、AL2、AL2023、RHEL、Ubuntu、Rocky Linux オペレーティングシステムをサポートします。

mount-efs.sh

デフォルトiamオプションでは、ノードのインスタンスロールで elasticfilesystem:ClientMountと を許可する必要がありますelasticfilesystem:ClientWrite。ノードのサブネットには、セキュリティグループがノードからのインバウンド NFS (TCP 2049) を許可する EFS マウントターゲットが必要です。

mount-fsx-lustre.sh

ノードのサブネットはファイルシステムに到達する必要があり、ファイルシステムのセキュリティグループはノードからのインバウンド Lustre トラフィック (TCP 988、リザーブドソースポートを使用するクライアントの場合は 1018～1023) を許可する必要があります。

configure-efs-homes.sh

このスクリプトには、amazon-efs-utils、nfs-utils、および PAM mkhomedir サポートが必要です。RHEL ファミリーノードで、、oddjoboddjob-mkhomedir、および をインストールしますauthselect。AL2023 で、 をauthselect明示的にインストールします。Ubuntu で、 をインストールしますlibpam-modules。IAM とネットワークの要件は に一致しますmount-efs.sh。

configure-ldaps.sh

このスクリプトには、sssd、sssd-ldap、および が必要ですsssd-tools。RHEL ファミリーノードでは、 authselectまたは authconfigと も必要ですoddjob-mkhomedir。Ubuntu では、 が必要ですlibpam-modules。

では--secret-arn、ノードのインスタンスロールがシークレットsecretsmanager:GetSecretValueを許可する必要があり、ノードには awscliおよび python3パッケージが必要です。シークレットの値は、 形式の JSON である必要があります{"username": "<bind-dn>", "password": "<bind-password>"}。匿名バインドは AWS API コールを行わず、IAM アクセス許可を必要としません。

configure-cloudwatch-logs.sh

スクリプトはライフサイクルアクションログディレクトリ () を転送します/var/log/amazon/pcs/lifecycle/actions。ノードのインスタンスロールはlogs:CreateLogGroup、ターゲットロググループlogs:PutLogEventsで 、logs:CreateLogStream、および を許可する必要があります。このスクリプトを使用して、事後デバッグのためにログをインスタンス外に転送します。