Volume ConfigFile adalah jenis volume yang menyimpan file konfigurasi, memungkinkan Anda menyuntikkan data konfigurasi ke dalam instans Elastic Container Instance (ECI). Topik ini menjelaskan cara memasang volume ConfigFile pada instans ECI.
Batasan
Dalam volume ConfigFile, ukuran satu file konfigurasi tidak boleh melebihi 32 KB, dan ukuran total semua file konfigurasi tidak boleh melebihi 60 KB.
Konfigurasi (API)
Saat memanggil operasi API CreateContainerGroup untuk membuat instans Elastic Container Instance, Anda dapat menggunakan parameter terkait Volume untuk menentukan volume, lalu menggunakan parameter terkait Container.VolumeMount untuk memasang volume tersebut ke kontainer. Parameter terkait dijelaskan di bawah ini. Untuk informasi selengkapnya, lihat CreateContainerGroup.
Deklarasikan volume
Saat menggunakan parameter terkait Volume untuk menentukan volume, Anda harus terlebih dahulu menentukan tipe dan nama volume tersebut. Selanjutnya, konfigurasikan parameter Volume lainnya berdasarkan nilai parameter Volume.N.Type.
|
Parameter |
Tipe |
Contoh |
Deskripsi |
|
Volume.N.Name |
String |
test-volume |
Nama volume. |
|
Volume.N.Type |
String |
ConfigFileVolume |
Atur nilainya ke |
|
Volume.N.ConfigFileVolume.ConfigFileToPath.N.Path |
String |
test/config-test.cnf |
Jalur file konfigurasi, relatif terhadap direktori mount. |
|
Volume.N.ConfigFileVolume.ConfigFileToPath.N.Content |
String |
bGl1bWk= |
Konten file konfigurasi yang telah dikodekan Base64. |
|
Volume.N.ConfigFileVolume.DefaultMode |
Integer |
0644 |
Izin default untuk file konfigurasi, ditentukan sebagai angka oktal empat digit. Sebagai contoh, Izin tersebut dijelaskan sebagai berikut:
|
|
Volume.N.ConfigFileVolume.ConfigFileToPath.N.Mode |
Integer |
0644 |
Izin untuk file konfigurasi, ditentukan sebagai angka oktal empat digit. Jika parameter ini dihilangkan, nilai Sebagai contoh, Izin tersebut dijelaskan sebagai berikut:
|
Memasang 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 sama dengan nilai Volume.N.Name. |
Container.N.VolumeMount.N.MountPath | String | /usr/share | Jalur di dalam kontainer tempat volume dipasang. Data dalam direktori ini akan tertutup oleh data pada volume. |
Container.N.VolumeMount.N.SubPath | String | /usr/sub | Subdirektori dari volume. Parameter ini menentukan subdirektori berbeda dari volume yang sama yang dapat dipasang oleh instans ke subdirektori berbeda di kontainer. |
Container.N.VolumeMount.N.ReadOnly | Boolean | false | Menentukan apakah direktori mount bersifat read-only. Nilai default: false. |
Container.N.VolumeMount.N.MountPropagation | String | None | Pengaturan propagasi mount untuk volume N. Propagasi mount memungkinkan Anda berbagi volume yang dipasang ke satu kontainer dengan kontainer lain dalam instans elastic container yang sama, atau bahkan dengan instans elastic container lain pada host yang sama. Nilai yang valid:
Nilai default: None. |
Volume juga dapat dipasang ke init container. Parameter yang diperlukan mirip dengan parameter pada tabel di atas; cukup ganti Container menjadi InitContainer.
Konfigurasi (Konsol)
Saat membuat instans Elastic Container Instance di halaman pembelian Elastic Container Instance, Anda dapat menentukan volume di bagian Container Group Configurations, lalu memasang volume tersebut ke kontainer di bagian Container Configurations.
Deklarasikan volume
-
Di bagian Container Group Configurations, buka Advanced Settings.
-
Di Storage, pilih tab Configuration Item, lalu klik Add.
-
Konfigurasikan parameter untuk volume ConfigFile.
-
Name: Nama volume ConfigFile.
-
Configuration File Path: Jalur file konfigurasi relatif terhadap direktori mount.
-
Content: Masukkan konten teks biasa dari file konfigurasi. Konsol secara otomatis mengkodekannya ke Base64.
-
Memasang volume
-
Di bagian Container Configurations, pilih sebuah kontainer dan buka Advanced Settings-nya.
-
Aktifkan Storage, lalu klik Add.
Hanya volume yang telah Anda deklarasikan di bagian Container Group Configurations yang tersedia untuk dipasang.
Pilih volume configfile-demo bertipe Configuration Item, atur jalur mount di kontainer ke
/data, dan jangan centang opsi Read-only.
Jika ingin memasang volume ke beberapa kontainer, pilih lebih banyak kontainer dan ulangi langkah-langkah di atas.
Contoh konfigurasi
Panggil operasi CreateContainerGroup untuk membuat instans ECI dan pasang volume ConfigFile ke dalamnya. Contoh berikut menunjukkan parameter permintaan yang diperlukan. Untuk informasi selengkapnya, lihat CreateContainerGroup.
ContainerGroupName=test-configfile
#Deklarasikan volume
Volume.1.Name=configfile-demo
Volume.1.Type=ConfigFileVolume
Volume.1.ConfigFileVolume.ConfigFileToPath.1.Path=test/config-test.cnf
Volume.1.ConfigFileVolume.ConfigFileToPath.1.Content=c2VydmVyLnBvcnQgPSA4MDgw
Volume.1.ConfigFileVolume.DefaultMode=0644
#Pasang volume ke kontainer
Container.1.Name=nginx
Container.1.Image=registry-vpc.cn-hangzhou.aliyuncs.com/eci_open/nginx:1.14.2
Container.1.VolumeMount.1.Name=configfile-demo
Container.1.VolumeMount.1.MountPath=/data