全部产品
Search
文档中心

Elastic Container Instance:Mount disk volume ke instance kontainer elastis

更新时间:Jul 06, 2025

Disk adalah produk penyimpanan tingkat blok yang disediakan oleh Alibaba Cloud. Disk menawarkan latensi rendah, performa tinggi, daya tahan tinggi, dan keandalan tinggi. Anda dapat menggunakan plug-in FlexVolume untuk memasang disk ke instance kontainer elastis sebagai volume. Topik ini menjelaskan cara memasang volume disk ke instance kontainer elastis.

Perhatian

  • Hanya disk dengan model bayar sesuai pemakaian yang dapat dipasang. Untuk informasi lebih lanjut, lihat Perangkat EBS.

  • Disk tidak dapat dibagi. Sebuah disk hanya dapat dipasang ke satu instance.

  • Maksimum enam volume disk dapat dipasang ke instance kontainer elastis.

  • Instance tempat disk dipasang harus berada di zona yang sama dengan disk tersebut.

  • Disk NVMe, yang fitur multi-mount-nya diaktifkan, tidak dapat dipasang ke instance kontainer elastis.

  • Anda tidak dapat memasang disk yang memiliki partisi.

Deskripsi konfigurasi

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

Tentukan volume yang akan dipasang

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

Parameter

Tipe

Contoh

Deskripsi

Volume.N.Name

String

disk-demo

Nama dari volume N.

Volume.N.Type

String

FlexVolume

Setel nilai menjadi FlexVolume. Nilai ini menentukan volume yang dipasang menggunakan plug-in FlexVolume.

Volume.N.FlexVolume.Driver

String

alicloud/disk

Jenis driver saat menggunakan plug-in FlexVolume untuk memasang volume. Setel nilai menjadi alicloud/disk, yang menentukan pemasangan disk Alibaba Cloud.

Volume.N.FlexVolume.FsType

String

ext4

Tipe sistem file. Pilih tipe sistem file disk. Nilai valid: ext4, ext3, xfs, dan vfat. Nilai default: ext4.

Volume.N.FlexVolume.Options

String

{"volumeSize":"50","tags":"test:eci"}

Opsi saat Anda menyetel parameter Volume.N.Type ke FlexVolume. Setiap opsi adalah pasangan kunci-nilai dalam string JSON.

Saat menggunakan plug-in FlexVolume untuk memasang disk, parameter ini mewakili parameter konfigurasi volume disk. Parameter berikut dapat dikonfigurasi:

Penting

Jika Anda tidak menentukan parameter volumeId, Anda harus menentukan parameter volumeSize. Jika Anda menentukan parameter volumeId, nilai parameter atribut disk seperti volumeSize diabaikan.

  • (Statis) Tentukan disk yang ada

    • volumeId: ID disk.

  • (Dinamis) Buat disk baru

    • volumeSize: ukuran disk. Nilai valid: 20 hingga 32768. Unit: GiB.

      Catatan

      Jika disk yang akan dibuat didasarkan pada snapshot (Anda menggunakan parameter snapshotId untuk menentukan snapshot), ukuran sebenarnya dari disk yang dibuat adalah nilai terbesar dari dua nilai berikut:

      • Nilai parameter volumeSize

      • Ukuran disk yang dibuat berdasarkan snapshot.

    • performanceLevel: level performa disk. Sistem secara otomatis menggunakan SSD yang ditingkatkan (ESSD) sebagai volume. Anda tidak dapat menentukan kategori disk. Untuk informasi lebih lanjut, lihat ESSDs.

    • deleteWithInstance: menentukan apakah akan melepaskan disk saat instance kontainer elastis dilepaskan. Nilai default: true.

    • encrypted: menentukan apakah akan mengenkripsi disk. Nilai default: false. Untuk informasi lebih lanjut, lihat Ikhtisar Enkripsi.

    • kmsKeyId: ID kunci Key Management Service (KMS) yang digunakan untuk mengenkripsi disk.

    • tags: tag yang akan diikat ke disk. Anda dapat mengikat hingga 20 tag. Format: "tagkey1:tagvalue1,tagkey2:tagvalue2".

    • snapshotId: ID snapshot. Snapshot adalah file data stateful dari disk pada titik waktu tertentu. Anda dapat memperoleh data pada disk yang dibuat berdasarkan snapshot. Untuk informasi lebih lanjut tentang snapshot, lihat Ikhtisar.

      Catatan

      Jika disk yang dibuat berdasarkan snapshot memiliki partisi, Anda tidak dapat memasang disk tersebut ke instance kontainer elastis.

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 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 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 valid:

  • None: Pemasangan volume tidak menerima pemasangan selanjutnya yang dipasang ke volume ini atau subdirektorinya.

  • HostToContainer: Pemasangan volume menerima semua pemasangan selanjutnya yang dipasang ke volume ini atau subdirektorinya.

  • Bidirectional: Nilai ini memiliki efek serupa dengan HostToContainer. Pemasangan volume menerima semua pemasangan selanjutnya 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.

Contoh konfigurasi

Panggil operasi API CreateContainerGroup untuk membuat instance kontainer elastis dan pasang disk ke instance sebagai volume. Bagian berikut menjelaskan parameter. Untuk informasi lebih lanjut, lihat CreateContainerGroup.

  • Contoh 1: (Statis) Tentukan disk yang ada

    ContainerGroupName=test-disk1
    SecurityGroupId=sg-bp1daxpbz9lzpvvc****
    VSwitchId=vsw-bp1gds63lmlm7ib05****
    # Tentukan volume yang akan dipasang.
    Volume.1.Name=disk-demo
    Volume.1.Type=FlexVolume
    Volume.1.FlexVolume.Driver=alicloud/disk
    Volume.1.FlexVolume.FsType=ext4
    Volume.1.FlexVolume.Options={"volumeId":"d-2zebuamrpar7xnj****"}
    # 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=disk-demo
    Container.1.VolumeMount.1.MountPath=/data
    Catatan

    Saat secara statis menentukan disk yang ada, disk yang ditentukan harus dalam status Pending dan berada di zona yang sama dengan instance kontainer elastis.

  • Contoh 2: (Dinamis) Buat disk baru

    ContainerGroupName=test-disk2
    # Tentukan volume yang akan dipasang.
    Volume.1.Name=disk-demo
    Volume.1.Type=FlexVolume
    Volume.1.FlexVolume.Driver=alicloud/disk
    Volume.1.FlexVolume.FsType=ext4
    Volume.1.FlexVolume.Options={"volumeSize":"50","tags":"test:eci"}
    # 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=disk-demo
    Container.1.VolumeMount.1.MountPath=/data