More for 219a5e665b
continuous-integration/drone/push Build is passing
Details
continuous-integration/drone/push Build is passing
Details
This commit is contained in:
parent
6446865df5
commit
d36785a023
|
@ -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.
|
||||||
|
|
Reference in New Issue