Getting started on A tool for commands http://example.org/getting-started/index.html Recent content in Getting started on A tool for commands Hugo -- gohugo.io en-us Install Backy http://example.org/getting-started/install/index.html Mon, 01 Jan 0001 00:00:00 +0000 http://example.org/getting-started/install/index.html <p>Binaries are available from the <a href="https://git.andrewnw.xyz/CyberShell/backy/releases" target="_blank">release page</a>. Make sure to get the correct version for your system, which supports x86_64, ARM64, and i386.</p> <h3 id="source-install">Source Install</h3> <p>You can install from source. You will need <a href="https://go.dev/doc/install" target="_blank">Go installed</a>.</p> <p>Then run:</p> <div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span>go install git.andrewnw.xyz/CyberShell/backy@master </span></span></code></pre></div><p>Once set, jump over to the <a href="http://example.org/getting-started/config">config docs</a> and start configuring your file.</p> Config File Definitions http://example.org/getting-started/config/index.html Mon, 01 Jan 0001 00:00:00 +0000 http://example.org/getting-started/config/index.html <h3 id="commands">Commands</h3> <p>The commands section is for defining commands. These can be run with or without a shell and on a host or locally.</p> <p>See the <a href="http://example.org/config/commands">commands documentation</a> for further information.</p> <div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-yaml" data-lang="yaml"><span style="display:flex;"><span><span style="color:#f92672">commands</span>: </span></span><span style="display:flex;"><span>  <span style="color:#f92672">stop-docker-container</span>: </span></span><span style="display:flex;"><span> <span style="color:#f92672">output</span>: <span style="color:#66d9ef">true</span> <span style="color:#75715e"># Optional and only when run in list and notifications are sent</span> </span></span><span style="display:flex;"><span>    <span style="color:#f92672">cmd</span>: <span style="color:#ae81ff">docker</span> </span></span><span style="display:flex;"><span>    <span style="color:#f92672">args</span>: </span></span><span style="display:flex;"><span>      - <span style="color:#ae81ff">compose</span> </span></span><span style="display:flex;"><span>      - -<span style="color:#ae81ff">f /some/path/to/docker-compose.yaml</span> </span></span><span style="display:flex;"><span>      - <span style="color:#ae81ff">down</span> </span></span><span style="display:flex;"><span>    <span style="color:#75715e"># if host is not defined, cmd will be run locally</span> </span></span><span style="display:flex;"><span>    <span style="color:#f92672">host</span>: <span style="color:#ae81ff">some-host </span> </span></span><span style="display:flex;"><span>  <span style="color:#f92672">backup-docker-container-script</span>: </span></span><span style="display:flex;"><span>    <span style="color:#f92672">cmd</span>: <span style="color:#ae81ff">/path/to/script</span> </span></span><span style="display:flex;"><span>    <span style="color:#75715e"># The host has to be defined in the config file</span> </span></span><span style="display:flex;"><span>    <span style="color:#f92672">host</span>: <span style="color:#ae81ff">some-host</span> </span></span><span style="display:flex;"><span>    <span style="color:#f92672">environment</span>: </span></span><span style="display:flex;"><span>      - <span style="color:#ae81ff">FOO=BAR</span> </span></span><span style="display:flex;"><span>     - <span style="color:#ae81ff">APP=$VAR</span> <span style="color:#75715e"># defined in .env file in config directory</span> </span></span><span style="display:flex;"><span>  <span style="color:#f92672">shell-cmd</span>: </span></span><span style="display:flex;"><span>    <span style="color:#f92672">cmd</span>: <span style="color:#ae81ff">rsync</span> </span></span><span style="display:flex;"><span>    <span style="color:#f92672">shell</span>: <span style="color:#ae81ff">bash</span> </span></span><span style="display:flex;"><span>    <span style="color:#f92672">args</span>: </span></span><span style="display:flex;"><span>      - -<span style="color:#ae81ff">av</span> </span></span><span style="display:flex;"><span> - <span style="color:#ae81ff">some-host:/path/to/data </span> </span></span><span style="display:flex;"><span> - <span style="color:#ae81ff">~/Docker/Backups/docker-data</span> </span></span><span style="display:flex;"><span> <span style="color:#f92672">script</span>: </span></span><span style="display:flex;"><span> <span style="color:#f92672">type</span>: <span style="color:#ae81ff">scriptFile</span> <span style="color:#75715e"># run a local script on a remote host</span> </span></span><span style="display:flex;"><span> <span style="color:#f92672">cmd</span>: <span style="color:#ae81ff">path/to/your/script.sh</span> </span></span><span style="display:flex;"><span> <span style="color:#f92672">host</span>: <span style="color:#ae81ff">some-host </span> </span></span><span style="display:flex;"><span>  <span style="color:#f92672">hostname</span>: </span></span><span style="display:flex;"><span>    <span style="color:#f92672">cmd</span>: <span style="color:#ae81ff">hostname</span> </span></span></code></pre></div><h3 id="lists">Lists</h3> <p>To execute groups of commands in sequence, use a list configuration.</p>