share facebook facebook twitter menu hatena pocket slack

2019.10.09 WED

EC2 user-data を使ってNAME Tagを設定する(Linux)

新川 貴章

WRITTEN BY 新川 貴章

前提条件

  • 今回は、EC2のName Tag をOSのスクリプトから設定する方法を紹介します。想定されるシチュエーションとしては、AMIからEC2 起動時にuser-data にスクリプトを組み込むことで一意のName Tag を設定します。
  • スクリプトサンプルはLinux 版となります。aws cli および curl、jq が使用できる環境が前提です。
  • Windows版のスクリプトサンプルは、下記記事を参照ください。
前提条件前回に引き続き、EC2のName Tag をOSのスクリプトから設定する方法を紹介します。お待たせしました! 今回は、PowerShellによるWindows Server が対象となります。想定されるシチュエーションとしては、AMIからEC2 起動時にuser-data にスクリプトを組み込む...

Linuxの場合

user-dataの設定方法

  • Linuxでシェルスクリプトが動作することを確認し、EC2インスタンス作成時の「インスタンスの詳細の設定」にて「高度な詳細」のユーザーデータに貼り付けます。
  • Linuxでのポイントは、シェバン(#! から始まる1行目)を忘れずに記載します。

スクリプトサンプル

  • EC2のメタデータを使用してインスタンスID、プライベートIPを読み込み、aws cli を使用して、Name Tagの設定を行います(Name TagにプライベートIPを追記する)。
    • 例:niikawa-test-Linux → niikawa-test-Linux-10.10.0.138
  • スクリプトの実行前後で、Namt Tag は下記の様に更新されます。

  • 以下、今回使用したスクリプトのサンプルです。EC2 起動時に、user-dataに指定します。
#!/bin/bash
TMPDIR=/tmp

# Instance IDを取得する
/usr/bin/curl 'http://169.254.169.254/latest/meta-data/instance-id' > ${TMPDIR}/instance-id.txt

# Private IPを取得する
/usr/bin/curl 'http://169.254.169.254/latest/meta-data/local-ipv4' > ${TMPDIR}/local-ipv4.txt

# NAME Tagを取得する
/usr/bin/aws ec2 describe-instances \
--query 'Reservations[].Instances[].{Name:Tags[?Key==`Name`].Value}' \
--filter "Name=instance-id,Values=`cat ${TMPDIR}/instance-id.txt`" \
--region ap-northeast-1 \
| /usr/bin/jq -r .[0].Name[0] > ${TMPDIR}/hostname.txt

# 変更後のNAME Tagを作成する
/usr/bin/echo `cat ${TMPDIR}/hostname.txt`-`cat ${TMPDIR}/local-ipv4.txt` > ${TMPDIR}/new-hostname.txt

# NAME Tagを更新する
/usr/bin/aws ec2 create-tags --resources `cat ${TMPDIR}/instance-id.txt` --tags Key=Name,Value=`cat ${TMPDIR}/new-hostname.txt` --region ap-northeast-1

user-dataが意図した通りに実行されない場合

  • 先ず、bashシェルスクリプト単体でエラーなく、実行できることを調査します。
  • EC2のroleに、EC2のFullAccess権限があることを確認します。
  • EC2起動後、下記ファイルを確認し、user-dataがセットされているか否かを調べます。
    • /var/lib/cloud/instance/user-data.txt
  • 下記ログファイルを確認し、エラーの有無や調査の手がかりを見つけます。
    • /var/log/cloud-init.log
  • bashシェルスクリプトにデバッグを追加し、どのステップで問題が起きたかを調べます。

参考資料

  • 今回のスクリプトでは、EC2のメタデータを読み込み、EC2のInstance IDやPrivate IPを取得しています。LinuxおよびWindowsでメタデータを読み込む方法は、下記の記事を参考にしてください。
概要EC2のインスタンスメタデータ(meta-data)およびユーザーデータ(user-data)は、インスタンス内からのみアクセス可能なインスタンスに関するデータです。インスタンスにアクセスできるユーザーなら誰でもそのメタデータおよびユーザーデータを参照できます。そ...
起動時に Amazon Linux インスタンスにユーザーデータを渡します。

元記事はこちら

EC2 user-data を使ってNAME Tagを設定する(Linux)

cloudpack

cloudpackは、Amazon EC2やAmazon S3をはじめとするAWSの各種プロダクトを利用する際の、導入・設計から運用保守を含んだフルマネージドのサービスを提供し、バックアップや24時間365日の監視/障害対応、技術的な問い合わせに対するサポートなどを行っております。
AWS上のインフラ構築およびAWSを活用したシステム開発など、案件のご相談はcloudpack.jpよりご連絡ください。