Ruby 3.0.7 RPM Builder & Repository

A complete solution for building Ruby 3.0.7 RPM packages and hosting them as a YUM/DNF repository on GitHub. Perfect for Enterprise Linux environments (Amazon Linux, Rocky Linux, RHEL, CentOS, etc.).

🎯 What This Project Does

This project provides:

1. Docker-based Ruby RPM Builder: Builds Ruby 3.0.7 with compat-openssl11 support
2. Automated RPM Repository: Creates a complete YUM/DNF repository with metadata
3. GitHub-hosted Package Distribution: Serves RPM packages directly from GitHub
4. Easy Server Installation: One-line installation script for your servers

🏗️ Architecture Overview

📦 Ruby Build Process
├── 🐳 Docker Container
│   ├── Builds Ruby 3.0.7 + compat-openssl11 RPMs
│   ├── Creates repository metadata (repodata/)
│   └── Generates client setup files
├── 🎯 GitHub Actions
│   ├── Automates the build process
│   └── Uploads complete repository as artifact
└── 📁 Repository Structure
    └── ruby3-0-7/
        ├── rpm-repo/x86_64/          # RPM packages + metadata
        └── client-setup/             # Installation scripts

🚀 Quick Start Guide

For Repository Maintainers

1. Fork & Setup

# Fork this repository to your GitHub account
# Clone your fork
git clone https://github.com/YOUR-USERNAME/ruby-build.git
cd ruby-build

2. Trigger Build

# Go to GitHub Actions tab in your repository
# Run "Build Ruby RPM (Simple)" workflow
# Click "Run workflow" button (x86_64 only)

3. Download & Deploy

# After build completes:
# 1. Go to Actions → Latest Run → Artifacts
# 2. Download "ruby3-0-7-complete-x86_64"
# 3. Extract the zip file
# 4. You'll get a ruby3-0-7/ folder

# Update repository URLs in the files:
# Edit ruby3-0-7/client-setup/ruby-build.repo
# Edit ruby3-0-7/client-setup/install.sh
# Replace USERNAME/REPOSITORY with your GitHub details

# Upload to your repository
cp -r ruby3-0-7 /path/to/your/repo/
cd /path/to/your/repo/
git add ruby3-0-7/
git commit -m "🚀 Add Ruby 3.0.7 RPM repository"
git push

For Server Administrators

1. Install Repository (One Command)

# Replace YOUR-USERNAME/YOUR-REPO with actual repository details
curl -fsSL https://raw.githubusercontent.com/YOUR-USERNAME/YOUR-REPO/main/ruby3-0-7/client-setup/install.sh | sudo bash

2. Install Ruby

# Install Ruby and dependencies
sudo dnf install ruby compat-openssl11

# Verify installation
ruby --version
dnf info ruby  # Should show ruby-build-3-0-7 as source

3. Package Management

# Search for available Ruby packages
dnf search ruby --repo=ruby-build-3-0-7

# List all packages from ruby-build repository
dnf list available --repo=ruby-build-3-0-7

# Update Ruby packages
sudo dnf update --repo=ruby-build-3-0-7

📋 Detailed Instructions

Building Ruby RPMs

Prerequisites

• GitHub account
• Basic familiarity with GitHub Actions
• Text editor for updating configuration files

Step-by-Step Build Process

1. Access GitHub Actions

   • Go to your forked repository on GitHub
   • Click "Actions" tab
   • Select "Build Ruby RPM (Simple)" workflow

2. Configure Build

   • Click "Run workflow"
   • Select branch: main
   • Click "Run workflow" button (builds x86_64 automatically)

3. Monitor Build Progress

   • Build takes approximately 15-20 minutes
   • Watch the progress in the Actions tab
   • Green checkmark = successful build
   • Red X = build failed (check logs)

4. Download Artifacts

   • After successful build, scroll to "Artifacts" section
   • Download ruby3-0-7-complete-x86_64.zip
   • Extract the zip file to get ruby3-0-7/ folder

Artifact Contents Explained

ruby3-0-7/
├── rpm-repo/
│   └── x86_64/
│       ├── repodata/                    # Repository metadata
│       │   ├── repomd.xml              # Main metadata file
│       │   ├── primary.xml.gz          # Package information
│       │   ├── filelists.xml.gz        # File listings
│       │   └── other.xml.gz            # Additional metadata
│       ├── ruby-3.0.7-*.rpm           # Ruby interpreter
│       ├── ruby-libs-*.rpm             # Ruby libraries
│       ├── ruby-devel-*.rpm            # Development files
│       └── compat-openssl11-*.rpm      # OpenSSL 1.1 compatibility
└── client-setup/
    ├── ruby-build.repo                 # YUM/DNF repository config
    └── install.sh                      # Automated installation script

Configuring Repository URLs

Edit Repository Configuration

# Open ruby3-0-7/client-setup/ruby-build.repo
# Update this line:
baseurl=https://raw.githubusercontent.com/USERNAME/REPOSITORY/main/ruby3-0-7/rpm-repo/x86_64/

