Module: Jets::AwsServices

Included in:
AwsInfo, Cfn::Ship, Cfn::Status, Cfn::TemplateBuilders::ApiGatewayBuilder, Cfn::TemplateBuilders::ApiGatewayDeploymentBuilder, Cfn::TemplateBuilders::ParentBuilder, Commands::Call, Commands::Delete, Commands::StackInfo, Commands::Url
Defined in:
lib/jets/aws_services.rb

Instance Method Summary collapse

Instance Method Details

#cfn ⇒ Object 



15
16
17
 
# File 'lib/jets/aws_services.rb', line 15

def cfn
  @cfn ||= Aws::CloudFormation::Client.new
end

#lambda ⇒ Object 



19
20
21
 
# File 'lib/jets/aws_services.rb', line 19

def lambda
  @lambda ||= Aws::Lambda::Client.new
end

#s3 ⇒ Object 



7
8
9
 
# File 'lib/jets/aws_services.rb', line 7

def s3
  @s3 ||= Aws::S3::Client.new
end

#s3_resource ⇒ Object 



11
12
13
 
# File 'lib/jets/aws_services.rb', line 11

def s3_resource
  @s3_resource ||= Aws::S3::Resource.new
end

#stack_exists?(stack_name) ⇒ Boolean

Returns:

  • (Boolean) 


27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
 
# File 'lib/jets/aws_services.rb', line 27

def stack_exists?(stack_name)
  return false if ENV['TEST']

  exist = nil
  begin
    # When the stack does not exist an exception is raised. Example:
    # Aws::CloudFormation::Errors::ValidationError: Stack with id blah does not exist
    resp = cfn.describe_stacks(stack_name: stack_name)
    exist = true
  rescue Aws::CloudFormation::Errors::ValidationError => e
    if e.message =~ /does not exist/
      exist = false
    elsif e.message.include?("'stackName' failed to satisfy constraint")
      # Example of e.message when describe_stack with invalid stack name
      # "1 validation error detected: Value 'instance_and_route53' at 'stackName' failed to satisfy constraint: Member must satisfy regular expression pattern: [a-zA-Z][-a-zA-Z0-9]*|arn:[-a-zA-Z0-9:/._+]*"
      puts "Invalid stack name: #{stack_name}"
      puts "Full error message: #{e.message}"
      exit 1
    else
      raise # re-raise exception  because unsure what other errors can happen
    end
  end
  exist
end

#stack_in_progress?(stack_name) ⇒ Boolean

All CloudFormation states listed here: docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-describing-stacks.html

Returns resp so we can use it to grab data about the stack without calling api again.

Returns:

  • (Boolean) 


55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
 
# File 'lib/jets/aws_services.rb', line 55

def stack_in_progress?(stack_name)
  return true if !stack_exists?(stack_name)

  # Assumes stack exists
  resp = cfn.describe_stacks(stack_name: stack_name)
  status = resp.stacks[0].stack_status
  if status =~ /_IN_PROGRESS$/
    puts "The '#{stack_name}' stack status is #{status}. " \
         "Please wait until the stack is ready and try again.".colorize(:red)
    exit 0
  elsif resp.stacks[0].outputs.empty?
    # This Happens when the miminal stack fails at the very beginning.
    # There is no s3 bucket at all.  User should delete the stack.
    puts "The minimal stack failed to create. Please delete the stack first and try again." \
    "You can delete the CloudFormation stack or use the `jets delete` command"
    exit 0
  else
    true
  end
end

#sts ⇒ Object 



23
24
25
 
# File 'lib/jets/aws_services.rb', line 23

def sts
  @sts ||= Aws::STS::Client.new
end