add function to get instance with specific tags

Author: tonerdo

modules/bash-commons/src/aws-wrapper.sh

@@ -169,6 +169,22 @@ function aws_wrapper_get_ips_in_asg {
   echo "$instances" | jq -r ".Reservations[].Instances[].$ip_param"
 }
 
+# Return a space-separated list of IPs belonging to instances with specific tag values.
+# If use_public_ips is "true", these will be the public IPs; otherwise, these will be the private IPs.
+function aws_wrapper_get_ips_with_tag {
+  local readonly tag_key="$1"
+  local readonly tag_value="$2"
+  local readonly aws_region="$3"
+  local readonly use_public_ips="$4"
+
+  local instances
+  instances=$(aws_get_instances_with_tag "$tag_key" "$tag_value" "$aws_region")
+  assert_not_empty_or_null "$instances" "Get info about Instances with tag $tag_key set to $tag_value"
+
+  local readonly ip_param=$([[ "$use_public_ips" == "true" ]] && echo "PublicIpAddress" || echo "PrivateIpAddress")
+  echo "$instances" | jq -r ".Reservations[].Instances[].$ip_param"
+}
+
 # Return a space-separated list of hostnames in the given ASG. If use_public_hostnames is "true", these will be the
 # public hostnames; otherwise, these will be the private hostnames.
 function aws_wrapper_get_hostnames_in_asg {

modules/bash-commons/src/aws.sh

@@ -62,6 +62,17 @@ function aws_get_instance_tags {
     --filters "Name=resource-type,Values=instance" "Name=resource-id,Values=$instance_id"
 }
 
+# Get the instances with a given tag and in a specific region. Returns JSON from the AWS CLI's describe-instances command.
+function aws_get_instances_with_tag {
+  local readonly tag_key="$1"
+  local readonly tag_value="$2"
+  local readonly instance_region="$3"
+
+  aws ec2 describe-instances \
+    --region "$instance_region" \
+    --filters "Name=tag:$tag_key,Values=$tag_value"
+}
+
 # Describe the given ASG in the given region. Returns JSON from the AWS CLI's describe-auto-scaling-groups command.
 function aws_describe_asg {
   local readonly asg_name="$1"