シェルスクリプトでOS・ディストリビューションを判定する方法｜/etc/os-releaseとID_LIKEでRHEL系とDebian系に1本で対応する設計

この記事のポイント

・/etc/os-release の ID 変数が最もポータブルな判定手段で、RHEL 7・Ubuntu 14.04以降に対応している
・ID_LIKE 変数を使えば AlmaLinux・Rocky Linux などの派生ディストリにも正確に対応できる
・パッケージマネージャーと設定パスの差分はwrapper関数1つで吸収し、呼び出し元のロジックを統一できる
・/etc/os-release がない旧環境や Alpine Linux・WSL2 へのフォールバックも設計に含める

# ファイルの内容例（Rocky Linux 9）
NAME="Rocky Linux"
VERSION="9.4 (Blue Onyx)"
ID=rocky
ID_LIKE="rhel centos fedora"
VERSION_ID="9.4"
PLATFORM_ID="platform:el9"
PRETTY_NAME="Rocky Linux 9.4 (Blue Onyx)"

# /etc/os-releaseを読み込む（ファイルが存在しない場合はスキップ）
if [ -f /etc/os-release ]; then
    . /etc/os-release
fi

# $IDの値を確認する
echo "OS ID: ${ID}"
echo "ID_LIKE: ${ID_LIKE}"

OS ID: rocky
ID_LIKE: rhel centos fedora

#!/bin/bash

# OSファミリーを返す関数
# 戻り値（標準出力）: "rhel" | "debian" | "alpine" | "unknown"
detect_os_family() {
    local id=""
    local id_like=""

    if [ -f /etc/os-release ]; then
        # サブシェルでsourceして変数を取得
        id=$(. /etc/os-release && echo "${ID}")
        id_like=$(. /etc/os-release && echo "${ID_LIKE}")
    fi

    # ID_LIKEにrhel/centos/fedoraが含まれればRHEL系
    case "${id_like}" in
        *rhel*|*centos*|*fedora*)
            echo "rhel"
            return
            ;;
    esac

    # IDで直接判定
    case "${id}" in
        rhel|centos|fedora|rocky|almalinux)
            echo "rhel"
            ;;
        debian|ubuntu|linuxmint|pop)
            echo "debian"
            ;;
        alpine)
            echo "alpine"
            ;;
        *)
            # フォールバック: 旧来のファイルで判定
            if [ -f /etc/redhat-release ]; then
                echo "rhel"
            elif [ -f /etc/debian_version ]; then
                echo "debian"
            else
                echo "unknown"
            fi
            ;;
    esac
}

os_family=$(detect_os_family)

case "${os_family}" in
    rhel)
        echo "RHEL系ディストリビューションです"
        ;;
    debian)
        echo "Debian系ディストリビューションです"
        ;;
    alpine)
        echo "Alpine Linuxです"
        ;;
    *)
        echo "未対応のOSです（処理を中止します）"
        exit 1
        ;;
esac

# パッケージインストールのwrapper関数
pkg_install() {
    local pkg="$1"
    local family
    family=$(detect_os_family)

    case "${family}" in
        rhel)
            dnf install -y "${pkg}" 2>/dev/null || yum install -y "${pkg}"
            ;;
        debian)
            apt-get install -y "${pkg}"
            ;;
        alpine)
            apk add --no-cache "${pkg}"
            ;;
        *)
            echo "エラー: 未対応のOSです" >&2
            return 1
            ;;
    esac
}

# パッケージ削除のwrapper関数
pkg_remove() {
    local pkg="$1"
    local family
    family=$(detect_os_family)

    case "${family}" in
        rhel)
            dnf remove -y "${pkg}" 2>/dev/null || yum remove -y "${pkg}"
            ;;
        debian)
            apt-get remove -y "${pkg}"
            ;;
        alpine)
            apk del "${pkg}"
            ;;
    esac
}

# 呼び出し例（OSを意識しない記述ができる）
pkg_install nginx
pkg_install vim

# OS別の設定ディレクトリパスを返す関数
get_sysconf_dir() {
    local family
    family=$(detect_os_family)

    case "${family}" in
        rhel)
            echo "/etc/sysconfig"
            ;;
        debian)
            echo "/etc/default"
            ;;
        *)
            echo "/etc/default"
            ;;
    esac
}

# 使用例
sysconf_dir=$(get_sysconf_dir)
echo "設定ファイルパス: ${sysconf_dir}/nginx"

# Alpine Linuxの/etc/os-releaseの例
ID=alpine
VERSION_ID=3.19.0
PRETTY_NAME="Alpine Linux v3.19"

# コンテナ内かどうかを判定する関数
is_container() {
    if [ -f /.dockerenv ]; then
        return 0  # コンテナ内
    fi
    # cgroup情報でも確認できる
    if grep -qE '(docker|lxc|kubepods)' /proc/1/cgroup 2>/dev/null; then
        return 0
    fi
    return 1  # コンテナ外
}

# 使用例
if is_container; then
    echo "コンテナ環境: syslog送信先を変更します"
fi

# WSL2かどうかを判定する関数
is_wsl() {
    if grep -qiE 'microsoft' /proc/version 2>/dev/null; then
        return 0  # WSL2
    fi
    return 1
}

if is_wsl; then
    echo "WSL2環境: Windows側ファイルシステムとの連携処理を実行します"
fi

# /etc/os-releaseがない旧環境向けフォールバック
_detect_legacy_os() {
    if [ -f /etc/redhat-release ]; then
        echo "rhel"
    elif [ -f /etc/debian_version ]; then
        echo "debian"
    elif [ -f /etc/alpine-release ]; then
        echo "alpine"
    else
        echo "unknown"
    fi
}

id=$(. /etc/os-release 2>/dev/null && echo "${ID}")
if [ -z "${id}" ]; then
    # IDが空の場合はフォールバック
    id=$(_detect_legacy_os)
fi