# Create your first OVH Cloud Docker machine
docker-machine create -d ovh hello-docker
OVH Cloud driver is based on OVH Public API. To create OVH API credentials, you may visit https://api.ovh.com. See 1. Get your OVH credentials below for a detailed how-to
The easiest way to install ovh docker-machine driver is to:
go install github.com/yadutaf/docker-machine-driver-ovh
ln -s $GOPATH/bin/docker-machine-driver-ovh /usr/local/bin/docker-machine-driver-ovh
OVH driver never store your OVH login and password. Instead it uses a set of 3 keys dedicated to a given application. If you don't have your keys already, generating them is easy:
- Go to the token creation page: https://api.ovh.com/createToken/?GET=/*&POST=/*&DELETE=/*&PUT=/*
- Enter your login, password, a name and a short description then validate. You may want to increase the validity period.
- You now have an
Application Key
,Application Secret
and aConsumer Key
.
This file will allow any application built with official OVH API drivers to use it without requiring new keys:
[default]
endpoint=ovh-eu
[ovh-eu]
application_key=<Application Key>
application_secret=<Application Secret>
consumer_key=<Consumer Key>
docker-machine create -d ovh node-1
Option Name | Description | Default Value | required |
---|---|---|---|
--ovh-application-secret or $OVH_APPLICATION_SECRET |
Application Secret | none | yes |
--ovh-application-key or $OVH_APPLICATION_KEY |
Application key | none | yes |
--ovh-consumer-key or $OVH_CONSUMER_KEY |
Consumer Key | none | yes |
--ovh-region |
Cloud region | GRA1 | no |
--ovh-flavor |
Cloud Machine type | vps-ssd-1 | no |
--ovh-project |
Cloud Project name | single one | only if multiple projects |
Note: OVH credentials may be supplied through arguments, environment or configuration file, by order of decreasing priority. The configuration may be:
- global
/etc/ovh.conf
- user specific
~/.ovh.conf
- application specific
./ovh.conf
go get github.com/yadutaf/docker-machine-driver-ovh
cd $GOPATH/src/github.com/yadutaf/docker-machine-driver-ovh
Make sure to export GO15VENDOREXPERIMENT=1
. Every necessary dependency is
stored in the vendoring directory.
To test the driver make sure your current build directory has the highest
priority in your $PATH
so that docker-machine can find it.
export PATH=$GOPATH/src/github.com/yadutaf/docker-machine-driver-ovh:$PATH
- OVH Cloud console: https://www.ovh.com/manager/cloud/index.html
- OVH Cloud offers: https://www.ovh.com/us/cloud/
- Docker Machine: https://docs.docker.com/machine/
- Contribute: https://github.com/yadutaf/docker-machine-driver-ovh
- Report bugs: https://github.com/yadutaf/docker-machine-driver-ovh/issues
MIT