docs/drivers/rackspace.md

<!--[metadata]>
+++
title = "Rackspace"
description = "Rackspace driver for machine"
keywords = ["machine, Rackspace, driver"]
[menu.main]
parent="smn_machine_drivers"
+++
<![end-metadata]-->

# Rackspace

Create machines on [Rackspace cloud](http://www.rackspace.com/cloud)

Options:

-   `--rackspace-username`: **required** Rackspace account username.
-   `--rackspace-api-key`: **required** Rackspace API key.
-   `--rackspace-region`: **required** Rackspace region name.
-   `--rackspace-endpoint-type`: Rackspace endpoint type (`adminURL`, `internalURL` or the default `publicURL`).
-   `--rackspace-image-id`: Rackspace image ID. Default: Ubuntu 15.10 (Wily Werewolf) (PVHVM).
-   `--rackspace-flavor-id`: Rackspace flavor ID. Default: General Purpose 1GB.
-   `--rackspace-ssh-user`: SSH user for the newly booted machine.
-   `--rackspace-ssh-port`: SSH port for the newly booted machine.
-   `--rackspace-docker-install`: Set if Docker has to be installed on the machine.

The Rackspace driver will use `59a3fadd-93e7-4674-886a-64883e17115f` (Ubuntu 15.10) by default.

Environment variables and default values:

| CLI option                   | Environment variable | Default                                |
| ---------------------------- | -------------------- | -------------------------------------- |
| **`--rackspace-username`**   | `OS_USERNAME`        | -                                      |
| **`--rackspace-api-key`**    | `OS_API_KEY`         | -                                      |
| **`--rackspace-region`**     | `OS_REGION_NAME`     | -                                      |
| `--rackspace-endpoint-type`  | `OS_ENDPOINT_TYPE`   | `publicURL`                            |
| `--rackspace-image-id`       | -                    | `59a3fadd-93e7-4674-886a-64883e17115f` |
| `--rackspace-flavor-id`      | `OS_FLAVOR_ID`       | `general1-1`                           |
| `--rackspace-ssh-user`       | -                    | `root`                                 |
| `--rackspace-ssh-port`       | -                    | `22`                                   |
| `--rackspace-docker-install` | -                    | `true`                                 |
First stage of splitting out Splitting out docs Fixing location of help entering in changes from testing Filling in some missing structure Updating with the comments from Nathan Updating with the comments from Nathan Updating after talk with Evan/Nathan Signed-off-by: Mary Anthony <mary@docker.com> 2015-07-07 09:53:04 -07:00			`<!--[metadata]>`
			`+++`
			`title = "Rackspace"`
			`description = "Rackspace driver for machine"`
			`keywords = ["machine, Rackspace, driver"]`
			`[menu.main]`
			`parent="smn_machine_drivers"`
			`+++`
			`<![end-metadata]-->`

			`# Rackspace`
Lint all Markdown documents Signed-off-by: David Gageot <david@gageot.net> 2015-11-27 10:16:42 +01:00
First stage of splitting out Splitting out docs Fixing location of help entering in changes from testing Filling in some missing structure Updating with the comments from Nathan Updating with the comments from Nathan Updating after talk with Evan/Nathan Signed-off-by: Mary Anthony <mary@docker.com> 2015-07-07 09:53:04 -07:00			`Create machines on [Rackspace cloud](http://www.rackspace.com/cloud)`

			`Options:`

Lint all Markdown documents Signed-off-by: David Gageot <david@gageot.net> 2015-11-27 10:16:42 +01:00			- `--rackspace-username`: required Rackspace account username.
			- `--rackspace-api-key`: required Rackspace API key.
			- `--rackspace-region`: required Rackspace region name.
			- `--rackspace-endpoint-type`: Rackspace endpoint type (`adminURL`, `internalURL` or the default `publicURL`).
Rackspace : update default image to ubuntu 15.10 Signed-off-by: Thomas Recloux <thomas.recloux@gmail.com> 2015-12-03 14:24:29 +01:00			- `--rackspace-image-id`: Rackspace image ID. Default: Ubuntu 15.10 (Wily Werewolf) (PVHVM).
Lint all Markdown documents Signed-off-by: David Gageot <david@gageot.net> 2015-11-27 10:16:42 +01:00			- `--rackspace-flavor-id`: Rackspace flavor ID. Default: General Purpose 1GB.
			- `--rackspace-ssh-user`: SSH user for the newly booted machine.
			- `--rackspace-ssh-port`: SSH port for the newly booted machine.
			- `--rackspace-docker-install`: Set if Docker has to be installed on the machine.
First stage of splitting out Splitting out docs Fixing location of help entering in changes from testing Filling in some missing structure Updating with the comments from Nathan Updating with the comments from Nathan Updating after talk with Evan/Nathan Signed-off-by: Mary Anthony <mary@docker.com> 2015-07-07 09:53:04 -07:00
Rackspace : update default image to ubuntu 15.10 Signed-off-by: Thomas Recloux <thomas.recloux@gmail.com> 2015-12-03 14:24:29 +01:00			The Rackspace driver will use `59a3fadd-93e7-4674-886a-64883e17115f` (Ubuntu 15.10) by default.
First stage of splitting out Splitting out docs Fixing location of help entering in changes from testing Filling in some missing structure Updating with the comments from Nathan Updating with the comments from Nathan Updating after talk with Evan/Nathan Signed-off-by: Mary Anthony <mary@docker.com> 2015-07-07 09:53:04 -07:00
			`Environment variables and default values:`

			`\| CLI option \| Environment variable \| Default \|`
Lint all Markdown documents Signed-off-by: David Gageot <david@gageot.net> 2015-11-27 10:16:42 +01:00			`\| ---------------------------- \| -------------------- \| -------------------------------------- \|`
First stage of splitting out Splitting out docs Fixing location of help entering in changes from testing Filling in some missing structure Updating with the comments from Nathan Updating with the comments from Nathan Updating after talk with Evan/Nathan Signed-off-by: Mary Anthony <mary@docker.com> 2015-07-07 09:53:04 -07:00			\| `--rackspace-username` \| `OS_USERNAME` \| - \|
			\| `--rackspace-api-key` \| `OS_API_KEY` \| - \|
			\| `--rackspace-region` \| `OS_REGION_NAME` \| - \|
			\| `--rackspace-endpoint-type` \| `OS_ENDPOINT_TYPE` \| `publicURL` \|
Rackspace : update default image to ubuntu 15.10 Signed-off-by: Thomas Recloux <thomas.recloux@gmail.com> 2015-12-03 14:24:29 +01:00			\| `--rackspace-image-id` \| - \| `59a3fadd-93e7-4674-886a-64883e17115f` \|
First stage of splitting out Splitting out docs Fixing location of help entering in changes from testing Filling in some missing structure Updating with the comments from Nathan Updating with the comments from Nathan Updating after talk with Evan/Nathan Signed-off-by: Mary Anthony <mary@docker.com> 2015-07-07 09:53:04 -07:00			\| `--rackspace-flavor-id` \| `OS_FLAVOR_ID` \| `general1-1` \|
			\| `--rackspace-ssh-user` \| - \| `root` \|
			\| `--rackspace-ssh-port` \| - \| `22` \|
			\| `--rackspace-docker-install` \| - \| `true` \|