Запросити теги EC2 зсередини примірника

Нещодавно Amazon додав чудову особливість тегування екземплярів EC2 парами «ключ-значення», щоб трохи полегшити управління великою кількістю віртуальних машин.

Чи є спосіб запитати ці теги так само, як і деякі інші дані набору користувачів? Наприклад:

$ curl http://169.254.169.254/latest/meta-data/placement/availability-zone
us-east-1d

Чи існує якийсь подібний спосіб запитувати теги?

Ви можете використовувати комбінацію інструмента метаданих AWS (для отримання ідентифікатора свого примірника) та нового API тегів для отримання тегів для поточного екземпляра.

Наступний скрипт bash повертає Ім'я вашого поточного екземпляра ec2 (значення тегу "Ім'я"). Змініть TAG_NAME до вашого конкретного випадку.

TAG_NAME="Name"
INSTANCE_ID="`wget -qO- http://instance-data/latest/meta-data/instance-id`"
REGION="`wget -qO- http://instance-data/latest/meta-data/placement/availability-zone | sed -e 's:\([0-9][0-9]*\)[a-z]*\$:\\1:'`"
TAG_VALUE="`aws ec2 describe-tags --filters "Name=resource-id,Values=$INSTANCE_ID" "Name=key,Values=$TAG_NAME" --region $REGION --output=text | cut -f5`"

Щоб встановити Aws cli

sudo apt-get install python-pip -y
sudo pip install awscli

Якщо ви використовуєте IAM замість явних облікових даних, використовуйте ці дозволи IAM:

{
  "Version": "2012-10-17",
  "Statement": [
    {    
      "Effect": "Allow",
      "Action": [ "ec2:DescribeTags"],
      "Resource": ["*"]
    }
  ]
}

Після того, як ви отримали ec2-metadataта ec2-describe-tagsвстановили (як згадується у відповіді Раньєрі вище ), ось приклад команди оболонки, щоб отримати "ім'я" поточного екземпляра, якщо припустити, що на ньому є тег "Ім'я = Foo".

Передбачає, що встановлені змінні середовища EC2_PRIVATE_KEY та EC2_CERT.

ec2-describe-tags \
  --filter "resource-type=instance" \
  --filter "resource-id=$(ec2-metadata -i | cut -d ' ' -f2)" \
  --filter "key=Name" | cut -f5

Це повертається Foo.

Ви можете додати цей сценарій до своїх хмарних даних користувача для завантаження тегів EC2 у локальний файл:

#!/bin/sh
INSTANCE_ID=`wget -qO- http://instance-data/latest/meta-data/instance-id`
REGION=`wget -qO- http://instance-data/latest/meta-data/placement/availability-zone | sed 's/.$//'`
aws ec2 describe-tags --region $REGION --filter "Name=resource-id,Values=$INSTANCE_ID" --output=text | sed -r 's/TAGS\t(.*)\t.*\t.*\t(.*)/\1="\2"/' > /etc/ec2-tags

Вам потрібні інструменти AWS CLI, встановлені у вашій системі: ви можете встановити їх з packagesрозділом у файлі хмарного конфігурації перед сценарієм, використовувати AMI, який вже включає їх, або додати команду aptабо yumкоманду на початку сценарію.

Для доступу до тегів EC2 вам потрібна політика, подібна цій, у ролі IAM вашого екземпляра:

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "Stmt1409309287000",
      "Effect": "Allow",
      "Action": [
        "ec2:DescribeTags"
      ],
      "Resource": [
        "*"
      ]
    }
  ]
}

Теги EC2 примірника доступні /etc/ec2-tagsу такому форматі:

FOO="Bar"
Name="EC2 tags with cloud-init"

Ви можете включити файл як є у сценарій оболонки, використовуючи . /etc/ec2-tags, наприклад:

#!/bin/sh
. /etc/ec2-tags
echo $Name

Теги завантажуються під час ініціалізації екземпляра, тому вони не відображатимуть подальші зміни.

Сценарій та політика IAM засновані на відповіді itaifrenkel.

Якщо ви не знаходитесь у зоні доступності за замовчуванням, результати переосмислення повернуться порожніми.

