feat: deploy-time build for SOCI indices (#7)

* feat: deploy-time build for SOCI indices

* Update README.md

.projenrc.js

@@ -22,7 +22,7 @@ const project = new awscdk.AwsCdkConstructLibrary({
 });
 // Bundle custom resource handler Lambda code
 project.projectBuild.compileTask.prependExec('npm ci && npm run build', {
-  cwd: 'lambda/nodejs-build',
+  cwd: 'lambda/trigger-codebuild',
 });
 // Run integ-test
 project.projectBuild.testTask.exec('yarn tsc -p tsconfig.dev.json && yarn integ-runner');

README.md

@@ -9,8 +9,8 @@ Install from npm:
 ```sh
 npm i deploy-time-build
 ```
-
-Then write CDK code as below:
+### Build Node.js apps
+Use the following code to build Node.js apps like React frontend:
 
 ```ts
 import { NodejsBuild } from 'deploy-time-build';
@@ -70,6 +70,22 @@ You can also override the path where assets are extracted by `extractPath` prope
 
 Please also check [the example directory](./example/) for a complete example. 
 
+### Build SOCI index for a container image
+[Seekable OCI (SOCI)](https://docs.aws.amazon.com/AmazonECS/latest/userguide/container-considerations.html) is a way to help start tasks faster for Amazon ECS tasks on Fargate 1.4.0. You can build and push a SOCI index to use the feature by the following CDK code:
+
+```ts
+import { SociIndexBuild } from 'deploy-time-build;
+
+const asset = new DockerImageAsset(this, 'Image', { directory: 'example-image' });
+new SociIndexBuild(this, 'Index', { imageTag: asset.assetHash, repository: asset.repository });
+// or using a utility method
+SociIndexBuild.fromImageAsset(this, 'Index', asset);
+
+// Use the asset for ECS Fargate tasks
+import { AssetImage } from 'aws-cdk-lib/aws-ecs';
+const assetImage = AssetImage.fromDockerImageAsset(asset);
+```
+
 ## Motivation - why do we need this construct?
 Previously, there are a few different ways to deploy frontend applications from CDK (1 and 2 below). But none is perfect with different pros and cons. This construct adds another option to deploy frontend apps.
 

example/example-image/Dockerfile

@@ -0,0 +1,5 @@
+FROM nginx:1.25.1
+# create dummy file to change the size of a image
+ARG DUMMY_FILE_SIZE_MB="10"
+# RUN fallocate -l ${DUMMY_FILE_SIZE_MB} dummy.img
+RUN dd if=/dev/zero of=dummy.img bs=1M count=${DUMMY_FILE_SIZE_MB}

example/index.ts

@@ -1,11 +1,12 @@
 import { Stack, StackProps, App, RemovalPolicy, CfnOutput } from 'aws-cdk-lib';
 import { Construct } from 'constructs';
 import { MockIntegration, RestApi } from 'aws-cdk-lib/aws-apigateway';
-import { NodejsBuild } from '../src/nodejs-build';
+import { NodejsBuild, SociIndexBuild } from '../src/';
 import { BlockPublicAccess, Bucket, BucketEncryption } from 'aws-cdk-lib/aws-s3';
 import { OriginAccessIdentity, CloudFrontWebDistribution } from 'aws-cdk-lib/aws-cloudfront';
+import { DockerImageAsset } from 'aws-cdk-lib/aws-ecr-assets';
 
-class TestStack extends Stack {
+class NodejsTestStack extends Stack {
   constructor(scope: Construct, id: string, props: StackProps = {}) {
     super(scope, id, props);
 
@@ -74,11 +75,22 @@ class TestStack extends Stack {
   }
 }
 
+class SociIndexTestStack extends Stack {
+  constructor(scope: Construct, id: string, props: StackProps = {}) {
+    super(scope, id, props);
+
+    const asset = new DockerImageAsset(this, 'Image', { directory: 'example-image' });
+
+    new SociIndexBuild(this, 'Index', { imageTag: asset.assetHash, repository: asset.repository });
+  }
+}
+
 class TestApp extends App {
   constructor() {
     super();
 
-    new TestStack(this, 'TestStack');
+    new NodejsTestStack(this, 'NodejsTestStack');
+    new SociIndexTestStack(this, 'SociIndexTestStack');
   }
 }