knoflook/abra
Archived
0
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity
The Co-op Cloud command-line interface 🎩🐇
This repository has been archived on 2021-07-03. You can view files and clone it, but cannot push or open issues or pull requests.
664 Commits 11 Branches 0 Tags 911 KiB
Shell 87%
Python 10.9%
Makefile 1.2%
Dockerfile 0.9%
57f3f96bbc
Go to file
decentral1se 57f3f96bbc
Use new name
2021-06-17 21:48:55 +02:00
bin Support logging in via Skopeo 2021-06-17 21:40:58 +02:00
completion Add Bash completion for abra recipe .. 2021-05-30 14:33:57 +02:00
deploy/install.abra.coopcloud.tech Bump to next version 2021-06-10 11:43:00 +02:00
tests Add debugging for tests 2021-04-07 01:29:43 +02:00
.drone.yml Use new image 2021-06-17 21:00:43 +02:00
.gitignore Drop the apps.json in the cwd 2021-06-05 08:26:43 +02:00
abra Use proper jq path 2021-06-17 09:34:36 +02:00
CHANGELOG.md Add change log entry [ci skip] 2021-06-17 21:42:33 +02:00
Dockerfile Add mirroring script 2021-06-05 22:41:50 +02:00
makefile Use new name 2021-06-17 21:48:55 +02:00
README.md Use new name 2021-06-17 21:48:55 +02:00

README.md

abra

Build Status

https://coopcloud.tech

The Co-op Cloud utility belt 🎩🐇

abra is a command-line tool for managing your own Co-op Cloud. It can provision new servers, create applications, deploy them, run backup and restore operations and a whole lot of other things. It is the go-to tool for day-to-day operations when managing a Co-op Cloud instance.

Change log

🔥 🔥 🔥 Please note, while we are still in public alpha, the abra release versioning scheme is not following semver conventions because we are still in the exploratory phases of building this tool. Please read the changes before upgrading your abra installation as there are most likely breaking changes coming each release. Sorry for any inconvenience caused, we're working hard to make this tool stable. Semver will be respected when we reach public beta. 🔥 🔥 🔥

See CHANGELOG.md.

Documentation

docs.coopcloud.tech

Install

Requirements:

  • pwqgen (optional)
  • pwgen (optional)
  • curl
  • docker
  • bash >= 4

Install the latest stable release:

curl https://install.abra.coopcloud.tech | bash

or the bleeding-edge development version:

curl https://install.abra.coopcloud.tech | bash -s -- --dev

The source for this script is here.

Container

An image is also provided.

docker run thecoopcloud/abra app ls

Update

Run abra upgrade to automatically download and install the latest release version.

To update the development version, run abra upgrade --dev.

Hack

It's written in Bash version 4 or greater!

Install it via curl https://install.abra.coopcloud.tech | bash -s -- --dev, then you can hack on the source in ~/.abra/src.

The command-line interface is generated via docopt. If you add arguments then you need to run make docopt ro regenerate the parser.

Please remember to update the CHANGELOG when you make a change.

Releasing

abra

install.abra.coopcloud.tech

  • Change the x.x.x header in CHANGELOG.md to reflect new version and mark date
  • Update the version in abra
  • Update the version in deploy/install.abra.coopcloud.tech/installer
  • git commit the above changes and then tag it with git tag <your-new-version>
  • git push and git push --tags
  • Deploy a new installer script make release-installer
  • Tell the world (CoTech forum, Matrix public channel, Autonomic mastodon, etc.)