Unduh aws efs csi driver - unduh kode sumber aws efs csi driver

aws efs csi driver

Kode sumber lainnya

ver-3.0.8

Unduh

Pengemudi CSI Amazon EFS

Driver Amazon Elastic File System Container Storage Interface (CSI) mengimplementasikan spesifikasi CSI untuk orkestrator kontainer untuk mengelola siklus hidup sistem file Amazon EFS.

Matriks Kompatibilitas Spesifikasi CSI

Versi Spesifikasi Driver CSI Amazon EFS CSI	v0.3.0	v1.1.0	v1.2.0
cabang utama	TIDAK	TIDAK	Ya
v2.xx	TIDAK	TIDAK	Ya
v1.xx	TIDAK	TIDAK	Ya
v0.3.0	TIDAK	Ya	TIDAK
v0.2.0	TIDAK	Ya	TIDAK
v0.1.0	Ya	TIDAK	TIDAK

Fitur

Driver Amazon EFS CSI mendukung penyediaan dinamis dan penyediaan statis. Saat ini, Penyediaan Dinamis membuat titik akses untuk setiap PV. Ini berarti sistem file Amazon EFS harus dibuat secara manual di AWS terlebih dahulu dan harus diberikan sebagai masukan ke parameter kelas penyimpanan. Untuk penyediaan statis, sistem file Amazon EFS perlu dibuat secara manual di AWS terlebih dahulu. Setelah itu, dapat dipasang di dalam wadah sebagai volume menggunakan driver.

Antarmuka CSI berikut diimplementasikan:

Layanan Pengontrol: CreateVolume, DeleteVolume, ControllerGetCapabilities, ValidateVolumeCapabilities
Layanan Node: NodePublishVolume, NodeUnpublishVolume, NodeGetCapabilities, NodeGetInfo, NodeGetId, NodeGetVolumeStats
Layanan Identitas: GetPluginInfo, GetPluginCapabilities, Probe

Parameter Kelas Penyimpanan untuk Penyediaan Dinamis

Parameter	Nilai-nilai	Bawaan	Opsional	Keterangan
Mode penyediaan	efs-ap		PALSU	Jenis volume yang disediakan oleh efs. Saat ini, Access Point didukung.
fileSystemId			PALSU	Sistem File tempat titik akses dibuat.
direktoriPerms			PALSU	Izin direktori untuk pembuatan direktori akar Access Point.
uid			BENAR	Id pengguna POSIX yang akan diterapkan untuk pembuatan direktori root Access Point.
gid			BENAR	Id grup POSIX yang akan diterapkan untuk pembuatan direktori root Access Point.
gidRangeStart		50000	BENAR	Rentang awal Id grup POSIX yang akan diterapkan untuk pembuatan direktori akar Titik Akses. Tidak digunakan jika uid/gid disetel.
gidRangeEnd		7000000	BENAR	Rentang akhir Id grup POSIX. Tidak digunakan jika uid/gid disetel.
jalur dasar			BENAR	Jalur tempat titik akses untuk penyediaan dinamis dibuat. Jika parameter ini tidak ditentukan, titik akses dibuat di bawah direktori root sistem file
subPathPattern		`/${.PV.name}`	BENAR	Templat yang digunakan untuk membuat subPath di mana setiap titik akses dibuat di bawah Penyediaan Dinamis. Dapat terdiri dari string tetap dan variabel terbatas, serupa dengan variabel 'subPathPattern' pada bagan nfs-subdir-external-provisioner. Mendukung `.PVC.name` , `.PVC.namespace` dan `.PV.name`
pastikanDirektori Unik		BENAR	BENAR	CATATAN: Hanya setel ini ke false jika Anda yakin ini adalah perilaku yang Anda inginkan . Digunakan ketika penyediaan dinamis diaktifkan, jika diatur ke true, menambahkan UID ke pola yang ditentukan dalam `subPathPattern` untuk memastikan bahwa titik akses tidak akan menunjuk ke direktori yang sama secara tidak sengaja.
az		""	BENAR	Digunakan untuk pemasangan lintas akun. `az` di bawah parameter kelas penyimpanan adalah opsional. Jika ditentukan, target pemasangan yang terkait dengan az akan digunakan untuk pemasangan lintas akun. Jika tidak ditentukan, target pemasangan acak akan dipilih untuk pemasangan lintas akun
gunakan kembaliAccessPoint		PALSU	BENAR	Jika disetel ke true, ini akan membuat token klien Access Point dari nama PVC yang disediakan. Sehingga AccessPoint dapat direplikasi dari cluster yang berbeda jika menggunakan nama PVC dan konfigurasi kelas penyimpanan yang sama.

