rclex_docker

This repository maintains the Dockerfile for the trial and tests of Rclex. The pre-built images are published on our Docker Hub.

https://hub.docker.com/r/rclex/rclex_docker

You can use the Docker image like the following.

$ docker pull rclex/rclex_docker:latest
$ docker run -it --rm --name rclex rclex/rclex_docker:latest

The rule of Docker Tags

Since Rclex relies heavily on 3 components (ROS 2, Elixir and Erlang/OTP), we decided to give the Tag of Docker image a long name to clarify each version.

• name-exA.B.C-otpX.Y.Z
  • name: The distribution of ROS 2 (e.g., humble)
  • A.B.C: The version of Elixir (e.g., Elixir 1.15.5)
  • X.Y.Z: The version of Erlang (e.g., OTP-26.0.2)

Available versions (docker tags)

Here is the list of Tags (also see Tags page on Docker Hub) as the CI targets for Rclex. They are associated with the ext of each Dockerfile on GitHub repository.

[latest] means the latest tag associated with the recommended environment for Rclex. Only this tag (including past) provides multi-platform, linux/amd64 and linux/arm64.

• Jazzy Jalisco (LTS rosdistro until May 2029)
  • jazzy-ex1.18.2-otp27.2.4
  • jazzy-ex1.17.3-otp27.2.4
  • jazzy-ex1.16.3-otp26.2.5
• Humble Hawksbill (LTS rosdistro until May 2027)
  • humble-ex1.18.2-otp27.2.4
  • humble-ex1.17.3-otp27.2.4 [latest]
  • humble-ex1.16.3-otp26.2.5

We highly recommend using Humble version because the previous ROS 2 distributions have already reached EOL. In particular, we have decided to stop supporting Dashing due to compatibility with Rclex code.

Policy for versions maintenance

First of all, please understand that we do not maintain this repository and Rclex at all times due to our limited development resource,,,

For Elixir, the version one earlier than the latest is considered as the "latest" version of this repository and Rclex. The subminor is assigned to the latest (last) version. Therefore, when 1.18 is already released, this repository's "latest" Elixir is 1.17.3.
For Erlang/OTP, we select the corresponding one.

The Docker images are maintained to support previous and later versions from "latest". For the previous version, the OTP version is lowered by one. For the later version, we do not always keep up with the latest Elixir releases.

It's hard to decide which LTS ROS distribution should be the "latest" one,,, We generally choose the most popular ones in the community at the time. However, please feel free to ask us if you want to use a newer distribution with Rclex for your project development. We do not actively support STS ROS Distribution. If Rclex works with only minor changes, we will support them, but if it is too much work, we will skip it.

Experimental versions

The following versions are not supported yet and are used as CI targets for Rclex, but these images have been published to Docker Hub for the future.

• None of this now

Deprecated versions

The following versions were used in the past and are still available on Docker Hub, but are no longer used for the operation test of Rclex.

• Jazzy Jalisco (LTS rosdistro until May 2029)
  • jazzy-ex1.17.3-otp27.2
• Iron Irwini (EOL!)
  • iron-ex1.15.5-otp26.0.2
• Humble Hawksbill
  • humble-ex1.16.2-otp26.2.2
  • humble-ex1.15.7-otp26.2.2 (past latest)
  • humble-ex1.14.5-otp25.3.2.5
  • humble-ex1.15.5-otp26.0.2 (past latest)
  • humble-ex1.13.4-otp25.0.3
  • humble-ex1.13.4-otp24.3.4.2
• Galactic Geochelone (EOL!)
  • galactic-ex1.15.5-otp26.0.2
  • galactic-ex1.13.4-otp25.0.3
  • galactic-ex1.13.1-otp24.1.7
  • galactic-ex1.12.3-otp24.1.5
  • galactic-ex1.11.4-otp23.3.4
• Foxy Fitzroy (EOL!)
  • foxy-ex1.15.5-otp26.0.2
  • foxy-ex1.14.5-otp25.3.2.5
  • foxy-ex1.14.0-otp25.0.4
  • foxy-ex1.13.4-otp25.0.3
  • foxy-ex1.13.1-otp24.1.7
  • foxy-ex1.12.3-otp24.1.5
  • foxy-ex1.11.4-otp23.3.4
• Dashing Diademata (EOL!)
  • dashing-ex1.12.3-otp24.1.5
  • dashing-ex1.11.4-otp23.3.4
  • dashing-ex1.10.4-otp23.3.4
  • dashing-ex1.9.4-otp22.3.4.18

Note for developers: how to use this repository

Available commands

• mix rclex_docker.build [options]: Builds rclex docker images
  • --dry-run - show all raw docker commands which invoked by this task.
  • --latest - build only latest target.
  • --multi - build latest target for multi-platform.
• mix rclex_docker.push [options]: Pushes rclex docker images
  • --dry-run - show all raw docker commands which invoked by this task.
  • --latest - push only latest target.
  • --multi - push latest target for multi-platform.

When using --multi option, you need to create a builder first (e.g., docker buildx create --use --name rclex_builder). And also, we guess that QEMU may be at least v5 (see detail).

Modification of versions

Edit list_target_tuples() in lib/rclex_docker.ex