EC2インスタンスのhostnameを永続変更する方法｜Amazon Linux 2・2023対応の手順と注意点

この記事のポイント

・EC2のホスト名が戻るのは cloud-init の上書き動作が原因
・cloud.cfg の preserve_hostname: true で永続化できる
・Amazon Linux 2 と 2023 では設定ファイルのパスが異なる
・Auto Scaling 環境ではインスタンスIDを使った動的命名が正解

# ホスト名を変更する
$ sudo hostnamectl set-hostname web01.example.com

# 変更を確認する
$ hostnamectl
   Static hostname: web01.example.com
         Icon name: computer-vm
           Chassis: vm
        Machine ID: a1b2c3d4e5f6...
           Boot ID: f7e8d9c0b1a2...
    Virtualization: kvm
  Operating System: Amazon Linux 2
       CPE OS Name: cpe:2.3:o:amazon:amazon_linux:2
            Kernel: Linux 5.10.210-201.852.amzn2.x86_64
      Architecture: x86-64

# cloud.cfg を編集する
$ sudo vi /etc/cloud/cloud.cfg

# 以下の行を true に変更する（デフォルトは false）
preserve_hostname: true

# 変更前
preserve_hostname: false

# 変更後
preserve_hostname: true

# /etc/hostname の内容を確認する
$ cat /etc/hostname
web01.example.com

# /etc/hosts を確認する
$ cat /etc/hosts
127.0.0.1   localhost localhost.localdomain localhost4 localhost4.localdomain4
::1         localhost localhost.localdomain localhost6 localhost6.localdomain6

# /etc/hosts にエントリを追加する
$ sudo vi /etc/hosts

# 以下の行を追加する（プライベートIPに合わせる）
10.0.1.23   web01.example.com web01

# 再起動する
$ sudo reboot

# 再起動後にSSH再接続してホスト名を確認する
$ hostname
web01.example.com

$ hostname -f
web01.example.com

# Amazon Linux 2023 推奨の方法
$ sudo vi /etc/cloud/cloud.cfg.d/99-preserve-hostname.cfg

# 以下の内容を記述する
preserve_hostname: true

# Amazon Linux 2023 での hostnamectl 出力例
$ hostnamectl
 Static hostname: web01.example.com
 Pretty hostname: web01.example.com
       Icon name: computer-vm
         Chassis: vm
      Machine ID: b2c3d4e5f6a7...
         Boot ID: c3d4e5f6a7b8...
  Virtualization: kvm
Operating System: Amazon Linux 2023.7.20250101
          Kernel: Linux 6.1.128-136.201.amzn2023.x86_64
    Architecture: x86-64

# cloud-init のログで hostname 設定を確認する
$ sudo grep -i hostname /var/log/cloud-init.log
2026-05-12 10:00:01,234 - util.py[DEBUG]: Running module set_hostname
2026-05-12 10:00:01,234 - util.py[DEBUG]: preserve_hostname is set, skipping

#!/bin/bash
# Auto Scaling 向けの動的ホスト名設定スクリプト
INSTANCE_ID=$(curl -s http://169.254.169.254/latest/meta-data/instance-id)
REGION=$(curl -s http://169.254.169.254/latest/meta-data/placement/region)
HOSTNAME="web-${INSTANCE_ID}.${REGION}.internal"

# ホスト名を設定する
hostnamectl set-hostname "${HOSTNAME}"

# /etc/hosts に追記する
PRIVATE_IP=$(curl -s http://169.254.169.254/latest/meta-data/local-ipv4)
echo "${PRIVATE_IP}   ${HOSTNAME}" >> /etc/hosts

# preserve_hostname を設定する
cat > /etc/cloud/cloud.cfg.d/99-preserve-hostname.cfg << EOF
preserve_hostname: true
EOF

#!/bin/bash
# AWS CLI でタグからホスト名を取得する
INSTANCE_ID=$(curl -s http://169.254.169.254/latest/meta-data/instance-id)
REGION=$(curl -s http://169.254.169.254/latest/meta-data/placement/region)

# Name タグの値を取得する
NAME_TAG=$(aws ec2 describe-tags \
  --filters "Name=resource-id,Values=${INSTANCE_ID}" \
            "Name=key,Values=Name" \
  --region "${REGION}" \
  --query 'Tags[0].Value' \
  --output text)

if [ "${NAME_TAG}" != "None" ] && [ -n "${NAME_TAG}" ]; then
    HOSTNAME=$(echo "${NAME_TAG}" | tr '[:upper:]' '[:lower:]' | tr ' ' '-')
    hostnamectl set-hostname "${HOSTNAME}"
fi

# cloud-init のキャッシュを確認する
$ sudo ls -la /var/lib/cloud/instances/

# 設定が反映されているか確認する
$ sudo grep preserve_hostname /etc/cloud/cloud.cfg
preserve_hostname: true

# cloud-init のログでエラーを確認する
$ sudo tail -50 /var/log/cloud-init.log | grep -i error

# 現在の FQDN を確認する
$ hostname -f
hostname: Name or service not known

# /etc/hosts を確認する
$ cat /etc/hosts
127.0.0.1   localhost

# プライベートIPとFQDNを追加する
$ echo "10.0.1.23 web01.example.com web01" | sudo tee -a /etc/hosts

# 再確認する
$ hostname -f
web01.example.com

# AMI 作成前に cloud-init のデータをリセットする
$ sudo cloud-init clean --logs

# または手動でキャッシュディレクトリを削除する
$ sudo rm -rf /var/lib/cloud/instances
$ sudo rm -rf /var/lib/cloud/data

# /etc/hostname もクリアしておく（任意）
$ sudo truncate -s 0 /etc/hostname