Skip to content

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

51 Commits

Folders and files

Repository files navigation

Erlang/OTP ビルド済みバイナリをインストールする

AWS-LC を静的リンクしたビルド済み Erlang/OTP をインストールします。GitHub Actions の composite action と、Ubuntu / macOS のインストーラーとして使えます。

  • ビルド済みの tar.gz をダウンロードして展開するだけです
  • dialyzer のベース PLT もダウンロードして ~/.cache/rebar3 に配置します (無効にするには --no-plt または use-plt: "false" を指定します)
  • 利用できるバージョンは versions/builds.tsv にあります

GitHub Actions で使う

- uses: shiguredo/setup-erlang@main
  with:
    otp-version: "29.1.2"
    aws-lc-version: "v5.12.0"
  • otp-version は完全一致で指定します (例: 29.1.2)
  • aws-lc-version は省略できます。省略時はその Erlang/OTP で利用できる最新の AWS-LC を使います
  • debug は文字列です。"true" のときだけデバッグ版を入れます。省略時とそれ以外の値は正式版です

デバッグ版を入れるときは debug を足します。

- uses: shiguredo/setup-erlang@main
  with:
    otp-version: "29.1.2"
    aws-lc-version: "v5.12.0"
    debug: "true"
  • デバッグ版のアセット名は otp-<target>-debug.tar.gz です。GitHub Release のタグは正式版と同じ otp-<otp-version>-aws-lc-<aws-lc-version> です
  • インストール先のディレクトリ名の末尾は -debug です
  • dialyzer のベース PLT は正式版のものを使います。デバッグ版だけの PLT はありません
  • Linux のデバッグ版は systemtap、macOS のデバッグ版は dtrace のプローブを含みます。stap や dtrace コマンド自体は入れません

キャッシュと dialyzer のベース PLT

- uses: shiguredo/setup-erlang@main
  with:
    otp-version: "29.1.2"
    aws-lc-version: "v5.12.0"
    use-cache: "true"
  • use-cache を有効にするとインストールディレクトリを actions/cache でキャッシュします
  • self-hosted runner では actions/cache を使いません
    • RUNNER_TOOL_CACHE 配下が runner に残るため、2 回目以降はインストール済みの Erlang/OTP をそのまま使います
  • use-plt はデフォルトで有効です。リリースに同梱された dialyzer のベース PLT (incremental) をダウンロードし、rebar3 が読む場所 (~/.cache/rebar3/rebar3_<OTP_VERSION>_iplt) に配置します
    • 無効にするには use-plt: "false" を指定します
    • 対象のアプリは rebar3 のデフォルトと同じ erts crypto kernel stdlib です
    • PLT のパスは plt-path 出力で参照できます
    • rebar3 のデフォルト設定 (base_plt_location: global、base_plt_prefix: rebar3) が前提です
  • dialyzer の incremental モードは、ベース PLT に記録された warnings 設定とプロジェクトの warnings 設定が完全一致しない場合、差分ではなく全ファイルを解析します
    • warnings をカスタムしているプロジェクトでは、GitHub hosted runner で project PLT (_build/default/rebar3_*.iplt) を actions/cache で保存すると 2 回目以降が速くなります
    • self-hosted runner では _build が残るため追加のキャッシュは不要です

出力

  • otp-version: インストールした Erlang/OTP のバージョン
  • aws-lc-version: インストールした AWS-LC のバージョン
  • erlang-root-dir: Erlang/OTP のインストールディレクトリ
  • plt-path: dialyzer のベース PLT のパス (use-plt が有効な場合のみファイルが存在します)
  • debug: デバッグ版を入れたとき "true"

Ubuntu / macOS で使う

$ curl -fsSL https://raw.githubusercontent.com/shiguredo/setup-erlang/main/scripts/install.sh | bash
  • GitHub Actions 以外では otp-version を省略できます。省略時は対応する最新の Erlang/OTP と AWS-LC をインストールします
  • インストール先は ${XDG_DATA_HOME:-$HOME/.local/share}/setup-erlang です
    • 変更するには --root を指定するか、SETUP_ERLANG_ROOT を設定します
  • インストールすると <root>/current がインストールしたバージョンへのシンボリックリンクになります
# バージョンを指定してインストールする
$ curl -fsSL https://raw.githubusercontent.com/shiguredo/setup-erlang/main/scripts/install.sh | bash -s -- 29.1.2

# AWS-LC も指定してインストールする
$ curl -fsSL https://raw.githubusercontent.com/shiguredo/setup-erlang/main/scripts/install.sh | bash -s -- 29.1.2 v5.12.0

# デバッグ版をインストールする
$ curl -fsSL https://raw.githubusercontent.com/shiguredo/setup-erlang/main/scripts/install.sh | bash -s -- --debug 29.1.2 v5.12.0

インストールの最後に表示される export PATH をシェルの設定ファイルに追加すると erl が使えるようになります。

