仮想クラスターの管理

仮想クラスターとは、Amazon EMR が登録されている Kubernetes 名前空間です。仮想クラスターを作成、説明、一覧表示、および削除できます。システム内の追加のリソースは消費されません。1 つの仮想クラスターは、1 つの Kubernetes 名前空間にマップされます。この関係により、Kubernetes 名前空間をモデル化するのと同じ方法で仮想クラスターをモデル化して、要件を満たすことができます。Kubernetes 概念概要 ドキュメントで、考えられるユースケースを参照してください。

Amazon EMR を Amazon EKS クラスターの Kubernetes 名前空間に登録するには、EKS クラスターの名前と、ワークロードを実行するためにセットアップされた名前空間が必要です。Amazon EMR に登録されたこれらのクラスターは、物理的なコンピューティングやストレージを管理するのではなく、ワークロードがスケジュールされている Kubernetes 名前空間を指しているため、仮想クラスターと呼ばれます。

注記

仮想クラスターを作成する前に、まず「EMR で Amazon を設定する EKS」のステップ 1 ～ 8 を完了する必要があります。

仮想クラスターを作成する

次のコマンドを実行して、Amazon EMR を EKS クラスター上の名前空間に登録し、仮想クラスターを作成します。virtual_cluster_name は、仮想クラスターに指定する名前に置き換えます。eks_cluster_name は、EKS クラスターの名前に置き換えます。namespace_name は、Amazon EMR を登録する名前空間に置き換えます。

aws emr-containers create-virtual-cluster \
--name virtual_cluster_name \
--container-provider '{
    "id": "eks_cluster_name",
    "type": "EKS",
    "info": {
        "eksInfo": {
            "namespace": "namespace_name"
        }
    }
}' 

または、次の例に示すように、仮想クラスターに必要なパラメータを含む JSON ファイルを作成することもできます。

{
    "name": "virtual_cluster_name", 
    "containerProvider": {
        "type": "EKS", 
        "id": "eks_cluster_name", 
        "info": {
            "eksInfo": {
                "namespace": "namespace_name"
            }
        }
    }
}

JSON ファイルへのパスを指定して、次の create-virtual-cluster コマンドを実行します。

aws emr-containers create-virtual-cluster \
--cli-input-json file://./create-virtual-cluster-request.json
    

注記

仮想クラスターが正常に作成されたことを確認するには、list-virtual-clusters コマンドを実行するか、Amazon EMR コンソールで [仮想クラスター] ページに移動して、仮想クラスターのステータスを確認します。

仮想クラスターを一覧表示する

次のコマンドを実行して、仮想クラスターのステータスを表示します。

aws emr-containers list-virtual-clusters

仮想クラスターを説明する

次のコマンドを実行して、名前空間、ステータス、登録日など、仮想クラスターの詳細を取得します。123456 は、仮想クラスター ID に置き換えます。

aws emr-containers describe-virtual-cluster --id 123456

仮想クラスターを削除する

次のコマンドを実行して、仮想クラスターを削除します。123456 は、仮想クラスター ID に置き換えます。

aws emr-containers delete-virtual-cluster --id 123456

仮想クラスターの状態

次の表には、仮想クラスターの 4 つの状態が示されています。

State	説明
RUNNING	仮想クラスターは RUNNING 状態です。
TERMINATING	仮想クラスターの要求された終了処理が進行中です。
TERMINATED	要求された終了処理が完了しています。
ARRESTED	要求された終了処理は、アクセス許可が不十分なため、失敗しました。