Considerações Pré-requisitos Etapa 1: Criar uma função do IAM Etapa 2: obter o driver Etapa 3: implantar uma aplicação de exemplo

Armazene volumes do Kubernetes com o Amazon EBS

O driver de Container Storage Interface (CSI) do Amazon Elastic Block Store (Amazon EBS) gerencia o ciclo de vida dos volumes do Amazon EBS como armazenamento para os volumes do Kubernetes que você criar. O driver da CSI do Amazon EBS cria volumes do Amazon EBS para estes tipos de volumes do Kubernetes: volumes temporários e volumes persistentes genéricos.

Considerações

Você não pode montar volumes do Amazon EBS em Pods do Fargate.
Você pode executar o controlador da CSI do Amazon EBS em nós do Fargate, mas o DaemonSet do nó da CSI do Amazon EBS só pode ser executado em instâncias do Amazon EC2.

Importante

Para utilizar a funcionalidade de snapshot do driver de CSI do Amazon EBS, é necessário instalar o criador de snapshots externo antes ou depois da instalação do complemento. Os componentes do snapshotter externo devem ser instalados na seguinte ordem:

CustomResourceDefinition (CRD) para volumesnapshotclasses, volumesnapshots e volumesnapshotcontents
RBAC (ClusterRole, ClusterRoleBinding e assim por diante)
implantação do controlador

Para obter mais informações, consulte Snapshotter de CSI no GitHub.

Pré-requisitos

Um cluster existente. Para ver a versão necessária da plataforma, execute o comando a seguir.
```
aws eks describe-addon-versions --addon-name aws-ebs-csi-driver
    
```
Um provedor OpenID Connect (OIDC) do AWS Identity and Access Management (IAM) existente para o cluster. Para determinar se você tem ou para criar uma, consulte Criar um provedor OIDC do IAM para o cluster.
Se você estiver usando uma PodSecurityPolicy no âmbito do cluster, certifique-se de que o complemento tenha permissões suficientes para ser implantado. Para obter as permissões exigidas por cada Pod de complemento, consulte a definição relevante de manifesto de complemento no GitHub.

Etapa 1: Criar uma função do IAM

O plugin CSI do Amazon EBS requer permissões do IAM para fazer chamadas para APIs da AWS em seu nome. Se você não concluir essas etapas, a tentativa de instalar o complemento e de executar kubectl describe pvc mostrarão failed to provision volume with StorageClass junto com erro could not create volume in EC2: UnauthorizedOperation. Para obter mais informações, consulte Set up driver permission(Configurar permissão de driver) no GitHub.

nota

Pods terão acesso às permissões atribuídas ao perfil do IAM, a menos que você bloqueie o acesso ao IMDS. Para ter mais informações, consulte Proteger os clusters do Amazon EKS com as práticas recomendadas.

O procedimento a seguir mostra como criar um perfil do IAM e associar a política gerenciada da AWS a ele. É possível usar o eksctl, o AWS Management Console ou a AWS CLI.

nota

As etapas específicas desse procedimento foram escritas para usar o driver como um complemento do Amazon EKS. Diferentes etapas para usar o driver como um complemento autogerenciado. Para obter mais informações, consulte Configurar permissão de driver no GitHub.

eksctl

Para criar o perfil do IAM do plugin Amazon EBS CSI com o `eksctl`

Criar um perfil do IAM e associar uma política. AWS mantém uma política AWS gerenciada ou você pode criar sua própria política personalizada. Você pode criar uma função IAM e anexar a política gerenciada AWS com o seguinte comando. Substitua o my-cluster pelo nome do cluster. O comando implanta uma pilha do AWS CloudFormation que cria um perfil do IAM e anexa a política do IAM a ele. Se o cluster estiver nas Regiões da AWS: AWS GovCloud (EUA-Leste) ou AWS GovCloud (EUA-Oeste), substitua arn:aws: por arn:aws-us-gov:.
```
eksctl create iamserviceaccount \
        --name ebs-csi-controller-sa \
        --namespace kube-system \
        --cluster my-cluster \
        --role-name AmazonEKS_EBS_CSI_DriverRole \
        --role-only \
        --attach-policy-arn arn:aws:iam::aws:policy/service-role/AmazonEBSCSIDriverPolicy \
        --approve
    
```

Se você usar uma chave do KMS personalizada para criptografia em seus volumes do Amazon EBS, personalize o perfil do IAM conforme necessário. Por exemplo, faça o seguinte:

Copie e cole o código a seguir em um novo arquivo kms-key-for-encryption-on-ebs.json. Substitua custom-key-arn pelo ARN da chave do KMS personalizada.


