Elastic Container Instance:Mount a disk volume

Precautions

• Only pay-as-you-go disks can be mounted. For more information, see EBS devices.

• Disks cannot be shared. A disk can be mounted to only one instance.

• A maximum of six disk volumes can be mounted to an elastic container instance.

• The instance to which a disk is mounted must reside in the same zone as the disk.

• NVMe disks, for which the multi-mount feature is enabled, cannot be mounted to elastic container instances.

• You cannot mount a disk that has partitions.

Configuration description

When you call the CreateContainerGroup API operation to create an elastic container instance, you can use Volume-related parameters to specify volumes, and then use Container.VolumeMount-related parameters to mount the volumes to containers. The following part describes the relevant parameters. For more information, see CreateContainerGroup.

Specify the volume to be mounted

When you use Volume-related parameters to specify volumes, you must first specify the types and names of the volumes. Then, you must configure other Volume-related parameters based on the value of the Volume.N.Type parameter.

Configuration examples

• Call an API operation

  Call the CreateContainerGroup API operation to create an elastic container instance and mount a disk to the instance as a volume. The following part describes the parameters. For more information, see CreateContainerGroup.

  • Example 1: (Statically) Specify an existing disk

    ContainerGroupName=test-disk1
    SecurityGroupId=sg-bp1daxpbz9lzpvvc****
    VSwitchId=vsw-bp1gds63lmlm7ib05****
    # Specify the volume to be mounted.
    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****"}
    # Mount the volume to a container.
    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

    Note

    When you statically specify an existing disk, the specified disk must be in the Pending state and reside in the same zone as the elastic container instance.

  • Example 2: (Dynamically) Create a new disk

    ContainerGroupName=test-disk2
    # Specify the volume to be mounted.
    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"}
    # Mount the volume to a container.
    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

• Use SDK for Python

  Use SDK for Python of v1.0.8 or later to create an elastic container instance for running the MySQL application. The data files of the MySQL application are stored on the disk whose ID is d-2zefzudpm3649e****. Sample code:

  from aliyunsdkeci.request.v20180808.CreateContainerGroupRequest import CreateContainerGroupRequest
  request = CreateContainerGroupRequest()
  request.set_SecurityGroupId(secureGroup-xxx)
  request.set_VSwitchId(vSwitch-xxx)
  request.set_ContainerGroupName(name-xxx)
  request.set_EipInstanceId(eip-xxx)
  request.set_RestartPolicy('Always')
  # volume1 is a disk volume, which is used to store MySQL data files.
  volume1 = {
      'Name': 'mysql-data-volume',
      'Type': 'FlexVolume',
      'FlexVolume.Driver': 'alicloud/disk'
      'FlexVolume.FsType': 'ext4',
      'FlexVolume.Options': '{\"volumeId\": \"d-2zefzudpm3649e****\"}',
  }
  # volume2 is a ConfigFile volume, which is used to pass in configuration data. Content must be Base64-encoded.
  configFileToPath = {
      'Path': 'my.cnf',
      'Content': 'aGVsbG8gd29ybGQ=',
  }
  volume2 = {
      'Name': 'mysql-config-volume',
      'Type': 'ConfigFileVolume',
      'ConfigFileVolume.ConfigFileToPaths': [configFileToPath],
  }
  # Attach the two volumes to the elastic container instance.
  request.set_Volumes([volume1, volume2])
  # Configure volumeMounts-related parameters to mount the two volumes to container directories.
  volume_mount1 = {
      'Name': 'mysql-data-volume',
      'MountPath': '/var/lib/mysql',
      'ReadOnly': False,
  }
  volume_mount2 = {
      'Name': 'mysql-config-volume',
      'MountPath': '/etc/mysql/conf.d/',
      'ReadOnly': False,
  }
  #environment variable
  env ={
      'Key': 'MYSQL_ROOT_PASSWORD',
      'Value': '123456',
  }
  #container ports
  port = {
      'Protocol':'TCP',
      'Port': 3306,
  }
  # containers
  container = {
      'Image': 'mysql:5.7',
      'Name': 'mysql',
      'Cpu': 0.5,
      'Memory': 1.0,
      'ImagePullPolicy': 'Always',
      'VolumeMounts': [volume_mount1, volume_mount2],
      'EnvironmentVars': [env],
      'Ports': [port],
  }
  request.set_Containers([container])
  response = eciClient.do_action_with_exception(request)
  print response