akshay/docs.coopcloud.tech
0
0
Fork 0
forked from toolshed/docs.coopcloud.tech
Code Issues Pull Requests 1 Projects Releases Wiki Activity

minor text and styling improvements to Operators Tutorial

Browse Source
This commit is contained in:
basebuilder
2024-04-02 10:39:10 +02:00
parent 3066cc1cea
commit 38c6ec1c6b
1 changed files with 29 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files

34
docs/operators/tutorial.md
View File

@ -139,15 +139,21 @@ abra server ls
In order to have your Co-op cloud deployment serve the public internet, we need to install the core web proxy, [Traefik](https://doc.traefik.io/traefik/). In order to have your Co-op cloud deployment serve the public internet, we need to install the core web proxy, [Traefik](https://doc.traefik.io/traefik/).
Traefik 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. Traefik 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.
To get started, you'll need to create a new app: **1. To get started, you'll need to create a new app:**
```bash ```bash
abra app new traefik abra app new traefik
``` ```
Choose your newly registered server and specify a domain name. Choose your newly registered server and specify a domain name. By default `abra`
will suggest `<app-name>.server.org` or prompt you with a list of servers.
**2. Configure this new `traefix` app**
You will want to take a look at your generated configuration and tweak the `LETS_ENCRYPT_EMAIL` value. You can do that by running `abra app config`: You will want to take a look at your generated configuration and tweak the `LETS_ENCRYPT_EMAIL` value. You can do that by running `abra app config`:
@ -155,14 +161,32 @@ You will want to take a look at your generated configuration and tweak the `LETS
abra app config <traefik-domain> abra app config <traefik-domain>
``` ```
Every app you deploy will have one of these `.env` files, which contains variables which will be injected into app configurations when deployed. Variables starting with `#` are optional, others are required. Every app you deploy will have one of these `.env` files, which contains
variables which will be injected into app configurations when deployed. These
files exist at relevantly named path:
Now it is time to deploy: ```bash
~/.abra/servers/<domain>/<traefik-domain>.env
```
Variables starting with `#` are optional, others are required. Some things to
consider here is that by default our *Traefik* recipe exposes the metric
dashboard unauthenticated on the public internet at the URL `<traefik-domain>`
it is deployed to, which is not ideal. You can disable this with:
```
DASHBOARD_ENABLED=false
```
**3. Now it is time to deploy your app:**
``` ```
abra app deploy <traefik-domain> abra app deploy <traefik-domain>
``` ```
Voila. Abracadabra :magic_wand: your first app is deployed :sparkles:
### Deploy Nextcloud ### Deploy Nextcloud
And now we can deploy apps. Let's create a new Nextcloud app. And now we can deploy apps. Let's create a new Nextcloud app.