Aidez à améliorer cette page

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Pour contribuer à ce guide de l'utilisateur, cliquez sur le GitHub lien Modifier cette page sur qui se trouve dans le volet droit de chaque page.

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Utiliser le stockage du système de fichiers Amazon S3 avec le pilote Amazon EFS CSI

S3 Files est un système de fichiers partagé qui connecte n'importe AWS quel ordinateur directement à vos données dans Amazon S3. Il fournit un accès rapide et direct à toutes vos données S3 sous forme de fichiers avec une sémantique complète du système de fichiers et des performances à faible latence, sans que vos données ne quittent S3. Cela signifie que les applications basées sur des fichiers, les agents et les équipes peuvent accéder aux données S3 et les utiliser en tant que système de fichiers à l'aide des outils dont ils dépendent déjà. Le pilote Amazon EFS Container Storage Interface (CSI) permet aux clusters Kubernetes exécutés dessus de monter des systèmes de fichiers AWS Amazon S3 en tant que volumes persistants à partir de la version 3.0.0. Cette rubrique explique comment utiliser le pilote Amazon EFS CSI pour gérer le système de fichiers Amazon S3 sur votre cluster Amazon EKS.

Considérations

Conditions préalables

Étape 1 : créer des rôles IAM

Le pilote CSI Amazon EFS nécessite des autorisations IAM pour interagir avec votre système de fichiers. Le pilote EFS CSI utilise deux comptes de service dotés de rôles IAM distincts :

Pour mettre en œuvre cette procédure, vous pouvez utiliser l’un des outils suivants :

eksctl

Si vous utilisez les identités du pod

Exécutez les commandes suivantes pour créer des rôles IAM et des associations Pod Identity aveceksctl. Remplacez my-cluster par votre valeur.

export cluster_name=my-cluster

# Create the controller role
eksctl create podidentityassociation \
    --service-account-name efs-csi-controller-sa \
    --namespace kube-system \
    --cluster $cluster_name \
    --role-name AmazonEKS_EFS_CSI_ControllerRole \
    --permission-policy-arns arn:aws: iam::aws:policy/service-role/AmazonS3FilesCSIDriverPolicy

# Create the node role
eksctl create podidentityassociation \
    --service-account-name efs-csi-node-sa \
    --namespace kube-system \
    --cluster $cluster_name \
    --role-name AmazonEKS_EFS_CSI_NodeRole \
    --permission-policy-arns arn:aws: iam::aws:policy/AmazonS3ReadOnlyAccess,arn:aws: iam::aws:policy/AmazonElasticFileSystemsUtils

Si vous utilisez des rôles IAM pour des comptes de service

Exécutez les commandes suivantes pour créer des rôles IAM aveceksctl. my-clusterRemplacez-le par le nom de votre cluster et region-code par votre code de AWS région.

export cluster_name=my-cluster
export region_code=region-code

# Create the controller role
export controller_role_name=AmazonEKS_EFS_CSI_ControllerRole
eksctl create iamserviceaccount \
    --name efs-csi-controller-sa \
    --namespace kube-system \
    --cluster $cluster_name \
    --role-name $controller_role_name \
    --attach-policy-arn arn:aws: iam::aws:policy/service-role/AmazonS3FilesCSIDriverPolicy \
    --approve \
    --region $region_code

# Create the node role
export node_role_name=AmazonEKS_EFS_CSI_NodeRole
eksctl create iamserviceaccount \
    --name efs-csi-node-sa \
    --namespace kube-system \
    --cluster $cluster_name \
    --role-name $node_role_name \
    --attach-policy-arn arn:aws: iam::aws:policy/AmazonS3ReadOnlyAccess \
    --attach-policy-arn arn:aws: iam::aws:policy/AmazonElasticFileSystemsUtils \
    --approve \
    --region $region_code

AWS Management Console

Exécutez la commande suivante pour créer un rôle IAM avec AWS Management Console.

AWS CLI

Exécutez les commandes suivantes pour créer des rôles IAM avec la AWS CLI.

Si vous utilisez les identités du pod

Si vous utilisez des rôles IAM pour des comptes de service

Étape 2 : obtenir le pilote CSI Amazon EFS

Nous vous recommandons d'installer le pilote CSI Amazon EFS en utilisant le module complémentaire Amazon EKS. Pour ajouter un module complémentaire Amazon EKS à votre cluster, voir Créer un module complémentaire Amazon EKS. Pour plus d'informations sur les modules complémentaires, voir Modules complémentaires Amazon EKS. Si vous ne parvenez pas à utiliser le module complémentaire Amazon EKS, nous vous encourageons à signaler les raisons pour lesquelles vous ne pouvez pas utiliser le module complémentaire Amazon EKS dans le GitHub référentiel de feuilles de route pour les conteneurs.

Sinon, si vous souhaitez une installation autogérée du pilote CSI Amazon EFS, voir Installation sur GitHub.

Étape 3 : Création d'un système de fichiers Amazon S3

Pour créer un système de fichiers Amazon S3, consultez Créer un système de fichiers Amazon S3 pour Amazon EKS sur GitHub.

Étape 4 : déployer un exemple d’application

Vous pouvez déployer une variété d'applications types et les modifier selon vos besoins. Pour plus d'informations, consultez la section Exemples sur GitHub.