more focus on abra

This commit is contained in:
2022-02-02 21:27:05 +01:00
parent 6625fd521f
commit 8dabfac897
6 changed files with 33 additions and 2 deletions

View File

@ -5,6 +5,7 @@ title: Abra
`abra` is our flagship client & command-line tool which has been developed specifically in the context of the Co-op Cloud project for the purpose of making day-to-day operations for [operators](/operators/) and [maintainers](/maintainers/) as convenient as possible. It is libre software, written in [Go](https://go.dev/) and maintained and extended by the community :heart:
- [Install](/abra/install): You want to install `abra` :100:
- [Quick start](/abra/quickstart): You're ready to get started using `abra` :muscle:
- [Upgrade](/abra/upgrade): You're looking for instructions on how to upgrade `abra` :arrow_heading_up:
- [Hack](/abra/hack): You wan to hack on `abra` and help out with the development :woman_construction_worker:
- [Troubleshoot](/abra/troubleshoot): `abra` ain't working and you'd like to know why :boom:

15
docs/abra/quickstart.md Normal file
View File

@ -0,0 +1,15 @@
---
title: Quick start
---
Once you've got `abra` installed, you can start your own Co-op Cloud deployment.
The core features of `abra` allow you to create, deploy and maintain libre software apps. `abra` can help you do on existing servers or by creating new servers (supported: [Servers.coop](https://servers.coop/) & [Hetzner](https://hetzner.com)), manage your DNS configuration (supported: [Gandi](https://gandi.net)) and maintain recipes.
There are a few ways to get started, here are some entrypoints listed below:
- If you're new around here and you'd like to learn how to deploy apps with `abra`, then a good place to start is the [new operators tutorial](/operators/tutorial). If you've already deployed some apps and would like to learn how to maintain them, then the [operators handbook](/operators/handbook) is the right place.
- If you're installing `abra` so you can do recipe packaging, take a look at the [new maintainers tutorial](/maintainers/tutorial). `abra` can help you check the quality of the recipe you've packaged and help you publish it to the public recipe catalogue. Then others can deploy your configuration :rocket:
If you run into any issues, please see the [troubleshooting page](/abra/trouble) :bomb:

View File

@ -2,6 +2,12 @@
title: Troubleshoot
---
## Where do I report `abra` bugs / feature requests?
## I'm having a bad day, where do I find a human?
TODO.
## SSH connection issues?
TODO.