andmarios/devenv repository overview

⁠DevOps Environment with some extra sauce

This is a text-based development and operations environment. It is neither basic nor slim. Its purpose is to let a developer push to his work repositories or manage his work servers in under one minute since docker run.

It includes in random order:

• gcc, golang, openjdk, python, ruby, scala (maven and sbt), development tools, nodejs etc
• emacs pre-configured with syntax highlighting and some sugar
• vim pre-configured with syntax highlighting
• golang autocomplete support for both emacs and vim
• scala autocomplete support for emacs (ensime, sbt)
• html autocomplete support for both emacs and vim
• git with bash completion enabled
• docker support with bash completion enabled
• tmux pre-configured
• ssh-agent
• ansible
• various tools (bind-utils, mlocate, jq, htop, etc)
• various custom bash commands, try dockip or gl (inside a git repo)
• jekyll

Optional:

• GCE project auto-activation support (through service account)
• ability to use provided ssh keys and settings (i.e use your ~/.ssh)
• automatic clone new / pull existing git repositories
• ansible automatic GCE configuration

Inside the container you start as a normal user (dev, uid 1000). This is only for your safety and to help with setup/use cases separation. You have sudo access if you need to run commands as the superuser (e.g yum install).

⁠GCE project auto-activation

Create a file named gce.account that contains your GCE service account. Create a file named gce.key that contains your unencrypted PEM key (from your p12 file).

If your files are inside /path/to/dsetup, then:

$ docker run -it -v /path/to/dsetup:/home/dev/.setup andmarios/devenv

If you want to enable automatic ansible GCE support you have to provide one more file named gce.project that contains your GCE project id. Example for creating gce.account and gce.project:

$ echo "[email protected]" > gce.account
$ echo "MYPROJECTID" > gce.project

⁠Provide SSH keys and settings

You may provide your $HOME/.ssh directory so that you will have your ssh keys and settings inside the container. The ssh-agent will ask you to activate your id_rsa key and any other key mentioned inside $HOME/.ssh/config. If you don't want to use the ssh-agent, press enter instead of providing your passphrase when asked.

$ docker run -it -v /home/USER/.ssh:/home/dev/.setup-ssh andmarios/devenv

| The reason we don't bind-mount directly to /home/dev/.ssh is that your user may have a different uid/gid from the | container's user. Bash scripts inside the container take care of this.

⁠Auto clone/pull repositories and custom gitconfig

Create a file named repos and add your git repositories inside, one per line. Then if your file is inside /path/to/dsetup:

$ docker run -it -v /path/to/dsetup:/home/dev/.setup andmarios/devenv

Obviously if your repositories need SSH keys for access, you have to provide them as mentioned above.

You can also supply your ~/.gitconfig file as gitconfig inside /path/to/dsetup, so that git will be preconfigured with your settings. If you don't want to copy it, you can always bind mount the original:

$ docker run -it -v /path/to/dsetup:/home/dev/.setup -v /home/USER/.gitconfig:/home/dev/.setup/gitconfig andmarios/devenv

I suggest to copy your gitconfig though.

⁠Docker support

The container can use an external docker daemon through bind mounting its socket:

$ docker run -it -v /run/docker.sock:/run/docker.sock andmarios/devenv

If your docker socket is owned by root you can use it directly. If it is owned by someone else, you need to use sudo for the docker commands.