# Replace USERNAME with your GitHub username
# Replace REPOSITORY with your repository name
# Example:
baseurl=https://raw.githubusercontent.com/johndoe/ruby-build/main/ruby3-0-7/rpm-repo/x86_64/

Edit Installation Script

# Open ruby3-0-7/client-setup/install.sh
# Update this line:
REPO_URL="https://raw.githubusercontent.com/USERNAME/REPOSITORY/main"

# Example:
REPO_URL="https://raw.githubusercontent.com/johndoe/ruby-build/main"

Server-Side Installation

Manual Repository Setup

# Method 1: Using the install script (recommended)
curl -fsSL https://raw.githubusercontent.com/YOUR-USERNAME/YOUR-REPO/main/ruby3-0-7/client-setup/install.sh | sudo bash

# Method 2: Manual configuration
sudo curl -o /etc/yum.repos.d/ruby-build-3-0-7.repo \
  https://raw.githubusercontent.com/YOUR-USERNAME/YOUR-REPO/main/ruby3-0-7/client-setup/ruby-build.repo

sudo dnf clean all
sudo dnf makecache

Repository Priority Explanation

The repository is configured with priority=9, which means:

• Lower number = Higher priority
• Amazon Linux default repos typically have priority 10
• Your Ruby packages will be preferred over Amazon Linux Ruby packages
• System-critical repos (priority 1-50) still take precedence

Verifying Installation

# Check if repository is installed
dnf repolist | grep ruby-build

# Verify Ruby will come from your repository
dnf list ruby --showduplicates

# Check package information
dnf info ruby

# Test Ruby installation
ruby --version
which ruby

🔧 Technical Details

What Gets Built

• Ruby 3.0.7: Main interpreter with compat-openssl11 support
• Ruby Libraries: Runtime libraries and standard library
• Ruby Development: Headers and development tools
• compat-openssl11: OpenSSL 1.1.1 compatibility layer
• Repository Metadata: Complete YUM/DNF repository structure

Build Process Details

1. Container Setup: Amazon Linux base with development tools
2. OpenSSL Build: Builds compat-openssl11 packages from source
3. Ruby Configuration: Modifies Ruby spec to use compat-openssl11
4. RPM Building: Creates all Ruby-related packages
5. Repository Creation: Generates metadata with createrepo_c
6. Testing: Verifies package installation and Ruby functionality

Security Considerations

• No GPG Signing: Packages are not GPG signed (gpgcheck=0)
• Public Repository: All packages are publicly accessible
• Source Verification: Built from official Rocky Linux SRPMs
• Container Isolation: Build process runs in isolated container

Supported Platforms

• Architecture: x86_64 only (Intel/AMD 64-bit)
• OS Compatibility: Enterprise Linux 9 (Amazon Linux 2023, Rocky Linux 9, RHEL 9, CentOS 9, AlmaLinux 9)
• Ruby Version: 3.0.7 (with potential for version updates)
• Note: aarch64 (ARM64) support removed for simplicity

🛠️ Troubleshooting

Common Build Issues

Build Fails During Docker Build

# Check Docker logs
docker logs ruby-builder

# Common issues:
# - Network connectivity problems
# - Insufficient disk space
# - Missing dependencies

Artifact Download Problems

# Artifacts are only available for:
# - 30 days after build
# - Successful builds only
# - Repository collaborators

# Re-run the workflow if artifact expired

Common Installation Issues

Repository Not Found

# Verify repository URL is accessible
curl -I https://raw.githubusercontent.com/YOUR-USERNAME/YOUR-REPO/main/ruby3-0-7/client-setup/ruby-build.repo

# Should return "200 OK"

Package Conflicts

# Remove existing Ruby packages
sudo dnf remove ruby* rubygems* --skip-broken

# Clean DNF cache
sudo dnf clean all

# Reinstall from ruby-build repository
sudo dnf install ruby --repo=ruby-build-3-0-7

Permission Denied

# Ensure you have sudo privileges
sudo -v

# Check repository file permissions
ls -la /etc/yum.repos.d/ruby-build-3-0-7.repo

Getting Help

Build Logs

• Check GitHub Actions logs for detailed build information
• Look for error messages in Docker build steps
• Verify all dependencies are correctly installed

Repository Issues

• Verify file permissions and accessibility
• Check network connectivity from server
• Ensure repository URLs are correctly configured

Ruby Issues

• Test with ruby --version and ruby -e "puts 'Hello'"
• Check library loading with ruby -e "require 'openssl'; puts OpenSSL::VERSION"
• Verify gem installation with gem --version

📝 Advanced Configuration

Adding Multiple Ruby Versions

# Create additional version directories
ruby3-1-0/
ruby3-2-0/
# Each with their own rpm-repo and client-setup

Custom Build Modifications

# Modify Dockerfile to:
# - Change Ruby version
# - Add additional packages
# - Modify build flags
# - Include custom patches

Repository Maintenance

# Periodic tasks:
# - Update Ruby versions
# - Clean old packages
# - Monitor repository size
# - Update security patches

🧪 Testing Rails Applications

