feat: add a new construct library for ECS (#1058)

Add a new construct library to start services on ECS, both on EC2 and
Fargate-based clusters.

Containers can be started from images that are publicly available on
DockerHub, images in ECR repositories, and images built directly from
sources that are stored in source code next to the CDK app.

ECS services can be used as load balancer targets, and there are
higher-level constructs available to make it easy to start a service
behind a load balancer.

BREAKING CHANGE: the ec2.Connections object has been changed to be able
to manage multiple security groups. The relevant property has been
changed from `securityGroup` to `securityGroups` (an array of security
group objects).

Author: SoManyHs

.gitignore

@@ -10,3 +10,4 @@ pack
 coverage
 .nyc_output
 .LAST_BUILD
+*.swp

examples/cdk-examples-typescript/.gitignore

@@ -1,2 +1,3 @@
 .LAST_BUILD
-*.snk
+hello-cdk-ecs/cdk.json
+*.snk

examples/cdk-examples-typescript/hello-cdk-ecs-declarative/cdk.json

@@ -0,0 +1,3 @@
+{
+    "app": "fargate-service.yml"
+}

examples/cdk-examples-typescript/hello-cdk-ecs-declarative/fargate-service.yml

@@ -0,0 +1,8 @@
+# applet is loaded from the local ./test-applet.js file
+applets:
+  LoadBalancedFargateService:
+    type: @aws-cdk/aws-ecs:LoadBalancedFargateServiceApplet
+    properties:
+      image: 'amazon/amazon-ecs-sample'
+      cpu: "2048"
+      memoryMiB: "1024"

examples/cdk-examples-typescript/hello-cdk-ecs/index.ts

@@ -0,0 +1,37 @@
+import ec2 = require('@aws-cdk/aws-ec2');
+import { InstanceType } from '@aws-cdk/aws-ec2';
+import ecs = require('@aws-cdk/aws-ecs');
+import cdk = require('@aws-cdk/cdk');
+
+class BonjourECS extends cdk.Stack {
+  constructor(parent: cdk.App, name: string, props?: cdk.StackProps) {
+    super(parent, name, props);
+
+    // For better iteration speed, it might make sense to put this VPC into
+    // a separate stack and import it here. We then have two stacks to
+    // deploy, but VPC creation is slow so we'll only have to do that once
+    // and can iterate quickly on consuming stacks. Not doing that for now.
+    const vpc = new ec2.VpcNetwork(this, 'MyVpc', { maxAZs: 2 });
+    const cluster = new ecs.Cluster(this, 'Ec2Cluster', { vpc });
+    cluster.addDefaultAutoScalingGroupCapacity({
+      instanceType: new InstanceType("t2.xlarge"),
+      instanceCount: 3,
+    });
+
+    // Instantiate ECS Service with just cluster and image
+    const ecsService = new ecs.LoadBalancedEc2Service(this, "Ec2Service", {
+      cluster,
+      memoryLimitMiB: 512,
+      image: ecs.DockerHub.image("amazon/amazon-ecs-sample"),
+    });
+
+    // Output the DNS where you can access your service
+    new cdk.Output(this, 'LoadBalancerDNS', { value: ecsService.loadBalancer.dnsName });
+  }
+}
+
+const app = new cdk.App();
+
+new BonjourECS(app, 'Bonjour');
+
+app.run();

examples/cdk-examples-typescript/hello-cdk-fargate/index.ts

@@ -0,0 +1,29 @@
+import ec2 = require('@aws-cdk/aws-ec2');
+import ecs = require('@aws-cdk/aws-ecs');
+import cdk = require('@aws-cdk/cdk');
+
+class BonjourFargate extends cdk.Stack {
+  constructor(parent: cdk.App, name: string, props?: cdk.StackProps) {
+    super(parent, name, props);
+
+    // Create VPC and Fargate Cluster
+    // NOTE: Limit AZs to avoid reaching resource quotas
+    const vpc = new ec2.VpcNetwork(this, 'MyVpc', { maxAZs: 2 });
+    const cluster = new ecs.Cluster(this, 'Cluster', { vpc });
+
+    // Instantiate Fargate Service with just cluster and image
+    const fargateService = new ecs.LoadBalancedFargateService(this, "FargateService", {
+      cluster,
+      image: ecs.DockerHub.image("amazon/amazon-ecs-sample"),
+    });
+
+    // Output the DNS where you can access your service
+    new cdk.Output(this, 'LoadBalancerDNS', { value: fargateService.loadBalancer.dnsName });
+  }
+}
+
+const app = new cdk.App();
+
+new BonjourFargate(app, 'Bonjour');
+
+app.run();

examples/cdk-examples-typescript/package.json

@@ -28,7 +28,9 @@
     "@aws-cdk/aws-cognito": "^0.14.1",
     "@aws-cdk/aws-dynamodb": "^0.14.1",
     "@aws-cdk/aws-ec2": "^0.14.1",
+    "@aws-cdk/aws-ecs": "^0.14.1",
     "@aws-cdk/aws-elasticloadbalancing": "^0.14.1",
+    "@aws-cdk/aws-elasticloadbalancingv2": "^0.14.1",
     "@aws-cdk/aws-iam": "^0.14.1",
     "@aws-cdk/aws-lambda": "^0.14.1",
     "@aws-cdk/aws-neptune": "^0.14.1",

packages/@aws-cdk/assets/lib/asset.ts

@@ -124,7 +124,7 @@ export class Asset extends cdk.Construct {
     // for tooling to be able to package and upload a directory to the
     // s3 bucket and plug in the bucket name and key in the correct
     // parameters.
-    const asset: cxapi.AssetMetadataEntry = {
+    const asset: cxapi.FileAssetMetadataEntry = {
       path: this.assetPath,
       id: this.uniqueId,
       packaging: props.packaging,

packages/@aws-cdk/aws-applicationautoscaling/lib/base-scalable-attribute.ts

@@ -62,21 +62,21 @@ export abstract class BaseScalableAttribute extends cdk.Construct {
   /**
    * Scale out or in based on time
    */
-  protected scaleOnSchedule(id: string, props: ScalingSchedule) {
+  protected doScaleOnSchedule(id: string, props: ScalingSchedule) {
     this.target.scaleOnSchedule(id, props);
   }
 
   /**
    * Scale out or in based on a metric value
    */
-  protected scaleOnMetric(id: string, props: BasicStepScalingPolicyProps) {
+  protected doScaleOnMetric(id: string, props: BasicStepScalingPolicyProps) {
     this.target.scaleOnMetric(id, props);
   }
 
   /**
    * Scale out or in in order to keep a metric around a target value
    */
-  protected scaleToTrackMetric(id: string, props: BasicTargetTrackingScalingPolicyProps) {
+  protected doScaleToTrackMetric(id: string, props: BasicTargetTrackingScalingPolicyProps) {
     this.target.scaleToTrackMetric(id, props);
   }
 }

packages/@aws-cdk/aws-autoscaling/lib/auto-scaling-group.ts

@@ -183,7 +183,7 @@ export class AutoScalingGroup extends cdk.Construct implements cdk.ITaggable, el
       vpc: props.vpc,
       allowAllOutbound: props.allowAllOutbound !== false
     });
-    this.connections = new ec2.Connections({ securityGroup: this.securityGroup });
+    this.connections = new ec2.Connections({ securityGroups: [this.securityGroup] });
     this.securityGroups.push(this.securityGroup);
     this.tags = new TagManager(this, {initialTags: props.tags});
     this.tags.setTag(NAME_TAG, this.path, { overwrite: false });