From 8122470c0b04c7d66cba236d7fcbaaec3e4cccf5 Mon Sep 17 00:00:00 2001 From: Jose Diaz-Gonzalez Date: Mon, 5 Dec 2022 06:14:50 -0500 Subject: [PATCH] chore: drop tutorials from main docs in favor of tutorials site This ensures the main docs don't become an area for every use case, rather just focusing on the core concepts and usages of Dokku. --- .../tutorials/run-on-external-volume.md | 78 ------------------- docs/template.html | 3 - 2 files changed, 81 deletions(-) delete mode 100644 docs/community/tutorials/run-on-external-volume.md diff --git a/docs/community/tutorials/run-on-external-volume.md b/docs/community/tutorials/run-on-external-volume.md deleted file mode 100644 index 19027a03a..000000000 --- a/docs/community/tutorials/run-on-external-volume.md +++ /dev/null @@ -1,78 +0,0 @@ -# Run Dokku on External Volume - -In order to leverage cloud-provider facilities like _attachable volumes_, (_a.k.a. block storage_) -the following is an easy tutorial to achieve Dokku runs on them. - -> Warning: If the block storage is not available and attached on boot it is possible that containers will not correctly start. Please keep this in mind when considering moving Dokku and/or Docker to network attached storage. - -## Tutorial - -The following is intended to be executed on the dokku host machine as `root`. -Say, _for instance_, that our volume is mapped into the systems as `/dev/vdb1`. - -Stop docker daemon - -```shell -systemctl stop docker -``` - -Prepare the filesystem: - -```shell -mkfs -t ext4 /dev/vdb1 -mkdir /mnt/volume -mount /dev/vdb1 /mnt/volume -``` - -Move the old data directories: - -```shell -mv /home/dokku /home/dokku.OLD -mv /var/lib/docker /var/lib/docker.OLD -mv /var/lib/dokku /var/lib/dokku.OLD -``` - -Move the data on the volume - -```shell -mkdir /mnt/volume/home/ -mkdir -p /mnt/volume/var/lib/ -mv /home/dokku.OLD /mnt/volume/home/dokku -mv /var/lib/dokku.OLD /mnt/volume/var/lib/dokku -mv /var/lib/docker.OLD /mnt/volume/var/lib/docker -``` - -Prepare the mountpoints - -```shell -mkdir /home/dokku -mkdir /var/lib/dokku -mkdir /var/lib/docker -chown dokku:dokku /home/dokku # respect the original ownership -chmod 711 /var/lib/docker # respect the original permissions -``` - -Mount bind - -```shell -mount -o bind /mnt/volume/home/dokku /home/dokku -mount -o bind /mnt/volume/var/lib/dokku /var/lib/dokku -mount -o bind /mnt/volume/var/lib/docker /var/lib/docker -``` - -Start docker daemon - -```shell -systemctl start docker -``` - -At this point all should be working fine, please check it out. - -Then, let the changes be reboot-persistent - -```shell -echo '/dev/vdb1 /mnt/volume ext4 defaults 0 2' | sudo tee -a /etc/fstab -echo '/mnt/volume/home/dokku /home/dokku none defaults,bind 0 0' | sudo tee -a /etc/fstab -echo '/mnt/volume/var/lib/dokku /var/lib/dokku none defaults,bind 0 0' | sudo tee -a /etc/fstab -echo '/mnt/volume/var/lib/docker /var/lib/docker none defaults,bind 0 0' | sudo tee -a /etc/fstab -``` diff --git a/docs/template.html b/docs/template.html index d534eeb2c..a2bc60a58 100644 --- a/docs/template.html +++ b/docs/template.html @@ -214,9 +214,6 @@ Community Contributions Clients Plugins - - Community Tutorials - Run on External Volume