As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Gerenciamento de clusters virtuais
<a name="virtual-cluster"></a>

Um cluster virtual corresponde a um namespace do Kubernetes no qual o Amazon EMR está registrado. Você pode criar, descrever, listar e excluir clusters virtuais. Eles não consomem quaisquer recursos adicionais em seu sistema. Um único cluster virtual mapeia para um único namespace do Kubernetes. Dado esse relacionamento, você pode modelar clusters virtuais da mesma forma que modela namespaces Kubernetes para atender aos seus requisitos. Confira os possíveis casos de uso na documentação de [visão geral dos conceitos do Kubernetes](https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/). 

Para registrar o Amazon EMR com um namespace do Kubernetes em um cluster do Amazon EKS, você precisa do nome do cluster do EKS e do namespace que foi configurado para executar sua workload. Esses clusters registrados no Amazon EMR são chamados de clusters virtuais porque não gerenciam computação ou armazenamento físicos, mas direcionam para um namespace do Kubernetes no qual sua workload está programada.

**nota**  
Antes de criar um cluster virtual, você deve concluir as etapas de 1 a 8 em [Configuração do Amazon EMR no EKS](setting-up.md).

**Topics**
+ [Criação de um cluster virtual](#create-virtul-cluster)
+ [Listagem de clusters virtuais](#list-virtual-cluster)
+ [Descrição de um cluster virtual](#describe-virtual-cluster)
+ [Exclusão de um cluster virtual](#delete-virtual-cluster)
+ [Estados de um cluster virtual](#virtual-cluster-states)

## Criação de um cluster virtual
<a name="create-virtul-cluster"></a>

Execute o comando apresentado a seguir para criar um cluster virtual ao registrar o Amazon EMR com um namespace em um cluster do EKS. {{virtual\_cluster\_name}}Substitua por um nome que você forneça para seu cluster virtual. {{eks\_cluster\_name}}Substitua pelo nome do cluster EKS. Substitua o pelo namespace {{namespace\_name}} com o qual você deseja registrar o 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}}"
        }
    }
}'
```

Como alternativa, você pode criar um arquivo JSON que inclua os parâmetros obrigatórios para o cluster virtual, como demonstra o exemplo a seguir.

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

Em seguida, execute o comando `create-virtual-cluster` apresentado a seguir com o caminho para o arquivo JSON.

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

**nota**  
Para validar a criação com êxito de um cluster virtual, visualize o status dos clusters virtuais ao executar o comando `list-virtual-clusters` ou ao acessar a página **Clusters virtuais** no console do Amazon EMR.

## Listagem de clusters virtuais
<a name="list-virtual-cluster"></a>

Execute o comando apresentado a seguir para visualizar o status dos clusters virtuais. 

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

## Descrição de um cluster virtual
<a name="describe-virtual-cluster"></a>

Execute o comando apresentado a seguir para obter mais detalhes sobre um cluster virtual, como o namespace, o status e a data de registro. {{123456}}Substitua pelo ID do seu cluster virtual. 

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

## Exclusão de um cluster virtual
<a name="delete-virtual-cluster"></a>

Execute o comando apresentado a seguir para excluir um cluster virtual. {{123456}}Substitua pelo ID do seu cluster virtual.

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

## Estados de um cluster virtual
<a name="virtual-cluster-states"></a>

A tabela a seguir descreve os quatro estados possíveis de um cluster virtual.


| `State` | Description | 
| --- | --- | 
| `RUNNING` | O cluster virtual está no estado RUNNING.  | 
| `TERMINATING` | O encerramento solicitado para o cluster virtual está em andamento. | 
| `TERMINATED` | O encerramento solicitado foi concluído. | 
| `ARRESTED` | O encerramento solicitado falhou devido a permissões insuficientes. |