rippled/.github/workflows/build-rhel.yml

# This workflow builds and tests the binary on various Red Hat Enterprise Linux
# configurations.
name: RHEL

on:
  workflow_call:
    inputs:
      build_dir:
        description: 'The directory where the build will take place.'
        required: false
        type: string
        default: '.build'
      conan_remote_name:
        description: 'The name of the Conan remote to use.'
        required: true
        type: string
      conan_remote_url:
        description: 'The URL of the Conan remote to use.'
        required: true
        type: string
    secrets:
      conan_remote_username:
        description: 'The username for logging into the Conan remote.'
        required: true
      conan_remote_password:
        description: 'The password for logging into the Conan remote.'
        required: true

concurrency:
  group: ${{ github.workflow }}-${{ github.ref }}-rhel
  cancel-in-progress: true

defaults:
  run:
    shell: bash

env:
  # Global configuration for Conan. This is used to set the number of parallel
  # downloads, uploads, and build jobs. The verbosity is set to verbose to
  # provide more information during the build process.
  CONAN_GLOBAL_CONF: |
    core.download:parallel={{ os.cpu_count() }}
    core.upload:parallel={{ os.cpu_count() }}
    tools.build:jobs={{ (os.cpu_count() * 4/5) | int }}
    tools.build:verbosity=verbose
    tools.compilation:verbosity=verbose
  # GitHub does not allow us to specify a reusable matrix strategy, so to avoid
  # duplication, we define it here using environment variables and create the
  # matrix in the first job. The matrix defined below should be kept in sync
  # with https://github.com/XRPLF/ci/blob/main/.github/workflows/rhel.yml.
  STRATEGY_MATRIX_ARCHITECTURE: >-
    [
      {
          "platform": "linux/amd64",
          "runner": "ubuntu-24.04"
      },
      {
          "platform": "linux/arm64",
          "runner": "ubuntu-24.04-arm"
      }
    ]
  STRATEGY_MATRIX_OS: >-
    [
        {
            "distro": "rhel",
            "release": "9.6",
            "compiler_name": "gcc",
            "compiler_version": "13"
        },
        {
            "distro": "rhel",
            "release": "9.6",
            "compiler_name": "gcc",
            "compiler_version": "14"
        },
        {
            "distro": "rhel",
            "release": "9.6",
            "compiler_name": "clang",
            "compiler_version": "any"
        },
    ]
  STRATEGY_MATRIX_BUILD_TYPE: >-
    [
      "Debug",
      "Release"
    ]
  STRATEGY_MATRIX_CMAKE_ARGS: >-
    [
      "-DUnity=OFF",
      "-DUnity=ON"
    ]

jobs:
  # Generate the strategy matrix and expose environment variables to be used by
  # following jobs. Exposing env vars this way is needed as they cannot be
  # directly passed as inputs to reusable workflows (although they can be passed
  # as inputs to actions).
  generate-outputs:
    runs-on: ubuntu-latest
    steps:
      - name: Generate outputs
        id: generate
        run: |
          echo "strategy_matrix_architecture=$(jq -c <<< '${{ env.STRATEGY_MATRIX_ARCHITECTURE }}')" >> "$GITHUB_OUTPUT"
          echo "strategy_matrix_os=$(jq -c <<< '${{ env.STRATEGY_MATRIX_OS }}')" >> "$GITHUB_OUTPUT"
          echo "strategy_matrix_build_type=$(jq -c <<< '${{ env.STRATEGY_MATRIX_BUILD_TYPE }}')" >> "$GITHUB_OUTPUT"
          echo "strategy_matrix_cmake_args=$(jq -c <<< '${{ env.STRATEGY_MATRIX_CMAKE_ARGS }}')" >> "$GITHUB_OUTPUT"
    outputs:
      conan_global_conf: ${{ env.CONAN_GLOBAL_CONF }}
      strategy_matrix_architecture: ${{ steps.generate.outputs.strategy_matrix_architecture }}
      strategy_matrix_os: ${{ steps.generate.outputs.strategy_matrix_os }}
      strategy_matrix_build_type: ${{ steps.generate.outputs.strategy_matrix_build_type }}
      strategy_matrix_cmake_args: ${{ steps.generate.outputs.strategy_matrix_cmake_args }}

  # Install and cache the dependencies using various configurations.
  install-dependencies:
    needs:
      - generate-outputs
    uses: ./.github/workflows/install-dependencies.yml
    strategy:
      fail-fast: false
      matrix:
        architecture: ${{ fromJson(needs.generate-outputs.outputs.strategy_matrix_architecture) }}
        os: ${{ fromJson(needs.generate-outputs.outputs.strategy_matrix_os) }}
        build_type: ${{ fromJson(needs.generate-outputs.outputs.strategy_matrix_build_type) }}
    with:
      build_dir: ${{ inputs.build_dir }}
      build_type: ${{ matrix.build_type }}
      conan_global_conf: ${{ needs.generate-outputs.outputs.conan_global_conf }}
      container: ghcr.io/xrplf/ci/${{ matrix.os.distro }}-${{ matrix.os.release }}:${{ matrix.os.compiler_name }}-${{ matrix.os.compiler_version }}
      runner: ${{ matrix.architecture.runner }}

  # Build and test the binary using various configurations.
  build-and-test:
    needs:
      - generate-outputs
      - install-dependencies
    uses: ./.github/workflows/build-nix.yml
    strategy:
      fail-fast: false
      matrix:
        architecture: ${{ fromJson(needs.generate-outputs.outputs.strategy_matrix_architecture) }}
        os: ${{ fromJson(needs.generate-outputs.outputs.strategy_matrix_os) }}
        build_type: ${{ fromJson(needs.generate-outputs.outputs.strategy_matrix_build_type) }}
        cmake_args: ${{ fromJson(needs.generate-outputs.outputs.strategy_matrix_cmake_args) }}
    with:
      build_dir: ${{ inputs.build_dir }}
      build_type: ${{ matrix.build_type }}
      cmake_args: ${{ matrix.cmake_args }}
      cmake_generator: "Ninja"
      conan_global_conf: ${{ needs.generate-outputs.outputs.conan_global_conf }}
      container: ghcr.io/xrplf/ci/${{ matrix.os.distro }}-${{ matrix.os.release }}:${{ matrix.os.compiler_name }}-${{ matrix.os.compiler_version }}
      runner: ${{ matrix.architecture.runner }}