{
      "Version": "2012-10-17",
      "Statement": [
        {
          "Effect": "Allow",
          "Action": [
            "kms:CreateGrant",
            "kms:ListGrants",
            "kms:RevokeGrant"
          ],
          "Resource": ["custom-key-arn"],
          "Condition": {
            "Bool": {
              "kms:GrantIsForAWSResource": "true"
            }
          }
        },
        {
          "Effect": "Allow",
          "Action": [
            "kms:Encrypt",
            "kms:Decrypt",
            "kms:ReEncrypt*",
            "kms:GenerateDataKey*",
            "kms:DescribeKey"
          ],
          "Resource": ["custom-key-arn"]
        }
      ]
    }

Crie a política . Você pode alterar KMS_Key_For_Encryption_On_EBS_Policy para um nome diferente. Porém, se fizer isso, não se esqueça de alterá-lo também em etapas posteriores.
```
aws iam create-policy \
      --policy-name KMS_Key_For_Encryption_On_EBS_Policy \
      --policy-document file://kms-key-for-encryption-on-ebs.json
    
```
Anexe a política do IAM necessária à função com o comando a seguir. Substitua 111122223333 pelo ID da sua conta. Se o cluster estiver nas Regiões da AWS: AWS GovCloud (EUA-Leste) ou AWS GovCloud (EUA-Oeste), substitua arn:aws: por arn:aws-us-gov:.
```
aws iam attach-role-policy \
      --policy-arn arn:aws:iam::111122223333:policy/KMS_Key_For_Encryption_On_EBS_Policy \
      --role-name AmazonEKS_EBS_CSI_DriverRole
    
```

AWS Management Console

Para criar a função do IAM do plugin Amazon EBS CSI com o AWS Management Console

Abra o console do IAM em https://console.aws.amazon.com/iam/.
No painel de navegação à esquerda, escolha Roles.
Na página Roles (Funções), selecione Create role (Criar função).
Na página Select trusted entity (Selecionar entidade confiável), faça o seguinte:
1. Na seção Trusted entity type (Tipo de entidade confiável), escolha Web identity (Identidade da Web).
2. Em Identity provider (Provedor de identidade), escolha OpenID ConnectOpenID Connect provider URL (URL do provedor OpenID Connect) para o cluster (conforme mostrado na guia Overview [Visão geral] do Amazon EKS).
3. Para Audience (Público), escolha sts.amazonaws.com.
4. Escolha Próximo.
Na página Add permissions (Adicionar permissões), faça o seguinte:
1. Na caixa Filter policies (Políticas de filtro) insira AmazonEBSCSIDriverPolicy.
2. Marque a caixa de seleção à esquerda do AmazonEBSCSIDriverPolicy retornado na pesquisa.
3. Escolha Próximo.
Na página Name, review, and create (Nomear, revisar e criar), faça o seguinte:
1. Em Role name (Nome da função), insira um nome exclusivo para a função, como AmazonEKS_EBS_CSI_DriverRole.
2. Em Adicionar tags (Opcional), adicione metadados ao perfil anexando tags como pares chave-valor. Para obter mais informações sobre o uso de tags no IAM, consulte Marcar recursos do IAM no Guia do usuário do IAM.
3. Selecione Criar função.
Depois que a função for criada, escolha a função no console a fim de abri-la para edição.
Escolha a guia Trust relationships (Relacionamentos de confiança) e, em seguida, escolha Edit trust policy (Editar política de confiança).
Encontre a linha semelhante à seguinte:
```
"oidc.eks.region-code.amazonaws.com/id/EXAMPLED539D4633E53DE1B71EXAMPLE:aud": "sts.amazonaws.com"
```
Adicione uma vírgula ao final da linha anterior e depois adicione a linha a seguir após a anterior. Substitua region-code pela Região da AWS em que está o cluster. Substitua EXAMPLED539D4633E53DE1B71EXAMPLE pelo ID do provedor OIDC do cluster.
```
"oidc.eks.region-code.amazonaws.com/id/EXAMPLED539D4633E53DE1B71EXAMPLE:sub": "system:serviceaccount:kube-system:ebs-csi-controller-sa"
```
Escolha Update Policy (Atualizar política) para concluir.
Se você usar uma chave do KMS personalizada para criptografia em seus volumes do Amazon EBS, personalize o perfil do IAM conforme necessário. Por exemplo, faça o seguinte:
1. No painel de navegação à esquerda, escolha Políticas.
2. Na página Policies (Políticas), escolha Create Policy (Criar política).
3. Na página Criar política, escolha a guia JSON.
4. Copie e cole o seguinte código no editor, substituindo custom-key-arn pelo ARN da chave do KMS personalizada:
```
{
      "Version": "2012-10-17",
      "Statement": [
        {
          "Effect": "Allow",
          "Action": [
            "kms:CreateGrant",
            "kms:ListGrants",
            "kms:RevokeGrant"
          ],
          "Resource": ["custom-key-arn"],
          "Condition": {
            "Bool": {
              "kms:GrantIsForAWSResource": "true"
            }
          }
        },
        {
          "Effect": "Allow",
          "Action": [
            "kms:Encrypt",
            "kms:Decrypt",
            "kms:ReEncrypt*",
            "kms:GenerateDataKey*",
            "kms:DescribeKey"
          ],
          "Resource": ["custom-key-arn"]
        }
      ]
    }
```
5. Escolha Próximo: etiquetas.
6. Na página Add tags (optional) (Adicionar etiquetas - opcional), escolha Next: Review (Próximo: revisar).
7. Em Name (Nome), insira um nome exclusivo para a sua política (por exemplo, KMS_Key_For_Encryption_On_EBS_Policy).
8. Escolha Criar política.
9. No painel de navegação à esquerda, escolha Roles.
10. Escolha AmazonEKS_EBS_CSI_DriverRole no console para abri-lo para edição.
11. Na lista suspensa Add permissions (Adicionar permissões), escolha Attach policies (Anexar políticas).
12. Na caixa Filter policies (Políticas de filtro) insira KMS_Key_For_Encryption_On_EBS_Policy.
13. Marque a caixa de seleção à esquerda do KMS_Key_For_Encryption_On_EBS_Policy retornado na pesquisa.
14. Escolha Anexar políticas.

