Command line client for Carina by Rackspace, a container service that's currently in Beta.
To download and install the carina CLI, use the appropriate instructions for your operating system.
If you're using Homebrew, run the following command:
$ brew install carinaDownloads for the latest release of carina are available in releases for 64-bit Linux and OS X. You can use curl to download the binary, move it to a directory on your $PATH, and make it executable:
$ curl -L https://download.getcarina.com/carina/latest/$(uname -s)/$(uname -m)/carina -o carina
$ mv carina ~/bin/carina
$ chmod u+x ~/bin/carinaIf you are using Chocolatey, run the following command:
> choco install carinaDownloads for the latest release of carina are available in releases. For quick installation, open PowerShell and run the following command:
> wget 'https://download.getcarina.com/carina/latest/Windows/x86_64/carina.exe' -OutFile carina.exeBe sure to move carina.exe to a directory on your %PATH%.
$ export CARINA_USERNAME=trythingsout
$ export CARINA_APIKEY=$RACKSPACE_APIKEY
$ carina list
ClusterName Flavor Segments AutoScale Status
mycluster container1-4G 1 false active
$ carina create newone
newone container1-4G 1 false new
$ carina create another --wait --autoscale
another container1-4G 1 true active
$ carina list
ClusterName Flavor Segments AutoScale Status
mycluster container1-4G 1 false active
newone container1-4G 1 false active
another container1-4G 1 true active
$ carina credentials another
#
# Credentials written to "/Users/rgbkrk/.carina/clusters/trythingsout/another"
#
source "/Users/rgbkrk/.carina/clusters/trythingsout/another/docker.env"
# Run the command above to get your Docker environment variables set
$ eval "$( carina credentials another )"
$ docker ps
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
$ docker run -d --name whoa -p 8080:8080 whoa/tiny
0e857826144194fd089310279915b1a052de9fb878d6d4f61420a0c64ee06c53
$ curl $( docker port whoa 8080 )
👊 I know kung fu 👊
usage: carina [<flags>] <command> [<args> ...]
command line interface to launch and work with Docker Swarm clusters
Flags:
--help Show context-sensitive help (also try --help-long and --help-man).
--version Show application version.
--username=USERNAME Carina username - can also set env var CARINA_USERNAME
--api-key=CARINA_APIKEY
Carina API Key - can also set env var CARINA_APIKEY
--endpoint="https://app.getcarina.com"
Carina API endpoint
Commands:
help [<command>...]
Show help.
create [<flags>] <cluster-name>
Create a swarm cluster
--wait wait for swarm cluster to come online (or error)
--segments=1 number of segments for the initial cluster
--autoscale whether autoscale is on or off
get <cluster-name>
Get information about a swarm cluster
list
List swarm clusters
grow --segments=SEGMENTS <cluster-name>
Grow a cluster by the requested number of segments
--segments=SEGMENTS number of segments to increase the cluster by
credentials [<flags>] <cluster-name>
download credentials
--path=<cluster-name>
path to write credentials out to
rebuild [<flags>] <cluster-name>
Rebuild a swarm cluster
--wait wait for swarm cluster to come online (or error)
delete <cluster-name>
Delete a swarm cluster
The build script assumes you're running go 1.5 or later. If not, upgrade or use something like gimme.
make carinaThis creates carina in the current directory (there is no make install currently).
If you want it to build on prior releases of go, we'd need a PR to change up how
the Makefile sets the LDFLAGS conditionally based on Go version.
The release script relies on github-release. Get it, configure it.
Make sure you're on master then run release.sh with the next tag and release name.
./release.sh v0.2.0 "Acute Aquarius"How do you pick the release name?
The hardest problem in computer science is picking names. For releases, we take an adjective attached combined with the next constellation from an alphabetical list of constellations. It can be alliterative if you like.