Catatan

Rentang Id grup Posix khusus untuk direktori akar Titik Akses harus menyertakan parameter gidRangeStart dan gidRangeEnd . Parameter ini bersifat opsional hanya jika keduanya dihilangkan. Jika Anda menentukan satu, maka yang lainnya menjadi wajib.
Saat menggunakan rentang ID grup Posix khusus, ada kemungkinan driver kehabisan Id grup POSIX yang tersedia. Kami menyarankan untuk memastikan rentang ID grup khusus cukup besar atau membuat kelas penyimpanan baru dengan sistem file baru untuk menyediakan volume tambahan.
az di bawah parameter kelas penyimpanan tidak sama dengan opsi mount efs-utils az . Opsi az mount digunakan untuk pemasangan cross-az atau pemasangan sistem file satu zona efs dalam akun aws yang sama dengan klaster.
Dengan menggunakan penyediaan dinamis, penegakan identitas pengguna selalu diterapkan.
Ketika penegakan pengguna diaktifkan, Amazon EFS menggantikan ID pengguna dan grup klien NFS dengan identitas yang dikonfigurasi pada titik akses untuk semua operasi sistem file.
Uid/gid yang dikonfigurasi pada titik akses adalah uid/gid yang ditentukan dalam kelas penyimpanan, nilai dalam gidRangeStart-gidRangeEnd (digunakan sebagai uid/gid) yang ditentukan dalam kelas penyimpanan, atau merupakan nilai yang dipilih oleh driver apakah tidak ada uid/gid atau gidRange yang ditentukan.
Kami menyarankan penggunaan penyediaan statis jika Anda tidak ingin menggunakan penegakan identitas pengguna.

Jika Anda ingin meneruskan mountOptions lainnya ke driver Amazon EFS CSI saat melakukan pemasangan, opsi tersebut dapat diteruskan melalui objek Volume Persisten atau Kelas Penyimpanan, bergantung pada apakah penyediaan statis atau dinamis digunakan. Berikut ini adalah contoh beberapa mountOptions yang dapat diteruskan:

lookupcache : Menentukan bagaimana kernel mengelola cache entri direktori untuk titik mount tertentu. Modusnya bisa salah satu, tidak ada, pos, atau positif. Setiap mode memiliki fungsi yang berbeda-beda dan untuk informasi lebih lanjut dapat merujuk pada tautan ini.
iam : Gunakan identitas IAM Pod Node CSI untuk mengautentikasi dengan Amazon EFS.

Opsi Pemasangan Default

Saat menggunakan driver EFS CSI, ketahuilah bahwa opsi pemasangan noresvport diaktifkan secara default. Ini berarti klien dapat menggunakan port sumber apa pun yang tersedia untuk komunikasi, bukan hanya port yang dicadangkan.

Enkripsi Dalam Transit

Salah satu keuntungan menggunakan Amazon EFS adalah menyediakan dukungan enkripsi dalam transit menggunakan TLS. Dengan menggunakan enkripsi saat transit, data akan dienkripsi selama transisinya melalui jaringan ke layanan Amazon EFS. Hal ini memberikan lapisan pertahanan tambahan yang mendalam untuk aplikasi yang memerlukan kepatuhan keamanan yang ketat.

Enkripsi saat transit diaktifkan secara default di driver versi cabang master. Untuk menonaktifkannya dan memasang volume menggunakan NFSv4 biasa, setel bidang volumeAttributes encryptInTransit ke "false" dalam manifes volume persisten Anda. Untuk contoh manifes, lihat contoh enkripsi dalam transit.