AWS CLI

Para criar a função do IAM do plugin Amazon EBS CSI com o AWS CLI

Exiba a URL do provedor OIDC do cluster. Substitua my-cluster pelo nome do cluster. Se o resultado do comando for None, revise os Pré-requisitos.


aws eks describe-cluster --name my-cluster --query "cluster.identity.oidc.issuer" --output text

Veja um exemplo de saída abaixo.

https://oidc.eks.region-code.amazonaws.com/id/EXAMPLED539D4633E53DE1B71EXAMPLE

Crie o perfil do IAM, concedendo a ação AssumeRoleWithWebIdentity.

Copie o conteúdo a seguir em um arquivo chamado aws-ebs-csi-driver-trust-policy.json. Substitua 111122223333 pelo ID da sua conta. Substitua EXAMPLED539D4633E53DE1B71EXAMPLE e region-code pelos valores retornados na etapa anterior. Se o cluster estiver nas Regiões da AWS: AWS GovCloud (EUA-Leste) ou AWS GovCloud (EUA-Oeste), substitua arn:aws: por arn:aws-us-gov:.


{
      "Version": "2012-10-17",
      "Statement": [
        {
          "Effect": "Allow",
          "Principal": {
            "Federated": "arn:aws:iam::111122223333:oidc-provider/oidc.eks.region-code.amazonaws.com/id/EXAMPLED539D4633E53DE1B71EXAMPLE"
          },
          "Action": "sts:AssumeRoleWithWebIdentity",
          "Condition": {
            "StringEquals": {
              "oidc.eks.region-code.amazonaws.com/id/EXAMPLED539D4633E53DE1B71EXAMPLE:aud": "sts.amazonaws.com",
              "oidc.eks.region-code.amazonaws.com/id/EXAMPLED539D4633E53DE1B71EXAMPLE:sub": "system:serviceaccount:kube-system:ebs-csi-controller-sa"
            }
          }
        }
      ]
    }

Crie a função. Você pode alterar AmazonEKS_EBS_CSI_DriverRole para um nome diferente. Se você alterá-lo, não se esqueça de alterá-lo em etapas superiores.


aws iam create-role \
      --role-name AmazonEKS_EBS_CSI_DriverRole \
      --assume-role-policy-document file://"aws-ebs-csi-driver-trust-policy.json"

Associar uma política. AWS mantém uma política AWS gerenciada ou você pode criar sua própria política personalizada. Anexe a política gerenciada pela AWS função com o comando a seguir. Se o cluster estiver nas Regiões da AWS: AWS GovCloud (EUA-Leste) ou AWS GovCloud (EUA-Oeste), substitua arn:aws: por arn:aws-us-gov:.
```
aws iam attach-role-policy \
      --policy-arn arn:aws:iam::aws:policy/service-role/AmazonEBSCSIDriverPolicy \
      --role-name AmazonEKS_EBS_CSI_DriverRole
    
```

