Remove old documentation source, add README on migration
Signed-off-by: John Mulhausen <john@docker.com>
This commit is contained in:
John Mulhausen
parent
4b671ea1cb
commit
464e29cddc
|
|
@ -1,79 +0,0 @@
|
||||||
<!--[metadata]>
|
|
||||||
+++
|
|
||||||
title = "OpenStack"
|
|
||||||
description = "OpenStack driver for machine"
|
|
||||||
keywords = ["machine, OpenStack, driver"]
|
|
||||||
[menu.main]
|
|
||||||
parent="smn_machine_drivers"
|
|
||||||
+++
|
|
||||||
<![end-metadata]-->
|
|
||||||
|
|
||||||
# OpenStack
|
|
||||||
|
|
||||||
Create machines on [OpenStack](http://www.openstack.org/software/)
|
|
||||||
|
|
||||||
Mandatory:
|
|
||||||
|
|
||||||
- `--openstack-auth-url`: Keystone service base URL.
|
|
||||||
- `--openstack-flavor-id` or `--openstack-flavor-name`: Identify the flavor that will be used for the machine.
|
|
||||||
- `--openstack-image-id` or `--openstack-image-name`: Identify the image that will be used for the machine.
|
|
||||||
|
|
||||||
## Usage
|
|
||||||
|
|
||||||
$ docker-machine create --driver openstack vm
|
|
||||||
|
|
||||||
## Options
|
|
||||||
|
|
||||||
- `--openstack-active-timeout`: The timeout in seconds until the OpenStack instance must be active.
|
|
||||||
- `--openstack-availability-zone`: The availability zone in which to launch the server.
|
|
||||||
- `--openstack-cacert`: The CA certificate bundle to verify against.
|
|
||||||
- `--openstack-domain-name` or `--openstack-domain-id`: Domain to use for authentication (Keystone v3 only).
|
|
||||||
- `--openstack-endpoint-type`: Endpoint type can be `internalURL`, `adminURL` on `publicURL`. If is a helper for the driver
|
|
||||||
to choose the right URL in the OpenStack service catalog. If not provided the default id `publicURL`
|
|
||||||
- `--openstack-floatingip-pool`: The IP pool that will be used to get a public IP can assign it to the machine. If there is an
|
|
||||||
IP address already allocated but not assigned to any machine, this IP will be chosen and assigned to the machine. If
|
|
||||||
there is no IP address already allocated a new IP will be allocated and assigned to the machine.
|
|
||||||
- `--openstack-keypair-name`: Specify the existing Nova keypair to use.
|
|
||||||
- `--openstack-insecure`: Explicitly allow openstack driver to perform "insecure" SSL (https) requests. The server's certificate will not be verified against any certificate authorities. This option should be used with caution.
|
|
||||||
- `--openstack-ip-version`: If the instance has both IPv4 and IPv6 address, you can select IP version. If not provided `4` will be used.
|
|
||||||
- `--openstack-net-name` or `--openstack-net-id`: Identify the private network the machine will be connected on. If your OpenStack project project contains only one private network it will be use automatically.
|
|
||||||
- `--openstack-password`: User password. It can be omitted if the standard environment variable `OS_PASSWORD` is set.
|
|
||||||
- `--openstack-private-key-file`: Used with `--openstack-keypair-name`, associates the private key to the keypair.
|
|
||||||
- `--openstack-region`: The region to work on. Can be omitted if there is only one region on the OpenStack.
|
|
||||||
- `--openstack-sec-groups`: If security groups are available on your OpenStack you can specify a comma separated list
|
|
||||||
to use for the machine (e.g. `secgrp001,secgrp002`).
|
|
||||||
- `--openstack-username`: User identifier to authenticate with.
|
|
||||||
- `--openstack-ssh-port`: Customize the SSH port if the SSH server on the machine does not listen on the default port.
|
|
||||||
- `--openstack-ssh-user`: The username to use for SSH into the machine. If not provided `root` will be used.
|
|
||||||
- `--openstack-tenant-name` or `--openstack-tenant-id`: Identify the tenant in which the machine will be created.
|
|
||||||
|
|
||||||
#### Environment variables and default values
|
|
||||||
|
|
||||||
| CLI option | Environment variable | Default |
|
|
||||||
| ------------------------------- | ---------------------- | ----------- |
|
|
||||||
| `--openstack-active-timeout` | `OS_ACTIVE_TIMEOUT` | `200` |
|
|
||||||
| `--openstack-auth-url` | `OS_AUTH_URL` | - |
|
|
||||||
| `--openstack-availability-zone` | `OS_AVAILABILITY_ZONE` | - |
|
|
||||||
| `--openstack-cacert` | `OS_CACERT | - |
|
|
||||||
| `--openstack-domain-id` | `OS_DOMAIN_ID` | - |
|
|
||||||
| `--openstack-domain-name` | `OS_DOMAIN_NAME` | - |
|
|
||||||
| `--openstack-endpoint-type` | `OS_ENDPOINT_TYPE` | `publicURL` |
|
|
||||||
| `--openstack-flavor-id` | `OS_FLAVOR_ID` | - |
|
|
||||||
| `--openstack-flavor-name` | `OS_FLAVOR_NAME` | - |
|
|
||||||
| `--openstack-floatingip-pool` | `OS_FLOATINGIP_POOL` | - |
|
|
||||||
| `--openstack-image-id` | `OS_IMAGE_ID` | - |
|
|
||||||
| `--openstack-image-name` | `OS_IMAGE_NAME` | - |
|
|
||||||
| `--openstack-insecure` | `OS_INSECURE` | `false` |
|
|
||||||
| `--openstack-ip-version` | `OS_IP_VERSION` | `4` |
|
|
||||||
| `--openstack-keypair-name` | `OS_KEYPAIR_NAME` | - |
|
|
||||||
| `--openstack-net-id` | `OS_NETWORK_ID` | - |
|
|
||||||
| `--openstack-net-name` | `OS_NETWORK_NAME` | - |
|
|
||||||
| `--openstack-password` | `OS_PASSWORD` | - |
|
|
||||||
| `--openstack-private-key-file` | `OS_PRIVATE_KEY_FILE` | - |
|
|
||||||
| `--openstack-region` | `OS_REGION_NAME` | - |
|
|
||||||
| `--openstack-sec-groups` | `OS_SECURITY_GROUPS` | - |
|
|
||||||
| `--openstack-ssh-port` | `OS_SSH_PORT` | `22` |
|
|
||||||
| `--openstack-ssh-user` | `OS_SSH_USER` | `root` |
|
|
||||||
| `--openstack-tenant-id` | `OS_TENANT_ID` | - |
|
|
||||||
| `--openstack-tenant-name` | `OS_TENANT_NAME` | - |
|
|
||||||
| `--openstack-username` | `OS_USERNAME` | - |
|
|
||||||
Loading…
Reference in New Issue