Catatan
Kubernetes versi 1.13 atau lebih baru diperlukan jika Anda menggunakan fitur ini di Kubernetes.

Driver Amazon EFS CSI di Kubernetes

Bagian berikut khusus untuk Kubernetes. Jika Anda adalah pengguna Kubernetes, gunakan ini untuk mengetahui fitur driver, langkah instalasi, dan contohnya.

Matriks Kompatibilitas Versi Kubernetes

Driver Amazon EFS CSI Versi Kubernetes	kematangan	v1.11	v1.12	v1.13	v1.14	v1.15	v1.16	v1.17+
cabang utama	TIDAK	TIDAK	TIDAK	TIDAK	TIDAK	TIDAK	TIDAK	Ya
v2.1.x	TIDAK	TIDAK	TIDAK	TIDAK	TIDAK	TIDAK	TIDAK	Ya
v2.0.x	TIDAK	TIDAK	TIDAK	TIDAK	TIDAK	TIDAK	TIDAK	Ya
v1.7.x	TIDAK	TIDAK	TIDAK	TIDAK	TIDAK	TIDAK	TIDAK	Ya
v1.6.x	TIDAK	TIDAK	TIDAK	TIDAK	TIDAK	TIDAK	TIDAK	Ya
v1.5.x	TIDAK	TIDAK	TIDAK	TIDAK	TIDAK	TIDAK	TIDAK	Ya
v1.4.x	TIDAK	TIDAK	TIDAK	TIDAK	TIDAK	TIDAK	TIDAK	Ya
v1.3.x	TIDAK	TIDAK	TIDAK	TIDAK	TIDAK	TIDAK	TIDAK	Ya
v1.2.x	TIDAK	TIDAK	TIDAK	TIDAK	TIDAK	TIDAK	TIDAK	Ya
v1.1.x	TIDAK	TIDAK	TIDAK	TIDAK	Ya	Ya	Ya	Ya
v1.0.x	TIDAK	TIDAK	TIDAK	TIDAK	Ya	Ya	Ya	Ya
v0.3.0	beta	TIDAK	TIDAK	TIDAK	Ya	Ya	Ya	Ya
v0.2.0	beta	TIDAK	TIDAK	TIDAK	Ya	Ya	Ya	Ya
v0.1.0	alfa	Ya	Ya	Ya	TIDAK	TIDAK	TIDAK	TIDAK

Gambar Kontainer

