feat(cloud9): support AWS CodeCommit repository clone on launch

packages/@aws-cdk/aws-cloud9/README.md

@@ -49,3 +49,17 @@ const c9env = new cloud9.Ec2Environment(this, 'Cloud9Env3', {
 new cdk.CfnOutput(this, 'URL', { value: c9env.ideUrl });
 ```
 
+Specify `repositories` to clone AWS Codecommit repositories into the environment
+
+```ts
+new cloud9.Ec2Environment(stack, 'C9Env', {
+  vpc,
+  repositories: [
+    {
+      repository: codecommit.Repository.fromRepositoryName(stack, 'Repo', 'foo'),
+      path: '/foo',
+    },
+  ],
+});
+
+```

packages/@aws-cdk/aws-cloud9/lib/environment.ts

@@ -1,3 +1,4 @@
+import * as codecommit from '@aws-cdk/aws-codecommit';
 import * as ec2 from '@aws-cdk/aws-ec2';
 import * as cdk from '@aws-cdk/core';
 import { CfnEnvironmentEC2 } from '../lib/cloud9.generated';
@@ -61,6 +62,29 @@ export interface Ec2EnvironmentProps {
    * @default - no description
    */
   readonly description?: string;
+
+  /**
+   * The AWS CodeCommit repository to be cloned
+   *
+   * @default - do not clone any repository
+   */
+  readonly repositories?: IRepository[];
+}
+
+/**
+ * The interface of the codecommit repository for Cloud9 environment
+ */
+export interface IRepository {
+  /**
+   * AWS CodeCommit repository
+   */
+  readonly repository: codecommit.IRepository,
+  /**
+   * The path within the development environment's default file system location to clone the AWS CodeCommit
+   * repository into. For example, `/REPOSITORY_NAME` would clone the repository into the
+   * `/home/USER_NAME/environment/REPOSITORY_NAME` directory in the environment.
+   */
+  readonly path: string;
 }
 
 /**
@@ -125,7 +149,11 @@ export class Ec2Environment extends cdk.Resource implements IEc2Environment {
       name: props.ec2EnvironmentName,
       description: props.description,
       instanceType: props.instanceType?.toString() ?? ec2.InstanceType.of(ec2.InstanceClass.BURSTABLE2, ec2.InstanceSize.MICRO).toString(),
-      subnetId: this.vpc.selectSubnets(vpcSubnets).subnetIds[0] ,
+      subnetId: this.vpc.selectSubnets(vpcSubnets).subnetIds[0],
+      repositories: props.repositories ? props.repositories.map(r => ({
+        repositoryUrl: r.repository.repositoryCloneUrlHttp,
+        pathComponent: r.path,
+      })) : undefined,
     });
     this.environmentId = c9env.ref;
     this.ec2EnvironmentArn = c9env.getAtt('Arn').toString();

packages/@aws-cdk/aws-cloud9/package.json

@@ -72,12 +72,14 @@
   "dependencies": {
     "@aws-cdk/core": "0.0.0",
     "@aws-cdk/aws-ec2": "0.0.0",
+    "@aws-cdk/aws-codecommit": "0.0.0",
     "constructs": "^3.0.2"
   },
   "homepage": "https://github.com/aws/aws-cdk",
   "peerDependencies": {
     "@aws-cdk/core": "0.0.0",
     "@aws-cdk/aws-ec2": "0.0.0",
+    "@aws-cdk/aws-codecommit": "0.0.0",
     "constructs": "^3.0.2"
   },
   "engines": {
@@ -95,4 +97,4 @@
   "awscdkio": {
     "announce": false
   }
-}
+}

packages/@aws-cdk/aws-cloud9/test/cloud9.environment.test.ts

@@ -1,4 +1,5 @@
 import { expect as expectCDK, haveResource } from '@aws-cdk/assert';
+import * as codecommit from '@aws-cdk/aws-codecommit';
 import * as ec2 from '@aws-cdk/aws-ec2';
 import * as cdk from '@aws-cdk/core';
 import * as cloud9 from '../lib';
@@ -66,4 +67,45 @@ test('throw error when subnetSelection not specified and the provided VPC has no
       instanceType: ec2.InstanceType.of(ec2.InstanceClass.C5, ec2.InstanceSize.LARGE),
     });
   }).toThrow(/no subnetSelection specified and no public subnet found in the vpc, please specify subnetSelection/);
+});
+
+test('imoprt codecommit repo', () => {
+  // WHEN
+  new cloud9.Ec2Environment(stack, 'C9Env', {
+    vpc,
+    repositories: [
+      {
+        repository: codecommit.Repository.fromRepositoryName(stack, 'Repo', 'foo'),
+        path: '/foo',
+      },
+    ],
+  });
+  // THEN
+  expectCDK(stack).to(haveResource('AWS::Cloud9::EnvironmentEC2', {
+    InstanceType: 't2.micro',
+    Repositories: [
+      {
+        PathComponent: '/foo',
+        RepositoryUrl: {
+          'Fn::Join': [
+            '',
+            [
+              'https://git-codecommit.',
+              {
+                Ref: 'AWS::Region',
+              },
+              '.',
+              {
+                Ref: 'AWS::URLSuffix',
+              },
+              '/v1/repos/foo',
+            ],
+          ],
+        },
+      },
+    ],
+    SubnetId: {
+      Ref: 'VPCPublicSubnet1SubnetB4246D30',
+    },
+  }));
 });