Command Line Utilities - v5.9

Usage

rs_shutdown [options]

Options

Synopsis

RightScale Tagger (rs_tag)

Tagger allows listing, adding and removing tags on the current instance and querying for all instances with a given set of tags.

Note: Spaces in tags are not supported in RightLink v5.7 and earlier.

Usage

root@good%  rs_tag --help

 rs_tag (--list, -l | --add, -a TAG | --remove, -r TAG | --query, -q TAG_LIST)

Options

Examples

Retrieve all tags:

rs_tag --list
rs_tag -l

Add tag 'opinions:tags=awesome' to instance:

rs_tag --add 'opinions:tags=awesome'
rs_tag -a 'opinions:tags=awesome'

Remove tag 'opinions:tags=awesome' from instance:

rs_tag --remove 'opinions:tags=awesome'
rs_tag -r 'opinions:tags=awesome'

Get and print last tag value for 'opinions:tags':

tag=$(rs_tag --list | grep 'opinions:tags' | head -n 1) && tag_value=${tag##*=}
echo 'Opinion on tags: '"$tag_value"

Remove all tags:

for i in `rs_tag --list | grep - | awk '{print $2}'`; do $(rs_tag --remove $i) ; done

In a RightScript, manage a unique tag 'on itself' using an Input value:

#!/bin/bash -e

# RightScript: Set node DNS hostname tag

# NODE_HOSTNAME can be set to any type text, environment variable, credential etc.
# e.g. EC2_PUBLIC_HOSTNAME

# remove any existing rs_node:dns_hostname tags
tags_remove=$(rs_tag --list | grep 'rs_node:dns_hostname' | awk '{ print $2 }')

# remove existing tags
for tag in `echo $tags_remove`
do
	echo Removing "$tag"
	rs_tag --remove "$tag"
done

# Add rs_node dns hostname tag
rs_tag --add 'rs_node:dns_hostname='"$NODE_DNS_HOSTNAME"

# get and print 1st/last set rs node dns hostname
tag=$(rs_tag --list | grep 'rs_node:dns_hostname' | head -n 1) && node_dns_hostname=${tag##*=}
echo 'Current/latest node dns hostname: '"$node_dns_hostname"

echo 'Done.'

Querying for tags:

Use rs_tag with the --query, -q TAG_LIST to query tag information about instances in your deployment only. A query will not return instances that are in a different deployment. TAG_LIST is a space-delimited list of machine tags. You can use some wildcard functions in the TAG_LIST by substituting an asterisk (*) for the value part of the machine tag -- for example, rs_tag -q "loadbalancer:app=*". 

Note: This is not a fully supported wildcard function. Semi-wildcard functions will not work, such as rs_tag -q "loadbalancer:app=prod*"

This returns a JSON object to stdout with the following syntax:

{ <agentA_id> : { "tags": [ <tag_n> ] } }

# rs_tag --query "rs_logging:state=*"
{
  "rs-instance-05c03c0150c3b55b83a63b4eb8c0f2af5156d8ea-5013179": {
    "tags": [
      "rs_launch:type=auto",
      "rs_logging:state=active",
      "rs_login:state=active",
      "rs_monitoring:state=active"
    ]
  },
  "rs-instance-00f2710adb07e72bbabf42092c93c675098a9ef0-5013178": {
    "tags": [
      "rs_launch:type=auto",
      "rs_logging:state=active",
      "rs_login:state=active",
      "rs_monitoring:state=active"
    ]
  },
  "rs-instance-71334da6925feee899ee1e5d58cc8c8b2423a59a-5325028": {
    "tags": [
      "rs_logging:state=active",
      "rs_login:state=active",
      "rs_monitoring:state=active"
    ]
  }
}

# rs_tag --query "rs_logging:sta*"
# rs_tag --query "rs_logging:*"
# rs_tag --query "rs_logg*"