Slide 1
Slide 1 text
cdk initͰੜ͞ΕΔ͋ͷϑΝΠϧୡԿͳͷ͔
ϏδωεςΫϊϩδʔ෦
2025/07/12 ࠤ౻ஐथ
Slide 2
Slide 2 text
2
ࣗݾհ
● 2020 Ϋϥεϝιουೖࣾ AWS CDK ར༻։࢝ɹ
● 2021 AWS DevDayͰCDKӡ༻ϊϋհ
● 2022 CDKࢧ෦্ཱͪ͛
● 2023 AWS CDK Conference Japan ։࠵
● 2024 AWS CDK Conference Japan ։࠵
● 2025
● AWS CDK Conference Japan ։࠵
● CDKͷຊॻ͍ͯΈͨ
● ෦ॺ
○ ϏδωεςΫϊϩδʔ෦
● ໊લʢχοΫωʔϜʣ
○ ࠤ౻ஐथ ʢtmk2154/tomoki10ʣ
Slide 3
Slide 3 text
એ݉લϑϦɿAWS CDKͷຊॻ͍ͯΈͨ 3
ٕज़ॻయ18ͰCDKͷຊॻ͍ͯΈ·ͨ͠ʂ
CDKࢧ෦ͷൃද͕٧·ͬͯ·͢ʂ͜Ε͔ΒCDK࢝ΊΔਓʂݟຊ͋ΔΑ
@tmk2154
https://techbookfest.org/product/wEWtvT8aRZgzAcVSnE7wS8
Slide 4
Slide 4 text
͜Μͳձͯ͠ͳ͍Ͱ͔͢ʁ 4
ઌഐ
ΤϯδχΞ
δϡχΞ
ΤϯδχΞ
ઌഐɺCDKͷνϡʔτϦΞϧΈͯcdk initͨ͠Β
ͳΜ͔ΊͬͪΌϑΝΠϧ࡞͞ΕͨΜͰ͚͢Ͳ
͜ΕͳΜͳΜ͔͢ʁ
͏ΘɺԿ͚ͩͬ͜Ε…ௐͨ͜ͱ͋Δ͚Ͳ
ΕͪΌͬͨɻԿ͚ͩͬͳ͋…
ͳΜ͔CDKΛྑ͍ײ͡ʹಈ͔ͨ͢ΊͷͭͩΑ
Slide 5
Slide 5 text
ࠓͷ 5
CDKͷຊͷதͰ͋͑ͯॻ͔ͳ͔ͬͨ
܅ͨͪԿऀͳͷʁ
→ ͜ͷࢿྉΛݟΕࢥ͍ग़ͤΔʢॳ/தڃऀʣ
→ ҙ֎ͱ༷૿͑ͯΔʂʢ্ڃऀʣ
IaCͷ࣮Λॻ͘ͱ͜ΖͶ
Slide 6
Slide 6 text
࣍
• ͦΕͧΕͷϑΝΠϧ/σΟϨΫτϦͷհ
• cdk.json
• package.json
• package-lock.json / node_modules
• jest.config.js
• tsconfig.json
• .gitignore/.npmignore
6
Slide 7
Slide 7 text
cdk.jsonͱ
CDKͷίϚϯυ࣮ߦ࣌ͷΤϯτϦʔϙΠϯτwatchɺcontextͳͲίϚϯ
࣮ߦ࣌ͷύϥϝʔλͳͲΛཧ͢ΔͨΊͷϑΝΠϧ
σϑΥϧτͰҎԼͷϓϩύςΟΛͭ
7
Slide 8
Slide 8 text
cdk.jsonͷappϓϩύςΟ
cdk synthcdk deployίϚϯυ࣮ߦ࣌ʹͲͷϑΝΠϧΛಡΈࠐΉͷ͔Λܾఆ͢Δ
ΤϯτϦʔϙΠϯτΛࢦఆ͢ΔϓϩύςΟ
• npx … ϩʔΧϧʹΠϯετʔϧ͞ΕͨύοέʔδΛ༻
ҎԼࣄલτϥϯεύΠϧΛෆཁʹ͠ɺख࡞ۀʹΑΔ࣌ؒతϩεΛ͙ͨΊઃఆ※
• ts-node … TypeScriptͷϑΝΠϧΛίϯύΠϧͤͣʹ࣮ߦ
• --prefer-ts-exts … ϞδϡʔϧͷΠϯϙʔτ࣌ʹɺJSΑΓTSϑΝΠϧΛ༏ઌ
8
※https://github.com/aws/aws-cdk/pull/11470
Slide 9
Slide 9 text
cdk.jsonͷwatchϓϩύςΟ
cdkίϚϯυͷwatchΦϓγϣϯΛ͏࣌ͷύϥϝʔλઃ
ఆ͕Մೳ
include … มߋݕ͢ΔϑΝΠϧ
exclude … มߋݕ͔Βআ֎͢ΔϑΝΠϧ
Watchͱಉ͡֊ͰbuildϓϩύςΟʹҙͷίϚϯυΛ
ઃఆ͢Δͱࣗಈ࣮ߦ͞ΕΔʢJavaͷϏϧυͳͲʣ
9
ࢀߟใɿhttps://aws.amazon.com/jp/blogs/news/increasing-development-speed-with-cdk-watch-jp/
Slide 10
Slide 10 text
cdk.jsonͷcontextϓϩύςΟ
جຊCDKΞϓϦʹ͢Λཧ͢ΔͨΊͷϓϩύςΟ
σϑΥϧτͰػೳϑϥά͕Έࠐ·Ε͍ͯΔɻύϥϝʔλมߋޡࣈमਖ਼ͳͲͰ
CDKࣗମͷ࣮͕มߋ͞ΕΔ͕ɺҎલͷόʔδϣϯͱͷޓੑΛอͭͨΊʹؚ·ΕΔ
10
ৄ͘͠ɿhttps://github.com/aws/aws-cdk/blob/main/packages/aws-cdk-lib/cx-api/FEATURE_FLAGS.md
Slide 11
Slide 11 text
cdk.jsonͷଞͷϓϩύςΟ
• build … Synthલʹ࣮ߦ͢ΔίϚϯυΛࢦఆʢྫɿLambdaʹೖΕΔJavaͷϏϧυʣ
• toolkitStackName … BootstrapͰ࡞͞ΕΔStack໊ͷมߋ
• toolkitBucket … BootstrapͰ࡞͞ΕΔόέοτͷઃఆʢbucketNameɺkmsKeyIdʣ
• versionReporting … CfnςϯϓϨʔτͷCDK࣮ߦόʔδϣϯͳͲͷهࡌͷON/OFF
• pathMetadata … CfnςϯϓϨʔτͷMetadataͷaws:cdk:pathͷهࡌͷON/OFF
• assetMetadata … CfnςϯϓϨʔτͷMetadataͷaws:asset:*ͷهࡌͷON/OFF
• notices … ίϚϯυ࣮ߦ࣌ͷ੬ऑੑɺϦάϨογϣϯͳͲͷ௨ͷON/OFF
• output … CfnςϯϓϨʔτͳͲͷग़ྗઌͷઃఆ
ͳͲͳͲ
11
ࢀߟɿhttps://github.com/aws/aws-cdk-cli/tree/main/packages/aws-cdk#json-configuration-files
ɹɹɹhttps://github.com/aws/aws-cdk-cli/blob/main/packages/aws-cdk/lib/cli/cli-config.ts
Slide 12
Slide 12 text
package.json
Node.js ϓϩδΣΫτͷઃఆϑΝΠϧ
• name … ϓϩδΣΫτ໊ʢ͢Δ߹༻ʣ
• version … ϓϩδΣΫτͷόʔδϣϯʢ͢Δ߹༻ʣ
• bin … ΞϓϦΛCLI͔Β࣮ߦ͢Δ߹༻ʢجຊෆཁʣ
• scripts … npm run **Ͱ࣮ߦͰ͖ΔεΫϦϓτͳͲΛઃఆ
• devDependency … ։ൃ͚ͩʹඞཁͳύοέʔδΛઃఆ
• dependency … ࣮ߦʹඞཁͳύοέʔδΛઃఆ
12
ࢀߟɿhttps://docs.npmjs.com/cli/v11/configuring-npm/package-json#bin
ɹɹɹhttps://dev.classmethod.jp/articles/remove-redundant-for-cdk-init/
…
Slide 13
Slide 13 text
package-lock.json/node_modules
package-lock.jsonͱ
package.jsonͰΠϯετʔϧ͢Δύοέʔδͱґଘ͢Δύο
έʔδͷπϦʔߏΛهड़͠ɺਖ਼֬ͳόʔδϣϯใΛอଘ͠
ෳϢʔβڥͰಉ͡ґଘؔΛอূ͢Δ
node_modulesͱ
package.jsonͰهࡌ͞ΕͨύοέʔδͳͲ͕Πϯετʔϧ͞
ΕΔσΟϨΫτϦ
13
ࢀߟɿhttps://docs.npmjs.com/cli/v11/configuring-npm/package-lock-json
ɹɹɹhttps://docs.npmjs.com/cli/v11/configuring-npm/folders
…
package-lock.json
Slide 14
Slide 14 text
jest.config.js
CDK͕σϑΥϧτͰ༻͢ΔςετϑϨʔϜϫʔΫͰ͋Δ
JestͷઃఆΛཧ͢ΔͨΊͷϑΝΠϧ
• module.exports … CommonJSܗࣜͷϞδϡʔϧΤΫεϙʔτߏจ
• testEnvironment … ςετ࣮ߦڥͷࢦఆɻNode.jsΛ༻
• roots …ςετରͱ͢ΔϑΝΠϧΛݕࡧ͢ΔσΟϨΫτϦΛࢦఆ
• testMatch … ࣮ߦ͢ΔςετϑΝΠϧͷύλʔϯ໊Λࢦఆ
• transform … ςετϑΝΠϧͷલॲཧΛࢦఆ
ɹɹɹɹɹɹɹ .ts/.tsxϑΝΠϧΛts-jestͰτϥϯεύΠϧޙʹ࣮ߦ
14
ࢀߟɿhttps://archive.jestjs.io/docs/ja/22.x/configuration
ESModuleͷมɿhttps://blog.serverworks.co.jp/2025/04/01/125304
…
Slide 15
Slide 15 text
tsconfig.json
TypeScriptίϯύΠϥͷઃఆ
ts-node/ts-jestͳͲͷπʔϧ͜ͷઃఆΛࢀর
15
ࢀߟɿhttps://www.typescriptlang.org/tsconfig/
ɹɹɹhttps://zenn.dev/uhyo/articles/blueberry-book-catchup
…
• compilerOptions … ίϯύΠϧઃఆͷࢦఆ
• target … ͲͷόʔδϣϯͷJavaScript͚ʹ͢Δ͔τϥϯεύΠϧ͢Δ͔ࢦఆ
ྫɿES2022 ͩͱɺ ECMAScript 2022 ͷߏจͰग़ྗ
• module … ϞδϡʔϧγεςϜͷࢦఆ
ɹɹɹɹɹɹྫɿNodeNext ͩͱɺESModule αϙʔτʹ४ڌͨ͠ϞδϡʔϧγεςϜΛ༻
• moduleResolution … import ͷղܾํ๏ͷࢦఆɻNode.js ४ڌͷํࣜͳͲ
• lib … Ͳͷඪ४ϥΠϒϥϦʢྫɿDOM, ES2022 ͳͲʣͷܕఆٛΛར༻Մೳʹ͢Δ͔Λࢦఆ
• declaration … *.d.tsܕఆٛϑΝΠϧΛੜ
• strict … ݫ֨ͳܕνΣοΫΦϓγϣϯΛ༗ޮԽ ͳͲͳͲ
Slide 16
Slide 16 text
.gitignore/.npmignore
.gitignoreͱ
Gitʹίϛοτ͠ͳ͍ϑΝΠϧΛઃఆ
16
…
.npmignoreͱ
npm publish͢Δ࣌ʹؚΊͳ͍ϑΝΠϧΛઃఆ
ʢجຊϓϩδΣΫτͰͷ։ൃʹෆཁʣ
Slide 17
Slide 17 text
͜Ε͔Β͜Ε 17
ઌഐ
ΤϯδχΞ
δϡχΞ
ΤϯδχΞ
ઌഐɺCDKͷνϡʔτϦΞϧΈͯcdk initͨ͠Β
ͳΜ͔ΊͬͪΌϑΝΠϧ࡞͞ΕͨΜͰ͚͢Ͳ
͜ΕͳΜͳΜ͔͢ʁ
ͳΜ͔ͦΜͳࢿྉ͋ͬͨͳ
͜ͷࢿྉݟͳ͕Β֬ೝͯ͠ΈΑ͏͔ʂ
Slide 18
Slide 18 text
ࢀߟ
݁ߏ͍Βͳ͍ϑΝΠϧهड़͋ΔͷͰɺ͜ͷࢿྉҰॹʹݟͯফͦ͏ʂ
18
…
https://dev.classmethod.jp/articles/remove-redundant-for-cdk-init/