Issues from testing on Ubuntu

[lindboe]

I tested out the installation instructions on Ubuntu 19.10, writing my notes here to fix up later. Notes are WIP, just keeping track because my laptop is about to die 😅

Documentation:

• the link to fork the repo button doesn't work. Probably better to remove the link and add a description and/or image.
• I think it might be preferable to link to the Docker installation documentation here rather than the store, because it's easier to find the link for the documentation for your platform

Tech:

• There aren't any eoan (Ubuntu 19.10) builds on the Docker repos, so the example command to add the Docker repository (below) won't work since it uses lsb_release -cs. The Disco build works just fine, though, so add a footnote to change $(lsb_release -cs) to disco if on Ubuntu 19.10.

  sudo add-apt-repository \
     "deb [arch=amd64] https://download.docker.com/linux/ubuntu \
     $(lsb_release -cs) \
     stable"
  

• Non-sudo docker run does not work on Linux by default. Need to create a docker group with privileges and add the user to this group, via: https://docs.docker.com/install/linux/linux-postinstall/. This may require changes to how the script runs, since logging in/out may be required.

• docker-compose isn't included in docker installation instructions, but necessary for make cli

[gsong]

@lindboe Not sure if you're familiar with Ansible, but this is what I do on Ubuntu 18 servers to get Docker going:

• https://github.com/gsong/ansible-common/tree/master/roles/os-add-docker-group
• https://github.com/gsong/ansible-common/tree/master/roles/os-install-docker-tools

[gsong]

@demophoon Did you experience these issues when working on your Linux test run? If so, how did you overcome them?

[demophoon]

I didn't get to test out the installation steps as I install and manage docker/docker-compose through puppet. (https://github.com/demophoon/puppet-environment/blob/production/manifests/roles/docker.pp) I do not recommend new users setup docker this way unless we provide them with some sort of installer. I have a skeleton puppet repo that has its own installer we could use if absolutely needed.

I definitely know about the groups issue, and docker-compose needs to be installed separately from docker-ce (as docker-compose isn't provided by the docker-ce package. See dpkg-query -L docker-ce).

[gsong]

@demophoon Do you install docker-compose via pip or some other mechanism?

[demophoon]

@gsong Both docker and docker-compose are handled by puppet on all of my computers.

Which is to say, i don't actually know how puppet installs them to the computer, one of the great benefits of its declarative nature :P