From d36785a023b77fa4af1437992d298536adfe6c42 Mon Sep 17 00:00:00 2001 From: decentral1se Date: Tue, 1 Jun 2021 00:41:01 +0200 Subject: [PATCH] More for 219a5e665be1ebeb4427d1b24e6a52d04a3ae88d --- docs/deploy.md | 46 +++++++++++++++++++++++----------------------- 1 file changed, 23 insertions(+), 23 deletions(-) diff --git a/docs/deploy.md b/docs/deploy.md index b5b3123..7cab7bd 100644 --- a/docs/deploy.md +++ b/docs/deploy.md @@ -27,13 +27,13 @@ On your server, you'll want to install [Docker](https://www.docker.com/). This c On a [Debian system](https://docs.docker.com/engine/install/debian/), that can be done like so. ```bash -$ sudo apt-get remove docker docker-engine docker.io containerd runc -$ sudo apt update -$ sudo apt-get install -y apt-transport-https ca-certificates curl gnupg-agent software-properties-common -$ curl -fsSL https://download.docker.com/linux/debian/gpg | sudo apt-key add - -$ sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/debian $(lsb_release -cs) stable" -$ sudo apt-get update -$ sudo apt-get install -y docker-ce docker-ce-cli containerd.io +sudo apt-get remove docker docker-engine docker.io containerd runc +sudo apt update +sudo apt-get install -y apt-transport-https ca-certificates curl gnupg-agent software-properties-common +curl -fsSL https://download.docker.com/linux/debian/gpg | sudo apt-key add - +sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/debian $(lsb_release -cs) stable" +sudo apt-get update +sudo apt-get install -y docker-ce docker-ce-cli containerd.io ``` ## Bootstrap `abra` @@ -52,7 +52,7 @@ Firstly, install `abra` locally. Bash. ```bash -$ curl https://install.abra.autonomic.zone | bash +curl https://install.abra.autonomic.zone | bash ``` The source for this script [is here](https://git.autonomic.zone/coop-cloud/abra/src/branch/main/installer/installer). @@ -60,14 +60,14 @@ The source for this script [is here](https://git.autonomic.zone/coop-cloud/abra/ You may need to add the `~/.local/bin/` directory with your `$PATH` in order to run the executable. ```bash -$ export PATH=$PATH:$HOME/.local/bin -$ abra --help # check it works +export PATH=$PATH:$HOME/.local/bin +abra --help # check it works ``` Now you can connect `abra` with your new server. ```bash -$ abra server add example.com +abra server add example.com ``` Where `example.com` is replaced with your server DNS name. @@ -83,7 +83,7 @@ Where `example.com` is replaced with your server DNS name. Once you've added the sever, you can initialise the [new single-host swarm](https://docs.docker.com/engine/swarm/key-concepts/). ```bash -$ abra server example.com init +abra server example.com init ``` You will now have a new `~/.abra/` folder on your local file system which stores all the configuration of your Co-op Cloud instance. You can easily share this as a git repository with others. @@ -93,7 +93,7 @@ You will now have a new `~/.abra/` folder on your local file system which stores In order to have your Co-op cloud installation automagically provision SSL certificates, we will first install [Traefik](https://doc.traefik.io/traefik/). This tool is the main entrypoint for all web requests (e.g. like NGINX) and supports automatic SSL certificate configuration and other quality-of-life features which make deploying libre apps more enjoyable. ```bash -$ abra app new --server example.com --domain traefik.example.com traefik +abra app new --server example.com --domain traefik.example.com traefik ``` We can then choose `traefik` as the app name. @@ -101,20 +101,20 @@ We can then choose `traefik` as the app name. You will want to take a look at your generated configuration and tweak the `LETS_ENCRYPT_EMAIL` value: ```bash -$ abra app traefik config +abra app traefik config ``` This is the required environment variables that you can configure and are injected into the app configuration when deployed. ``` -$ abra app traefik deploy +abra app traefik deploy ``` We can then check that everything came up as expected. ```bash -$ abra app traefik ps # status check -$ abra app traefik logs # logs watch +abra app traefik ps # status check +abra app traefik logs # logs watch ``` ## Deploy Nextcloud @@ -124,7 +124,7 @@ And now we can deploy apps. Let's create a new Nextcloud app. ```bash -$ abra app new --server example.com --domain cloud.example.com nextcloud +abra app new --server example.com --domain cloud.example.com nextcloud ``` We can then choose `nextcloud` as the app name. @@ -132,7 +132,7 @@ We can then choose `nextcloud` as the app name. And we need to generate secrets for the app: database connection password, root password and admin password. ```bash -$ abra app nextcloud secret generate --all +abra app nextcloud secret generate --all ``` !!! warning @@ -145,14 +145,14 @@ $ abra app nextcloud secret generate --all Then we can deploy the Nextcloud. ```bash -$ abra app nextcloud deploy +abra app nextcloud deploy ``` And once again, we can watch to see that things come up correctly. ```bash -$ abra app nextcloud ps # status check -$ abra app nextcloud logs # logs watch +abra app nextcloud ps # status check +abra app nextcloud logs # logs watch ``` !!! note @@ -161,7 +161,7 @@ $ abra app nextcloud logs # logs watch command under `watch` like so. ```bash - $ watch abra app nextcloud ps + watch abra app nextcloud ps ``` And you can wait until you see that all containers have the "Running" state.