»AWS EC2

»aws-ami (builder)

Search for and return an existing AMI.

»Interface

  • Output: ami.Image

»Required Parameters

These parameters are used in the use stanza for this plugin.

»region

The AWS region to search in.

  • Type: string

»Optional Parameters

These parameters are used in the use stanza for this plugin.

»filters

DescribeImage specific filters to search with.

The filters are always name => [value].

  • Type: map[string][]string
  • Optional

»name

The name of the AMI to search for, supports wildcards.

  • Type: string
  • Optional

»owners

The set of AMI owners to restrict the search to.

  • Type: []string
  • Optional

»Output Attributes

Output attributes can be used in your waypoint.hcl as variables via artifact or deploy.

»image

  • Type: string

»aws-ec2 (platform)

Deploy the application into an AutoScaling Group on EC2.

»Interface

  • Input: ami.Image
  • Output: ec2.Deployment

»Required Parameters

These parameters are used in the use stanza for this plugin.

»count

How many EC2 instances to configure the ASG with.

The fields here (desired, min, max) map directly to the typical ASG configuration.

  • Type: *ec2.countConfig

»instance_type

The EC2 instance type to deploy.

  • Type: string

»region

The AWS region to deploy into.

  • Type: string

»service_port

The TCP port on the instances that the app will be running on.

  • Type: int

»Optional Parameters

These parameters are used in the use stanza for this plugin.

»extra_ports

Additional TCP ports to allow into the EC2 instances.

These additional ports are usually used to allow secondary services, such as ssh.

  • Type: []int
  • Optional

»key

The name of an SSH Key to associate with the instances, as preconfigured in EC2.

  • Type: string
  • Optional

»security_groups

Additional security groups to attached to the EC2 instances.

This plugin creates security groups that match the above ports by default. this field allows additional security groups to be specified for the instances.

  • Type: []string
  • Optional

»subnet

The subnet to place the instances into.

  • Type: string
  • Optional
  • Default: a public subnet in the dafault VPC

»Output Attributes

Output attributes can be used in your waypoint.hcl as variables via artifact or deploy.

»public_dns

  • Type: string

»public_ip

  • Type: string

»region

  • Type: string

»service_name

  • Type: string

»target_group_arn

  • Type: string

»aws-alb (releasemanager)

Release target groups by attaching them to an ALB.

»Interface

  • Input: alb.TargetGroup
  • Output: alb.Release

»Mappers

»Allow EC2 Deployments to be hooked up to an ALB

  • Input: ec2.Deployment
  • Output: alb.TargetGroup

»Required Parameters

This plugin has no required parameters.

»Optional Parameters

These parameters are used in the use stanza for this plugin.

»certificate

ARN for the certificate to install on the ALB listener.

When this is set, the port automatically changes to 443 unless overriden in this configuration.

  • Type: string
  • Optional

»domain_name

Fully qualified domain name to set for the ALB.

Set along with zone_id to have DNS automatically setup for the ALB. this value should include the full hostname and domain name, for instance app.example.com.

  • Type: string
  • Optional

»listener_arn

The ARN on an existing ALB to configure.

When this is set, no ALB or Listener is created. Instead the application is configured by manipulating this existing Listener. This allows users to configure their ALB outside waypoint but still have waypoint hook the application to that ALB.

  • Type: string
  • Optional

»name

The name to assign the ALB.

Names have to be unique per region.

  • Type: string
  • Optional
  • Default: derived from application name

»port

The TCP port to configure the ALB to listen on.

  • Type: int
  • Optional
  • Default: 80 for HTTP, 443 for HTTPS

»subnets

The subnet ids to allow the ALB to run in.

  • Type: []string
  • Optional
  • Default: public subnets in the account default VPC

»zone_id

Route53 ZoneID to create a DNS record into.

Set along with domain_name to have DNS automatically setup for the ALB.

  • Type: string
  • Optional