Ruby で Markdown 形式のテキストを扱う gem として commonmarker がある。

手元の macOS や AlmaLinux 9 では普通に使えたが，AlmaLinux 8 では動かなかったのを，開発元に教えていただいた方法で解決した。

うまくいかなかったこと

ふつうに

gem install commonmarker

とすると，すんなりインストールできた。
確認：

$ gem list commonmarker

*** LOCAL GEMS ***

commonmarker (2.6.1 x86_64-linux)

バージョン番号のうしろに「x86_64-linux」が付いているのは，ソレ用のプリコンパイル版¹であることを意味する。

しかし，動かない。require "commonmarker" しただけで以下のようなエラーが出る。

/usr/local/rbenv/versions/4.0.1/lib/ruby/gems/4.0.0/gems/commonmarker-2.6.1-x86_64-linux/lib/commonmarker/extension.rb:13:in 'Kernel#require': cannot load such file -- commonmarker/commonmarker (LoadError)
	from /usr/local/rbenv/versions/4.0.1/lib/ruby/gems/4.0.0/gems/commonmarker-2.6.1-x86_64-linux/lib/commonmarker/extension.rb:13:in '<top (required)>'
	from /usr/local/rbenv/versions/4.0.1/lib/ruby/gems/4.0.0/gems/commonmarker-2.6.1-x86_64-linux/lib/commonmarker.rb:3:in 'Kernel#require_relative'
	from /usr/local/rbenv/versions/4.0.1/lib/ruby/gems/4.0.0/gems/commonmarker-2.6.1-x86_64-linux/lib/commonmarker.rb:3:in '<top (required)>'
	from <internal:/usr/local/rbenv/versions/4.0.1/lib/ruby/4.0.0/rubygems/core_ext/kernel_require.rb>:144:in 'Kernel#require'
/usr/local/rbenv/versions/4.0.1/lib/ruby/gems/4.0.0/gems/commonmarker-2.6.1-x86_64-linux/lib/commonmarker/extension.rb:7:in 'Kernel#require_relative': /lib64/libc.so.6: version `GLIBC_2.30' not found (required by /usr/local/rbenv/versions/4.0.1/lib/ruby/gems/4.0.0/gems/commonmarker-2.6.1-x86_64-linux/lib/commonmarker/4.0/commonmarker.so) - /usr/local/rbenv/versions/4.0.1/lib/ruby/gems/4.0.0/gems/commonmarker-2.6.1-x86_64-linux/lib/commonmarker/4.0/commonmarker.so (LoadError)
	from /usr/local/rbenv/versions/4.0.1/lib/ruby/gems/4.0.0/gems/commonmarker-2.6.1-x86_64-linux/lib/commonmarker/extension.rb:7:in '<top (required)>'
	from /usr/local/rbenv/versions/4.0.1/lib/ruby/gems/4.0.0/gems/commonmarker-2.6.1-x86_64-linux/lib/commonmarker.rb:3:in 'Kernel#require_relative'
	from /usr/local/rbenv/versions/4.0.1/lib/ruby/gems/4.0.0/gems/commonmarker-2.6.1-x86_64-linux/lib/commonmarker.rb:3:in '<top (required)>'
	from <internal:/usr/local/rbenv/versions/4.0.1/lib/ruby/4.0.0/rubygems/core_ext/kernel_require.rb>:144:in 'Kernel#require'
<internal:/usr/local/rbenv/versions/4.0.1/lib/ruby/4.0.0/rubygems/core_ext/kernel_require.rb>:139:in 'Kernel#require': cannot load such file -- commonmarker (LoadError)

なんかごちゃごちゃ書いてるけど，要は「GLIBC_2.30 が無い」と。

各種バージョンは以下のとおり。

AlmaLinux release 8.10 (Cerulean Leopard)
ruby 4.0.1 (2026-01-13 revision e04267a14b) +PRISM [x86_64-linux]
commonmarker 2.6.1

AlmaLinux 9.7 (Moss Jungle Cat) では問題なかった。
Ruby は 3.4.8 も試したが 4.0.1 と同じだった。

commonmarker は最新版でなく古いものも試そうとしたが，さまざまな原因で諦めた。

glibc のバージョンが古い

ええと，glibc のバージョンはどうなってんだ？

$ sudo dnf info glibc

とやると「2.28」であった。

同様の問題は nokogiri でもあった：
Nokogiri が version `GLIBC_2.29' not found で読み込めない件 - Qiita