Versi Driver Amazon EFS CSI	Gambar
cabang utama	amazon/aws-efs-csi-driver:master
v2.1.0	amazon/aws-efs-csi-driver:v2.1.0
v2.0.9	amazon/aws-efs-csi-driver:v2.0.9
v2.0.8	amazon/aws-efs-csi-driver:v2.0.8
v2.0.7	amazon/aws-efs-csi-driver:v2.0.7
v2.0.6	amazon/aws-efs-csi-driver:v2.0.6
v2.0.5	amazon/aws-efs-csi-driver:v2.0.5
v2.0.4	amazon/aws-efs-csi-driver:v2.0.4
v2.0.3	amazon/aws-efs-csi-driver:v2.0.3
v2.0.2	amazon/aws-efs-csi-driver:v2.0.2
v2.0.1	amazon/aws-efs-csi-driver:v2.0.1
v2.0.0	amazon/aws-efs-csi-driver:v2.0.0
v1.7.7	amazon/aws-efs-csi-driver:v1.7.7
v1.7.6	amazon/aws-efs-csi-driver:v1.7.6
v1.7.5	amazon/aws-efs-csi-driver:v1.7.5
v1.7.4	amazon/aws-efs-csi-driver:v1.7.4
v1.7.3	amazon/aws-efs-csi-driver:v1.7.3
v1.7.2	amazon/aws-efs-csi-driver:v1.7.2
v1.7.1	amazon/aws-efs-csi-driver:v1.7.1
v1.7.0	amazon/aws-efs-csi-driver:v1.7.0
v1.6.0	amazon/aws-efs-csi-driver:v1.6.0
v1.5.9	amazon/aws-efs-csi-driver:v1.5.9
v1.5.8	amazon/aws-efs-csi-driver:v1.5.8
v1.5.7	amazon/aws-efs-csi-driver:v1.5.7
v1.5.6	amazon/aws-efs-csi-driver:v1.5.6
v1.5.5	amazon/aws-efs-csi-driver:v1.5.5
v1.5.4	amazon/aws-efs-csi-driver:v1.5.4
v1.5.3	amazon/aws-efs-csi-driver:v1.5.3
v1.5.2	amazon/aws-efs-csi-driver:v1.5.2
v1.5.1	amazon/aws-efs-csi-driver:v1.5.1
v1.5.0	amazon/aws-efs-csi-driver:v1.5.0
v1.4.9	amazon/aws-efs-csi-driver:v1.4.9
v1.4.8	amazon/aws-efs-csi-driver:v1.4.8
v1.4.7	amazon/aws-efs-csi-driver:v1.4.7
v1.4.6	amazon/aws-efs-csi-driver:v1.4.6
v1.4.5	amazon/aws-efs-csi-driver:v1.4.5
v1.4.4	amazon/aws-efs-csi-driver:v1.4.4
v1.4.3	amazon/aws-efs-csi-driver:v1.4.3
v1.4.2	amazon/aws-efs-csi-driver:v1.4.2
v1.4.1	amazon/aws-efs-csi-driver:v1.4.1
v1.4.0	amazon/aws-efs-csi-driver:v1.4.0
v1.3.8	amazon/aws-efs-csi-driver:v1.3.8
v1.3.7	amazon/aws-efs-csi-driver:v1.3.7
v1.3.6	amazon/aws-efs-csi-driver:v1.3.6
v1.3.5	amazon/aws-efs-csi-driver:v1.3.5
v1.3.4	amazon/aws-efs-csi-driver:v1.3.4
v1.3.3	amazon/aws-efs-csi-driver:v1.3.3
v1.3.2	amazon/aws-efs-csi-driver:v1.3.2
v1.3.1	amazon/aws-efs-csi-driver:v1.3.1
v1.3.0	amazon/aws-efs-csi-driver:v1.3.0
v1.2.1	amazon/aws-efs-csi-driver:v1.2.1
v1.2.0	amazon/aws-efs-csi-driver:v1.2.0
v1.1.1	amazon/aws-efs-csi-driver:v1.1.1
v1.1.0	amazon/aws-efs-csi-driver:v1.1.0
v1.0.0	amazon/aws-efs-csi-driver:v1.0.0
v0.3.0	amazon/aws-efs-csi-driver:v0.3.0
v0.2.0	amazon/aws-efs-csi-driver:v0.2.0
v0.1.0	amazon/aws-efs-csi-driver:v0.1.0

Gambar ECR

Versi Pengemudi	Gambar ECR
v2.1.0	public.ecr.aws/efs-csi-driver/amazon/aws-efs-csi-driver:v2.1.0

Catatan
Anda dapat menemukan gambar versi driver efs-csi sebelumnya dari sini

Fitur

Penyediaan statis - Sistem file Amazon EFS perlu dibuat secara manual terlebih dahulu, kemudian dapat dipasang di dalam kontainer sebagai volume persisten (PV) menggunakan driver.
Penyediaan dinamis - Menggunakan klaim volume persisten (PVC) untuk menyediakan volume persisten (PV) secara dinamis. Saat Membuat PVC, kuberenetes meminta Amazon EFS untuk membuat Titik Akses dalam sistem file yang akan digunakan untuk memasang PV.
Opsi Pemasangan - Opsi pemasangan dapat ditentukan dalam volume persisten (PV) atau kelas penyimpanan untuk penyediaan dinamis guna menentukan cara pemasangan volume.
Enkripsi data saat transit - Sistem file Amazon EFS dipasang dengan enkripsi saat transit yang diaktifkan secara default di versi cabang utama driver.
Pemasangan lintas akun - Sistem file Amazon EFS dari akun aws yang berbeda dapat dipasang dari klaster Amazon EKS.
Multiarch - Gambar driver Amazon EFS CSI sekarang menjadi multiarch di ECR

