探索 API 開發的挑戰與解決之道 | .NET Conf 2023 Taiwan
0 likes469 views
本文件探讨了API开发中的挑战和解决方案，重点讨论了设计、开发和运维的各个阶段。作者介绍了与API相关的各种技术工具和最佳实践，如API规格设计、数据API构建器以及API网关的功能。最后，文件强调了规范的重要性以及有效管理API的策略。
探索 API 開發的挑戰與解決之道 | .NET Conf 2023 Taiwan
- 1. 探索 API 開發的挑戰與解決之道 Alan Tsai
- 2. 簡單的自我介紹 • Alan Tsai • 蔡孟玹 • 後端工程師 - .NET 技術為主 • 喜歡學習不同東西 • Azure • Data Science、Chatbot • Container、DevOps • 加强開發的Tools、架構 • 翻譯文章/軟體 • 兩本翻譯書 • 三門線上課程 • 看小說、玩手游 @Alan Tsai 的學習筆記 4
- 3. 教就是最好的學習方式 - 喜歡考證驗證所學 @Alan Tsai 的學習筆記 5
- 4. 喜歡技術分享 • 2022 .NET Conf • 談 Event Driven Architecture 之前 是不是該把 Event 規格搞定？ CloudEvents 是什麼？ | 邁上 Cloud Native App 之路 • 2021 .NET Conf • 不會 Javascript 沒關係 用 Blazor 來解決前端需求成為 Full Stack .NET 開發者吧 • 2020 Global Azure • Azure API Management 協助邁向Open API及Micro Service架構的好用服務 @Alan Tsai 的學習筆記 6
- 5. 喜歡技術分享 • Tibame • AZ-900、AZ-104、AZ-204 • GitHub Copilot 企業導入，在製造業、金融業、服務業，已培訓近800人次 • Trainocate • AZ-104、AZ-204、AZ-400、DP-200、DP-201、PL-900、DA-100 • 台灣智慧自動化與機器人協會 • 運用Python進行大數據分析、機器學習基礎理論課程及人工智慧 – ML.NET • 中華電信學院 • DevOps與CI/CD實務研習班、Windows Container 技術實務班 • 使用Azure AI打造有人工智能的Line聊天機器人 @Alan Tsai 的學習筆記 7
- 6. 歡迎訂閲、按讚 + 分享 FB 粉絲頁 http://fb.alantsai.net Alan Tsai 的學習筆記 https://blog.alantsai.net http://yt.alantsai.net http://bili.alantsai.net 影片 contact@alantsai.net contact@alantsai.net @Alan Tsai 的學習筆記 8
- 7. Agenda • API First 要解決什麼問題？ • 軟體開發的生命週期有什麼可以協助我們？ • 設計 • 開發 • 維運/上線 @Alan Tsai 的學習筆記 9
- 8. 大家有聽過 Death Star Architecture 嗎？ @Alan Tsai 的學習筆記 10
- 9. 11 @Alan Tsai 的學習筆記 What is Death Star Architecture and why you should care
- 10. 12 @Alan Tsai 的學習筆記 What is Death Star Architecture and why you should care • 改 A 壞 B => 有程式碼品質問題 • Gate Keepers 變成英雄 • 為了加速開發，我們導入 “敏捷” 專注 在 Process, Documentation, Planning • 整個糾結在一起，value stream 散落在 各個解決方案 • 開始有很多分支 (但是 DB 是同一座…) • 商業需求不會因為開發變慢而停下 • 各個部門解決自己的問題，而沒有思考 整體公司。沒有一致步調前進
- 11. 從 Monolithic 到 Microservices Migrate a monolithic application to microservices using domain-driven design
- 12. 從 Monolithic 到 Microservices Mastering the Art of API Design
- 13. API 的風格是什麼？ Mastering the Art of API Design
- 14. 從設計開始
- 15. Code First or API First ? API (OpenAPI Spec) Domain Model (Class Diagram) Entity Model (ERD Diagram)
- 16. Code First API (OpenAPI Spec) Domain Model (Class Diagram) Entity Model (ERD Diagram)
- 17. API First API Contract (OpenAPI Spec) Domain Model (Class Diagram) Entity Model (ERD Diagram)
- 18. Code First or API First ? Mastering the Art of API Design
- 19. 如何 Design API？ API 的成功與否，規格定的好不好 (這是設計 議題) 占了 70% 以上，規格定對了，後面的 實做 (效能，可靠度等等) 做得好才有加分。 ---安德魯
- 20. 如何 Design API？ API First - 從理想的 API Spec 設計開始 - Youtube API First - 從理想的 API Spec 設計開始 - 文章
- 23. 4 年前的我
- 26. Breaking 和 Changelog 的差異 https://www.oasdiff.com/home
- 27. 避免 Breaking Change 的兩種情況 https://www.oasdiff.com/home/breaking-changes
- 28. 產生出人看的懂的異動記錄
- 29. 進入開發
- 31. 如何可以快速使用 API？該用 SDK 嗎？ • 不想要有其他的套件相依 • SDK 的品質不夠好 • 需要有高速需求 • 不知道有 SDK
- 32. Kiota • 專門給使用端的產生工具 • C#, CLI, Go, Java, PHP, Python, Ruby, Swift and Typescript • 有 discovery, selection, generation • 支援 OpenAPI • 微軟 Support, Open Source
- 33. 35 @Alan Tsai 的學習筆記 https://github.com/Azure/data-api-builder/tree/main 初探 Data API Builder：在幾分鐘內將資料庫轉換成 REST 和 GraphQL 不再是夢想
- 34. Scenario • Local • Install DAB • Container MSSQL Database Setup • DAB Setup • API • GraphQL 36 @Alan Tsai 的學習筆記
- 35. 準備 DAB • 需要是 .NET 6+ SDK 37 @Alan Tsai 的學習筆記 dotnet --list-sdks dotnet tool install --global Microsoft.DataApiBuilder dab --version
- 36. 透過 Docker Container 38 @Alan Tsai 的學習筆記 docker run -e "ACCEPT_EULA=Y" -e "MSSQL_SA_PASSWORD=yourStrong(!)Password" -p 1433:1433 -d mcr.microsoft.com/mssql/server:2022-latest dab init --database-type "mssql" --connection-string "Server=localhost;Database=BookTest;User ID=sa;Password=yourStrong(!)Password;TrustServerCertificate=true" --host-mode "Development" dab start
- 37. 上線啦
- 38. 如何被呼叫？ The API gateway pattern versus the Direct client-to-microservice communication
- 39. API Gateway 應該做什麼事情？ What are the differences between a load balancer and an API gateway?
- 40. Azure APIM
- 42. Azure APIM - Self-hosted gateway Self-hosted gateway overview 功能差異比較
- 43. 全公司的 API 到底有多少？
- 44. Azure API Center – Public Preview
- 45. Azure API Center • API Inventory • API Governance • Metadata • API Discovery key concepts
- 46. Azure API Center – 整合 GitHub Copilot Chat
- 48. 結論 • 設計 • Typespec 寫規格 • oasdiff 審規格 • 開發 • Mock API • Kiota 產生呼叫的 API • Data API Builder (DAB) DB as API • 維運 • Azure API Center 管理 API • Azure API Management Gateway 服務 50 @Alan Tsai 的學習筆記