iRework the manpage a little - drist - a remote deployment tool Err bitreich.org 70 hgit clone git://bitreich.org/drist/ git://enlrupgkhuxnvlhsf6lc3fziv5h2hhfrinws65d7roiv6bfj7d652fid.onion/drist/ URL:git://bitreich.org/drist/ git://enlrupgkhuxnvlhsf6lc3fziv5h2hhfrinws65d7roiv6bfj7d652fid.onion/drist/ bitreich.org 70 1Log /scm/drist/log.gph bitreich.org 70 1Files /scm/drist/files.gph bitreich.org 70 1Refs /scm/drist/refs.gph bitreich.org 70 1Tags /scm/drist/tag bitreich.org 70 1README /scm/drist/file/README.gph bitreich.org 70 1LICENSE /scm/drist/file/LICENSE.gph bitreich.org 70 i--- Err bitreich.org 70 1commit b62625b79ee16f841d0a3693aea3d8521cc6a2ba /scm/drist/commit/b62625b79ee16f841d0a3693aea3d8521cc6a2ba.gph bitreich.org 70 1parent f87b55ae60ad8e173107eb34fbff84f8d64afc7b /scm/drist/commit/f87b55ae60ad8e173107eb34fbff84f8d64afc7b.gph bitreich.org 70 hAuthor: Quentin Rameau URL:mailto:quinq@fifth.space bitreich.org 70 iDate: Thu, 19 Jul 2018 23:33:42 +0200 Err bitreich.org 70 i Err bitreich.org 70 iRework the manpage a little Err bitreich.org 70 i Err bitreich.org 70 iDiffstat: Err bitreich.org 70 i M drist.1 | 72 ++++++++++++++++++------------- Err bitreich.org 70 i Err bitreich.org 70 i1 file changed, 42 insertions(+), 30 deletions(-) Err bitreich.org 70 i--- Err bitreich.org 70 1diff --git a/drist.1 b/drist.1 /scm/drist/file/drist.1.gph bitreich.org 70 i@@ -15,36 +15,40 @@ is a tool to configure remote servers using Err bitreich.org 70 i and Err bitreich.org 70 i .Xr rsync 1 . Err bitreich.org 70 i .Nm Err bitreich.org 70 i-has been designed to be simple, so it may not offer features you want. Err bitreich.org 70 i+has been designed to be simple, so it may not offer all the features Err bitreich.org 70 i+you want. Err bitreich.org 70 i Err bitreich.org 70 i When you run Err bitreich.org 70 i-.Nm Err bitreich.org 70 i-, it will look at special directories in the current working directory. Err bitreich.org 70 i+.Nm Ns Err bitreich.org 70 i+, it will look at a set of special directories in the current working Err bitreich.org 70 i+directory. Err bitreich.org 70 i Err bitreich.org 70 i-The whole sequence is the following, with HOSTNAME being the result of Err bitreich.org 70 i+Here is the whole sequence, with Err bitreich.org 70 i+.Em HOSTNAME Err bitreich.org 70 i+being the result of Err bitreich.org 70 i .Ql uname -n Err bitreich.org 70 i-on the remote system. Err bitreich.org 70 i+on the remote system: Err bitreich.org 70 i Err bitreich.org 70 i .Bl -enum -offset indent -compact Err bitreich.org 70 i .It Err bitreich.org 70 i if folder Err bitreich.org 70 i .Ar files Err bitreich.org 70 i-exists, files in it are copied on Err bitreich.org 70 i+exists, its content is copied to Err bitreich.org 70 i .Ar server Err bitreich.org 70 i .It Err bitreich.org 70 i if folder Err bitreich.org 70 i-.Ar files-HOSTNAME Err bitreich.org 70 i-exists, files in it are copied on Err bitreich.org 70 i+.Ar files- Ns Em HOSTNAME Err bitreich.org 70 i+exists, its content copied to Err bitreich.org 70 i .Ar server Err bitreich.org 70 i .It Err bitreich.org 70 i if folder Err bitreich.org 70 i .Ar absent Err bitreich.org 70 i-exists, files in it are removed remotely on Err bitreich.org 70 i+exists, filenames in it are removed from Err bitreich.org 70 i .Ar server Err bitreich.org 70 i .It Err bitreich.org 70 i if folder Err bitreich.org 70 i-.Ar absent-HOSTNAME Err bitreich.org 70 i-exists, files in it are removed remotely on Err bitreich.org 70 i+.Ar absent- Ns Em HOSTNAME Err bitreich.org 70 i+exists, filenames in it are removed from Err bitreich.org 70 i .Ar server Err bitreich.org 70 i .It Err bitreich.org 70 i if file Err bitreich.org 70 i@@ -53,49 +57,57 @@ exists, it is executed remotely on Err bitreich.org 70 i .Ar server Err bitreich.org 70 i .It Err bitreich.org 70 i if file Err bitreich.org 70 i-.Ar script-HOSTNAME Err bitreich.org 70 i+.Ar script- Ns Em HOSTNAME Err bitreich.org 70 i exists, it is executed remotely on Err bitreich.org 70 i .Ar server Err bitreich.org 70 i .El Err bitreich.org 70 i Err bitreich.org 70 i-If directory Err bitreich.org 70 i+The presence of each of those files or directories is optional. Err bitreich.org 70 i+ Err bitreich.org 70 i+If the directory Err bitreich.org 70 i .Ar files Err bitreich.org 70 i-is present, the content of this folder will be copied on the remote server Err bitreich.org 70 i+is present, its content will be copied to the remote Err bitreich.org 70 i .Ar server Err bitreich.org 70 i-from the root filesystem /. You can create Err bitreich.org 70 i-.Ar files-HOSTNAME Err bitreich.org 70 i+relatively to the root / directory. You can create Err bitreich.org 70 i+.Ar files- Ns Em HOSTNAME Err bitreich.org 70 i with Err bitreich.org 70 i-.Ar HOSTNAME Err bitreich.org 70 i+.Em HOSTNAME Err bitreich.org 70 i being the result of the command Err bitreich.org 70 i .Ql uname -n Err bitreich.org 70 i-on the remote server. The content of this foldre will be copied on the remote server Err bitreich.org 70 i-after the Err bitreich.org 70 i+on the remote server. The content of this folder will be copied to the Err bitreich.org 70 i+remote server after the Err bitreich.org 70 i .Ar files Err bitreich.org 70 i-directory. This folder is useful if you need to add some files only on certains servers. Err bitreich.org 70 i+directory has been processed. This folder is useful for adding Err bitreich.org 70 i+.Em HOSTNAME Ns -specific Err bitreich.org 70 i+files. Err bitreich.org 70 i Err bitreich.org 70 i After the files are copied, Err bitreich.org 70 i .Nm Err bitreich.org 70 i will look at two the folders Err bitreich.org 70 i .Ar absent Err bitreich.org 70 i and Err bitreich.org 70 i-.Ar absent-HOSTNAME Err bitreich.org 70 i+.Ar absent Ns Em HOSTNAME Err bitreich.org 70 i in the current working directory. Err bitreich.org 70 i .Nm Err bitreich.org 70 i-will remotely delete all files listed in the tree of the directory. Err bitreich.org 70 i+will remotely delete all files listed in this directory tree. Err bitreich.org 70 i Err bitreich.org 70 i Finally, the file Err bitreich.org 70 i .Ar script Err bitreich.org 70 i-be copied on the remote server and then executed and deleted after execution Err bitreich.org 70 i-(shall the script succeed or fail). If Err bitreich.org 70 i-.Ar script-HOSTNAME Err bitreich.org 70 i-exists, it will be procedded too in the same way. This is useful if you need Err bitreich.org 70 i-to run commands on a particular servers. Err bitreich.org 70 i+be copied to the remote server, executed and deleted (shall the script Err bitreich.org 70 i+succeed or not). If Err bitreich.org 70 i+.Ar script- Ns Em HOSTNAME Err bitreich.org 70 i+exists, it will be processed in the same way. This is useful if you Err bitreich.org 70 i+need to run Err bitreich.org 70 i+.Em HOSTNAME Ns -specific Err bitreich.org 70 i+commands. Err bitreich.org 70 i Err bitreich.org 70 i-I recommend to write small "modules" installing required packages for a task and providing Err bitreich.org 70 i-the files needed rather than an all-in-one module to deploy an entire system. Err bitreich.org 70 i+I recommend writing small "modules" which would install the required Err bitreich.org 70 i+packages for a task and provide the files needed, rather than writing a Err bitreich.org 70 i+full-blown module for deploying an entire system at once. Err bitreich.org 70 i Err bitreich.org 70 i .Nm Err bitreich.org 70 i-does not take care of permissions and ownership. Thoses should be modified by the Err bitreich.org 70 i+does not handle file permissions and ownership. Thoses should be Err bitreich.org 70 i+modified by the Err bitreich.org 70 i .Ar script Err bitreich.org 70 i file. Err bitreich.org 70 i . Err bitreich.org 70 .