This is an automatic MacOSX and Ubuntu Linux Docker provisioner, based on Ansible.
It will install the following packages:
- Install and upgrade docker, docker-machine
- Install and configure dinghy
- Start dnsdock container alongside dnsmasq proxy resolver
- Install a launchscript to automatically start the docker vm (MacOSX only)
To install on MacOSX, no matter which version, issue
bash <(curl -fsSL https://raw.githubusercontent.com/sparkfabrik/sparkdock/master/bin/install.macosx)
If success, last step is to add on your shell profile file, the following line eval "$(dinghy env)".
Depending on the shell you are using (HINT: you can discover it by opening a terminal andh run echo $SHELL):
- zsh:
~/.zshrc - bash:
~/.bash_profile
We are currently supporting all versions from 14.04 LTS up to 20.04 LTS.
18.04 support is finally stable (but for docker, read on) and the installation procedure is now totally uninstrusive on systems that ships with systemd-resolved (namely 17.04+).
The new installer automatically selects the correct packages and configurations for your OS version.
Important note on docker: due to some delay in releasing a stable bionic package we are relying on test official repo channel. This means ATTOW we are running docker-ce 18.05rc1. If you experience any issue, please change your repository back to artful stable.
Stable support will be available as soon as available (probably in june 2018).
To install just issue
bash <(curl -fsSL https://raw.githubusercontent.com/sparkfabrik/sparkdock/master/bin/install.ubuntu)
The provisioner has been tested on Debian Stretch 9.1 only. With newer versions YMMV. To install on Debian, issue
bash <(curl -fsSL https://raw.githubusercontent.com/sparkfabrik/sparkdock/master/bin/install.debian)
Please find hints and troubleshooting information on our company playbook: http://playbook.sparkfabrik.com/guides/local-development-environment-configuration
Open a terminal and run:
systemctl restart systemd-resolved
To check the status of systemd-resolved run: resolvectl status from the command line and you
should see something like this:
Global
LLMNR setting: no
MulticastDNS setting: no
DNSOverTLS setting: no
DNSSEC setting: no
DNSSEC supported: no
Current DNS Server: 172.17.0.1
DNS Servers: 172.17.0.1
DNS Domain: ~loc
DNSSEC NTA: 10.in-addr.arpa
16.172.in-addr.arpa
168.192.in-addr.arpa
17.172.in-addr.arpa
18.172.in-addr.arpa
19.172.in-addr.arpa
20.172.in-addr.arpa
- Check if dnsmasq is running with
brew services, to be sure runbrew services restart dnsmasqthenps aux | grep dnsmasqto check if the process is running. - Check if dnsmasq configurations is equal to: https://github.com/sparkfabrik/sparkdock/blob/master/config/macosx/dnsmasq.conf
- Check if the static routing is still active, to be sure run
sudo route -n add -net 172.16.0.0/12 $(docker-machine ip dinghy) - Check if dnsdock container is running
docker ps | grep dnsdock - Check dinghy services, you should see something like this:
❯ dinghy status
VM: running
NFS: running
FSEV: running
DNS: stopped
PROXY: stopped
- Clear the system DNS cache with the following commands:
sudo dscacheutil -flushcache
sudo killall -HUP mDNSResponder
With the latest release of sparkdock we introduced the use of the daemon "fsevents_to_vm" (https://github.com/codekitchen/fsevents_to_vm) which is a simple daemon act to migrate osx fsevents filesystem over ssh to the docker-machine, as NFS does not support them.
To check if the daemon is running run ps aux | grep fsevents_to_vm if you don't see any process, you can run it again by typing /usr/local/bin/fsevent-start.
- Check if dnsmasq can actually start or dnsdock is binding port 53 on 0.0.0.0
- Check the other way around
- Check you are running dnsmasq with the default configuration in
/etc/dnsmasq.conf(you really should use/etc/dnsmasq.dto store personal config files!) - Are your user in the
dockergroup? - Did your read the last notice about loggin' out, then in again to make unix know your user was added to such group?
This package is maintained by SparkFabrik's staff, mostly by Paolo Mainardi (MacOSX configuration) and Paolo Pustorino (Ubuntu configuration).
Contributions are welcome, in particular it would be great to have playbooks for other OSes or Linux distro. Send us PRs, open issues if you encounter bugs, talk about this stuff in your blog and - most important - use docker! ;)