Catatan
Karena Amazon EFS adalah sistem file elastis, Amazon EFS tidak benar-benar menerapkan kapasitas sistem file apa pun. Nilai kapasitas penyimpanan aktual dalam klaim volume persisten dan volume persisten tidak digunakan saat membuat sistem file. Namun, karena kapasitas penyimpanan merupakan kolom yang wajib diisi oleh Kubernetes, Anda harus menentukan nilainya dan Anda dapat menggunakan nilai apa pun yang valid untuk kapasitas tersebut.

Instalasi

Pertimbangan

Driver CSI Amazon EFS tidak kompatibel dengan citra kontainer berbasis Windows.
Anda tidak dapat menggunakan penyediaan volume persisten dinamis dengan node Fargate, namun Anda dapat menggunakan penyediaan statis.
Penyediaan dinamis memerlukan driver 1.2 atau lebih baru. Anda dapat menyediakan volume persisten secara statis menggunakan driver versi 1.1 pada versi klaster Amazon EKS yang didukung.
Versi 1.3.2 atau lebih baru dari driver ini mendukung arsitektur Arm64, termasuk instans berbasis Amazon EC2 Graviton.
Versi 1.4.2 atau lebih baru dari driver ini mendukung penggunaan FIPS untuk memasang sistem file. Untuk informasi lebih lanjut tentang cara mengaktifkan FIPS, lihat Helm.
Catat kuota sumber daya untuk Amazon EFS. Misalnya, terdapat kuota 1000 titik akses yang dapat dibuat untuk setiap sistem file Amazon EFS. Untuk informasi selengkapnya, lihat https://docs.aws.amazon.com/efs/latest/ug/limits.html#limits-efs-resources-per-account-per-region.

Konfigurasikan noda permulaan simpul

Terdapat potensi kondisi race pada permulaan node (terutama ketika sebuah node pertama kali bergabung dengan cluster) dimana pod/proses yang bergantung pada Driver EFS CSI dapat bekerja pada sebuah node sebelum Driver EFS CSI dapat memulai dan siap sepenuhnya. Untuk mengatasi hal ini, Driver EFS CSI berisi fitur untuk secara otomatis menghapus noda dari node saat startup. Fitur ini diperkenalkan dari Driver EFS CSI versi v1.7.2 dan grafik Helm versi v2.5.2. Pengguna dapat mencemari node mereka ketika mereka bergabung dengan cluster dan/atau saat startup, untuk mencegah pod lain berjalan dan/atau dijadwalkan pada node sebelum Driver EFS CSI siap.

Fitur ini diaktifkan secara default, dan administrator klaster harus menggunakan taint efs.csi.aws.com/agent-not-ready:NoExecute (efek apa pun akan berfungsi, namun NoExecute disarankan). Misalnya, Grup Node Terkelola EKS mendukung node yang tercemar secara otomatis.

Prasyarat

Penyedia AWS Identity and Access Management (IAM) OpenID Connect (OIDC) yang ada untuk klaster Anda. Untuk menentukan apakah Anda sudah memilikinya, atau akan membuatnya, lihat Membuat penyedia IAM OIDC untuk klaster Anda.
AWS CLI diinstal dan dikonfigurasi pada perangkat Anda atau AWS CloudShell. Untuk menginstal versi terbaru, lihat Menginstal, memperbarui, dan menghapus instalan AWS CLI dan Konfigurasi cepat dengan aws configure dalam Panduan Pengguna AWS Command Line Interface. Versi AWS CLI yang diinstal di AWS CloudShell mungkin juga beberapa versi di belakang versi terbaru. Untuk memperbaruinya, lihat Menginstal AWS CLI ke direktori home Anda di Panduan Pengguna AWS CloudShell.
Alat baris perintah kubectl diinstal pada perangkat Anda atau AWS CloudShell. Versinya bisa sama atau maksimal satu versi minor yang lebih awal atau lebih baru dari versi Kubernetes cluster Anda. Untuk menginstal atau mengupgrade kubectl , lihat Menginstal atau memperbarui kubectl .

