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

# 仮想クラスターの管理
<a name="virtual-cluster"></a>

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

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

**注記**  
仮想クラスターを作成する前に、まず「[Amazon EMR on EKS のセットアップ](setting-up.md)」のステップ 1 ～ 8 を完了する必要があります。

**Topics**
+ [仮想クラスターを作成する](#create-virtul-cluster)
+ [仮想クラスターを一覧表示する](#list-virtual-cluster)
+ [仮想クラスターを説明する](#describe-virtual-cluster)
+ [仮想クラスターを削除する](#delete-virtual-cluster)
+ [仮想クラスターの状態](#virtual-cluster-states)

## 仮想クラスターを作成する
<a name="create-virtul-cluster"></a>

次のコマンドを実行して、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 コンソールで **[仮想クラスター]** ページに移動して、仮想クラスターのステータスを確認します。

## 仮想クラスターを一覧表示する
<a name="list-virtual-cluster"></a>

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

```
aws emr-containers list-virtual-clusters
```

## 仮想クラスターを説明する
<a name="describe-virtual-cluster"></a>

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

```
aws emr-containers describe-virtual-cluster --id {{123456}}
```

## 仮想クラスターを削除する
<a name="delete-virtual-cluster"></a>

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

```
aws emr-containers delete-virtual-cluster --id {{123456}}
```

## 仮想クラスターの状態
<a name="virtual-cluster-states"></a>

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


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