シェルスクリプトのヒアドキュメント設計｜設定ファイル・SQLクエリ・通知メール本文を動的生成する実装パターン

この記事のポイント

・<<EOFは変数展開あり、<<'EOF'はシングルクォートで囲んで展開なしにできる
・<<-EOFを使うとタブでインデントした行頭を揃えてコードを整理できる
・ssh・mysql・mailコマンドと組み合わせると複数行の入力を安全に渡せる
・区切り文字はEOF以外の任意の文字列でよい。ネスト時は別名を使う

#!/bin/bash
SERVER_NAME="example.com"
DOC_ROOT="/var/www/html/example"

# echo版（行ごとにリダイレクトが必要でクォートのエスケープが増える）
echo "server {"                                  > /etc/nginx/conf.d/example.conf
echo "    listen 80;"                           >> /etc/nginx/conf.d/example.conf
echo "    server_name ${SERVER_NAME};"          >> /etc/nginx/conf.d/example.conf
echo "    root ${DOC_ROOT};"                    >> /etc/nginx/conf.d/example.conf
echo "    index index.html index.htm;"          >> /etc/nginx/conf.d/example.conf
echo "}"                                        >> /etc/nginx/conf.d/example.conf

#!/bin/bash
SERVER_NAME="example.com"
DOC_ROOT="/var/www/html/example"

# ヒアドキュメント版（ファイルに書きたい内容をそのままスクリプト内に書ける）
cat < /etc/nginx/conf.d/example.conf
server {
    listen 80;
    server_name ${SERVER_NAME};
    root ${DOC_ROOT};
    index index.html index.htm;
}
EOF

#!/bin/bash
DB_HOST="db01.internal"
DB_NAME="production"

# 区切り文字はEOF以外にも END や HEREDOC など何でもよい
cat <

[miyazaki@web01 ~]$ bash heredoc_test.sh
[database]
host = db01.internal
name = production
port = 3306

#!/bin/bash
# 変数展開を止めたい場合は区切り文字をシングルクォートで囲む
cat <<'EOF' > /tmp/template_raw.txt
# このファイルは後でsedで置換する
HOST=${DB_HOST}
NAME=${DB_NAME}
PORT=3306
EOF

cat /tmp/template_raw.txt

[miyazaki@web01 ~]$ bash heredoc_noexpand.sh
# このファイルは後でsedで置換する
HOST=${DB_HOST}
NAME=${DB_NAME}
PORT=3306

#!/bin/bash
generate_config() {
    local server_name="$1"
    # <<-EOF で行頭のタブを取り除く（本文はタブで字下げしてある）
    cat <<-EOF
	[server]
	name = ${server_name}
	enabled = true
	EOF
}

generate_config "app01"
generate_config "app02"

[miyazaki@web01 ~]$ bash heredoc_indent.sh
[server]
name = app01
enabled = true
[server]
name = app02
enabled = true

#!/bin/bash
# 複数バーチャルホストのNginx設定を一括生成するスクリプト

# 書式: "サイト名:ポート:ドキュメントルート"
SITES=(
    "site-a:8081:/var/www/site-a"
    "site-b:8082:/var/www/site-b"
    "site-c:8083:/var/www/site-c"
)

for site_info in "${SITES[@]}"; do
    IFS=':' read -r name port docroot <<< "${site_info}"
    conf_file="/etc/nginx/conf.d/${name}.conf"

    cat < "${conf_file}"
server {
    listen ${port};
    server_name ${name}.example.com;
    root ${docroot};
    index index.html index.htm;
    access_log /var/log/nginx/${name}_access.log;
    error_log  /var/log/nginx/${name}_error.log;
}
EOF
    echo "[$(date '+%Y-%m-%d %H:%M:%S')] 生成完了: ${conf_file}"
done

[miyazaki@web01 ~]$ sudo bash gen_vhost.sh
[2026-08-12 10:14:32] 生成完了: /etc/nginx/conf.d/site-a.conf
[2026-08-12 10:14:32] 生成完了: /etc/nginx/conf.d/site-b.conf
[2026-08-12 10:14:32] 生成完了: /etc/nginx/conf.d/site-c.conf

#!/bin/bash
REMOTE_HOST="app01.internal"
DEPLOY_DIR="/opt/myapp"
TIMESTAMP=$(date '+%Y-%m-%d %H:%M:%S')

ssh miyazaki@${REMOTE_HOST} <> "${DEPLOY_DIR}/logs/deploy.log"
    systemctl restart myapp.service
    systemctl is-active myapp.service && echo "起動確認OK" || echo "起動失敗"
EOF

#!/bin/bash
DB_USER="appuser"
DB_NAME="inventory"
TARGET_DATE="2026-08-01"

mysql -u "${DB_USER}" -p"$(cat /etc/myapp/db_pass)" "${DB_NAME}" <

#!/bin/bash
HOSTNAME=$(hostname)
DISK_USAGE=$(df -h /var | awk 'NR==2{print $0}')
TIMESTAMP=$(date '+%Y-%m-%d %H:%M:%S')
ALERT_MAIL="admin@example.com"

send_disk_alert() {
    local usage_pct="$1"
    mail -s "[ALERT] ${HOSTNAME} ディスク使用率 ${usage_pct}% 超過" "${ALERT_MAIL}" <

#!/bin/bash
SERVER_NAME="example.com"

# NG: シングルクォート区切りは変数展開されない
cat <<'EOF'
server_name ${SERVER_NAME};
EOF

# OK: クォートなし区切りは変数展開される
cat <

[miyazaki@web01 ~]$ bash heredoc_ng.sh
server_name ${SERVER_NAME};
server_name example.com;

# cat -Aでタブ(^I)とスペースを確認する
[miyazaki@web01 ~]$ cat -A heredoc_indent.sh | grep -n "name ="
 7:	name = ${server_name};$     # ^Iが見えればタブ（正常）
 8:    name = ${server_name};$  # スペースのみだと <<-EOF が効かない