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

Add deprecation notice

Browse Source 
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

15
docs/deploy.md
View File

@ -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
@ -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
@ -163,9 +174,11 @@ 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.