Mount an emptyDir volume to an elastic container instance - Elastic Container Instance

Volume emptyDir adalah direktori kosong yang digunakan untuk menyimpan data secara sementara dan memfasilitasi berbagi data antar kontainer. Topik ini menjelaskan cara memasang volume emptyDir ke Elastic Container Instance.

Peringatan

Volume emptyDir digunakan untuk menyimpan data secara sementara. Saat Elastic Container Instance tempat volume emptyDir dipasang dihapus atau di-restart, data yang tersimpan dalam volume emptyDir akan dihapus.

Deskripsi konfigurasi (mode API)

Saat Anda memanggil operasi API CreateContainerGroup untuk membuat Elastic Container Instance, Anda dapat menggunakan parameter terkait Volume untuk menentukan volume, lalu menggunakan parameter Container.VolumeMount terkait untuk memasang volume tersebut ke kontainer. Bagian berikut menggambarkan parameter terkait. Untuk informasi lebih lanjut, lihat CreateContainerGroup.

Tentukan volume yang akan dipasang

Saat menggunakan parameter terkait Volume untuk menentukan volume, Anda harus terlebih dahulu menentukan jenis dan nama volume tersebut. Kemudian, konfigurasikan parameter Volume lainnya berdasarkan nilai dari parameter Volume.N.Type.

Parameter	Tipe	Contoh	Deskripsi
Volume.N.Name	String	emptydir-demo	Nama volume N.
Volume.N.Type	String	EmptyDirVolume	Nilai EmptyDirVolume menunjukkan bahwa volume emptyDir akan dibuat.
Volume.N.EmptyDirVolume.Medium	String	Memory	Media penyimpanan volume emptyDir N. Parameter ini kosong secara default, yang menunjukkan bahwa sistem file node digunakan sebagai media penyimpanan. Nilai yang valid: Memory: menggunakan memori sebagai media penyimpanan. LocalRaid0: membentuk disk lokal menjadi RAID 0. Nilai ini hanya berlaku untuk skenario di mana instance kontainer elastis dengan disk lokal dipasang dibuat. Untuk informasi lebih lanjut, lihat Tentukan tipe Instance ECS yang menggunakan disk lokal untuk membuat instance kontainer elastis.
Volume.N.EmptyDirVolume.SizeLimit	String	256Mi	Ukuran penyimpanan volume emptyDir N. Saat Anda menentukan parameter ini, unit diperlukan. Kami merekomendasikan Anda menggunakan Gi atau Mi sebagai unit.

Catatan

Jika Anda mengatur Volume.N.EmptyDirVolume.Medium ke Memory, Anda dapat mengatur Volume.N.EmptyDirVolume.SizeLimit untuk memodifikasi ukuran shm instance tersebut. Setelah mengatur kedua parameter tersebut, Anda harus memasang volume emptyDir ke direktori /dev/shm dari kontainer.

Pasang volume

Setelah menentukan volume, Anda dapat menggunakan parameter terkait VolumeMount untuk memasang volume tersebut ke kontainer.

Parameter	Tipe	Contoh	Deskripsi
Container.N.VolumeMount.N.Name	String	test-volume	Nama volume N yang akan dipasang ke kontainer N. Nilai ini adalah nilai dari Volume.N.Name.
Container.N.VolumeMount.N.MountPath	String	/usr/share	Direktori tempat volume N dipasang. Data di bawah direktori ini ditimpa oleh data pada volume. Pastikan nilai ini benar.
Container.N.VolumeMount.N.SubPath	String	/usr/sub	Subdirektori volume. Parameter ini menentukan subdirektori berbeda dari volume yang sama yang dapat dipasang oleh instance ke subdirektori berbeda dari kontainer.
Container.N.VolumeMount.N.ReadOnly	Boolean	false	Menentukan apakah direktori pemasangan bersifat hanya-baca. Nilai default: false.
Container.N.VolumeMount.N.MountPropagation	String	None	Pengaturan propagasi pemasangan volume N. Propagasi pemasangan memungkinkan Anda berbagi volume yang dipasang ke satu kontainer ke kontainer lain dalam instance kontainer elastis yang sama, atau bahkan ke instance kontainer elastis lain pada host yang sama. Nilai yang valid: None: Pemasangan volume tidak menerima pemasangan berikutnya yang dipasang ke volume ini atau subdirektorinya. HostToContainer: Pemasangan volume menerima semua pemasangan berikutnya yang dipasang ke volume ini atau subdirektorinya. Bidirectional: Nilai ini memiliki efek serupa dengan HostToContainer. Pemasangan volume menerima semua pemasangan berikutnya yang dipasang ke volume ini atau subdirektorinya. Selain itu, semua pemasangan volume yang dibuat oleh kontainer N disebarkan kembali ke host dan ke semua kontainer dari semua instance kontainer elastis yang menggunakan volume yang sama. Nilai default: None.

