diff --git a/docs/bootstrap-instance-with-docker.md b/docs/bootstrap-instance-with-docker.md index 17a4c220..ab24da05 100644 --- a/docs/bootstrap-instance-with-docker.md +++ b/docs/bootstrap-instance-with-docker.md @@ -1,13 +1,14 @@ # 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. +This file complements [the existing docker documentation](docker.md). The +file documents, in great detail, how to bootstrap Houdini into a docker +image, primarily from source code wherever possible, 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 @@ -33,3 +34,31 @@ If the last command gets the error … the `docker` group. This creates a docker image named `bullseye-base` on your system. + +## Building Node 14 from Source + +Currently, the default Docker image uses the Debian `nodejs` version +`14.17.4-deb-1nodesource1` as downloaded from this apt-source entry: + + deb [signed-by=/usr/share/keyrings/nodesource.gpg] https://deb.nodesource.com/node_14.x bullseye main + +… which leads to this line in the apt-get output: + + Get:9 https://deb.nodesource.com/node_14.x bullseye/main amd64 nodejs amd64 14.17.4-deb-1nodesource1 [25.0 MB] + +We have not yet provided a method yet to bootstrap the necessary version of +Node from source. + +## Building Yarn 14 from Source + +Currently, the default Docker image uses the Debian `nodejs` version +`1.22.5-1` as downloaded from this apt-source entry: + + deb [signed-by=/usr/share/keyrings/nodesource.gpg] https://deb.nodesource.com/node_14.x bullseye main + +… which leads to this line in the apt-get output: + + Get:6 https://dl.yarnpkg.com/debian stable/main amd64 yarn all 1.22.5-1 [891 kB] + +We have not provided a method yet to bootstrap the necessary version of +Yarn from source.