This repository has been archived on 2024-02-13. You can view files and clone it, but cannot push or open issues or pull requests.
balena-elixir/README.md

43 lines
2.4 KiB
Markdown
Raw Normal View History

2019-11-30 08:37:46 +13:00
# Balena Elixir
This repository contains scripts to build versions of Elixir on top of [Balena's standard base images](https://www.balena.io/docs/reference/base-images/base-images/). This gives us access to the great features built into Balena's images such as cross-compilation, init system and UDEV.
These images are built using my [balena-erlang](https://gitlab.com/jimsy/balena-erlang) images as a base.
Please note that these are *unofficial*, *unsupported* images.
## How to pick an image:
This repository contains images build for several architectures in both Debian and Alpine distributions. There are also `-build` variants, which are mainly used for caching but contain all the development dependencies needed to compile Erlang. If you're having trouble getting a dependency to build try using a `-build` variant.
```
registry.gitlab.com/jimsy/balena-elixir/<arch>-<distro>(-build|):<elixir_version>-<distro_version>
```
### Image names:
* `<arch>` is the value corresponding to the `BALENA_ARCH` variable, not the Docker arch type.
* `<distro>` is the Linux distribution. At this time only `debian` or `alpine`.
* `<elixir_version>` is the Elixir version. You can also skip the patch number and just specify the major and minor versions. Only relatively recent versions of Elixir are built, based on the versions of Erlang I was able to build. See the [balena-erlang](https://gitlab.com/jimsy/balena-erlang) repository for more information.
* `<distro_version>` is the Linux distribution version or codename.
Too see a full list of available images and tags see [this project's container registry page](https://gitlab.com/jimsy/balena-elixir/container_registry).
### Examples:
#### `registry.gitlab.com/jimsy/balena-elixir/armv7hf-debian:1.9-buster`
An `armv7hf` (suitable for a Rasperry Pi 2 or 3) image of the latest version of Elixir 1.9 on Debian buster.
#### `registry.gitlab.com/jimsy/balena-elixir/aarch64-alpine:1.5.3`
An `aarch64` (suitable for Raspberry Pi 3 or 4) image of Elixir 1.5.3 on the most recent version of Alpine.
#### `registry.gitlab.com/jimsy/balena-elixir/i386-debian:1.8`
An `i386` (suitable for Intel NUC or other industrial computer) image of the latest release of Elixir 1.8 on the latest release of Debian.
#### `Dockerfile.template`
In your Balena project you can use `%%BALENA_ARCH%%` instead of your machine name to select the image you want, eg. `FROM registry.gitlab.com/jimsy/balena-elixir/%%BALENA_ARCH%%-alpine:1.9`.