Disable Ruby 4.0.4 install-time docs for ruby-build installs

[Copilot]

Ruby 4.0.4 installs started failing in the Ruby feature due to an upstream regression during install-time documentation generation. This change makes both supported install paths skip doc generation only for Ruby 4.0.4 so the feature can provision the affected version reliably without changing other Ruby install flows.

• What changed

  • Pass RUBY_CONFIGURE_OPTS='--disable-install-doc' when installing Ruby 4.0.4 through mise
  • Pass the same option when installing Ruby 4.0.4 through rbenv
  • Leave other Ruby versions on their existing install commands unchanged

• Why this is scoped correctly

  • The failure being worked around is specific to Ruby 4.0.4
  • Both mise and rbenv flow through ruby-build, so both paths need the same version-specific guardrail

• Result

  • Avoids triggering install-time RubyGems/RDoc doc generation for affected Ruby 4.0.4 builds
  • Preserves the current feature contract for other Ruby versions while narrowing the workaround to the affected install step

if [ "$VERSION" = "4.0.4" ]; then
  RUBY_CONFIGURE_OPTS='--disable-install-doc' /usr/local/share/rbenv/bin/rbenv install "$VERSION"
else
  /usr/local/share/rbenv/bin/rbenv install "$VERSION"
fi

if [ "$VERSION" = "4.0.4" ]; then
  RUBY_CONFIGURE_OPTS='--disable-install-doc' "$HOME/.local/bin/mise" install "ruby@$VERSION"
else
  "$HOME/.local/bin/mise" install "ruby@$VERSION"
fi

[rafaelfranca]

@copilot does using this option cause miss to not use the precompiled versions?

[Copilot]

@copilot does using this option cause miss to not use the precompiled versions?

No — not in the precompiled path. In cef2bc6, RUBY_CONFIGURE_OPTS is only relevant if ruby-build actually runs ./configure/make. The with_precompiled_rubies scenario still passed in CI on this branch, and its log shows mise downloading and extracting ruby-4.0.4.x86_64_linux.tar.gz, so it was still using the precompiled artifact.

[rafaelfranca]

@copilot can we only use the disable-doc option the the Ruby version is 4.0.4?

[Copilot]

@copilot can we only use the disable-doc option the the Ruby version is 4.0.4?

Done in 19f5c8d. The disable-doc flag is now only applied when the requested Ruby version is 4.0.4; other versions keep the previous install command in both the mise and rbenv paths.

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

• containers.dev
  • Triggering command: /home/REDACTED/work/_temp/ghcca-node/node/bin/node node /home/REDACTED/work/devcontainer/devcontainer/node_modules/.bin/devcontainer features test -f ruby --skip-autogenerated --skip-duplicated . (dns block)
• mise.run
  • Triggering command: /usr/bin/curl curl REDACTED (dns block)
• westus.data.mcr.microsoft.com
  • Triggering command: /home/REDACTED/work/_temp/ghcca-node/node/bin/node node /home/REDACTED/work/devcontainer/devcontainer/node_modules/.bin/devcontainer features test -f ruby --skip-autogenerated --skip-duplicated . (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

[rafaelfranca]

@copilot improve your changes. There is too much duplication in your code

[Copilot]

@copilot improve your changes. There is too much duplication in your code

Done in fe3dd40. I factored the Ruby 4.0.4-specific install logic into a shared helper so the mise and rbenv paths no longer duplicate the conditional workaround.

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

• containers.dev
  • Triggering command: /home/REDACTED/work/_temp/ghcca-node/node/bin/node node /home/REDACTED/work/devcontainer/devcontainer/node_modules/.bin/devcontainer features test -f ruby --skip-autogenerated --skip-duplicated . (dns block)
• eastus.data.mcr.microsoft.com
  • Triggering command: /home/REDACTED/work/_temp/ghcca-node/node/bin/node node /home/REDACTED/work/devcontainer/devcontainer/node_modules/.bin/devcontainer features test -f ruby --skip-autogenerated --skip-duplicated . (dns block)
• mise.run
  • Triggering command: /usr/bin/curl curl REDACTED (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

[Copilot]

Pull request overview

This PR scopes a workaround for a Ruby 4.0.4 ruby-build regression by conditionally disabling install-time documentation generation during Ruby installation, while keeping all other Ruby version install behavior unchanged.

Changes:

• Add a shared helper to run Ruby install commands under su, injecting RUBY_CONFIGURE_OPTS='--disable-install-doc' only for Ruby 4.0.4.
• Apply the version-specific workaround to both the rbenv and mise Ruby install paths.

Comments suppressed due to low confidence (1)

features/src/ruby/install.sh:132

• ruby@$_version is expanded into the su -c string without quoting. Because VERSION is user-controlled via feature options, this can break for unexpected values and can allow shell injection in the -c string. Wrap the version argument in quotes (e.g., pass "ruby@$_version" as done for the install command).

    run_ruby_install_command "$_user" "$_version" "$_home_dir/.local/bin/mise install \"ruby@$_version\""
    su "$_user" -c "$_home_dir/.local/bin/mise use -g ruby@$_version"
    su "$_user" -c "$_home_dir/.local/bin/mise settings add idiomatic_version_file_enable_tools ruby"

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.