Catatan
Pod yang berjalan di AWS Fargate secara otomatis memasang sistem file Amazon EFS, tanpa memerlukan langkah-langkah instalasi driver manual yang dijelaskan di halaman ini.

Siapkan izin pengemudi

Pengemudi memerlukan izin IAM untuk berbicara dengan Amazon EFS guna mengelola volume atas nama pengguna. Ada beberapa metode untuk memberikan izin IAM driver:

Menggunakan Add-on EKS Pod Identity - Instal add-on EKS Pod Identity ke klaster EKS Anda. Ini tidak memerlukan driver efs-csi untuk diinstal melalui add-on EKS, ini dapat digunakan apa pun metode instalasi driver efs-csi. Jika metode instalasi ini digunakan, kebijakan AmazonEFSCSIDriverPolicy harus ditambahkan ke IAM role grup simpul klaster.
Menggunakan IAM role untuk akun layanan – Buat IAM Role untuk akun layanan dengan izin yang diperlukan di iam-policy-example.json. Batalkan komentar pada anotasi dan tempatkan ARN peran IAM dalam manifes akun layanan. Misalnya langkah-langkahnya, lihat Membuat kebijakan dan peran IAM untuk Amazon EKS.
Menggunakan profil instans IAM – Memberikan izin yang diperlukan kepada semua node pekerja dengan melampirkan kebijakan ke profil instans pekerja.

Menyebarkan driver

Ada beberapa opsi untuk menerapkan driver. Berikut ini beberapa contohnya.

[ helm ]

Prosedur ini memerlukan Helm V3 atau lebih baru. Untuk menginstal atau mengupgrade Helm, lihat Menggunakan Helm dengan Amazon EKS.

Untuk menginstal driver menggunakan Helm

Tambahkan repo Helm.

helm repo add aws-efs-csi-driver https://kubernetes-sigs.github.io/aws-efs-csi-driver/

Perbarui repo.
```
helm repo update aws-efs-csi-driver
```

Instal rilis driver menggunakan bagan Helm.

helm upgrade --install aws-efs-csi-driver --namespace kube-system aws-efs-csi-driver/aws-efs-csi-driver

Untuk menentukan repositori gambar, tambahkan argumen berikut. Ganti alamat repositori dengan alamat gambar kontainer klaster.

--set image.repository=602401143452.dkr.ecr.region-code.amazonaws.com/eks/aws-efs-csi-driver

Jika Anda sudah membuat akun layanan dengan mengikuti Buat kebijakan dan peran IAM untuk Amazon EKS, tambahkan argumen berikut.

--set controller.serviceAccount.create=false 
--set controller.serviceAccount.name=efs-csi-controller-sa

Jika Anda tidak memiliki akses keluar ke Internet, tambahkan argumen berikut.

--set sidecars.livenessProbe.image.repository=602401143452.dkr.ecr.region-code.amazonaws.com/eks/livenessprobe 
--set sidecars.node-driver-registrar.image.repository=602401143452.dkr.ecr.region-code.amazonaws.com/eks/csi-node-driver-registrar 
--set sidecars.csiProvisioner.image.repository=602401143452.dkr.ecr.region-code.amazonaws.com/eks/csi-provisioner

Untuk memaksa driver Amazon EFS CSI menggunakan FIPS untuk memasang sistem file, tambahkan argumen berikut.

--set useFips=true

Catatan
hostNetwork: true (harus ditambahkan pada spesifikasi/penerapan pada instalasi kubernetes di mana metadata AWS tidak dapat dijangkau dari jaringan pod. Untuk memperbaiki kesalahan berikut NoCredentialProviders: no valid providers in chain parameter ini harus ditambahkan.)

[Manifes (registrasi pribadi)]

Jika Anda ingin mengunduh gambar dengan manifes, kami sarankan terlebih dahulu mencoba langkah-langkah ini untuk menarik gambar aman dari registri Amazon ECR pribadi.

Untuk menginstal driver menggunakan gambar yang disimpan di registri Amazon ECR pribadi