Catatan

Volume juga dapat dipasang ke init kontainer. Parameter yang diperlukan mirip dengan parameter dalam tabel sebelumnya. Anda hanya perlu mengubah Container menjadi InitContainer.

Konfigurasi (mode konsol)

Saat membuat Elastic Container Instance di halaman pembelian Elastic Container Instance, Anda dapat menentukan volume di bagian Konfigurasi Grup Kontainer dan kemudian memasang volume tersebut ke kontainer di bagian Konfigurasi Kontainer.

Tentukan volume yang akan dipasang

Di bagian Container Group Configurations dari langkah Pengaturan Dasar wizard Buat Grup Kontainer, klik Advanced Settings.
Di bagian Storage, klik tab Temporary Directories dan kemudian klik Add.
Di bidang Nama, masukkan nama untuk volume emptyDir.

Pasang volume

Di bagian Container Configurations dari langkah Pengaturan Dasar wizard Buat Grup Kontainer, pilih kontainer dan klik Pengaturan Lanjutan dari kontainer tersebut.
Aktifkan Storage dan klik Add.
Anda hanya dapat menambahkan volume yang telah ditentukan di bagian Konfigurasi Grup Kontainer.

Catatan

Jika ingin memasang volume ke beberapa kontainer, pilih lebih banyak kontainer dan ulangi operasi sebelumnya.

Contoh konfigurasi

Kode berikut memberikan contoh parameter yang perlu dikonfigurasikan saat memanggil operasi API CreateContainerGroup untuk membuat Elastic Container Instance dan memasang volume emptyDir ke instance tersebut. Untuk informasi lebih lanjut, lihat CreateContainerGroup.

Contoh 1: Berbagi data antar kontainer

ContainerGroupName=test-emptydir
# Tentukan volume yang akan dipasang.
Volume.1.Name=emptydir-demo
Volume.1.Type=EmptyDirVolume
# Pasang volume ke Kontainer 1.
Container.1.Name=nginx
Container.1.Image=registry-vpc.cn-hangzhou.aliyuncs.com/eci_open/nginx:1.14.2
Container.1.VolumeMount.1.Name=emptydir-demo
Container.1.VolumeMount.1.MountPath=/data1
# Pasang volume ke Kontainer 2.
Container.2.Name=busybox
Container.2.Image=registry-vpc.cn-hangzhou.aliyuncs.com/eci_open/busybox:1.30
Container.2.Command.1=sleep
Container.2.Arg.1=999999
Container.2.VolumeMount.1.Name=emptydir-demo
Container.2.VolumeMount.1.MountPath=/data2

Dalam contoh di atas, volume emptyDir dibagikan antara Kontainer 1 dan Kontainer 2. Direktori /data1 dari Kontainer 1 dan direktori /data2 dari Kontainer 2 kosong secara default. File yang ditambahkan ke volume emptyDir di satu kontainer dapat diakses dari kontainer lain.

Contoh 2: Modifikasi ukuran shm sebuah instance

ContainerGroupName=test-emptydir
# Tentukan volume yang akan dipasang.
Volume.1.Name=emptydir-shm
Volume.1.Type=EmptyDirVolume
Volume.1.EmptyDirVolume.Medium=Memory
Volume.1.EmptyDirVolume.SizeLimit=256Mi
# Pasang volume ke Kontainer 1.
Container.1.Name=nginx
Container.1.Image=registry-vpc.cn-hangzhou.aliyuncs.com/eci_open/nginx:1.14.2
Container.1.VolumeMount.1.Name=emptydir-shm
Container.1.VolumeMount.1.MountPath=/dev/shm

Dalam contoh di atas, EmptyDirVolume.Medium diatur ke Memory, EmptyDirVolume.SizeLimit diatur ke 256Mi, dan volume emptyDir dipasang ke direktori /dev/shm. Dengan cara ini, ukuran shm instance kontainer elastis dimodifikasi menjadi 256 MiB.