Rails 7.0 + Ruby 3.0.7 Compatibility Testing

This repository includes a working example of Ruby 3.0.7 running Rails 7.0 on Amazon Linux. The setup demonstrates compatibility and provides a foundation for Rails applications.

Quick Rails Test

# Build the Rails test container
podman build -f Dockerfile.optimized -t rails-ruby-test .

# Run the Rails application
podman run -d -p 3000:3000 --name rails-app rails-ruby-test

# Test the application
curl http://localhost:3000/todos

# View logs
podman logs rails-app

# Stop and cleanup
podman stop rails-app && podman rm rails-app

What's Included in the Test App

The test application includes:

• Rails 7.0.8.7 running on Ruby 3.0.7
• SQLite3 database with todo scaffold
• Compatibility fixes for Logger constant issues
• Native gem compilation (nokogiri, psych, etc.)
• OpenSSL compatibility using compat-openssl11
• Responsive web interface with basic styling

Rails Application Features

# View todo list
curl http://localhost:3000/todos

# Create new todo (GET form)
curl http://localhost:3000/todos/new

# Access individual todos
curl http://localhost:3000/todos/1
curl http://localhost:3000/todos/2
curl http://localhost:3000/todos/3

Pre-seeded Test Data

The application comes with test todos to verify functionality:

1. "Test Ruby 3.0.7 + Rails 7.0" - Compatibility verification
2. "Check OpenSSL compatibility" - compat-openssl11 validation
3. "Test gem compilation" - Native extension verification

Known Compatibility Fixes Applied

1. Logger Constant Issue:

   # Patches ActiveSupport logger_thread_safe_level.rb
   RUN find /usr/local/share/gems/gems -name "logger_thread_safe_level.rb" -exec sed -i '1i require "logger"' {} \;

2. Psych Gem Compilation:

   # Adds required YAML development headers
   RUN yum install -y libyaml-devel

3. System Dependencies:

   # Complete development environment
   RUN yum install -y gcc gcc-c++ make sqlite-devel libyaml-devel

Building Custom Rails Applications

Use the optimized Dockerfile as a base for your Rails applications:

FROM amazonlinux:latest

# Copy the Ruby installation steps from Dockerfile.optimized
# Add Ruby 3.0.7 repository
RUN curl -fsSL "https://raw.githubusercontent.com/YOUR-USERNAME/YOUR-REPO/main/ruby3-0-7/client-setup/ruby-build.repo" \
    -o "/etc/yum.repos.d/ruby-build-3-0-7.repo"

# Install Ruby and system dependencies  
RUN yum clean all && yum makecache && \
    yum install -y ruby ruby-devel compat-openssl11 compat-openssl11-devel \
                   gcc gcc-c++ make sqlite-devel libyaml-devel nodejs npm

# Install Rails and apply compatibility fixes
RUN gem install rails -v "~> 7.0.0" --no-document && \
    find /usr/local/share/gems/gems -name "logger_thread_safe_level.rb" -exec sed -i '1i require "logger"' {} \;

# Add your Rails application
COPY . /app
WORKDIR /app
RUN bundle install

# Start your Rails app
CMD ["rails", "server", "-b", "0.0.0.0"]

Performance Metrics

Container build times:

• From source compilation: ~20+ minutes
• Using RPM repository: ~5 minutes
• Build cache utilization: ~2 minutes for rebuilds

Runtime verification:

• Rails server starts in ~3-5 seconds
• Native gems compile successfully
• Full CRUD operations functional
• OpenSSL/TLS connections working

Troubleshooting Rails Issues

Common Rails + Ruby 3.0.7 issues:

1. Logger constant errors:

   # Already fixed in Dockerfile.optimized
   # Manual fix: Add require "logger" to problematic files

2. Psych compilation failures:

   # Ensure libyaml-devel is installed
   yum install -y libyaml-devel

3. Bundle install as root warnings:

   # Non-critical warning - application still functions
   # For production, use non-root user

4. Gem compilation issues:

   # Ensure all development packages are installed
   yum install -y gcc gcc-c++ make openssl-devel libffi-devel

📖 Additional Resources

Documentation Links

• RPM Packaging Guide
• DNF Repository Management
• Ruby Build Configuration
• GitHub Actions Documentation
• Rails 7.0 Documentation

Community Support

• Issues: Report problems in the GitHub Issues section
• Discussions: Use GitHub Discussions for questions
• Contributions: Pull requests welcome for improvements

📄 License & Legal

This project is provided as-is for building Ruby RPM packages from official sources. All built packages maintain their original licensing terms:

• Ruby: Licensed under Ruby License / BSD 2-Clause License
• OpenSSL: Licensed under Apache License 2.0
• Rocky Linux packages: Follow respective upstream licenses

🔄 Version History

• v1.0: Initial Ruby 3.0.7 build with compat-openssl11
• v1.1: Added automated repository generation
• v1.2: GitHub-hosted repository with client setup
• Current: Complete automated workflow with manual deployment

---

Need Help? Open an issue in this repository or check the troubleshooting section above.