diff --git a/Docker_Config_UoD_ESS.md b/Docker_Config_UoD_ESS.md new file mode 100644 index 00000000..11c2eac2 --- /dev/null +++ b/Docker_Config_UoD_ESS.md @@ -0,0 +1,57 @@ +UoD Deployment Note +=================== +For deployments to UoD only, mount docker data root folder on ESS, use the followings instructions and update the docker configuration before deployment. + +This configuration change is not required for deployments to other environments. + +Instructions +------------ + +* Opens a terminal session as the root + + sudo su + +* Create the virtual disk (40 GB, it can be increased it in the future if needed) + + dd if=/dev/zero of=/uod/idr/scratch/docker-storage.img bs=1G count= 40 + +* Format the disk + + mkfs.xfs /uod/idr/scratch/docker-storage.img + +* Create a directory to act as a mount point and bind the virtual drive to it + + mkdir -p /var/lib/docker-xfs + mount -o loop,pquota /uod/idr/scratch/docker-storage.img /var/lib/docker-xfs + +* Mount the virtual disk when machine is restarted + + vi /etc/fstab + + Add this line by the end of the file + + /uod/idr/scratch/docker-storage.img /var/lib/docker-xfs xfs loop,defaults 0 0 + +* Check it + + df -h /var/lib/docker-xfs + +* Stop the docker service + + systemctl stop docker + +* Edit the following file to configure the docker to use the mounted folder for data root + + vi /etc/docker/daemon.json + + Add the following contents + + { + "data-root": "/var/lib/docker-xfs", + "storage-driver": "overlay2" + } + + +* Start the docker service + + systemctl start docker diff --git a/README.md b/README.md index 7f8ef4ec..6331dc05 100644 --- a/README.md +++ b/README.md @@ -20,6 +20,10 @@ Devspace code depends on the following repositories: # Installation +This application includes UoD-specific UoD deployment configuration. + +Please refer to [this file ](Docker_Config_UoD_ESS.md) before deploying. + The following instructions explain how to deploy a devspace on a Docker host. * Log into the Docker host using ssh