要は

AlmaLinux 8 を使う限り glibc のバージョンは上げられないので，プリコンパイル版は動かない
ローカルでコンパイルせよ

ということだ。

ローカルでコンパイルを試みる

commonmarker や nokogiri のように，プリコンパイル版が用意されている gem で，あえてローカルでコンパイルするインストール方法をとるには，以下の三つの方法がある。

gem install に --platform ruby オプションを与える
Gemfile で gem メソッドに force_ruby_platform: true オプションを与える
.bundle/config に BUNDLE_FORCE_RUBY_PLATFORM: "true" を記述

gem install

最初の一つは Bundler と無関係に実行できる。

以下のようにする

gem install --platform ruby

ただし，せっかくこれでインストールしても，Bundler を使うプロジェクトで bundle install すると，プリコンパイル版がさらにインストールされて使われてしまうことに注意。

また，Bundler を使わない場合でも，プリコンパイル版がインストール済みの場合はそちらが使われてしまうようなので，削除しておく必要がある。

残りの二つはいずれも Bundler を使う場合の方法。

Gemfile

Gemfile に

gem "commonmarker", force_ruby_platform: true

のように記述する。

AlmaLinux 8 でのみ force_ruby_platform: true を付けたいなら，ちょっと面倒だけど

Gemfile

redhat_release_path = "/etc/redhat-release"
if File.exist?(redhat_release_path) && File.read(redhat_release_path).start_with?("AlmaLinux release 8")
  gem "commonmarker", force_ruby_platform: true
else
  gem "commonmarker"
end

みたいに書く。

あるいは

Gemfile

require "etc"
if Etc.uname[:release].include?(".el8_")
  gem "commonmarker", force_ruby_platform: true
else
  gem "commonmarker"
end

だろうか。

.bundle/config

Bundler を使うプロジェクトのディレクトリーで

bundle config set force_ruby_platform true

とすると，.bundle/config というファイルが作られ

BUNDLE_FORCE_RUBY_PLATFORM: "true"

が書かれる（既にファイルがあった場合は追記される）。

すると，このプロジェクトで bundle install とか bundle update したときに，すべての gem についてこれが適用される。

結果

三つのいずれの方法を使っても同じだが，

ERROR:  Error installing commonmarker:

とエラーが出てインストールに失敗する。
全体は以下のとおり：

ERROR:  Error installing commonmarker:
	ERROR: Failed to build gem native extension.
current directory: /usr/local/rbenv/versions/3.4.8/lib/ruby/gems/3.4.0/gems/commonmarker-2.6.1/ext/commonmarker

