mirror of
https://github.com/apache/jclouds.git
synced 2025-02-06 10:09:35 +00:00
33522b8945
- bump api version to 1.21 - use `alpine/3.2` image for liveTests - use `kwart/alpine-ext:3.2-ssh` image as ssh-able image - assert request bodies created correctly in NetworkApiMockTest
56 lines
2.2 KiB
Markdown
56 lines
2.2 KiB
Markdown
# Docker as a local cloud provider
|
|
jclouds-docker is a local cloud provider modelled on [docker](http://www.docker.io). Similar to other jclouds supported
|
|
providers, it supports the same portable abstractions offered by jclouds.
|
|
|
|
##Setup
|
|
|
|
Please follow these steps to configure your workstation for jclouds-docker:
|
|
|
|
- install the latest Docker release (please visit https://docs.docker.com/installation/)
|
|
|
|
If you are using `docker-machine` then it can also manage certificates and help you setup `DOCKER_CERT_PATH` and `DOCKER_HOST` environment variables.
|
|
|
|
Assuming these environment variables are setup correctly there are no further setups steps are required.
|
|
|
|
Live tests then can now be run: `mvn -Plive integration-test`
|
|
|
|
#How it works
|
|
|
|
|
|
--------------- -------------
|
|
| Image(s) | | Node(s) |
|
|
--------------- -------------
|
|
--------- docker remote api ----------------------------------------
|
|
| jclouds | ---------------------------> | DOCKER_HOST |
|
|
--------- ----------------------------------------
|
|
|
|
##Components
|
|
|
|
- jclouds \- acts as a java client to access to docker features
|
|
- DOCKER_HOST \- hosts Docker API, NB: jclouds-docker assumes that the latest Docker is installed
|
|
- Image \- it is a docker image that can be started.
|
|
- Node \- is a docker container
|
|
|
|
## Assumptions
|
|
|
|
- jclouds-docker assumes that the images specified using the template are ssh'able.
|
|
|
|
--------------
|
|
|
|
#Notes:
|
|
- jclouds-docker is still at alpha stage please report any issues you find at [jclouds issues](https://issues.apache.org/jira/browse/JCLOUDS)
|
|
- jclouds-docker has been tested on Mac OSX, it might work on Linux iff vbox is running and set up correctly. However, it has never been tried on Windows.
|
|
|
|
--------------
|
|
|
|
#Troubleshooting
|
|
As jclouds docker support is quite new, issues may occasionally arise. Please follow these steps to get things going again:
|
|
|
|
1. Remove all containers
|
|
|
|
$ docker rm -f `docker ps -a`
|
|
|
|
2. remove all the images
|
|
|
|
$ docker rmi -f `docker images -q`
|