roxxers
/
abra
forked from coop-cloud/abra-bash
0
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity
The Co-op Cloud command-line interface 🎩🐇
428 Commits 9 Branches 0 Tags 4.9 MiB
Shell 89.4%
Python 9%
Makefile 1.6%
Go to file
decentral1se d9374dc48e
Don't ignore JSON, we'll need it 		2021-04-02 15:49:08 +02:00
bin Add newline 2021-04-02 15:39:15 +02:00
completion Fix `server` bash completion 2020-12-31 11:47:14 +02:00
deploy Fix service name to match existing convention 2021-04-02 15:44:37 +02:00
tests Fix tests 2021-03-26 00:28:47 +01:00
.drone.yml Run flake8 against python scripts 2021-04-02 15:42:28 +02:00
.gitignore Don't ignore JSON, we'll need it 2021-04-02 15:49:08 +02:00
CHANGELOG.md Fix change log entries 2021-03-26 01:17:06 +01:00
README.md Add abra-apps releaser docs and target 2021-04-02 15:38:49 +02:00
abra Reinstate --force for the deploy command 2021-03-26 00:40:23 +01:00
makefile Get shellcheck working for the bin/ scripts 2021-04-02 15:39:02 +02:00

README.md

abra

Build Status codecov

https://cloud.autonomic.zone

The cooperative 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.cloud.autonomic.zone

Install

Install the latest stable release:

curl https://install.abra.autonomic.zone | bash

or the bleeding-edge development version:

curl https://install.abra.autonomic.zone | bash -s -- --dev

The source for this script is here.

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.autonomic.zone | 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.

Release

  • Change the x.x.x header in CHANGELOG.md to reflect new version and mark date
  • Update versions in deploy/install.abra.autonomic.zone/installer and abra
  • git commit the above changes and then tag it with git tag <your-new-version>
  • Then git push and git push --tags
  • Deploy a new installer script make release-installer
  • Tell the world

Other releases

abra-apps.autonomic.zone

abra-apps.autonomic.zone

$ make release-abra-apps