This topic describes how to mount a data disk to the Docker data directory. When the disk space is insufficient to support the increase in the number of containers or images on a node, you can mount a data disk to the Docker data directory. This provides more storage space to create containers and store images.
Docker data directory
Docker data is stored in a union file system (UnionFS) on a disk. The default container data and image data of Docker is stored in the /var/lib/docker directory. You can run the du command to view the disk space that is occupied by this directory:
du -h --max-depth=0 /var/lib/docker
Mount a data disk
A Docker image may be large in size. A few images may occupy a large amount of disk space. The disk capacity may be insufficient if you store large-sized images or create a large number of containers. In this case, you must mount a data disk to the Docker data directory. This provides storage space for these images and containers.
- Create a data disk and mount it to the node for which you want to expand the disk.
For more information, see Create a disk.
- Log on to the Elastic Compute Service (ECS) console and create a disk.
- In the left-side navigation pane, choose .
- On the Instances page, click the ID of the ECS instance that you want to manage. Then, you are directed to the instance details page.
- Click the Cloud Disk tab.
- On the Cloud Disk tab, click Attach Disk in the upper-right corner of the page.
- In the Attach Disk dialog box, select the created disk from the Target Disk drop-down list. Click OK.
- Click Attach to attach the disk to the ECS instance. Record the mount point
- Log on to the ECS instance and format the mounted disk.
- Run the ls -l /dev/xvd* or ls -l /dev/vd* command to check whether the returned mount point is the same as that you have recorded.
- Run the fdisk command to partition the disk and run the mkfs.ext4 command to format the disk.
- Migrate the Docker data to the disk. If you do not want to suspend the applications that run on the node, you must migrate the applications. For more information about how to migrate applications that run in a Container Service for Swarm cluster, see Schedule an application to specified nodes. For more information about how to migrate applications that run in a Container Service for Kubernetes (ACK) cluster, see Safely Drain a Node while Respecting Application SLOs.
- To ensure data integrity during the migration process, stop the Docker daemon and kubelet. You can run the service docker stop command to stop the Docker daemon and run the service kubelet stop command to stop kubelet.
- Move the Docker data directory to a backup directory, such as mv /var/lib/docker /var/lib/docker_data.
- Mount the formatted disk to the /var/lib/docker and /var/lib/kubelet directories. Example:
echo "/dev/xvdb1 /var/lib/container/ ext4 defaults 0 0" >>/etc/fstab echo "/var/lib/container/kubelet /var/lib/kubelet none defaults,bind 0 0" >>/etc/fstab echo "/var/lib/container/docker /var/lib/docker none defaults,bind 0 0" >>/etc/fstab mkdir /var/lib/docker mount -a
- Migrate the Docker data that has been backed up to a directory of the formatted disk, such as mv /var/lib/docker_data/* /var/lib/docker/.
- Start the Docker daemon and kubelet, and check where the data is stored.
- Run the service docker start command to start the Docker daemon and run the service kubelet start command to start kubelet.
- Run the df command to check whether /var/lib/docker has been mounted to the disk. If you want to start the Kubernetes cluster, skip this
- Run the docker ps command to check whether containers are lost. Restart containers as required. For
example, you can restart containers that do not have the
- If a container has been migrated to other nodes, you can schedule it back to the node
to which you have attached the disk.
For more information, see Container Service for Kubernetes.