simon/docs.coopcloud.tech
0
0
Fork 0
forked from toolshed/docs.coopcloud.tech
Code Pull Requests Activity

More for 219a5e665b

Browse Source
This commit is contained in:
decentral1se
2021-06-01 00:41:01 +02:00
parent 6446865df5
commit d36785a023
1 changed files with 23 additions and 23 deletions
Download Patch File Download Diff File Expand all files Collapse all files

46
docs/deploy.md
View File

@ -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. On a [Debian system](https://docs.docker.com/engine/install/debian/), that can be done like so.
```bash ```bash
$ sudo apt-get remove docker docker-engine docker.io containerd runc sudo apt-get remove docker docker-engine docker.io containerd runc
$ sudo apt update sudo apt update
$ sudo apt-get install -y apt-transport-https ca-certificates curl gnupg-agent software-properties-common 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 - 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 add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/debian $(lsb_release -cs) stable"
$ sudo apt-get update sudo apt-get update
$ sudo apt-get install -y docker-ce docker-ce-cli containerd.io sudo apt-get install -y docker-ce docker-ce-cli containerd.io
``` ```
## Bootstrap `abra` ## Bootstrap `abra`
@ -52,7 +52,7 @@ Firstly, install `abra` locally.
Bash. Bash.
```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). 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. You may need to add the `~/.local/bin/` directory with your `$PATH` in order to run the executable.
```bash ```bash
$ export PATH=$PATH:$HOME/.local/bin export PATH=$PATH:$HOME/.local/bin
$ abra --help # check it works abra --help # check it works
``` ```
Now you can connect `abra` with your new server. Now you can connect `abra` with your new server.
```bash ```bash
$ abra server add example.com abra server add example.com
``` ```
Where `example.com` is replaced with your server DNS name. 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/). Once you've added the sever, you can initialise the [new single-host swarm](https://docs.docker.com/engine/swarm/key-concepts/).
```bash ```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. 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. 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 ```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. 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: You will want to take a look at your generated configuration and tweak the `LETS_ENCRYPT_EMAIL` value:
```bash ```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. 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. We can then check that everything came up as expected.
```bash ```bash
$ abra app traefik ps # status check abra app traefik ps # status check
$ abra app traefik logs # logs watch abra app traefik logs # logs watch
``` ```
## Deploy Nextcloud ## Deploy Nextcloud
@ -124,7 +124,7 @@ And now we can deploy apps.
Let's create a new Nextcloud app. Let's create a new Nextcloud app.
```bash ```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. 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. And we need to generate secrets for the app: database connection password, root password and admin password.
```bash ```bash
$ abra app nextcloud secret generate --all abra app nextcloud secret generate --all
``` ```
!!! warning !!! warning
@ -145,14 +145,14 @@ $ abra app nextcloud secret generate --all
Then we can deploy the Nextcloud. Then we can deploy the Nextcloud.
```bash ```bash
$ abra app nextcloud deploy abra app nextcloud deploy
``` ```
And once again, we can watch to see that things come up correctly. And once again, we can watch to see that things come up correctly.
```bash ```bash
$ abra app nextcloud ps # status check abra app nextcloud ps # status check
$ abra app nextcloud logs # logs watch abra app nextcloud logs # logs watch
``` ```
!!! note !!! note
@ -161,7 +161,7 @@ $ abra app nextcloud logs # logs watch
command under `watch` like so. command under `watch` like so.
```bash ```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. And you can wait until you see that all containers have the "Running" state.