翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
追加のソフトウェアをインストールするためのブートストラップアクションの作成
ブートストラップアクションを使用することにより、追加のソフトウェアのインストール、またはクラスターインスタンスの設定のカスタマイズを行うことができます。ブートストラップアクションは、Amazon Linux Amazon マシンイメージ () を使用してインスタンスEMRを起動した後にクラスターで実行されるスクリプトですAMI。ブートストラップアクションは、Amazon がクラスターの作成時に指定したアプリケーションEMRをインストールする前、およびクラスターノードがデータの処理を開始する前に実行されます。実行中のクラスターにノードを追加した場合、ブートストラップアクションはこれらのノードでも同じ方法で実行されます。カスタムブートストラップアクションを作成し、クラスターを作成するタイミングを指定できます。
Amazon EMRAMIバージョン 2.x および 3.x の事前定義されたブートストラップアクションのほとんどは、Amazon EMRリリース 4.x ではサポートされていません。例えば、 configure-Hadoop
と configure-daemons
は Amazon EMRリリース 4.x ではサポートされていません。代わりに、Amazon EMRリリース 4.x はこの機能をネイティブに提供します。Amazon EMRAMIバージョン 2.x および 3.x から Amazon EMRリリース 4.x にブートストラップアクションを移行する方法の詳細については、「Amazon EMR リリースガイド」の「Amazon の以前のAMIバージョンでクラスターとアプリケーションの設定をカスタマイズEMRする」を参照してください。
ブートストラップアクションの基本
デフォルトでは、ブートストラップアクションは Hadoop ユーザーとして実行されます。ブートストラップアクションは、sudo
を使用し、ルート権限で実行できます。
すべての Amazon EMR管理インターフェイスはブートストラップアクションをサポートします。コンソール、、または から複数のbootstrap-actions
パラメータを指定することで AWS CLI、クラスターごとに最大 16 のブートストラップアクションを指定できますAPI。
Amazon EMRコンソールから、オプションでクラスターの作成中にブートストラップアクションを指定できます。
を使用するとCLI、 create-cluster
コマンドを使用してクラスターを作成するときに --bootstrap-actions
パラメータを追加EMRすることで、ブートストラップアクションスクリプトへの参照を Amazon に渡すことができます。
--bootstrap-actions Path="s3://
mybucket
/filename
",Args=[arg1
,arg2
]
ブートストラップアクションがゼロ以外のエラーコードを返す場合、Amazon はそれを失敗としてEMR扱い、インスタンスを終了します。ブートストラップアクションに失敗するインスタンスが多すぎると、Amazon はクラスターをEMR終了します。少数のインスタンスだけが失敗した場合、Amazon は失敗したインスタンスを再割り当てして続行EMRしようとします。クラスターの lastStateChangeReason
エラーコードを使用して、ブートストラップアクションによって引き起こされたエラーを識別します。
ブートストラップアクションを条件付きで実行する
マスターノードでのみブートストラップアクションを実行するには、そのノードがマスターかどうかを判断するロジックを含むカスタムブートストラップアクションを使用できます。
#!/bin/bash if grep isMaster /mnt/var/lib/info/instance.json | grep false; then echo "This is not master node, do nothing,exiting" exit 0 fi echo "This is master, continuing to execute script" # continue with code logic for master node below
次の出力はコアノードから出力されます。
This is not master node, do nothing, exiting
次の出力はマスターノードから出力されます。
This is master, continuing to execute script
このロジックを使用するには、上記のコードを含むブートストラップアクションを Amazon S3 バケットにアップロードします。で AWS CLI、 --bootstrap-actions
パラメータをaws emr create-cluster
API呼び出しに追加し、ブートストラップスクリプトの場所を の値として指定しますPath
。
シャットダウンアクション
ブートストラップアクションスクリプトで 1 つ以上の shutdown actions を作成するには、スクリプトを /mnt/var/lib/instance-controller/public/shutdown-actions/
ディレクトリに書き込みます。クラスターが終了すると、ディレクトリ内のすべてのスクリプトが並行して実行されます。各スクリプトが 60 秒以内に実行され完了しなければなりません。
ノードの終了時にエラーが発生した場合、シャットダウンアクションスクリプトが実行される保証はありません。
注記
Amazon EMRバージョン 4.0 以降を使用する場合は、マスターノードに /mnt/var/lib/instance-controller/public/shutdown-actions/
ディレクトリを手動で作成する必要があります。デフォルトでは存在しませんが、作成後は、このディレクトリのスクリプトがシャットダウンの前に実行されます。ディレクトリを作成するためのマスターノードへの接続の詳細については、「を使用してプライマリノードに接続する SSH」を参照してください。
カスタムブートストラップアクションの使用
カスタムスクリプトを作成すると、カスタマイズされたブートストラップアクションを実行します。どの Amazon EMRインターフェイスでも、カスタムブートストラップアクションを参照できます。
注記
最高のパフォーマンスを得るには、Amazon で使用するカスタムブートストラップアクション、スクリプト、およびその他のファイルをEMR、クラスター AWS リージョン と同じ にある Amazon S3 バケットに保存することをお勧めします。
カスタムブートストラップアクションの追加
カスタムブートストラップアクションを使用した Simple Storage Service (Amazon S3) から各ノードへのオブジェクトのコピー
アプリケーションをインストールする前に、Simple Storage Service (Amazon S3) からクラスター内の各ノードにオブジェクトをコピーするブートストラップアクションを使用できます。 AWS CLI はクラスターの各ノードにインストールされるため、ブートストラップアクションは AWS CLI コマンドを呼び出すことができます。
Simple Storage Service (Amazon S3) から各クラスターノードのローカルフォルダ /mnt1/myfolder
にファイル myfile.jar
をコピーする簡単なブートストラップアクションスクリプトの例を次に示します。スクリプトは、以下の内容を使って、copymyfile.sh
のファイル名で Simple Storage Service (Amazon S3) に保存されます。
#!/bin/bash aws s3 cp s3://mybucket/myfilefolder/myfile.jar /mnt1/myfolder
クラスターの起動時にスクリプトを指定します。次の AWS CLI 例は、これを示しています。
aws emr create-cluster --name "Test cluster" --release-label
emr-7.2.0
\ --use-default-roles --ec2-attributes KeyName=myKey \ --applications Name=Hive Name=Pig \ --instance-count 3 --instance-type m5.xlarge \ --bootstrap-actions Path="s3://mybucket/myscriptfolder/copymyfile.sh"