ec2-describe-tags \
   --region \
     $(curl -s http://169.254.169.254/latest/meta-data/placement/availability-zone  | sed -e "s/.$//") \
   --filter \
     resource-id=$(curl --silent http://169.254.169.254/latest/meta-data/instance-id)

Якщо ви хочете додати фільтр, щоб отримати певний тег (elasticbeanstalk: середовище-ім'я в моєму випадку), ви можете це зробити.

ec2-describe-tags \
   --region \
     $(curl -s http://169.254.169.254/latest/meta-data/placement/availability-zone  | sed -e "s/.$//") \
   --filter \
     resource-id=$(curl --silent http://169.254.169.254/latest/meta-data/instance-id) \
   --filter \
     key=elasticbeanstalk:environment-name | cut -f5

І щоб отримати лише значення для тегу, який я відфільтрував, ми трубимо вирізати і отримаємо п’яте поле.

ec2-describe-tags \
  --region \
    $(curl -s http://169.254.169.254/latest/meta-data/placement/availability-zone  | sed -e "s/.$//") \
  --filter \
    resource-id=$(curl --silent http://169.254.169.254/latest/meta-data/instance-id) \
  --filter \
    key=elasticbeanstalk:environment-name | cut -f5

Для Python:

from boto import utils, ec2
from os import environ

# import keys from os.env or use default (not secure)
aws_access_key_id = environ.get('AWS_ACCESS_KEY_ID', failobj='XXXXXXXXXXX')
aws_secret_access_key = environ.get('AWS_SECRET_ACCESS_KEY', failobj='XXXXXXXXXXXXXXXXXXXXX')

#load metadata , if  = {} we are on localhost
# http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/AESDG-chapter-instancedata.html
instance_metadata = utils.get_instance_metadata(timeout=0.5, num_retries=1)
region = instance_metadata['placement']['availability-zone'][:-1]
instance_id = instance_metadata['instance-id']

conn = ec2.connect_to_region(region, aws_access_key_id=aws_access_key_id, aws_secret_access_key=aws_secret_access_key)
# get tag status for our  instance_id using filters
# http://docs.aws.amazon.com/AWSEC2/latest/CommandLineReference/ApiReference-cmd-DescribeTags.html
tags = conn.get_all_tags(filters={'resource-id': instance_id, 'key': 'status'})
if tags:
    instance_status = tags[0].value
else:
    instance_status = None
    logging.error('no status tag for '+region+' '+instance_id)

Ви також можете скористатися describe-instancesклипом, а не describe-tags:

Цей приклад показує, як отримати значення тегу 'my-tag-name' для примірника:

aws ec2 describe-instances \
  --instance-id $(curl -s http://169.254.169.254/latest/meta-data/instance-id) \
  --query "Reservations[*].Instances[*].Tags[?Key=='my-tag-name'].Value" \
  --region ap-southeast-2 --output text

Змініть регіон відповідно до місцевих обставин. Це може бути корисно, коли ваш екземпляр має привілеї descri-instances, але не теги description у політиці профілю екземпляра

Використовуючи API AWS 'data data' та 'meta data', можна написати сценарій, який обертає маріонетку, щоб запустити маріонетковий запуск зі спеціальним ім'ям cert.

Спочатку запустіть aws-екземпляр із користувацькими даними користувача: "роль: веб-сервер"

#!/bin/bash

# Find the name from the user data passed in on instance creation
USER=$(curl -s "http://169.254.169.254/latest/user-data")
IFS=':' read -ra UDATA <<< "$USER"

# Find the instance ID from the meta data api
ID=$(curl -s "http://169.254.169.254/latest/meta-data/instance-id")
CERTNAME=${UDATA[1]}.$ID.aws

echo "Running Puppet for certname: " $CERTNAME
puppet agent -t --certname=$CERTNAME 

Це називає маріонетку з ім'ям certname, як "webserver.i-hfg453.aws", тоді ви можете створити маніфест вузла під назвою "веб-сервер", а маріонетки "нечітке узгодження вузла" означатиме, що він використовується для надання всіх веб-серверів.

Цей приклад передбачає, що ви будуєте на базовому зображенні з встановленою маріонеткою тощо.

Переваги:

1) Вам не потрібно передавати свої повноваження

2) Ви можете бути настільки детальними, як вам подобається, за допомогою конфігурацій ролей.

Я зібрав наступне, що, сподіваємось, простіше і зрозуміліше, ніж деякі з існуючих відповідей, і використовує лише CLI AWS і ніяких додаткових інструментів.

Цей приклад коду показує, як отримати значення тегу 'myTag' для поточного екземпляра EC2:

Використання тегів опису :

export AWS_DEFAULT_REGION=us-east-1
instance_id=$(curl -s http://169.254.169.254/latest/meta-data/instance-id)
aws ec2 describe-tags \
  --filters "Name=resource-id,Values=$instance_id" 'Name=key,Values=myTag' \
  --query 'Tags[].Value' --output text

Або, альтернативно, за допомогою опису-екземплярів :

aws ec2 describe-instances --instance-id $instance_id \
  --query 'Reservations[].Instances[].Tags[?Key==`myTag`].Value' --output text

Варіація деяких відповідей вище, але ось як я отримав значення конкретного тегу із сценарію даних користувача на екземплярі

REGION=$(curl http://instance-data/latest/meta-data/placement/availability-zone | sed 's/.$//')

INSTANCE_ID=$(curl -s http://instance-data/latest/meta-data/instance-id)

TAG_VALUE=$(aws ec2 describe-tags --region $REGION --filters "Name=resource-id,Values=$INSTANCE_ID" "Name=key,Values='<TAG_NAME_HERE>'" | jq -r '.Tags[].Value')

Встановіть AWS CLI:

curl "https://s3.amazonaws.com/aws-cli/awscli-bundle.zip" -o "awscli-bundle.zip"
sudo apt-get install unzip
unzip awscli-bundle.zip
sudo ./awscli-bundle/install -i /usr/local/aws -b /usr/local/bin/aws

Отримайте теги для поточного екземпляра:

aws ec2 describe-tags --filters "Name=resource-id,Values=`ec2metadata --instance-id`"

Виходи:

{
    "Tags": [
        {
            "ResourceType": "instance", 
            "ResourceId": "i-6a7e559d", 
            "Value": "Webserver", 
            "Key": "Name"
        }
    ]
}

Використовуйте трохи perl для вилучення тегів:

aws ec2 describe-tags --filters \
"Name=resource-id,Values=`ec2metadata --instance-id`" | \
perl -ne 'print "$1\n" if /\"Value\": \"(.*?)\"/'

Повернення:

Webserver

Завантажте та запустіть автономний виконуваний файл для цього.

Іноді не можна встановити awscli, що залежить від python. Докер також може бути поза картиною.

Ось моя реалізація в golang: https://github.com/hmalphettes/go-ec2-describe-tags

Jq + ec2metaдані роблять це трохи приємніше. Я використовую cf і маю доступ до регіону. Інакше ви можете схопити його в баш.

aws ec2 describe-tags --region $REGION \
--filters "Name=resource-id,Values=`ec2metadata --instance-id`" | jq --raw-output \
'.Tags[] | select(.Key=="TAG_NAME") | .Value'

Для тих, хто досить божевільний, щоб використовувати Fish shell на EC2, ось зручний фрагмент для вашого /home/ec2-user/.config/fish/config.fish. Команда hostdata тепер перелічить усі ваші теги, а також загальнодоступні IP-адреси та ім’я хоста.

set -x INSTANCE_ID (wget -qO- http://instance-data/latest/meta-data/instance-id)
set -x REGION (wget -qO- http://instance-data/latest/meta-data/placement/availability-zone | sed 's/.$//')

function hostdata
    aws ec2 describe-tags --region $REGION --filter "Name=resource-id,Values=$INSTANCE_ID" --output=text | sed -r 's/TAGS\t(.*)\t.*\t.*\t(.*)/\1="\2"/'
    ec2-metadata | grep public-hostname
    ec2-metadata | grep public-ipv4
end