SmithyでSDKコードを生成していく的なおはなし

https://nakanoshima-dev.connpass.com/event/252909/
[Online]nakanoshima.dev #28 改めて学ぶAWS SDKの表と裏
2022/7/27(水) 18:30 〜 22:00

Transcript

1. © 2022, Amazon Web Services, Inc. or its affiliates. © 2022, Amazon Web Services, Inc. or its affiliates. SmithyでSDKコードを ⽣成していく的なおはなし Takao Mitsuyoshi N A K A N O S H I M A . D E V # 2 8
2. © 2022, Amazon Web Services, Inc. or its affiliates. 光吉 隆雄（Mitsuyoshi Takao） アマゾンウェブサービスジャパン合同会社 技術統括本部⻄⽇本ソリューション部 ソリューションアーキテクト 経歴︓ ⼤⼿ゲーム会社基盤開発・DevOps推進 Infrastructure as Code, CI/CD, Container 好きなAWSサービス︓ ⻄⽇本のエンタープライズ企業を担当するソリューションアーキテクトとして、 新たに AWS の導⼊をご検討頂いているお客様／既に AWS をご利⽤頂いてい るお客様の課題解決を技術⾯から⽀援しています。 ⾃⼰紹介 AWS CodeBuild
3. © 2022, Amazon Web Services, Inc. or its affiliates. アジェンダ • AWS SDKの歴史的な話 • Smithyの特徴 • smithy-rubyを触ってみる • まとめ
4. © 2022, Amazon Web Services, Inc. or its affiliates. © 2022, Amazon Web Services, Inc. or its affiliates. AWS SDKの歴史的な話 4
5. © 2022, Amazon Web Services, Inc. or its affiliates. 増える AWS SDK for XXX 5 Rust, Kotlin, Swift Developer Preview Previewを加えると今や AWS SDK は12個の⾔語をサポートしている
6. © 2022, Amazon Web Services, Inc. or its affiliates. AWS の新機能に対する対応 6 機能追加発⽣ 11:00 CodeGen
7. © 2022, Amazon Web Services, Inc. or its affiliates. 歴史的背景 7
8. © 2022, Amazon Web Services, Inc. or its affiliates. Smithyの導⼊ 8
9. © 2022, Amazon Web Services, Inc. or its affiliates. C2Jとおなじ︖ 9
10. © 2022, Amazon Web Services, Inc. or its affiliates. AWS独⾃の機能の追加 10
11. © 2022, Amazon Web Services, Inc. or its affiliates. © 2022, Amazon Web Services, Inc. or its affiliates. Smithyの特徴 11
12. © 2022, Amazon Web Services, Inc. or its affiliates. Smithyの特徴 12 • Protocol-agnostic • Designed to evolve • Codify and enforce API governance • Resource based
13. © 2022, Amazon Web Services, Inc. or its affiliates. Smithyの特徴 13 • Protocol-agnostic • Designed to evolve • Codify and enforce API governance • Resource based
14. © 2022, Amazon Web Services, Inc. or its affiliates. 記述の基本 各オブジェクトにShape(型のようなもの)がある。 各オブジェクトにTraits(特性)を記述してより多くの情報を付与 14 @title("ACME Simple Image Service") service Weather { version: "2006-03-01", resources: [City] } Shape(型) 名前 プロパティ 値 Traits(特性)
15. © 2022, Amazon Web Services, Inc. or its affiliates. サービスとリソース 記述しているサービスの全体的な情報をserviceとして記述。 サービスの中で扱われるリソースを記述 15 service Weather { version: "2006-03-01", resources: [City] } resource City { identifiers: { cityId: CityId }, read: GetCity } @pattern("^[A-Za-z0-9 ]+$") string CityId リソース サービス
16. © 2022, Amazon Web Services, Inc. or its affiliates. オペレーション 16 @readonly operation GetCity { input: GetCityInput, output: GetCityOutput } @input structure GetCityInput { @required cityId: CityId } @output structure GetCityOutput { @required name: String } オペレーション(操作) 取得時に⼀意の識別⼦ として必須のためtraits 結果に必ずnameが 含まれることの宣⾔
17. © 2022, Amazon Web Services, Inc. or its affiliates. オペレーション 17 @readonly operation GetCity { input: GetCityInput, output: GetCityOutput } @input structure GetCityInput { @required cityId: CityId } @output structure GetCityOutput { @required name: String } オペレーション(操作) 取得時に⼀意の識別⼦ として必須のためtraits 結果に必ずnameが 含まれることの宣⾔ これらの定義の中にはプロトコル、シリアライズ形式といった情報は存在しない とはいえ必須でないというだけで、 たとえば @http という traitsがあり、httpプロトコルに関する情報を付与できる。 またOpenAPIにコンバートすることも可能。（完全なサポートではないため不可逆）
18. © 2022, Amazon Web Services, Inc. or its affiliates. Smithyの特徴 18 • Protocol-agnostic • Designed to evolve • Codify and enforce API governance • Resource based
19. © 2022, Amazon Web Services, Inc. or its affiliates. 拡張性 19 • デフォルトで様々なTraitsが存在 • AWSの機能に関するTraitsも • 既存リソースへの追加などに対しては 下位互換性を持っている
20. © 2022, Amazon Web Services, Inc. or its affiliates. © 2022, Amazon Web Services, Inc. or its affiliates. smithy-rubyを触ってみる 20
21. © 2022, Amazon Web Services, Inc. or its affiliates. AWS SDKと関係ない rubygems の⽣成 21 high_score_servi ce (ruby on rails) high-score- service.smithy high-score- service gem CodeGen request
22. © 2022, Amazon Web Services, Inc. or its affiliates. © 2022, Amazon Web Services, Inc. or its affiliates. デモ 22
23. © 2022, Amazon Web Services, Inc. or its affiliates. © 2022, Amazon Web Services, Inc. or its affiliates. まとめ 23
24. © 2022, Amazon Web Services, Inc. or its affiliates. まとめ 24 • AWS SDK はすべての⾔語で同⼀の機能を保証するためにより良い⼿法で改 善を加え続けている • Smithy は AWS のためのものではなくプロトコルやフォーマットにとらわ れないIDL • (開発中の⾔語も多いけど)好きな⾔語で Smithy を触ってみよう!
25. © 2022, Amazon Web Services, Inc. or its affiliates. 参考 25 • AWS re:Invent 2021 - Building with the new AWS SDKs for Rust, Kotlin, and Swift • https://www.youtube.com/watch?v=Nhk1K1AjYvg • Smithy • https://awslabs.github.io/smithy/ • Developer Preview: Ruby SDK code generation using Smithy • https://aws.amazon.com/jp/blogs/developer/developer-preview-smithy-code- generated-ruby-sdk/
26. © 2022, Amazon Web Services, Inc. or its affiliates. Thank you! © 2022, Amazon Web Services, Inc. or its affiliates. 26