/usr/local/rbenv/versions/3.4.8/bin/ruby extconf.rb
checking for gcc... yes
checking for g++... yes
checking for gcc-ar... yes
checking for cargo... yes
checking for install_name_tool... no
checking for $(CARGO_BUILD_TARGET)-install_name_tool... no
current directory: /usr/local/rbenv/versions/3.4.8/lib/ruby/gems/3.4.0/gems/commonmarker-2.6.1/ext/commonmarker
make -j3 DESTDIR= sitearchdir=./.gem.20260115-837501-owot26 sitelibdir=./.gem.20260115-837501-owot26 clean
current directory: /usr/local/rbenv/versions/3.4.8/lib/ruby/gems/3.4.0/gems/commonmarker-2.6.1/ext/commonmarker
make -j3 DESTDIR= sitearchdir=./.gem.20260115-837501-owot26 sitelibdir=./.gem.20260115-837501-owot26
generating target/release/libcommonmarker.so (release)
cargo rustc  --manifest-path ./Cargo.toml --target-dir target --lib --profile release -- -C linker=gcc -L native=/usr/local/rbenv/versions/3.4.8/lib -C link-arg=-lm -l pthread
Compiling proc-macro2 v1.0.103
Compiling unicode-ident v1.0.20
Compiling quote v1.0.41
Compiling shlex v1.3.0
Compiling memchr v2.7.6
Compiling glob v0.3.3
Compiling syn v2.0.108
Compiling clang-sys v1.8.1
Compiling libc v0.2.177
Compiling aho-corasick v1.1.4
Compiling regex-syntax v0.8.8
Compiling cfg-if v1.0.4
Compiling minimal-lexical v0.2.1
Compiling nom v7.1.3
Compiling libloading v0.8.9
Compiling regex-automata v0.4.13
Compiling either v1.15.0
Compiling bindgen v0.69.5
Compiling serde_core v1.0.228
Compiling itertools v0.12.1
Compiling regex v1.12.2
Compiling cexpr v0.6.0
Compiling rustc-hash v1.1.0
Compiling find-msvc-tools v0.1.4
Compiling bitflags v2.10.0
Compiling lazycell v1.3.0
Compiling lazy_static v1.5.0
Compiling cc v1.2.43
Compiling pkg-config v0.3.32
Compiling shell-words v1.1.0
Compiling strsim v0.11.1
Compiling ident_case v1.0.1
Compiling fnv v1.0.7
Compiling rustix v1.1.2
Compiling serde v1.0.228
Compiling darling_core v0.21.3
Compiling onig_sys v69.9.1
Compiling rb-sys-build v0.9.123
Compiling powerfmt v0.2.0
Compiling rb-sys-env v0.2.2
Compiling linux-raw-sys v0.11.0
Compiling rustversion v1.0.22
Compiling itoa v1.0.15
Compiling utf8parse v0.2.2
Compiling prettyplease v0.2.37
Compiling crc32fast v1.5.0
Compiling anstyle-parse v0.2.7
Compiling darling_macro v0.21.3
Compiling deranged v0.5.5
Compiling rb-sys v0.9.123
Compiling serde_json v1.0.145
Compiling simd-adler32 v0.3.7
Compiling time-core v0.1.6
Compiling colorchoice v1.0.4
Compiling siphasher v1.0.1
Compiling anstyle v1.0.13
Compiling anstyle-query v1.1.4
Compiling thiserror v2.0.17
Compiling adler2 v2.0.1
Compiling num-conv v0.1.0
Compiling is_terminal_polyfill v1.70.2
Compiling equivalent v1.0.2
Compiling tinyvec_macros v0.1.1
Compiling hashbrown v0.16.0
Compiling indexmap v2.12.0
Compiling tinyvec v1.10.0
Compiling anstream v0.6.21
Compiling time v0.3.44
Compiling miniz_oxide v0.8.9
Compiling phf_shared v0.11.3
Compiling terminal_size v0.4.3
Compiling darling v0.21.3
error: failed to run custom build command for rb-sys v0.9.123
Caused by:
process didn't exit successfully: /usr/local/rbenv/versions/3.4.8/lib/ruby/gems/3.4.0/gems/commonmarker-2.6.1/ext/commonmarker/target/release/build/rb-sys-dfa8e3f338f9ceff/build-script-main (exit status: 101)
--- stdout
cargo:rerun-if-env-changed=RUBY
cargo:rerun-if-env-changed=RBCONFIG_CROSS_COMPILING
cargo:rerun-if-env-changed=RBCONFIG_RUBY_PROGRAM_VERSION
cargo:rerun-if-env-changed=RBCONFIG_ruby_install_name
cargo:rerun-if-env-changed=RBCONFIG_platform
cargo:rerun-if-env-changed=RUBY_ROOT
cargo:rerun-if-env-changed=RUBY_VERSION
cargo:rerun-if-env-changed=RUBY
cargo:rerun-if-changed=build/features.rs
cargo:rerun-if-changed=build/stable_api_config.rs
cargo:rerun-if-changed=build/version.rs
cargo:rerun-if-changed=build/main.rs
cargo:rerun-if-env-changed=RUBY_STATIC
cargo:rerun-if-env-changed=RBCONFIG_ENABLE_SHARED
cargo:rerun-if-env-changed=RBCONFIG_rubyhdrdir
cargo:rerun-if-env-changed=RBCONFIG_rubyarchhdrdir
cargo:rerun-if-env-changed=RBCONFIG_CPPFLAGS
cargo:rerun-if-env-changed=RBCONFIG_rubyhdrdir
cargo:rerun-if-env-changed=RBCONFIG_MAJOR
cargo:rerun-if-env-changed=RBCONFIG_MINOR
cargo:rerun-if-env-changed=TARGET
cargo:rerun-if-env-changed=TARGET
cargo:rerun-if-env-changed=BINDGEN_EXTRA_CLANG_ARGS_x86_64-unknown-linux-gnu
cargo:rerun-if-env-changed=BINDGEN_EXTRA_CLANG_ARGS_x86_64-unknown-linux-gnu
cargo:rerun-if-env-changed=BINDGEN_EXTRA_CLANG_ARGS_x86_64_unknown_linux_gnu
cargo:rerun-if-env-changed=BINDGEN_EXTRA_CLANG_ARGS_x86_64_unknown_linux_gnu
cargo:rerun-if-env-changed=BINDGEN_EXTRA_CLANG_ARGS
cargo:rerun-if-env-changed=BINDGEN_EXTRA_CLANG_ARGS
--- stderr
INFO: using bindgen with clang args: ["-I/usr/local/rbenv/versions/3.4.8/include/ruby-3.4.0", "-I/usr/local/rbenv/versions/3.4.8/include/ruby-3.4.0/x86_64-linux", "-fms-extensions", "-fstack-protector-strong", "-U_FORTIFY_SOURCE", "-D_FORTIFY_SOURCE=2", "-O3", "-fno-fast-math", "-ggdb3", "-Wall", "-Wextra", "-Wdeprecated-declarations", "-Wdiv-by-zero", "-Wduplicated-cond", "-Wimplicit-function-declaration", "-Wimplicit-int", "-Wpointer-arith", "-Wwrite-strings", "-Wold-style-definition", "-Wimplicit-fallthrough=0", "-Wmissing-noreturn", "-Wno-cast-function-type", "-Wno-constant-logical-operand", "-Wno-long-long", "-Wno-missing-field-initializers", "-Wno-overlength-strings", "-Wno-packed-bitfield-compat", "-Wno-parentheses-equality", "-Wno-self-assign", "-Wno-tautological-compare", "-Wno-unused-parameter", "-Wno-unused-value", "-Wsuggest-attribute=format", "-Wsuggest-attribute=noreturn", "-Wunused-variable", "-Wmisleading-indentation", "-Wundef"]
#include "ruby.h"
#ifdef HAVE_RUBY_DEBUG_H
#include "ruby/debug.h"
#endif
#ifdef HAVE_RUBY_DEFINES_H
#include "ruby/defines.h"
#endif
#ifdef HAVE_RUBY_ENCODING_H
#include "ruby/encoding.h"
#endif
#ifdef HAVE_RUBY_FIBER_SCHEDULER_H
#include "ruby/fiber/scheduler.h"
#endif
#ifdef HAVE_RUBY_INTERN_H
#include "ruby/intern.h"
#endif
#ifdef HAVE_RUBY_IO_H
#include "ruby/io.h"
#endif
#ifdef HAVE_RUBY_MEMORY_VIEW_H
#include "ruby/memory_view.h"
#endif
#ifdef HAVE_RUBY_MISSING_H
#include "ruby/missing.h"
#endif
#ifdef HAVE_RUBY_ONIGMO_H
#include "ruby/onigmo.h"
#endif
#ifdef HAVE_RUBY_ONIGURUMA_H
#include "ruby/oniguruma.h"
#endif
#ifdef HAVE_RUBY_RACTOR_H
#include "ruby/ractor.h"
#endif
#ifdef HAVE_RUBY_RANDOM_H
#include "ruby/random.h"
#endif
#ifdef HAVE_RUBY_RE_H
#include "ruby/re.h"
#endif
#ifdef HAVE_RUBY_REGEX_H
#include "ruby/regex.h"
#endif
#ifdef HAVE_RUBY_RUBY_H
#include "ruby/ruby.h"
#endif
#ifdef HAVE_RUBY_ST_H
#include "ruby/st.h"
#endif
#ifdef HAVE_RUBY_THREAD_H
#include "ruby/thread.h"
#endif
#ifdef HAVE_RUBY_THREAD_NATIVE_H
#include "ruby/thread_native.h"
#endif
#ifdef HAVE_RUBY_UTIL_H
#include "ruby/util.h"
#endif
#ifdef HAVE_RUBY_VERSION_H
#include "ruby/version.h"
#endif
#ifdef HAVE_RUBY_VM_H
#include "ruby/vm.h"
#endif
#ifdef HAVE_RUBY_WIN32_H
#include "ruby/win32.h"
#endif
#ifdef HAVE_RUBY_IO_BUFFER_H
#include "ruby/io/buffer.h"
#endif
#ifdef HAVE_RUBY_ATOMIC_H
#include "ruby/atomic.h"
#endif
struct rb_sys__Opaque__RString { struct RString dummy; };
struct rb_sys__Opaque__RArray { struct RArray dummy; };
struct rb_sys__Opaque__RData { struct RData dummy; };
struct rb_sys__Opaque__RTypedData { struct RTypedData dummy; };
struct rb_sys__Opaque__rb_matchext_struct { struct rb_matchext_struct dummy; };
struct rb_sys__Opaque__rb_internal_thread_event_data { struct rb_internal_thread_event_data dummy; };
struct rb_sys__Opaque__rb_io_internal_buffer { struct rb_io_internal_buffer dummy; };
thread 'main' (838810) panicked at /home/XXXX/.cargo/registry/src/index.crates.io-1949cf8c6b5b557f/bindgen-0.69.5/lib.rs:622:31:
Unable to find libclang: "couldn't find any valid shared libraries matching: ['libclang.so', 'libclang-.so', 'libclang.so.', 'libclang-.so.'], set the LIBCLANG_PATH environment variable to a path where one of these files can be found (invalid: [])"
note: run with RUST_BACKTRACE=1 environment variable to display a backtrace
warning: build failed, waiting for other jobs to finish...
make: *** [Makefile:573: target/release/libcommonmarker.so] エラー 101
make failed, exit code 2
Gem files will remain installed in /usr/local/rbenv/versions/3.4.8/lib/ruby/gems/3.4.0/gems/commonmarker-2.6.1 for inspection.
Results logged to /usr/local/rbenv/versions/3.4.8/lib/ruby/gems/3.4.0/extensions/x86_64-linux/3.4.0/commonmarker-2.6.1/gem_make.out

これを読み解こうとしたが，知識が無さすぎて諦めた。

開発元に泣きつき解決

commonmarker gem のリポジトリーに issue を立てた：
https://github.com/gjtorikian/commonmarker/issues/434

非常に素早く的確なアドバイスがいただけて，わずか 10 時間で完全解決した。

「libclang-dev のインストールが必要なのでは」とのことだったが，AlmaLinux ではそこをちょっと読み替えて，clang-devel をインストールすればいい。

エラーメッセージからこれが読み取れるようになりたいものだ。

ともかく

sudo dnf install clang-devel

しておけば，コンパイルが無事にできて commonmarker がインストールできることが分かった。

commonmarker は拡張ライブラリーであって，コンパイルが必要な部分を内包しているのだが，さまざまなプラットフォーム用に事前にコンパイルしたものも用意されている。これを使わず，インストールするマシン上でコンパイルすることもできる。 ↩