mayel
/
docs.coopcloud.tech
forked from coop-cloud/docs.coopcloud.tech
0
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

Add deprecation notice 

See coop-cloud/organising#107.
This commit is contained in:
decentral1se 2021-08-02 11:37:53 +02:00
parent 53351a534a
commit 388f6a5b98
No known key found for this signature in database
GPG Key ID: 5E2EF5A63E3718CC
2 changed files with 29 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

27
docs/deploy.md
View File

@ -5,8 +5,8 @@ title: Deploy your first app
In order to deploy an app you need two things: In order to deploy an app you need two things:
1. a server (e.g. [Hetzner VPS](https://www.hetzner.com/cloud)), with 1. a server (e.g. [Hetzner VPS](https://www.hetzner.com/cloud)), with
- SSH access - SSH access
- a public IP address - a public IP address
2. a DNS provider (e.g. [Gandi](https://www.gandi.net/en)) 2. a DNS provider (e.g. [Gandi](https://www.gandi.net/en))
## Create your server ## Create your server
@ -46,11 +46,20 @@ usermod -a -G docker myusername
## Bootstrap `abra` ## Bootstrap `abra`
!!! danger "Here be dragons I"
`abra` is an officially deprecated tool as of August 1rst 2021 but it is
still our main daily driver to managing Co-op Cloud instances. We're in the
middle of a [Golang](https://golang.org) port which you can learn more about
it [this blog post](https://coopcloud.tech/blog/this-month-in-coop-cloud-july/).
There will only be bug and security fixes provided for `abra` from now on, please
feel free to raise issues when you run into them.
Once your DNS and docker daemon are up, you can install [`abra`](https://git.autonomic.zone/autonomic-cooperative/abra) locally on your developer machine and hook it up to your server. Once your DNS and docker daemon are up, you can install [`abra`](https://git.autonomic.zone/autonomic-cooperative/abra) locally on your developer machine and hook it up to your server.
Firstly, install `abra` locally. Firstly, install `abra` locally.
!!! danger "Here be dragons" !!! danger "Here be dragons II"
`abra` is written in Bash version 4 and if you have a version older than `abra` is written in Bash version 4 and if you have a version older than
that, you will face issues. You can check your current bash version by that, you will face issues. You can check your current bash version by
@ -81,9 +90,9 @@ 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.
!!! note "About SSH" !!! note "About SSH"
`abra` uses Docker's built-in SSH support to make a secure connection to a `abra` uses Docker's built-in SSH support to make a secure connection to a
remote Docker daemon, to deploy and manage apps from your local development remote Docker daemon, to deploy and manage apps from your local development
machine. machine.
If you need to specify a non-standard port, and/or different username, for SSH, If you need to specify a non-standard port, and/or different username, for SSH,
add them as extra arguments: add them as extra arguments:
@ -139,9 +148,11 @@ abra app traefik deploy
``` ```
If you get a message like this: If you get a message like this:
```bash ```bash
ERROR: https://traefik.example.com still isn't up, check status by running "abra app traefik ps" ERROR: https://traefik.example.com still isn't up, check status by running "abra app traefik ps"
``` ```
then it might need a few seconds more to start up. You can run `abra app traefik ps`, as suggested, to see when it's ready – look for `Running` under `CURRENT STATUS` – or `abra app traefik logs` to see app logs. then it might need a few seconds more to start up. You can run `abra app traefik ps`, as suggested, to see when it's ready – look for `Running` under `CURRENT STATUS` – or `abra app traefik logs` to see app logs.
## Deploy Nextcloud ## Deploy Nextcloud
@ -156,16 +167,18 @@ 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.
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
``` ```
If abra complains about lacking pwqgen, it is available in the packet passwdqc on debian. Install it with If abra complains about lacking pwqgen, it is available in the packet passwdqc on debian. Install it with
```bash ```bash
sudo apt-get install passwdqc sudo apt-get install passwdqc
``` ```
and run the previous command again. and run the previous command again.
!!! warning !!! warning

9
docs/overview.md
View File

@ -51,6 +51,15 @@ Learn more about why we use Docker swarm [in the FAQ section](/faq/#why-docker-s
## Command-line tool ## Command-line tool
!!! danger "Here be dragons"
`abra` is an officially deprecated tool as of August 1rst 2021 but it is
still our main daily driver to managing Co-op Cloud instances. We're in the
middle of a [Golang](https://golang.org) port which you can learn more about
it [this blog post](https://coopcloud.tech/blog/this-month-in-coop-cloud-july/).
There will only be bug and security fixes provided for `abra` from now on, please
feel free to raise issues when you run into them. More Coming Soon :tm:
Finally, with an application and an application environment, we need a tool to read that package format and actually deploy it to the environment. For this, we have developed and published the [abra] command-line tool. Finally, with an application and an application environment, we need a tool to read that package format and actually deploy it to the environment. For this, we have developed and published the [abra] command-line tool.
Abra aims at providing a simple command-line interface for managing your own co-op cloud. You can bootstrap machines with the required tools, create new applications, deploy them, back them up, restore them and so on. Abra aims at providing a simple command-line interface for managing your own co-op cloud. You can bootstrap machines with the required tools, create new applications, deploy them, back them up, restore them and so on.