

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

# カスタムブートストラップアクション
<a name="custom-bootstrap-actions-v3"></a>

/[`HeadNode`](HeadNode-v3.md)/ [`CustomActions`](HeadNode-v3.md#HeadNode-v3-CustomActions)[`OnNodeStart`](HeadNode-v3.md#yaml-HeadNode-CustomActions-OnNodeStart)設定を定義すると、 はノードの起動直後に任意のコード AWS ParallelCluster を実行します。/[`HeadNode`](HeadNode-v3.md)/ [`CustomActions`](HeadNode-v3.md#HeadNode-v3-CustomActions)[`OnNodeConfigured`](HeadNode-v3.md#yaml-HeadNode-CustomActions-OnNodeConfigured)設定を定義すると、 はノード設定が正しく完了した後にコード AWS ParallelCluster を実行します。

 AWS ParallelCluster バージョン 3.4.0 以降では、// [`HeadNode`](HeadNode-v3.md) [`CustomActions`](HeadNode-v3.md#HeadNode-v3-CustomActions)[`OnNodeUpdated`](HeadNode-v3.md#yaml-HeadNode-CustomActions-OnNodeUpdated)設定を定義すると、ヘッドノードの更新後にコードを実行できます。

通常、このコードは Amazon Simple Storage Service (Amazon S3) に保存され、HTTPS 接続でアクセスされます。コードは `root` として実行され、クラスターのオペレーティングシステムでサポートされている任意のスクリプト言語で実行できます。多くの場合、コードは *Bash* か *Python* で書かれています。

**注記**  
 AWS ParallelCluster バージョン 3.7.0 以降、クラスター[`Imds`](Imds-cluster-v3.md#Imds-cluster-v3.title)/[`ImdsSupport`](Imds-cluster-v3.md#yaml-cluster-Imds-ImdsSupport)デフォルト設定は です`v2.0`。  
新しいクラスターを作成してバージョン 3.7.0 以降のバージョンにアップグレードする場合は、カスタムブートストラップアクションスクリプトを IMDSv2 と互換性があるように更新するか、クラスター設定ファイルで [`Imds`](Imds-cluster-v3.md#Imds-cluster-v3.title)/[`ImdsSupport`](Imds-cluster-v3.md#yaml-cluster-Imds-ImdsSupport) を `v1.0` に設定してください。

**警告**  
責任[共有モデル](https://aws.amazon.com/compliance/shared-responsibility-model/)で説明されているように、カスタムスクリプトと引数を設定するのはお客様の責任です。カスタムブートストラップスクリプトと引数が、クラスターノードへのフルアクセス権があると信頼できるソースからのものであることを確認してください。

**警告**  
AWS ParallelCluster は、 `/etc/parallelcluster/cfnconfig` ファイルを通じて提供される内部変数の使用をサポートしていません。このファイルは将来のリリースの一部として削除される可能性があります。

`OnNodeStart` アクションは、NAT、Amazon Elastic Block Store (Amazon EBS)、スケジューラの設定など、ノードデプロイのブートストラップアクションが開始される前に呼び出されます。`OnNodeStart` のブートストラップアクションには、ストレージの変更、その他のユーザーの追加、パッケージの追加などがあります。

**注記**  
クラスターに [`DirectoryService`](DirectoryService-v3.md)と [`HeadNode`](HeadNode-v3.md) // [`CustomActions`](HeadNode-v3.md#HeadNode-v3-CustomActions) [`OnNodeStart`](HeadNode-v3.md#yaml-HeadNode-CustomActions-OnNodeStart)スクリプトを設定すると、 は`OnNodeStart`スクリプトを実行する前に `sssd` AWS ParallelCluster を設定`DirectoryService`して再起動します。

`OnNodeConfigured` アクションは、ノードのブートストラップ・プロセスが完了した後に呼び出されます。`OnNodeConfigured` アクションは、インスタンスが完全に構成され、完了したとみなされる前の最後のアクションです。一般的な `OnNodeConfigured` のアクションには、スケジューラ設定の変更、ストレージやパッケージの変更などがあります。設定時に指定することで、スクリプトに引数を渡すことができます。

ヘッドノードの更新が完了し、スケジューラーと共有ストレージが最新のクラスター設定変更に対応するようになった後、`OnNodeUpdated` アクションが呼び出されます。

`OnNodeStart` または `OnNodeConfigured` カスタムアクションが成功すると、終了コード 0 で成功が示されます。それ以外の終了コードは、インスタンスのブートストラップが失敗したことを示します。

`OnNodeUpdated` カスタムアクションが成功すると、終了コード 0 で成功が通知されます。それ以外の終了コードは、失敗したことを示します。

**注記**  
[`OnNodeUpdated`](HeadNode-v3.md#yaml-HeadNode-CustomActions-OnNodeUpdated) を設定した場合、更新が失敗したときに `OnNodeUpdated` アクションを以前の状態に手動で復元する必要があります。  
`OnNodeUpdated` カスタムアクションが失敗した場合、更新は以前の状態にロールバックします。ただし、`OnNodeUpdated` アクションは更新時にのみ実行され、スタックのロールバック時には実行されません。

/ および i / [`HeadNode`](HeadNode-v3.md) / [`CustomActions`](Scheduling-v3.md#Scheduling-v3-SlurmQueues-CustomActions)設定セクションでは、ヘッドノード[`CustomActions`](HeadNode-v3.md#HeadNode-v3-CustomActions)とキューごとに異なるスクリプトを指定できます。 [`SlurmQueues`](Scheduling-v3.md#Scheduling-v3-SlurmQueues) は [`Scheduling`](Scheduling-v3.md) `HeadNode`セクション[`OnNodeUpdated`](HeadNode-v3.md#yaml-HeadNode-CustomActions-OnNodeUpdated)でのみ設定できます。

**注記**  
 AWS ParallelCluster バージョン 3.0 以前は、ヘッドノードとコンピューティングノードに異なるスクリプトを指定できませんでした。「[AWS ParallelCluster 2.x から 3.x への移行](moving-from-v2-to-v3.md)」を参照してください。

**Topics**
+ [アクションと引数を定義するための構成設定](custom-bootstrap-actions-config-v3.md)
+ [引数](custom-bootstrap-actions-args-v3.md)
+ [カスタムブートストラップアクションを使用したクラスターの例](custom-bootstrap-actions-example-cluster-v3.md)
+ [IMDSv2 のカスタムブートストラップスクリプトを更新する方法の例](custom-bootstrap-actions-example-imdsv2-v3.md)
+ [IMDSv1 の設定を更新する方法の例](custom-bootstrap-actions-example-imdsv1-v3.md)