Unduh manifesnya. Ganti release-XX dengan cabang yang Anda inginkan. Kami merekomendasikan menggunakan versi rilis terbaru. Untuk daftar cabang aktif, lihat Cabang.
```
kubectl kustomize 
    " github.com/kubernetes-sigs/aws-efs-csi-driver/deploy/kubernetes/overlays/stable/ecr/?ref=release-2.X " > private-ecr-driver.yaml
```
Catatan
Jika Anda mengalami masalah yang tidak dapat diselesaikan dengan menambahkan izin IAM, cobalah langkah-langkah Manifes (registrasi publik).
Pada perintah berikut, ganti region-code dengan Wilayah AWS tempat klaster Anda berada. Kemudian jalankan perintah yang dimodifikasi untuk mengganti us-west-2 dalam file dengan Wilayah AWS Anda.
```
sed -i.bak -e ' s|us-west-2|region-code| ' private-ecr-driver.yaml
```
Ganti account dalam perintah berikut dengan akun dari registri citra kontainer Amazon untuk Wilayah AWS tempat klaster Anda berada, lalu jalankan perintah yang dimodifikasi untuk mengganti 602401143452 dalam file.
```
sed -i.bak -e ' s|602401143452|account| ' private-ecr-driver.yaml
```
Jika Anda sudah membuat akun layanan dengan mengikuti Buat kebijakan dan peran IAM untuk Amazon EKS, lalu edit file private-ecr-driver.yaml . Hapus baris berikut yang membuat akun layanan Kubernetes.
```
 apiVersion: v1
kind: ServiceAccount
metadata:
  labels:
    app.kubernetes.io/name: aws-efs-csi-driver
  name: efs-csi-controller-sa
  namespace: kube-system
---
```

Terapkan manifes.

kubectl apply -f private-ecr-driver.yaml

[ Manifes (registrasi publik) ]

Untuk beberapa situasi, Anda mungkin tidak dapat menambahkan izin IAM yang diperlukan untuk diambil dari registri Amazon ECR pribadi. Salah satu contoh skenario ini adalah jika perwakilan IAM Anda tidak diizinkan untuk mengautentikasi dengan akun orang lain. Jika hal ini benar, Anda dapat menggunakan registri Amazon ECR publik.

Untuk menginstal driver menggunakan gambar yang disimpan di registri Amazon ECR publik

Unduh manifesnya. Ganti release-XX dengan cabang yang Anda inginkan. Kami merekomendasikan menggunakan versi rilis terbaru. Untuk daftar cabang aktif, lihat Cabang.
```
kubectl kustomize 
    " github.com/kubernetes-sigs/aws-efs-csi-driver/deploy/kubernetes/overlays/stable/?ref=release-2.X " > public-ecr-driver.yaml
```
Jika Anda sudah membuat akun layanan dengan mengikuti Buat kebijakan dan peran IAM, lalu edit file public-ecr-driver.yaml . Hapus baris berikut yang membuat akun layanan Kubernetes.
```
apiVersion: v1
kind: ServiceAccount
metadata:
  labels:
    app.kubernetes.io/name: aws-efs-csi-driver
  name: efs-csi-controller-sa
  namespace: kube-system
---
```
Terapkan manifes.
```
kubectl apply -f public-ecr-driver.yaml
```

Setelah menerapkan driver, Anda dapat melanjutkan ke bagian berikut:

Buat sistem file Amazon EFS untuk Amazon EKS
Contoh

Argumen Kontainer untuk efs-plugin daemonset efs-csi-node

Parameter	Bawaan	Opsional	Keterangan
vol-metrik-keikutsertaan	PALSU	BENAR	Ikut serta untuk mengeluarkan metrik volume.
periode penyegaran vol-metrik	240	BENAR	Periode penyegaran untuk metrik volume dalam hitungan menit.
vol-metrik-fs-batas laju	5	BENAR	Pembatas laju rutinitas metrik volume per sistem file.

Memahami Dampak keikutsertaan vol-metrik:

Mengaktifkan parameter vol-metrics-opt-in akan mengaktifkan pengumpulan data penggunaan inode dan disk. Fungsionalitas ini, khususnya dalam skenario dengan sistem file yang lebih besar, dapat mengakibatkan peningkatan penggunaan memori karena agregasi informasi sistem file yang mendetail. Kami menyarankan pengguna dengan sistem file skala besar untuk mempertimbangkan aspek ini ketika memanfaatkan fitur ini.