Se você usar uma chave do KMS personalizada para criptografia em seus volumes do Amazon EBS, personalize o perfil do IAM conforme necessário. Por exemplo, faça o seguinte:

Copie e cole o código a seguir em um novo arquivo kms-key-for-encryption-on-ebs.json. Substitua custom-key-arn pelo ARN da chave do KMS personalizada.


{
      "Version": "2012-10-17",
      "Statement": [
        {
          "Effect": "Allow",
          "Action": [
            "kms:CreateGrant",
            "kms:ListGrants",
            "kms:RevokeGrant"
          ],
          "Resource": ["custom-key-arn"],
          "Condition": {
            "Bool": {
              "kms:GrantIsForAWSResource": "true"
            }
          }
        },
        {
          "Effect": "Allow",
          "Action": [
            "kms:Encrypt",
            "kms:Decrypt",
            "kms:ReEncrypt*",
            "kms:GenerateDataKey*",
            "kms:DescribeKey"
          ],
          "Resource": ["custom-key-arn"]
        }
      ]
    }

Crie a política . Você pode alterar KMS_Key_For_Encryption_On_EBS_Policy para um nome diferente. Porém, se fizer isso, não se esqueça de alterá-lo também em etapas posteriores.
```
aws iam create-policy \
      --policy-name KMS_Key_For_Encryption_On_EBS_Policy \
      --policy-document file://kms-key-for-encryption-on-ebs.json
    
```
Anexe a política do IAM necessária à função com o comando a seguir. Substitua 111122223333 pelo ID da sua conta. Se o cluster estiver nas Regiões da AWS: AWS GovCloud (EUA-Leste) ou AWS GovCloud (EUA-Oeste), substitua arn:aws: por arn:aws-us-gov:.
```
aws iam attach-role-policy \
      --policy-arn arn:aws:iam::111122223333:policy/KMS_Key_For_Encryption_On_EBS_Policy \
      --role-name AmazonEKS_EBS_CSI_DriverRole
    
```

Agora que você criou o perfil do IAM do driver de CSI do Amazon EBS, poderá avançar para a próxima seção. Quando você implanta o complemento com esse perfil do IAM, ele cria e é configurado para usar uma conta de serviço chamada ebs-csi-controller-sa. A conta de serviço está vinculada a uma clusterrole Kubernetes que recebe as permissões necessárias do Kubernetes.

Etapa 2: obter o driver de CSI do Amazon EBS

Recomendamos que você instale o driver de CSI do Amazon EBS por meio do complemento do Amazon EKS para reforçar a segurança e reduzir o volume do trabalho. Para adicionar um complemento do Amazon EKS ao cluster, consulte Criar um complemento do Amazon EKS. Para obter mais informações sobre complementos, consulte Complementos do Amazon EKS.

Importante

Antes de adicionar o driver do Amazon EBS como um complemento do Amazon EKS, verifique se você não tem uma versão autogerenciada do driver instalada no seu cluster. Em caso afirmativo, consulte Desinstalar um driver de CSI autogerenciado do Amazon EBS em GitHub.

Como alternativa, se desejar uma instalação autogerenciada do driver de CSI do Amazon EFS, consulte Instalação em GitHub.

Etapa 3: implantar uma aplicação de exemplo

Você pode implantar toda uma variedade de aplicações de exemplo e modificá-las conforme necessário. Para obter mais informações, consulte Exemplos de Kubernetes no GitHub.

Atenção O Javascript está desativado ou não está disponível no seu navegador.

Para usar a documentação da AWS, o Javascript deve estar ativado. Consulte as páginas de Ajuda do navegador para obter instruções.

Convenções do documento

Armazenar dados de aplicações

Perguntas frequentes sobre a migração de CSI do EBS

Armazene volumes do Kubernetes com o Amazon EBS

Considerações

Importante

Pré-requisitos

Etapa 1: Criar uma função do IAM

nota

nota

Para criar o perfil do IAM do plugin Amazon EBS CSI com o eksctl

Para criar a função do IAM do plugin Amazon EBS CSI com o AWS Management Console

Para criar a função do IAM do plugin Amazon EBS CSI com o AWS CLI

Etapa 2: obter o driver de CSI do Amazon EBS

Importante

Etapa 3: implantar uma aplicação de exemplo

Para criar o perfil do IAM do plugin Amazon EBS CSI com o `eksctl`