Upgrade to Pro
— share decks privately, control downloads, hide ads and more …
Speaker Deck
Features
Speaker Deck
PRO
Sign in
Sign up for free
Search
Search
初心者でもできる! AWS CDKへのコントリビュート
Search
bun
July 24, 2023
Technology
0
1.2k
初心者でもできる! AWS CDKへのコントリビュート
DevelopersIO 2023 福岡 にて登壇させていただいた時の資料となります。
bun
July 24, 2023
Tweet
Share
More Decks by bun
See All by bun
はじめてのSDET / My first challenge as a SDET
bun913
1
380
とあるOSSを継続可能にするための取り組みについて / OSS Refactoring Process
bun913
2
510
そのbeforeEach本当に必要? TIPSをご紹介 / beforeEach TIPS
bun913
1
1k
あなたはどっち派?XSpec系テストフレームワークの構造化流派について / XSpec Title Naming
bun913
1
660
良いユニットテストの性質を整理してたら考えるべき設計も見えてきたの
bun913
11
6.9k
GitHub Copilotと快適なユニットテストコード作成生活
bun913
10
7.9k
気が付いたらJSTQB AL TAに合格していた。そんな旅がしたいの。
bun913
2
920
ユーザーストーリーのレビューを自動化したみたの
bun913
1
1k
「XX試験の環境作ってよ」と言われた時によく使うAWSのソリューションについて
bun913
0
360
Other Decks in Technology
See All in Technology
Amazon Bedrockで実現する 新たな学習体験
kzkmaeda
1
140
比起獨自升級 我更喜歡 DevOps 文化 <3
line_developers_tw
PRO
0
950
doda開発 生成AI元年宣言!自家製AIエージェントから始める生産性改革 / doda Development Declaration of the First Year of Generated AI! Productivity Reforms Starting with Home-grown AI Agents
techtekt
0
180
Copilot Agentを普段使いしてわかった、バックエンド開発で使えるTips
ykagano
1
1.4k
新卒3年目の後悔〜機械学習モデルジョブの運用を頑張った話〜
kameitomohiro
0
350
DenoとJSRで実現する最速MCPサーバー開発記 / Building MCP Servers at Lightning Speed with Deno and JSR
yamanoku
1
210
白金鉱業Meetup_Vol.19_PoCはデモで語れ!顧客の本音とインサイトを引き出すソリューション構築
brainpadpr
2
450
IIWレポートからみるID業界で話題のMCP
fujie
0
620
Кто отправит outbox? Валентин Удальцов, автор канала Пых
lamodatech
0
210
"SaaS is Dead" は本当か!? 生成AI時代の医療 Vertical SaaS のリアル
kakehashi
PRO
3
270
ハノーバーメッセ2025座談会.pdf
iotcomjpadmin
0
130
AIエージェントの継続的改善のためオブザーバビリティ
pharma_x_tech
6
1.3k
Featured
See All Featured
[RailsConf 2023 Opening Keynote] The Magic of Rails
eileencodes
29
9.5k
The Cost Of JavaScript in 2023
addyosmani
50
8.4k
Fight the Zombie Pattern Library - RWD Summit 2016
marcelosomers
233
17k
Statistics for Hackers
jakevdp
799
220k
Distributed Sagas: A Protocol for Coordinating Microservices
caitiem20
331
22k
Music & Morning Musume
bryan
46
6.6k
Raft: Consensus for Rubyists
vanstee
140
7k
How to Create Impact in a Changing Tech Landscape [PerfNow 2023]
tammyeverts
52
2.8k
YesSQL, Process and Tooling at Scale
rocio
172
14k
Sharpening the Axe: The Primacy of Toolmaking
bcantrill
43
2.4k
What's in a price? How to price your products and services
michaelherold
245
12k
Code Review Best Practice
trishagee
68
18k
Transcript
初心者でもできる! AWS CDKへのコントリビュート 2023/7/24 AWS事業本部 モダンアプリケーションコンサルティング部 今泉大樹 1
#devio2023 2
本セッションではAWS CDKという ツールについてお話しします 3
注意事項 •AWSサービスについてのお話しはほとんどありません •AWS CDKの具体的な使い方は紹介いたしません •「俺(私)・・・今年こそOSS貢献するんだ・・・」という方に向けたお話しを いたします 4
自己紹介 5 今泉 大樹 - bun913 クラスメソッド株式会社 AWS事業本部モダンアプリケーションコンサルティング部 Twitter: @bun76235104
GitHub: bun913 4年半ほどITエンジニアをしています (3年Webアプリ寄り、1年半程度AWSインフラ寄り) 2023年7月よりお客様のアプリのモダナイズをご支援 2023 Japan AWS Top Engineer 2023 Japan AWS All Certifications Engineer 最近の趣味: 競技プログラミング(そんなに強くない) 25年前くらいからの趣味: ◯◯の大冒険
Agenda •AWS CDKってなに? •初めてAWS CDKを使うときのオススメ •AWS CDKへのコントリビューション(貢献)と方法 •コントリビューションをするときの注意点 6
7 AWS CDKってなに?
ようするに IaC(Infrastructure as Code) のツールの一つです 8
こんな構成を作るときに 9
AWS CDKならこれだけの記述量です 10
公式サイトを見てみましょう 11
さまざまなプログラミング言語で利用可 12
13 初めてAWS CDKを使うときのオススメ
いろいろな言語でCDKを使えるとなると じゃあPythonやGoなら知っているから それで触ってみようかな? 14
親しんだ言語で開始するのもいいのですが TypeScriptで開始するのがおすすめです 15
私がTSをおスメする理由 AWS CDKが様々な言語で利用できる仕組みと関 係しています 16
JSiiという仕組み 17 TypeScriptで書かれたプロジェクトが JavaScript、Python、Java、C#などでも利用 できる
TypeScriptで書かれたソースをJSiiで変換 18 (ほとんどの)CDKのソースコードはTSで記述 されている
•AWS CDKで検索するとTypeScriptの情報が多く出てくる •TSは静的型付言語なので、型の恩恵を受けることができる • ちょっとしたパラメーターなら調べるより型見た方が早い • 「インフラリソースの定義」という性質上パラメーターが多い •これらに加えて・・・ ということで理由です 19
普段のCDK開発から型の定義やメソッドの定義をよく見る →普段から定義をよく見るようになると構造を理解しやすい →構造を理解すると当然バグの直し方や原因を把握しやすい →コントリビューション(貢献)のチャンス!! ソースコードがTypeScriptということは!? 20
21 AWS CDKへのコントリビューション (貢献)と方法
おさらいも兼ねて AWS CDKへのコントリビューションはTypeScript で書かれるリポジトリのみでOK 22
GitHubにリポジトリがあります 23 https://github.com/aws/aws-cdk
コントリビューションの流れ 24
一般的な開発と同じ流れなのはわかった どうやってIssueとか見つけるの? バグなんて自分では中々見つけられないでしょ 25
まずはGitHubのリポジトリにアクセス 26 https://github.com/aws/aws-cdk
IssuesでIssueの一覧を開く 27 https://github.com/aws/aws-cdk/issues
good first Issueのラベルでフィルタリング 28
(ドキュメント修正の場合) 29 「documentation」のラベルを追加
(軽微なバグ修正の場合) 30 「bug」のラベルを追加
ほぼ答えが書かれているIssueも 31 コアコントリビューターの方が 「どこの」「なにを」直せば良さそうかアドバイス をしている
実際に私が担当したバグ 32 クラス初期化時に受け取ったパラメーターをリ ソース作成時に渡し忘れるバグ お茶目なミスもカワイイですね
これでIssue探しはばっちり ローカルで開発するときの注意点もいくつか 紹介します 33
34 コントリビューションをするときの注意点 (3点)
注意点1 ビルドもサクッと通らない可能性があります 35
AWS CDKのリポジトリはモノレポ 36 aws-cdk-libというパッケージの中にもCDKで 対応する様々なサービスが・・・
aws-cdk-lib というパッケージをビルド 37 lernaというモノレポ管理に利用されるツールを 利用している ※ このビルドにも数分要する https://github.com/aws/aws-cdk/blob/main/CONTRIBUTING.md
ビルド時にメモリが足らないことも・・・ 38
それですらコントリビューションのチャンス 39 https://github.com/aws/aws-cdk/pull/26465/files 1行追加しただけですが、新規コントリビュー ターの無駄時間を削る貢献です
注意点2 開発時はこまめに単体テストを実施する 40
修正って怖いですよね?でもありがたいことに AWS CDKはかなりテストが書かれている 41
aws-cdk-libだけでもテストに時間がかかる 42 修正した部分だけ単体テストを実行する方法も 書かれています https://github.com/aws/aws-cdk/blob/main/CONTRIBUTING.md
注意点3 実際にリソースを作成するテストでは 課金に注意 43
Integration Testの課金 44 https://github.com/aws/aws-cdk/blob/main/CONTRIBUTING.md 実際にリソースを作成する挙動をする
AWS Configの変更の検知には留意 45 https://dev.classmethod.jp/articles/aws-config-amazon-athena/
手っ取り早いのは CDK検証用のアカウント用意した方が良いかも 46
どうしても課金がいやなら 47 代わりにIntegテストを実行してくれたコアコント リビューターの方もいらっしゃいました
48 まとめ
•AWS CDKはIaCの一種でいろいろなプログラミング言語で書ける •TypeScriptで始めるのがおすすめ •初めてのコントリビューションには`good first issue` を探す •課金発生するポイントを抑えて楽しく開発しましょう まとめ 49
50