Argumen Kontainer untuk penerapan (pengontrol)

Parameter	Nilai-nilai	Bawaan	Opsional	Keterangan
hapus-titik-akses-root-dir		PALSU	BENAR	Ikut serta untuk menghapus direktori akar titik akses dengan DeleteVolume. Secara default, DeleteVolume akan menghapus titik akses di belakang Volume Persisten dan menghapus titik akses tidak akan menghapus direktori akar titik akses atau isinya.
tag			BENAR	Pasangan kunci:nilai yang dipisahkan spasi yang akan ditambahkan sebagai tanda untuk sumber daya Amazon EFS. Misalnya, '--tags=nama:efs-tag-tanggal pengujian:24 Januari'

Meningkatkan Driver CSI Amazon EFS

Tingkatkan ke versi terbaru:

Jika Anda ingin memperbarui ke versi rilis terbaru:

kubectl apply -k " github.com/kubernetes-sigs/aws-efs-csi-driver/deploy/kubernetes/overlays/stable/?ref=release-2.0 "

Tingkatkan ke versi tertentu:

Jika Anda ingin memperbarui ke versi tertentu, sesuaikan dulu file driver yaml secara lokal:

kubectl kustomize " github.com/kubernetes-sigs/aws-efs-csi-driver/deploy/kubernetes/overlays/stable/?ref=release-2.0 " > driver.yaml

Kemudian, perbarui semua baris yang merujuk image: amazon/aws-efs-csi-driver ke versi yang diinginkan (misalnya, ke image: amazon/aws-efs-csi-driver:v2.1.0 ) di file yaml, dan terapkan driver yaml lagi:

kubectl apply -f driver.yaml

Contoh

Sebelum mengikuti contoh, Anda perlu:

Pahami cara menyiapkan Kubernetes di AWS dan cara membuat sistem file Amazon EFS.
Saat membuat sistem file Amazon EFS, pastikan sistem tersebut dapat diakses dari klaster Kubernetes. Hal ini dapat dicapai dengan membuat sistem file di dalam VPC yang sama dengan cluster Kubernetes atau menggunakan peering VPC.
Instal driver Amazon EFS CSI dengan mengikuti langkah-langkah Instalasi.

Tautan contoh

Penyediaan statis
Penyediaan dinamis
Enkripsi dalam perjalanan
Mengakses sistem file dari beberapa pod
Gunakan Amazon EFS di StatefulSets
Pasang subjalur
Gunakan Titik Akses

Menggunakan botocore untuk mengambil alamat ip target pemasangan ketika nama dns tidak dapat diselesaikan

Driver Amazon EFS CSI mendukung penggunaan botocore untuk mengambil alamat ip target pemasangan ketika nama dns tidak dapat diselesaikan, misalnya, ketika pengguna memasang sistem file di VPC lain, botocore sudah diinstal sebelumnya pada efs-csi-driver yang dapat mengatasi masalah DNS ini.
Prasyarat kebijakan IAM untuk menggunakan fitur ini :
Izinkan tindakan elasticfilesystem:DescribeMountTargets dan ec2:DescribeAvailabilityZones dalam kebijakan Anda yang dilampirkan pada peran akun layanan Amazon EKS, lihat contoh kebijakan di sini.

Perkembangan

Silakan baca Spesifikasi CSI dan Dokumentasi Pengembang CSI Kubernetes untuk mendapatkan pemahaman dasar tentang driver CSI sebelum Anda mulai.
Jika Anda akan memperbarui file kebijakan iam, harap perbarui juga kebijakan efs di weaveworks/eksctl https://github.com/weaveworks/eksctl/blob/main/pkg/cfn/builder/statement.go */

Persyaratan

Golang 1.13.4+

Ketergantungan

Dependensi dikelola melalui modul go. Untuk membangun proyek, pertama-tama aktifkan go mod menggunakan export GO111MODULE=on , untuk membangun proyek, jalankan: make