How to use Alibaba Cloud CSI storage - Container Service for Kubernetes: Central de Documentação do Alibaba Cloud

O ACK integra-se profundamente ao armazenamento do Alibaba Cloud e oferece suporte a serviços de armazenamento nativos do Kubernetes. Instale o plug-in CSI em um cluster registrado para anexar automaticamente discos em nuvem, NAS, OSS e volumes locais aos pods. Este tópico explica como usar o armazenamento CSI do Alibaba Cloud em um cluster registrado.

Configure as permissões do RAM, instale o plug-in CSI e monte volumes nos seus pods.

Considerações

Verifique se as restrições a seguir se aplicam:

Em clusters de data center, os nós ECS adicionados por meio de pools de nós recebem automaticamente o rótulo alibabacloud.com/external=true.

Pré-requisitos

Certifique-se de que você tem:

Um ACK One registered cluster criado com um cluster Kubernetes externo conectado.
Um cluster registrado executando o Kubernetes 1.24 ou posterior.
(Obrigatório para implantações em data center) Um circuito Express Connect entre seu data center e o Alibaba Cloud.

Etapa 1: Configure permissões do RAM

O plug-in Container Storage Interface (CSI) exige um par de AccessKey para chamar as APIs do Alibaba Cloud. Sem esse par, o plug-in não acessa o armazenamento em nuvem.

Escolha um método:

Usar o onectl

Instale o onectl na sua máquina local.

Conceda permissões do plug-in CSI ao usuário RAM:

onectl ram-user grant --addon csi-plugin

Saída esperada:

Ram policy ack-one-registered-cluster-policy-csi-plugin granted to ram user ack-one-user-ce313528c3 successfully.

Usar o console

Crie um usuário RAM.

Crie uma política personalizada com o exemplo a seguir. Essa política concede permissões para gerenciar discos, snapshots, políticas de snapshot, tags, instâncias, sistemas de arquivos NAS e buckets do OSS.

Show sample policy

{
    "Version": "1",
    "Statement": [
        {
            "Action": [
                "ecs:AttachDisk",
                "ecs:DetachDisk",
                "ecs:DescribeDisks",
                "ecs:CreateDisk",
                "ecs:ResizeDisk",
                "ecs:CreateSnapshot",
                "ecs:DeleteSnapshot",
                "ecs:CreateAutoSnapshotPolicy",
                "ecs:ApplyAutoSnapshotPolicy",
                "ecs:CancelAutoSnapshotPolicy",
                "ecs:DeleteAutoSnapshotPolicy",
                "ecs:DescribeAutoSnapshotPolicyEX",
                "ecs:ModifyAutoSnapshotPolicyEx",
                "ecs:AddTags",
                "ecs:DescribeTags",
                "ecs:DescribeSnapshots",
                "ecs:ListTagResources",
                "ecs:TagResources",
                "ecs:UntagResources",
                "ecs:ModifyDiskSpec",
                "ecs:DeleteDisk",
                "ecs:DescribeInstanceAttribute",
                "ecs:DescribeInstances"
            ],
            "Resource": ["*"],
            "Effect": "Allow"
        },
        {
            "Action": [
                "nas:DescribeFileSystems",
                "nas:DescribeMountTargets",
                "nas:AddTags",
                "nas:DescribeTags",
                "nas:RemoveTags",
                "nas:CreateFileSystem",
                "nas:DeleteFileSystem",
                "nas:ModifyFileSystem",
                "nas:CreateMountTarget",
                "nas:DeleteMountTarget",
                "nas:ModifyMountTarget",
                "nas:TagResources",
                "nas:SetDirQuota",
                "nas:EnableRecycleBin",
                "nas:GetRecycleBinAttribute"
            ],
            "Resource": ["*"],
            "Effect": "Allow"
        },
        {
            "Action": [
                "oss:PutBucket",
                "oss:GetObjectTagging",
                "oss:ListBuckets",
                "oss:PutBucketTags",
                "oss:GetBucketTags",
                "oss:PutBucketEncryption",
                "oss:GetBucketInfo"
            ],
            "Resource": ["*"],
            "Effect": "Allow"
        }
    ]
}

Anexe a política personalizada ao usuário RAM.
Crie um AccessKey para o usuário RAM.

Aviso
Configure uma política de restrição de rede do AccessKey para limitar chamadas a redes confiáveis.
Crie um Secret chamado alibaba-addon-secret no namespace kube-system com o par de AccessKey. O plug-in CSI usa esse Secret para autenticação no Alibaba Cloud.
```
kubectl -n kube-system create secret generic alibaba-addon-secret \
  --from-literal='access-key-id=<your-access-key-id>' \
  --from-literal='access-key-secret=<your-access-key-secret>'
```
Substitua <your-access-key-id> e <your-access-key-secret> pelo seu par de AccessKey.

Etapa 2: Instale o plug-in CSI

Instale o csi-plugin e o csi-provisioner.

Usar o onectl

Instale os add-ons:

onectl addon install csi-plugin
onectl addon install csi-provisioner

Saída esperada:

Addon csi-plugin, version **** installed.
Addon csi-provisioner, version **** installed.

Usar o console

Faça login no console do ACK. No painel de navegação à esquerda, clique em Clusters.
Clique no nome do cluster. No painel de navegação à esquerda, clique em Add-ons.
Clique na aba Volumes. Localize os cartões csi-plugin e csi-provisioner e clique em Install em cada cartão.
Na caixa de diálogo Message, confirme as versões e clique em OK.

Etapa 3: Usar volumes

Após instalar o plug-in CSI, monte diferentes tipos de volume no cluster registrado.

Tipo de volume	Tópicos
NAS	Use a statically provisioned NAS volume, Use a dynamically provisioned NAS volume
OSS	Use a statically provisioned ossfs 1.0 volume, Encrypt an ossfs 1.0 volume
Disco	Use a statically provisioned disk volume, Use a dynamically provisioned disk volume

Próximas etapas

Gerencie ou remova add-ons CSI na página Add-ons do console do ACK ou use o onectl.
Gerencie o armazenamento em vários clusters registrados com o gerenciamento de frota do ACK One.