36 lines
1.8 KiB
Markdown
36 lines
1.8 KiB
Markdown
|
# Bootstrapping a Houdini Instance Using Docker
|
||
|
|
|
||
|
|
This file complements [the existing docker documentation](docker.md). The file
|
||
|
|
documents, in great detail, how to bootstrap Houdini into a docker image from
|
||
|
|
complete scratch. Special attention was given to verifying the licensing
|
||
|
|
requirements and details, and to attempt to reproduce the creation of the
|
||
|
|
Docker image from scratch in the most complete way. Some of the instructions
|
||
|
|
herein are not specific to Houdini or Ruby on Rails applications at all;
|
||
|
|
rather, they are simply documentation of steps that at least one user went
|
||
|
|
through to bootstrap to a usable docker image.
|
||
|
|
|
||
|
|
Commands that were run as pure root have the `#` in front of them; commands
|
||
|
|
run as a regular user (which sometimes include `sudo`, so note that some of
|
||
|
|
them are run with system privileges) have a `$` in front of them.
|
||
|
|
|
||
|
|
## Creating a Base Image
|
||
|
|
|
||
|
|
Since most Docker images have copyleft license compliance problem, rather
|
||
|
|
than using a docker image from Docker's problematic repositories, we create
|
||
|
|
a Debian image from scratch. Using the
|
||
|
|
[instructions to create one's own base image](https://docs.docker.com/develop/develop-images/baseimages/),
|
||
|
|
along with
|
||
|
|
[Debian's deboostrap instructions](https://wiki.debian.org/Debootstrap), to
|
||
|
|
create a docker image of Debian's `bullseye` release.
|
||
|
|
|
||
|
|
# mkdir /srv/bullseye-base
|
||
|
|
# debootstrap bullseye /srv/bullseye-base http://deb.debian.org/debian/
|
||
|
|
$ sudo tar -C /srv/bullseye-base -c . | docker import - bullseye-base
|
||
|
|
|
||
|
|
If the last command gets the error …
|
||
|
|
Got permission denied while trying to connect to the Docker daemon socket at unix:///var/run/docker.sock: …
|
||
|
|
… then likely the user account that you're using as a regular user is not in
|
||
|
|
the `docker` group.
|
||
|
|
|
||
|
|
This creates a docker image named `bullseye-base` on your system.
|