https://github.com/hexpm/bob
The Builder
https://github.com/hexpm/bob
Last synced: 6 months ago
JSON representation
The Builder
- Host: GitHub
- URL: https://github.com/hexpm/bob
- Owner: hexpm
- Created: 2014-06-21T16:46:29.000Z (over 11 years ago)
- Default Branch: main
- Last Pushed: 2025-02-13T11:29:05.000Z (9 months ago)
- Last Synced: 2025-05-15T19:09:14.475Z (6 months ago)
- Language: Elixir
- Homepage:
- Size: 607 KB
- Stars: 265
- Watchers: 13
- Forks: 62
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Bob the builder
Bob performs automated tasks for the Elixir and Hex projects.
## Elixir builds
Elixir builds are compiled on each git push to https://github.com/elixir-lang/elixir for any branch. After the build completes it will be available at `https://builds.hex.pm/builds/elixir/{REF}.zip` where `{REF}` is the git ref for that push. Examples of URLs are:
* https://builds.hex.pm/builds/elixir/main.zip
* https://builds.hex.pm/builds/elixir/v1.12.3.zip
These Elixir builds will be compiled against the oldest supported OTP version to ensure maximum compatibility for all users. We also build Elixir for every officially supported OTP version, if possible always use an Elixir compiled against the latest OTP version to get all available features in Elixir. These builds are available at `https://builds.hex.pm/builds/elixir/{REF}-otp-{OTP_MAJOR_VERSION}.zip`, examples are:
* https://builds.hex.pm/builds/elixir/main-otp-20.zip
* https://builds.hex.pm/builds/elixir/v1.12.3-otp-24.zip
Since these builds are only available for officially supported OTP versions it is recommended that you fall back to the non OTP versioned URL if you get a 404 error for your combination of Elixir and OTP versions. Check https://github.com/hexpm/bob/blob/main/lib/bob/job/build_elixir.ex to find which OTP versions we build against for particular Elixir versions.
See https://builds.hex.pm/builds/elixir/builds.txt for a list of all builds.
## Elixir docs
On git pushes documentation is built and pushed to `https://hexdocs.pm/{APPLICATION}/{VERSION}` where `{APPLICATION}` is an application in the Elixir standard distribution and `{VERSION}` is the Elixir version, examples are:
* https://hexdocs.pm/elixir/
* https://hexdocs.pm/elixir/main
* https://hexdocs.pm/mix/1.12.3
Documentation tarballs are also uploaded to `https://repo.hex.pm/docs/{APPLICATION}-{VERSION}.tar.gz`, examples are:
* https://repo.hex.pm/docs/elixir-main.tar.gz
* https://repo.hex.pm/docs/mix-1.12.3.tar.gz
## Erlang builds
Erlang builds compiled on Ubuntu LTS versions are built periodically. Bob checks for new tagged releases every 15 minutes and builds any new versions it discovers. The "master" and "maint*" branches are built once a day.
After the builds complete they will be available at `https://builds.hex.pm/builds/otp/${ARCH}/${OS_VER}/${REF}.tar.gz` where `${ARCH}` is the CPU architecture, `${OS_VER}` is the OS name and version, and `${REF}` is the name of the git tag or branch.
Supported architectures:
* `amd64`
* `arm64`
Supported OS versions:
* `ubuntu-20.04`
* `ubuntu-22.04`
* `ubuntu-24.04`
Examples of URLs are:
* https://builds.hex.pm/builds/otp/amd64/ubuntu-20.04/master.tar.gz
* https://builds.hex.pm/builds/otp/arm64/ubuntu-22.04/OTP-26.0.tar.gz
* https://builds.hex.pm/builds/otp/amd64/ubuntu-24.04/maint.tar.gz
For lists of builds see:
* `amd64`:
* https://builds.hex.pm/builds/otp/amd64/ubuntu-20.04/builds.txt
* https://builds.hex.pm/builds/otp/amd64/ubuntu-22.04/builds.txt
* https://builds.hex.pm/builds/otp/amd64/ubuntu-24.04/builds.txt
* `arm64`:
* https://builds.hex.pm/builds/otp/arm64/ubuntu-20.04/builds.txt
* https://builds.hex.pm/builds/otp/arm64/ubuntu-22.04/builds.txt
* https://builds.hex.pm/builds/otp/arm64/ubuntu-24.04/builds.txt
## Docker images
Docker images for Bob's Elixir and Erlang builds are built periodically. Bob checks for new Elixir and Erlang releases every 15 minutes and builds images for any new versions it discovers. The list of operating system distributions we base the images on can be found here: https://github.com/hexpm/bob/blob/main/lib/bob/job/docker_checker.ex#L5.
Tagged images are never changed, that means `hexpm/erlang@22.0-alpine-3.11.2` will always target the tag `OTP-22.0` and won't update when `OTP-22.0.1` is released.
Erlang builds are found at https://hub.docker.com/r/hexpm/erlang, they use the versioning scheme `${OTP_VER}-${OS_NAME}-${OS_VER}` for tags. Builds for all releases since OTP 17 are provided.
Elixir builds are found at https://hub.docker.com/r/hexpm/elixir, they use the versioning scheme `${ELIXIR_VER}-erlang-${OTP_VER}-${OS_NAME}-${OS_VER}`. Builds for all major releases since Elixir 1.0.0 are provided. Images are built for all pairs of compatible Elixir and OTP versions.
Builds are provided for the following OS and architectures using the docker `OS/ARCH` scheme:
* `linux/amd64`
* `linux/arm64/v8`
### Examples of image names
* `hexpm/erlang:22.2.8-alpine-3.11.3`
* `hexpm/erlang:22.2-ubuntu-bionic-20200219`
* `hexpm/elixir:1.10.2-erlang-22.2.8-alpine-3.11.3`
* `hexpm/elixir:1.10.0-erlang-22.2-ubuntu-bionic-20200219`
## Hex S3 backups
Each days backups of yesterdays access logs stored on the bucket `logs.hex.pm` is uploaded to the bucket `backup.hex.pm`.
A snapshot of the bucket `s3.hex.pm` is also uploaded to [tarsnap](https://www.tarsnap.com).