Machine is the single easiest way to provision a new Docker host or . I use it to setup new remote staging servers and it takes a minute at most. It selects an appropriate Linux distribution for the Docker Engine and installs the Docker daemon, all in one go. Docker machine It can do all of this with 15 different cloud providers! You can set up a server in any of them, using the same simple command .For example, if you’re using , Docker Machine calls the AWS API on your behalf to create an EC2 instance into your AWS account. docker-machine create AWS — it’s blazing fast — the command line is dead simple — it manages all of the SSH keys and TLS certificates even if you have dozens of servers — makes your servers immediately ready for Docker deployments But there’s one pain… It can only store all of its configuration locally on your computer. So after you’ve setup your servers and deployed your project your teammates won’t be able to connect to the and redeploy by themselves. machine How can you share access to the Docker Host with your teammates? They need both the SSH keys and the TLS certificates that Machine created to connect to the remote Docker daemon.You need at leas the TLS certificates to connect to your remote Docker host from your local Docker client, as it is the secure way for Docker to connect to the Docker HTTP API exposed on port 2376. Btw, how does it work? I’ve shown how Docker Machine stores keys and certificates on your local computer. It’s all in . here ~/.docker/machine/machines Fail #1: Using the Docker Machine generic driver Docker Machine “generic” driver creates using an existing VM/Host with SSH. It’s also great if you’ve provisioned your servers with Terraform for example, as it will connect to them and install the Docker daemon for you. machines The Generic driver then sounds like a valid solution for your teammates to install the Docker Machine: docker-machine create \ --driver generic \ --generic-ip-address=YOUR_SERVER_IP \ --generic-ssh-key PATH_TO_YOUR_SSH_KEY \ my_project This will connect to the remote server, restart the Docker daemon, stop all the running containers and … regenerate the remote TLS certificates. Which means they can connect but you can’t connect anymore! Error checking and/or regenerating the certs. You can attempt to regenerate them using ‘docker-machine regenerate-certs [name]’ Well, you could regenerate both the local and the remote certificates from your end and your teammates would have to do the same next time etc.. FAIL Fail #2: Copying folders Now that you know how Machine internally stores the configuration, the second thought is simply to copy the folder directly into your teammates folder. machine ~/.docker/machine/machines/xxx ~/.docker/machine/machines Let’s try it, and try to connect to the Docker host: There was an error validating certificates for host “YOUR_SERVER_IP:2376”: x509: certificate signed by unknown authority Wow, Machine detects that the client certificates you’ve been copying haven’t been created/signed by yourself (with your own master certificates stored in ) and refuses to connect. FAIL ~/.docker/machine/certs Fail #3: Use Docker Machine “none” driver This one looks like it fits the bill but seems to have been broken for a while. The solution The solution is to import both the client certificates and SSH keys for this Docker host, but also the master certificates from the developer who initially created the Docker . machine You don’t want to overwrite your own master certificates so we’ll save them in the folder and modify the file to point to these specific master certificates. machine machine config.json Clone your your folder into a temporary directory and your certificates into it: machine $ 2. Update the to be compatible with your teammate Docker storage path (Docker Machine only takes absolute paths so you need to replace with ) (assuming OSX): ./my_machine/config.json /Users/your_username/.docker /Users/her_username/.docker $ sed -i.bak 's/machine\/certs/machine\/machines\/my_machine\/certs/' ./my_machine/config.json $ sed -i.bak 's/your_username/her_username/' ./my_machine/config.json 3. Archive your configuration: machine $ tar -zcf my_machine.tar.gz my_machine Get them to extract the archive into their . Voilà! ~/.docker/machine Lionel is Chief Technology Officer of London-based startup Wi5 and author of the Future-Proof Engineering Culture course . You can reach out to him on https://getlionel.com
