Base Images for Hanami 1.1.1
These images are built from jdickey's Customised Ruby Builds, with tags matching those in the base image. This leads to a bit of complexity, as we now have three significant (conceptual) versioned layers that the users of these images should care about: the base operating system (Debian Jessie or Stretch, Alpine); the version of Ruby being used (currently, 2.4.2, 2.4.3, or 2.5.0); and the version of the Hanami framework (here, Version 1.1.1; current as of this writing). Encoding all three version identifiers into a single tag name could lead to tags such as 1.1.1-stretch-2.5.0 or, worse, 1.1.1-2.5.0 (implying "whatever the current default base OS is"). Does anyone not have problems with this? Hence, this repo will concern itself with only Hanami 1.1.1; future releases of Hanami are expected to be supported by congruently-structured and -tagged but separate Docker image repos.
As of Version 0.11.1, a new build process is used, using a Ruby CLI-driven script dynamically builds a sequence of in-memory Dockerfile text sequences, and builds them dynamically using the docker-api Gem. While building the Dockerfile for a particular image, a sequence of gem install commands is RUN based on whether the image is or is not built with the hanami-model Gem, and whether or not it is built with the capybara Gem, useful for testing. Using capybara also requires operating-system support, including the Qt GUI toolkit, which adds significant size to the image being built.
One consequence of this is that building the entire set of base images takes significantly less time as running a sequence of docker build command-line invocations (roughly 13 minutes for the current 20 base images, vs 55 minutes for the 17 images supported previously).
Each built image encodes four items of information about itself into its image name:
-
the version of Ruby installed in the image (currently, MRI 2.4.2, 2.4.3, or 2.5.0);
-
the base operating system used to build the image (Debian Jessie, slimmed-down Debian Jessie, Debian Stretch, slimmed-down Debian Stretch, or Alpine 3.7);
-
whether the image includes the
hanami-modelGem and its supporting Gems (but not any specific database-access Gems such assqliteorpg); and -
whether the image includes the Qt windowing toolkit, needed for the Capybara test-automation library and the
capybara-webkitheadless browser.
Examples might be 2.5.0-alpine-hm-no-qt or 2.4.2-jessie-no-hm-qt.
Additional tags are created as synonyms for the as-built tags. For example, the 2.4-jessie-hm-qt tag refers to the latest 2.4.x Ruby version (currently, 2.4.3). Similarly, the 2-no-hm-no-qt tag refers to the latest 2.x version of Ruby, which is presently 2.5.0 built on Debian Stretch. Finally, tags which do not name a particular base OS (jessie, stretch, or alpine) refer to what has been designated the "default" for a specific Ruby version, which is generally in accordance with the defaults for the official Ruby images. 2.4 is a synonym for 2.4.3-jessie-hm-qt, and 2.5 is a synonym for 2.5.0-alpine-hm-qt.
The full list of tags follows, as a sequence of lists. Each list starts with the base tag used when that image was first generated. List items below that are alternatives to (aliases for) the base tag. Note that pulling the image without specifying a tag will pull the latest image, which is the same image as 2.5.0-stretch-hm-qt. The alternative tags expected to be most commonly used are listed; however, in general, the use of the base image name is strongly recommended.
These images are expected to be used more for development and testing than for production deployment, since they include Qt and Capybara, which bloat the images considerably but are not orinarily used in production.
Note that the Debian images have "normal" images (stretch or jessie) as well as "slim" images (stretch-slim or jessie-slim). The "slim" images have fewer packages installed by default, and thus use less disk space for the base image, but are still considerably larger than equivalent alpine images.
-
Base image tag:
2.5.0-alpine3.7-hm-qt- Common alternative tags:
2.5.0-alpine2.5-alpinealpine
- All tags for image:
2.5-alpine3.7-hm-qt2-alpine3.7-hm-qtalpine3.7-hm-qt2.5.0-alpine3.72.5-alpine3.72-alpine3.7alpine3.72.5.0-alpine37-hm-qt2.5-alpine37-hm-qt2-alpine37-hm-qtalpine37-hm-qt2.5.0-alpine372.5-alpine372-alpine37alpine372.5.0-alpine-hm-qt2.5-alpine-hm-qt2-alpine-hm-qtalpine-hm-qt2.5.0-alpine2.5-alpine2-alpinealpine
- Common alternative tags:
-
Base image tag:
2.5.0-stretch-hm-qt- Common alternative tags:
2.5.02.5latest
- All tags for image:
2.5.0-hm-qt2.5-stretch-hm-qt2.5-hm-qt2-stretch-hm-qt2-hm-qtstretch-hm-qthm-qt2.5-stretch2-stretchstretch2.5.02.52latest
- Common alternative tags:
-
Base image tag:
2.5.0-slim-stretch-hm-qt- Common alternative tags:
2.5.0-slim2.5-slimslim
- All tags for image:
2.5.0-slim-hm-qt2.5-slim-stretch-hm-qt2.5-slim-hm-qt2-slim-stretch-hm-qt2-slim-hm-qt2-slim-stretch-hm-qt2-slim-hm-qtslim-stretch-hm-qtslim-hm-qt2.5-slim-stretch2-slim-stretchslim-stretch2.5.0-slim2.5-slim2-slimslim
- Common alternative tags:
-
Base image tag:
2.4.3-jessie-hm-qt- Common alternative tags:
2.4.32.4
- All tags for image:
2.4-jessie-hm-qt2.4.3-hm-qt2.4.32.4-hm-qt2.4
- Common alternative tags:
-
Base image tag:
2.4.3-slim-jessie-hm-qt- Common alternative tags:
2.4.3-slim2.4-slim
- All tags for image:
2.4-slim-jessie-hm-qt2.4.3-slim-hm-qt2.4-slim-hm-qt2.4.3-slim2.4-slim
- Common alternative tags:
Equivalents without the (generally recommended) hanami-model Gem:
-
Base image tag:
2.5.0-alpine3.7-no-hm-qt- Common alternative tags:
2.5.0-alpine-no-hm2.5-alpine-no-hmalpine-no-hm
- All tags for image:
2.5-alpine3.7-no-hm-qt2-alpine3.7-no-hm-qtalpine3.7-no-hm-qt2.5.0-alpine3.7-no-hm2.5-alpine3.7-no-hm2-alpine3.7-no-hmalpine3.7-no-hm2.5.0-alpine37-no-hm-qt2.5-alpine37-no-hm-qt2-alpine37-no-hm-qtalpine37-no-hm-qt2.5.0-alpine37-no-hm2.5-alpine37-no-hm2-alpine37-no-hmalpine37-no-hm2.5.0-alpine-no-hm-qt2.5-alpine-no-hm-qt2-alpine-no-hm-qtalpine-no-hm-qt2.5.0-alpine-no-hm2.5-alpine-no-hm2-alpine-no-hmalpine-no-hm
- Common alternative tags:
-
Base image tag:
2.5.0-stretch-no-hm-qt- Common alternative tags:
2.5.0-no-hm-qtno-hm-qtstretch-no-hm
- All tags for image:
2.5.0-no-hm-qt2.5-stretch-no-hm-qt2.5-no-hm-qt2-stretch-no-hm-qt2-no-hm-qtstretch-no-hm-qtno-hm-qtstretch-no-hm
- Common alternative tags:
-
Base image tag:
2.5.0-slim-stretch-no-hm-qt- Common alternative tags:
2.5.0-slim-no-hm-qtslim-no-hm
- All tags for image:
2.5.0-slim-no-hm-qt2.5-slim-stretch-no-hm-qt2.5-slim-no-hm-qt2-slim-stretch-no-hm-qt2-slim-no-hm-qt2-slim-stretch-no-hm-qt2-slim-no-hm-qtslim-stretch-no-hm-qtslim-no-hm-qtslim-no-hm2.5-slim-stretch-no-hm2-slim-stretch-no-hmslim-stretch-no-hm
- Common alternative tags:
-
Base image tag:
2.4.3-jessie-no-hm-qt- Common alternative tags:
2.4-jessie-no-hm-qt2.4.3-no-hm-qt2.4-no-hm-qt
- All tags for image:
2.4-jessie-no-hm-qt2.4.3-no-hm-qt2.4-no-hm-qt
- Common alternative tags:
-
Base image tag:
2.4.3-slim-jessie-no-hm-qt- Common alternative tags:
2.4-slim-jessie-no-hm-qtjessie-no-hm-qt
- All tags for image:
2.4-slim-jessie-no-hm-qt2.4.3-slim-no-hm-qt2.4-slim-no-hm-qtslim-jessie-no-hm-qtjessie-no-hm-qt
- Common alternative tags:
These images do not include the Qt GUI libraries, the Capybara testing framework, or the capybara-webkit headless-browsing interface for Capybara, and are thus useful when the extra size induced by these packages is undesirable (e.g., in an image being built for production).
-
Base image tag:
2.5.0-alpine3.7-hm-no-qt- Common alternative tags:
2.5.0-alpine-no-qt2.5-alpine-no-qtalpine-no-qt
- All tags for image:
2.5-alpine3.7-hm-no-qt2-alpine3.7-hm-no-qtalpine3.7-hm-no-qt2.5.0-alpine3.7-no-qt2.5-alpine3.7-no-qt2-alpine3.7-no-qtalpine3.7-no-qt2.5.0-alpine37-hm-no-qt2.5-alpine37-hm-no-qt2-alpine37-hm-no-qtalpine37-hm-no-qt2.5.0-alpine37-no-qt2.5-alpine37-no-qt2-alpine37-no-qtalpine37-no-qt2.5.0-alpine-hm-no-qt2.5-alpine-hm-no-qt2-alpine-hm-no-qtalpine-hm-no-qt2.5.0-alpine-no-qt2.5-alpine-no-qt2-alpine-no-qtalpine-no-qt
- Common alternative tags:
-
Base image tag:
2.5.0-stretch-hm-no-qt- Common alternative tags:
2.5.0-hm-no-qtstretch-hm-no-qthm-no-qtno-qt
- All tags for image:
2.5.0-hm-no-qt2.5-stretch-hm-no-qt2.5-hm-no-qt2-stretch-hm-no-qt2-hm-no-qtstretch-hm-no-qthm-no-qtstretch-hm-no-qtstretch-no-qtno-qt
- Common alternative tags:
-
Base image tag:
2.5.0-slim-stretch-hm-no-qt- Common alternative tags:
2.5.0-slim-hm-no-qtslim-hm-no-qt2.5.0-slim-no-qt2.5-slim-no-qtslim-no-qt
- All tags for image:
2.5.0-slim-hm-no-qt2.5-slim-stretch-hm-no-qt2.5-slim-hm-no-qt2-slim-stretch-hm-no-qt2-slim-hm-no-qt2-slim-stretch-hm-no-qt2-slim-hm-no-qtslim-stretch-hm-no-qtslim-hm-no-qt2.5-slim-stretch-no-qt2-slim-stretch-no-qtslim-stretch-no-qt2.5.0-slim-no-qt2.5-slim-no-qt2-slim-no-qtslim-no-qt
- Common alternative tags:
-
Base image tag:
2.4.3-jessie-hm-no-qt- Common alternative tags:
2.4.jessie-hm-no-qt2.4.3-hm-no-qt2.4-hm-no-qt
- All tags for image:
2.4.jessie-hm-no-qt2.4.3-hm-no-qt2.4-hm-no-qt
- Common alternative tags:
-
Base image tag:
2.4.3-slim-jessie-hm-no-qt- Common alternative tags:
2.4-slim-jessie-hm-no-qt2.4.3-slim-hm-no-qt2.4-slim-hm-no-qt
- All tags for image:
2.4-slim-jessie-hm-no-qt2.4.3-slim-hm-no-qt2.4-slim-hm-no-qt
- Common alternative tags:
As before, equivalents without the (recommended) hanami-model Gem:
-
Base image tag:
2.5.0-alpine3.7-no-hm-no-qt- Common alternative tags:
2.5.0-alpine-no-hm-no-qt2.5-alpine-no-hm-no-qtalpine-no-hm-no-qt
- All tags for image:
2.5-alpine3.7-no-hm-no-qt2-alpine3.7-no-hm-no-qtalpine3.7-no-hm-no-qt2.5.0-alpine37-no-hm-no-qt2.5-alpine37-no-hm-no-qt2-alpine37-no-hm-no-qtalpine37-no-hm-no-qt2.5.0-alpine37-no-hm-no-qt2.5-alpine37-no-hm-no-qt2-alpine37-no-hm-no-qtalpine37-no-hm-no-qt2.5.0-alpine-no-hm-no-qt2.5-alpine-no-hm-no-qt2-alpine-no-hm-no-qtalpine-no-hm-no-qt
- Common alternative tags:
-
Base image tag:
2.5.0-stretch-no-hm-no-qt- Common alternative tags:
2.5.0-no-hm-no-qt2.5-no-hm-no-qtstretch-no-hm-no-qtno-hm-no-qt
- All tags for image:
2.5.0-no-hm-no-qt2.5-stretch-no-hm-no-qt2.5-no-hm-no-qt2-stretch-no-hm-no-qt2-no-hm-no-qtstretch-no-hm-no-qtno-hm-no-qt
- Common alternative tags:
-
Base image tag:
2.5.0-slim-stretch-no-hm-no-qt- Common alternative tags:
2.5.0-slim-no-hm-no-qt2.5-slim-no-hm-no-qtslim-no-hm-no-qt
- All tags for image:
2.5.0-slim-no-hm-no-qt2.5-slim-stretch-no-hm-no-qt2.5-slim-no-hm-no-qt2-slim-stretch-no-hm-no-qt2-slim-no-hm-no-qtslim-no-hm-no-qtslim-stretch-no-hm-no-qt
- Common alternative tags:
-
Base image tag:
2.4.3-jessie-no-hm-no-qt- Common alternative tags:
2.4-jessie-no-hm-no-qt2.4.3-no-hm-no-qt2.4-no-hm-no-qt
- All tags for image:
2.4-jessie-no-hm-no-qt2.4.3-no-hm-no-qt2.4-no-hm-no-qt
- Common alternative tags:
-
Base image tag:
2.4.3-slim-jessie-no-hm-no-qt- Common alternative tags:
2.4-slim-jessie-no-hm-no-qt2.4.3-slim-no-hm-no-qt2.4-slim-no-hm-no-qt
- All tags for image:
2.4-slim-jessie-no-hm-no-qt2.4.3-slim-no-hm-no-qt2.4-slim-no-hm-no-qt
- Common alternative tags:
These Gems are direct or indirect dependencies of an as-generated skeleton app for Hanami app as of the public release of Version 1.1.1. These images do not include the hanami-model Gem and its dependencies, nor do the include the capybara Gem and its dependencies.
Also, Gems included in the Ruby base image are not listed here.
| Gem Name | Version |
|---|---|
concurrent-ruby |
1.0.5 |
dry-configurable |
0.7.0 |
dry-container |
0.6.0 |
dry-core |
0.4.5 |
dry-equalizer |
0.2.0 |
dry-logic |
0.4.2 |
dry-types |
0.11.1 |
dry-validation |
0.11.0 |
hanami |
1.1.1 |
hanami-assets |
1.1.1 |
hanami-cli |
0.1.1 |
hanami-controller |
1.1.1 |
hanami-helpers |
1.1.1 |
hanami-mailer |
1.1.0 |
hanami-router |
1.1.1 |
hanami-utils |
1.1.2 |
hanami-validations |
1.1.0 |
hanami-view |
1.1.1 |
http_router |
0.11.2 |
inflecto |
0.0.2 |
mail |
2.7.0 |
mini_mime |
1.1.0 |
rack |
2.0.4 |
tilt |
2.0.8 |
transproc |
1.0.2 |
url_mount |
0.2.1 |
Images built including the hanami-model Gem also include the following Gems:
| Gem Name | Version |
|---|---|
dry-initializer |
1.4.1 |
dry-struct |
0.3.1 |
hanami-model |
1.1.0 |
ice_nine |
0.11.2 |
rom |
3.3.3 |
rom-mapper |
0.5.1 |
rom-repository |
1.4.0 |
rom-sql |
1.3.5 |
sequel |
4.49.0 |
Note that as of Gem version 1.1.0, hanami-model only supports SQL-based databases, hence rom-sql. Also note that the Sequel Gem version is significantly outdated; at this writing, the current version of sequel is 5.6.0. Support for ROM Version 5+ is anticipated for hanami-model 2.0.0, expected in 2Q-3Q 2018.
Images built including the capybara Gem and its dependencies also include the following Gems:
The "full" images, i.e., those not with a trailing -no-qt in their tag name, also include the following Gems:
| Gem Name | Version |
|---|---|
addressable |
2.5.2 |
capybara |
2.16.1 |
mini_mime |
1.0.0 |
mini_portile2 |
2.3.0 |
nokogiri |
1.8.2 |
public_suffix |
3.0.1 |
rack |
2.0.3 |
rack-test |
0.8.3 |
xpath |
3.0.0 |
The capybara Gem is essential for testing and debugging Web apps. It depends on drivers installed at the OS level; perhaps the most common is capybara-webkit. From the capybara-webkit README:
capybara-webkit depends on a WebKit implementation from Qt, a cross-platform development toolkit. You'll need to download the Qt libraries to build and install the gem. You can find instructions for downloading and installing Qt on the capybara-webkit wiki. capybara-webkit requires Qt version 4.8 or greater.
Installing Qt 4 or 5 on Debian Linux brings in well over 100 packages, increasing the image size considerably. While this is necessary for test and, generally, development as well, it is not necessary to deploy a production-mode application.
See the README for the jdickey/ruby base image and the official Ruby Docker image docs.
All files in this repository are Copyright © 2018 by Jeff Dickey, and licensed under the MIT License.
As with all Docker images, these also contain other software which may be under other licenses (such as Ruby, Bash, etc from the base images, along with any direct or indirect dependencies of the primary software being contained).
As for any pre-built image usage, it is the image user's responsibility to ensure that any use of this image complies with any relevant licenses for all software contained within.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent