CINXE.COM

<!DOCTYPE html><html lang="ja" data-scope-path="layouts/application"><head prefix="og: http://ogp.me/ns# article: http://ogp.me/ns/article#"><link crossorigin="" href="https://www.google-analytics.com/analytics.js" rel="preconnect" /><link rel="preload" href="/fonts/noto-sans-jp-v24-japanese-regular.woff2" as="font" type="font/woff2" crossorigin="anonymous"><link rel="preload" href="/fonts/noto-sans-jp-v24-japanese-700.woff2" as="font" type="font/woff2" crossorigin="anonymous"> <script async src="https://www.googletagmanager.com/gtag/js?id=UA-25666851-3"></script> <script> window.dataLayer = window.dataLayer || []; function gtag(){dataLayer.push(arguments);} gtag('js', new Date()); gtag('config', 'UA-25666851-3'); </script> <link rel="stylesheet" media="all" href="/assets/ress-d1ba3a251927ab1f2bcc841c9a810109355bcb4260a522a0f76452fdc2fe6095.css" /><link rel="stylesheet" media="all" href="/assets/scopes/layouts/application-dda4ec688c139c8f29c39a2a795bcf4af04c4326643549a37f5d8843fffaebab.css" /><link rel="stylesheet" media="all" href="/assets/scopes/articles/show-37905516c06229c8fde10714e660fc48bc7b6ce7881755707db8b0327ceb5bf1.css" /><link rel="stylesheet" media="all" href="/assets/scopes/partials/_viewer-3a78a10250bb498047a06b71271b62ea949e304d25b9781c4450cf998aa2640c.css" /><link rel="stylesheet" media="all" href="/assets/scopes/layouts/_header-db87b54171cc020758ab7d1494677f8f6c2e9c93b453e896af82e4814eaacc7c.css" /><link rel="stylesheet" media="all" href="/assets/scopes/layouts/_breadcrumbs-744a099ab0b9eb5c4bd45215617e267c7d7c404ddddce8810eead5335512e637.css" /><link rel="stylesheet" media="all" href="/assets/scopes/layouts/_footer-a06961717440c6d0183c582c7f21768011f334d368f51b614eabc87bb17b3bbf.css" /><script src="/packs/application-02365dbc4dc28919eee1.js" defer="defer"></script><link href="/icon.png" rel="icon" type="image/png" /><link href="/apple-touch-icon.png" rel="apple-touch-icon" type="image/png" /><link href="/feed" rel="alternate" title="RSS2.0" type="application/rss+xml" /><title>AWS CDK で TypeScript Lambda をいい感じに管理するサンプルコード集 | Basicinc Enjoy Hacking!</title><meta name="csrf-param" content="authenticity_token" /> <meta name="csrf-token" content="23F4eQ4B+txlSsTnycZigkaSKuOI3keSVxrIWPCrvsLB7HNVRXlJ8d33KY91/8dcCVnATYjLVGnGyqoe4pJMMw==" /><meta content="width=device-width,initial-scale=1" name="viewport" /><meta content="AWS CDK で TypeScript Lambda をいい感じに管理するサンプルコード集 | Basicinc Enjoy Hacking!" property="og:title" /><meta content="article" property="og:type" /><meta content="2020-07-09T10:06:13+09:00" property="article:published_time" /><meta content="zaru" property="article:author" /><meta content="Technology" property="article:section" /><meta content="https://tech.basicinc.jp/articles/213" property="og:url" /><meta content="https://tech.basicinc.jp/assets/default_eyecatch-9e0d94e7defd5e124532d0b790a8f8cccfdffa0aed4581afa5f932cfec0b39a2.png" property="og:image" /><meta content="image/png" property="og:image:type" /><meta content="1200" property="og:image:width" /><meta content="630" property="og:image:height" /><meta content="弊社で AWS CDK を使って TypeScript Lambda 管理の運用が始まりました。運用に乗せるまでに試行錯誤して作った Lambda 管理サンプルコードをまとめておきます。とりあえず TypeScript な Lambda Lambda 自体を TypeSc..." property="og:description" /><meta content="ja_JP" property="og:locale" /><meta content="summary" name="twitter:card" /><meta content="@zaru" name="twitter:creator" /></head><body><header data-scope-path="layouts/_header"><div class="header-contents"><a class="root-link" href="/"><svg class="site-logo"><use xlink:href="/assets/icons-5bbe775037b55281ef0bc50d30a51f69c7c3914d399c7107e37f0702d98ae8a2.svg#logo"></use></svg><div class="site-title">Enjoy Hacking!</div></a><div class="site-desc">Basicinc エンジニアブログ</div></div></header><nav data-scope-path="layouts/_breadcrumbs"><ul class="breadcrumbs" itemscope="itemscope" itemtype="https://schema.org/BreadcrumbList">% cat <li itemprop="itemListElement" itemscope="itemscope" itemtype="https://schema.org/ListItem"><a itemprop="item" href="/">~</a><meta itemprop="position" content="1" /></li>/<li class="current" itemprop="itemListElement" itemscope="itemscope" itemtype="https://schema.org/ListItem">AWSCDKでTypeScriptLambdaをいい感じに管理するサンプルコード集.md<meta itemprop="item" content="https://tech.basicinc.jp/articles/213" /><meta itemprop="position" content="2" /></li></ul></nav><div data-scope-path="articles/show"><article class="article"><h1 class="article-title">AWS CDK で TypeScript Lambda をいい感じに管理するサンプルコード集</h1><div class="article-desc"><a class="article-author" href="/authors/1"><img class="article-author-avatar" src="https://tech.basicinc.jp/uploads/e868e5fb1e34b970ae7d8e04c454ff28.png" />zaru</a><div class="article-date-info"><time class="article-posted-date">Posted 2020-07-09</time></div></div><div class="article-body"><div data-scope-path="partials/_viewer">弊社で AWS CDK を使って TypeScript Lambda 管理の運用が始まりました。運用に乗せるまでに試行錯誤して作った Lambda 管理サンプルコードをまとめておきます。 <h2>とりあえず TypeScript な Lambda</h2> Lambda 自体を TypeScript で書きたいので <code>@aws-cdk/aws-lambda-nodejs</code> パッケージの <code>NodejsFunction</code> を使って Lambda を定義しています。これの便利なところはビルド含めて全部勝手にやってくれるところです。普通の JavaScript であれば <code>@aws-cdk/aws-lambda</code> パッケージの <code>Function</code> で同じように書くことができます。 <pre lang="typescript" class="highlight highlight-typescript">import * as core from '@aws-cdk/core'; import {NodejsFunction} from '@aws-cdk/aws-lambda-nodejs'; import {RemovalPolicy} from '@aws-cdk/core'; import {LogRetention} from '@aws-cdk/aws-lambda'; import {RetentionDays} from '@aws-cdk/aws-logs'; export class SimpleLambdaStack extends core.Stack { constructor(scope: core.App, id: string, props?: core.StackProps) { super(scope, id, props); const fn = new NodejsFunction(this, 'SimpleLambda', { entry: 'lambda/simple-lambda/index.ts', currentVersionOptions: { removalPolicy: RemovalPolicy.RETAIN, }, memorySize: 256, timeout: core.Duration.seconds(180), environment: { 'TZ': 'Asia/Tokyo', }, }); // CloudWatch Logs の保持期間を指定（デフォルトだと無期限） new LogRetention(this, 'SaveSessionLogRetention', { logGroupName: `/aws/lambda/${fn.functionName}`, retention: RetentionDays.ONE_WEEK, }); } } </pre> <code>currentVersionOptions</code> は Lambda のバージョンを残す設定です。常に LATEST だけで良いのであれば指定しなくて良いです。その他にメモリやタイムアウトなど Lambda のオプションは全て指定できます。 1つ注意点としてはデフォルトで作成される CloudWatch Logs の保持期間は無期限になっています。ログが大量に出力される場合はコストが厳しくなるので要件に合わせて期間指定をした方が良いです。 <h2>npm パッケージを含めた Lambda</h2> これは普通に Lambda のコードの中で <code>import </code> すれば自動でやってくれます。 <pre><code>npm install uuid </code></pre> <pre lang="typescript" class="highlight highlight-typescript">import {v4 as uuidv4} from 'uuid'; export async function handler() { console.log(uuidv4()); } </pre> <h2>既存のリソースに接続する Lambda</h2> この例はすでに作ってある Kinesis Data Stream をトリガーとする Lambda の例です。 AWS CDK では既存リソースの取得メソッドは <code>fromXXX</code> と from で始まるようになっているので、欲しいリソースパッケージのリファレンスを見ると大抵見つかります。リソースによって arn 指定するものもあれば他の識別子になっていることもあります。見つからない場合は AWS CDK GitHub リポジトリの Issue を検索すると、大体要望が上がっているので、それをウオッチするといいでしょう。 <pre lang="typescript" class="highlight highlight-typescript">import * as core from '@aws-cdk/core'; import {NodejsFunction} from '@aws-cdk/aws-lambda-nodejs'; import {RemovalPolicy} from '@aws-cdk/core'; import * as lambda from '@aws-cdk/aws-lambda'; import * as iam from '@aws-cdk/aws-iam'; export class ExistsResourceLambdaStack extends core.Stack { constructor(scope: core.App, id: string, props?: core.StackProps) { super(scope, id, props); const fn = new NodejsFunction(this, 'ExistsResourceLambda', { entry: 'lambda/exists-resource-lambda/index.ts', currentVersionOptions: { removalPolicy: RemovalPolicy.RETAIN, }, }); // Kinesis をトリガーにするために Lambda ポリシーを調整 fn.addToRolePolicy(new iam.PolicyStatement({ resources: [ 'arn:aws:kinesis:ap-northeast-1:11111111:stream/sample', ], actions: [ 'kinesis:DescribeStream', 'kinesis:DescribeStreamSummary', 'kinesis:GetRecords', 'kinesis:GetShardIterator', 'kinesis:ListShards', 'kinesis:ListStreams', 'kinesis:SubscribeToShard', ]} )); const kinesis = 'arn:aws:kinesis:ap-northeast-1:11111111:stream/sample'; fn.addEventSourceMapping('KinesisDataTrigger', { eventSourceArn: kinesis, batchSize: 10, startingPosition: lambda.StartingPosition.LATEST, }); } } </pre> <code>addToRolePolicy</code> で Lambda に Kinesis にアクセスできる権限を追加します。そして <code>addEventSourceMapping</code> で指定リソースをイベントソースに設定します。 <h2>Lambda のエイリアスとバージョンを設定</h2> 一つの Lambda を開発やステージングとプロダクションなど複数の環境で使い分けるためにエイリアスを使いたくなる時があります。エイリアスを使うと各環境ごとの切り替えコストが低いのでオススメです。 余談ですが、エイリアス単位で環境変数を持つことはできないので、そこは Lambda 関数内で自身のエリアスを取得して設定を切り替える必要があるところが面倒くさいです…。 <pre lang="typescript" class="highlight highlight-typescript">import * as core from '@aws-cdk/core'; import {NodejsFunction} from '@aws-cdk/aws-lambda-nodejs'; import {RemovalPolicy} from '@aws-cdk/core'; import * as lambda from '@aws-cdk/aws-lambda'; export class AliasWithVersionLambdaStack extends core.Stack { constructor(scope: core.App, id: string, props?: core.StackProps) { super(scope, id, props); const fn = new NodejsFunction(this, 'AliasWithVersionLambdaStack', { entry: 'lambda/alias-with-version-lambda/index.ts', currentVersionOptions: { removalPolicy: RemovalPolicy.RETAIN, }, }); // 最新バージョンを取得 const currentVersion = fn.currentVersion; // development エイリアスは最新バージョンを指定 const development = new lambda.Alias(this, 'DevelopmentAlias', { aliasName: 'development', version: currentVersion, }); // production エイリアスはバージョン1を指定 // バージョンを切り替えたい場合はここを修正してデプロイする const prodVersion = lambda.Version.fromVersionArn(this, 'ProductionVersion', `${fn.functionArn}:1`); prodVersion.addAlias('production'); // もし production エイリアスに特定のリソーストリガーを設定したい場合はこちら // const prodAlias = lambda.Alias.fromAliasAttributes(this, 'ProductionAlias', { // aliasName: 'production', // aliasVersion: prodVersion // }); // prodAlias.addEventSourceMapping('ProductionKinesisDataTrigger', { // eventSourceArn: 'arn:aws:kinesis:ap-northeast-1:11111111:stream/sample-prod', // batchSize: 10, // startingPosition: lambda.StartingPosition.LATEST // }) const stgVersion = lambda.Version.fromVersionArn(this, 'StagingVersion', `${fn.functionArn}:2`); stgVersion.addAlias('staging'); } } </pre> <h2>Lambda@Edge をデプロイ</h2> Lambda@Edge もいい感じにデプロイができます。この例だと新しく CloudFront と Origin の S3 を新しく作り、そこに Lambda を ORIGIN_REQUEST として設定をしています。S3 や ACM は既存のリソースが使えますが、CloudFront は現時点ではまだ使えません。必ず新規作成になります。 <pre lang="typescript" class="highlight highlight-typescript">import * as core from '@aws-cdk/core'; import {Bucket} from '@aws-cdk/aws-s3'; import * as cloudfront from '@aws-cdk/aws-cloudfront'; import * as certificatemanager from '@aws-cdk/aws-certificatemanager'; import {NodejsFunction} from '@aws-cdk/aws-lambda-nodejs'; import {RemovalPolicy} from '@aws-cdk/core'; import * as lambda from '@aws-cdk/aws-lambda'; import * as iam from '@aws-cdk/aws-iam'; export class CloudfrontLambdaEdgeStack extends core.Stack { constructor(scope: core.App, id: string, props?: core.StackProps) { super(scope, id, props); const fn = new NodejsFunction(this, 'LambdaEdge', { entry: 'lambda/cloudfront-lambda-edge/index.ts', currentVersionOptions: { removalPolicy: RemovalPolicy.RETAIN, }, role: new iam.Role(this, 'AllowLambdaServiceToAssumeRole', { assumedBy: new iam.CompositePrincipal( new iam.ServicePrincipal('lambda.amazonaws.com'), new iam.ServicePrincipal('edgelambda.amazonaws.com'), ), }), }); const fnVersion = new lambda.Version(this, 'LambdaEdgeVersion', { lambda: fn, }); const sourceBucket = new Bucket(this, 'ZaruCDKBucket'); // 既存の S3 バケットを利用したい場合はこちら // const arn = 'arn:aws:s3:::...'; // const sourceBucket = Bucket.fromBucketArn(this, 'ExistsBucket', arn); // ACM の承認は手動になるため、メールチェックして approve しないとデプロイ進行しない const certificate = new certificatemanager.Certificate(this, 'Certificate', { domainName: 'cdk.sunaba.sh', subjectAlternativeNames: ['cdk.sunaba.sh'], }); // 既存の ACM を利用したい場合はこちら // const arn = 'arn:aws:...'; // const certificate = Certificate.fromCertificateArn(this, 'Certificate', arn); const distribution = new cloudfront.CloudFrontWebDistribution(this, 'ZaruCDKDistribution', { originConfigs: [ { s3OriginSource: { s3BucketSource: sourceBucket, }, behaviors: [{ isDefaultBehavior: true, lambdaFunctionAssociations: [ { eventType: cloudfront.LambdaEdgeEventType.ORIGIN_REQUEST, lambdaFunction: fnVersion, }, ], }], }, ], viewerCertificate: cloudfront.ViewerCertificate.fromAcmCertificate( certificate, { aliases: ['cdk.example.com'], securityPolicy: cloudfront.SecurityPolicyProtocol.TLS_V1, sslMethod: cloudfront.SSLMethod.SNI, }, ), }); } } </pre> こんな感じで AWS CDK で Lambda を管理するサンプルコード集でした。また運用していく中で使えるものがあれば反映していきます。</div></div><div class="article-sns-share-buttons"><a rel="nofollow" target="_blank" class="pocket-share sns-share-button" href="http://getpocket.com/edit?title=AWS+CDK+%E3%81%A7+TypeScript+Lambda+%E3%82%92%E3%81%84%E3%81%84%E6%84%9F%E3%81%98%E3%81%AB%E7%AE%A1%E7%90%86%E3%81%99%E3%82%8B%E3%82%B5%E3%83%B3%E3%83%97%E3%83%AB%E3%82%B3%E3%83%BC%E3%83%89%E9%9B%86+by+zaru+%7C+Basicinc+Enjoy+Hacking%21&url=https%3A%2F%2Ftech.basicinc.jp%2Farticles%2F213"><svg class="sns-icon pocket-icon"><use xlink:href="/assets/icons-5bbe775037b55281ef0bc50d30a51f69c7c3914d399c7107e37f0702d98ae8a2.svg#pocket"></use></svg></a><a rel="nofollow" target="_blank" class="hatena-share sns-share-button" href="http://b.hatena.ne.jp/add?mode=confirm&title=AWS+CDK+%E3%81%A7+TypeScript+Lambda+%E3%82%92%E3%81%84%E3%81%84%E6%84%9F%E3%81%98%E3%81%AB%E7%AE%A1%E7%90%86%E3%81%99%E3%82%8B%E3%82%B5%E3%83%B3%E3%83%97%E3%83%AB%E3%82%B3%E3%83%BC%E3%83%89%E9%9B%86+by+zaru+%7C+Basicinc+Enjoy+Hacking%21&url=https%3A%2F%2Ftech.basicinc.jp%2Farticles%2F213"><svg class="sns-icon hatena-icon"><use xlink:href="/assets/icons-5bbe775037b55281ef0bc50d30a51f69c7c3914d399c7107e37f0702d98ae8a2.svg#hatena"></use></svg></a><a rel="nofollow" target="_blank" class="twitter-share sns-share-button" href="https://twitter.com/share?text=AWS+CDK+%E3%81%A7+TypeScript+Lambda+%E3%82%92%E3%81%84%E3%81%84%E6%84%9F%E3%81%98%E3%81%AB%E7%AE%A1%E7%90%86%E3%81%99%E3%82%8B%E3%82%B5%E3%83%B3%E3%83%97%E3%83%AB%E3%82%B3%E3%83%BC%E3%83%89%E9%9B%86+by+zaru+%7C+Basicinc+Enjoy+Hacking%21&url=https%3A%2F%2Ftech.basicinc.jp%2Farticles%2F213"><svg class="sns-icon twitter-icon"><use xlink:href="/assets/icons-5bbe775037b55281ef0bc50d30a51f69c7c3914d399c7107e37f0702d98ae8a2.svg#twitter"></use></svg></a><a rel="nofollow" target="_blank" class="facebook-share sns-share-button" href="http://www.facebook.com/share.php?u=https%3A%2F%2Ftech.basicinc.jp%2Farticles%2F213"><svg class="sns-icon facebook-icon"><use xlink:href="/assets/icons-5bbe775037b55281ef0bc50d30a51f69c7c3914d399c7107e37f0702d98ae8a2.svg#facebook"></use></svg></a></div></article></div><footer data-scope-path="layouts/_footer"><div class="footer-contents"><a class="root-link" href="/"><svg class="site-logo"><use xlink:href="/assets/icons-5bbe775037b55281ef0bc50d30a51f69c7c3914d399c7107e37f0702d98ae8a2.svg#logo"></use></svg><div class="site-title">Enjoy Hacking!</div></a><ul class="link-list"><li class="link-list-item"><a class="link" href="https://basicinc.jp/" rel="noopener" target="_blank">株式会社ベーシック</a></li><li class="link-list-item"><a class="link" href="https://basicinc.jp/enjoy-hacking" rel="noopener" target="_blank">エンジニア募集</a></li><li class="link-list-item"><a class="link" href="https://qiita.com/organizations/basicinc" rel="noopener" target="_blank">Qiita</a></li><li class="link-list-item"><a class="link" href="https://www.wantedly.com/companies/basicinc/projects" rel="noopener" target="_blank">Wantedly</a></li></ul></div></footer></body></html>