abra/README.md
2021-03-17 12:59:09 +01:00

2.0 KiB

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

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 installer/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