Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/rackspace/rack
A CLI for Rackspace (unmaintained)
https://github.com/rackspace/rack
Last synced: 2 months ago
JSON representation
A CLI for Rackspace (unmaintained)
- Host: GitHub
- URL: https://github.com/rackspace/rack
- Owner: rackspace
- License: other
- Created: 2015-04-14T22:08:59.000Z (almost 10 years ago)
- Default Branch: master
- Last Pushed: 2023-05-09T20:59:15.000Z (over 1 year ago)
- Last Synced: 2024-08-02T01:26:29.408Z (6 months ago)
- Language: Go
- Homepage:
- Size: 2.33 MB
- Stars: 81
- Watchers: 14
- Forks: 57
- Open Issues: 54
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# rack (unmaintained)
Command-line interface for the Rackspace Cloud.
`rack` provides a consistent interface for interacting with the Rackspace Cloud. For example, creating a new server:
```
$ rack servers instance create \
--name my-server \
--image-id 5ed162cc-b4eb-4371-b24a-a0ae73376c73 \
--flavor-id general1-1 \
--keypair my-laptop
ID 9818861f-2f14-437f-89b0-a36dfa1831b7
AdminPass 4vLb2PiqUGdP
```
## Build From Source
Make sure you have [Go installed](https://golang.org/doc/install) and the [`GOPATH`](https://golang.org/doc/code.html#GOPATH) environment variable set.
```sh
go get github.com/rackspace/rack
cd $GOPATH/src/github.com/rackspace/rack
./script/build
```
## Setting Authentication Credentials
`rack` has a number of ways of getting credentials configured. The easiest way is to use `rack configure` to setup a profile:
```
$ rack configure
This interactive session will walk you through creating
a profile in your configuration file. You may fill in all or none of the
values.
Rackspace Username: iamacat
Rackspace API key: secrets
Rackspace Region: IAD
Profile Name (leave blank to create a default profile):
```
This will create a configuration file at `~/.rack/config` which will store your credentials. When using the default profile, you don't need to specify the profile:
```
rack servers instance list
```
However, if you've named a profile, you can use the `--profile` flag to specify it explicitly:
```
rack servers instance list --profile staging
```
### Environment Variables
In addition to using the config file, you can also use environment variables. The following environment variables are supported:
`RS_REGION_NAME` (DFW, IAD, ORD, LON, SYD, HKG)
`RS_USERNAME` (Your Rackspace username)
`RS_API_KEY` (Your Rackspace API key)
### Command-line
Lastly, you can also set your authentication credentials as flags:
```
$ rack servers instance list --username user1 --api-key 123456789 --region DFW
```
### Precedence
`rack` will first look for credentials as flags. Secondly, `rack` will use a named profile, or `default` if there is a default profile. Lastly, `rack` will look for environment variables.
## Bash Completion
At any time, you can run `rack init` which will create the auto-completion file in `~/.rack/bash_autocomplete` and add it to `~/.bash_profile`. You'll need to restart your terminal session to enable auto-completion.
For command completion on Windows, please see the [command completion](https://developer.rackspace.com/docs/rack-cli/configuration#command-completion) section on the configuration page of our documentation.