$ export PATH="$HOME/.local/share/setup-erlang/current/bin:$PATH"
$ erl -noshell -eval 'io:format("~s~n", [erlang:system_info(otp_release)]), halt().'
  • erl は $0 の位置からルートディレクトリを探すため、bin/erl 単位のシンボリックリンクでは動きません。current のディレクトリ単位のシンボリックリンクを PATH に通してください

バージョンの確認と切り替え

スクリプトを保存しておくと list と use が使えます。

$ curl -fsSL -o setup-erlang.sh https://raw.githubusercontent.com/shiguredo/setup-erlang/main/scripts/install.sh
$ bash setup-erlang.sh list
setup-erlang: installed under /Users/example/.local/share/setup-erlang
  * 29.1.2-aws-lc-v5.12.0
setup-erlang: available for aarch64-apple-darwin
  29.1.2  v5.11.0 v5.12.0
  29.1.1  v5.9.0 v5.10.0 v5.11.0
  29.1  v5.9.0
  29.0.6  v5.8.0
$ bash setup-erlang.sh use 29.1.2 v5.12.0
  • list はインストール済みのバージョン (先頭の * が current) と、その環境で利用できるバージョンを表示します
  • use はインストール済みのバージョンへ current を切り替えます

オプションと環境変数

  • --otp-version / INPUT_OTP_VERSION: Erlang/OTP のバージョン (例: 29.1.2)
  • --aws-lc-version / INPUT_AWS_LC_VERSION: AWS-LC のバージョン (例: v5.12.0)
  • --target / INPUT_OTP_TARGET: ターゲットトリプル。通常は自動検出します
  • --root / SETUP_ERLANG_ROOT: インストール先
  • --no-plt / INPUT_USE_PLT: dialyzer のベース PLT をインストールしません
  • --debug / INPUT_DEBUG: "true" のときデバッグ版をインストールします。use と list でも同じ指定でデバッグ版を選びます
  • SETUP_ERLANG_MANIFEST: マニフェストファイルを直接指定します
  • SETUP_ERLANG_MANIFEST_URL: マニフェストの URL を指定します (既定は raw.githubusercontent.com/shiguredo/setup-erlang/main/versions/builds.tsv)
  • SETUP_ERLANG_MANIFEST_REF: マニフェストを取得する ref を指定します (既定は main)

対応プラットフォーム

  • Ubuntu x86_64
    • 26.04
    • 24.04
  • Ubuntu arm64
    • 26.04
    • 24.04
  • macOS arm64
    • 26

ビルド済みバイナリは glibc 2.38 以降が必要です。Ubuntu 22.04 以前では動作しません。macOS の x86_64 には対応していません。

ビルドオプション

正式版とデバッグ版は、同じ shiguredo/otp の aws-lc-OTP-* タグから作ります。アプリケーション構成は同じです。wx を使う observer、debugger、et はどちらにも入れません。

正式版の configure は docker-erlang-otp と同じです。

--enable-kernel-poll
--enable-dirty-schedulers
--enable-jit
--disable-sharing-preserving
--disable-sctp
--disable-dynamic-ssl-lib
--with-ssl=<AWS-LC のインストール先>
--with-ssl-rpath=no
--without-javac
--without-odbc
--without-wx
--without-debugger
--without-observer
--without-crashdump_viewer
--without-et
--without-tftp
--without-ftp
--without-megaco
--without-eldap
--without-diameter
--without-jinterface
--without-mnesia
--without-snmp
--without-erl_docgen
--without-ssh

デバッグ版は、このあとに次を足します。

--enable-lock-counter
--with-microstate-accounting=extra
--with-dynamic-trace=systemtap
--with-dynamic-trace=dtrace
  • --with-dynamic-trace=systemtap は Linux、--with-dynamic-trace=dtrace は macOS です
  • --enable-lock-counter を付けると、make release が通常の beam.smp に加えて beam.lcnt.smp を入れます。起動は erl -emu_type lcnt です
  • フレームポインタ付きの beam.frmptr.smp は configure では選ばれないので、同じリリースツリーに対して make -C erts/emulator TYPE=frmptr release で追加します。起動は erl -emu_type frmptr です
  • デバッグ版に入るエミュレータは、通常の beam.smp、beam.lcnt.smp、beam.frmptr.smp です。通常の erl は最適化された beam.smp のままです。--with-microstate-accounting=extra と dynamic trace の計測点は、この beam.smp に入ります
  • JIT 向けの +JPperf はビルドオプションではありません。正式版でもデバッグ版でも、実行時に指定します

AWS-LC パッチ

  • AWS-LC を静的リンクした Erlang/OTP を提供しています
  • shiguredo/otp の aws-lc-OTP-* タグからビルドしています
  • 正式版のビルドオプションは docker-erlang-otp と同じです。デバッグ版の追加分は「ビルドオプション」にあります

管理ポリシー

  • GitHub Actions と Ubuntu / macOS 向けのビルド済み Erlang/OTP
  • Erlang/OTP のリリースに追従していく

ライセンス

Apache License 2.0

Copyright 2026 Shiguredo Inc.

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages