Upgrade to Pro — share decks privately, control downloads, hide ads and more …

ChatGPTとCIパイプラインを利用してドキュメント作成作業を自動化した話

Avatar for Toru Takahashi Toru Takahashi
July 29, 2023
Programming
0
2k

 ChatGPTとCIパイプラインを利用してドキュメント作成作業を自動化した話

AWS DevDay2023登壇資料です。
https://www.youtube.com/watch?v=B2TwG94zlss

Avatar for Toru Takahashi

Toru Takahashi

July 29, 2023
Tweet

More Decks by Toru Takahashi

See All by Toru Takahashi
自分の技術力を言語化しよう
Avatar for Toru Takahashi tttol
3
69
アプリケーションエンジニアだからこそわかるCDKコントリビューションの難しさと面白さ.pdf
Avatar for Toru Takahashi tttol
3
170
AWS_AmplifyとNFCカードを使ってデジタル名刺を作る.pdf
Avatar for Toru Takahashi tttol
4
140
AWS AmplifyとNFCカードを使ってデジタル名刺を作る
Avatar for Toru Takahashi tttol
0
81
はじめてのAWS CDKコントリビュート
Avatar for Toru Takahashi tttol
0
220
Amplify製アプリケーションにパスキー認証を導入する
Avatar for Toru Takahashi tttol
1
170
Virtual Threadsで実現する性能改善
Avatar for Toru Takahashi tttol
1
1.9k
私がAWS Amplifyを使う理由
Avatar for Toru Takahashi tttol
1
380
AWS Community Builder流：技術情報のインプット・アウトプット戦略
Avatar for Toru Takahashi tttol
1
880

Other Decks in Programming

See All in Programming
知っているようで知らない"rails new"の世界 / The World of "rails new" You Think You Know but Don't
Avatar for luccafort luccafort
PRO
1
190
基礎から学ぶ大画面対応(Learning Large-Screen Support from the Ground Up)
Avatar for Tomoya Miwa tomoya0x00
0
4.3k
Ruby Parser progress report 2025
Avatar for yui-knk yui_knk
1
460
速いWebフレームワークを作る
Avatar for Yusuke Wada yusukebe
5
1.7k
Introducing ReActionView: A new ActionView-compatible ERB Engine @ Rails World 2025, Amsterdam
Avatar for Marco Roth marcoroth
0
710
アルテニア コンサル／ＩＴエンジニア向け 採用ピッチ資料
Avatar for ALTENIR altenir
0
110
Namespace and Its Future
Avatar for Satoshi Tagomori tagomoris
6
710
プロポーザル駆動学習 / Proposal-Driven Learning
Avatar for mackey0225 mackey0225
2
1.3k
Android 16 × Jetpack Composeで縦書きテキストエディタを作ろう / Vertical Text Editor with Compose on Android 16
Avatar for cc4966 cc4966
2
270
プロパティベーステストによるUIテスト: LLMによるプロパティ定義生成でエッジケースを捉える
Avatar for Tetta Noguchi tetta_pdnt
0
4.3k
MCPとデザインシステムに立脚したデザインと実装の融合
Avatar for Yuku Kotani yukukotani
4
1.5k
時間軸から考えるTerraformを使う理由と留意点
Avatar for Ryoma Fujiwara fufuhu
16
4.8k

Featured

See All Featured
The Invisible Side of Design
Avatar for Vitaly Friedman smashingmag
301
51k
Docker and Python
Avatar for Tania Allard trallard
46
3.6k
Java REST API Framework Comparison - PWX 2021
Avatar for Matt Raible mraible
33
8.8k
Principles of Awesome APIs and How to Build Them.
Avatar for Keavy McMinn keavy
126
17k
Reflections from 52 weeks, 52 projects
Avatar for Jefferson Lam jeffersonlam
352
21k
The World Runs on Bad Software
Avatar for Brandon Keepers bkeepers
PRO
70
11k
Code Review Best Practice
Avatar for Trisha Gee trishagee
71
19k
Chrome DevTools: State of the Union 2024 - Debugging React & Beyond
Avatar for Addy Osmani addyosmani
7
850
The Psychology of Web Performance [Beyond Tellerrand 2023]
Avatar for Tammy Everts tammyeverts
49
3k
Building a Modern Day 
E-commerce SEO Strategy
Avatar for Aleyda Solis aleyda
43
7.6k
ピンチをチャンスに：未来をつくるプロダクトロードマップ #pmconf2020
Avatar for Aki / @LoveIdahoBurger aki_iinuma
127
53k
CoffeeScript is Beautiful & I Never Want to Write Plain JavaScript Again
Avatar for Sam Stephenson sstephenson
162
15k

Transcript

  1. © 2023, Amazon Web Services, Inc. or its affiliates. All

    rights reserved. © 2023, Amazon Web Services, Inc. or its affiliates. All rights reserved. ChatGPTとCIパイプラインを利用して ドキュメント作成作業を自動化した話 髙橋 透 F-3-2 NRIネットコム株式会社

  2. © 2023, Amazon Web Services, Inc. or its affiliates. All

    rights reserved. 髙橋 透 (Toru Takahashi) NRIネットコム株式会社 バックエンドエンジニア (主にJava SpringBoot) 自己紹介

  3. © 2023, Amazon Web Services, Inc. or its affiliates. All

    rights reserved. ドキュメント整備 やってますか？

  4. © 2023, Amazon Web Services, Inc. or its affiliates. All

    rights reserved. • 外部設計書 • 内部設計書 • DB 設計書 • テスト設計書 • 運用保守手順書 • etc... ドキュメント整備 やってますか？ https://www.vecteezy.com/photo/10610487-close-up-hands- of-a-man-in-a-white-shirt-searching-for-contract-agreement- documents-in-stack-of-group-report-papers-clipped-in-color- clips

  5. © 2023, Amazon Web Services, Inc. or its affiliates. All

    rights reserved. ちゃんとメンテ できてますか？

  6. © 2023, Amazon Web Services, Inc. or its affiliates. All

    rights reserved. ＜よくあるケース＞ • アプリを更新したがドキュメントの更新が漏れていた • ドキュメントを更新したが誤記載・typo があった • 忙しさを理由にドキュメント更新を後回しにしてしまう ちゃんとメンテできてますか？

  7. © 2023, Amazon Web Services, Inc. or its affiliates. All

    rights reserved. ＜よくあるケース＞ • アプリを更新したがドキュメントの更新が漏れていた ↑コーディングに集中したい…ドキュメント更新面倒… • ドキュメントを更新したが誤記載・typo があった • 忙しさを理由にドキュメント更新を後回しにしてしまう ちゃんとメンテできてますか？

  8. © 2023, Amazon Web Services, Inc. or its affiliates. All

    rights reserved. ＜よくあるケース＞ • アプリを更新したがドキュメントの更新が漏れていた ↑コーディングに集中したい…ドキュメント更新面倒… • ドキュメントを更新したが誤記載・typo があった ↑ミスを100％防ぐことは難しい • 忙しさを理由にドキュメント更新を後回しにしてしまう ちゃんとメンテできてますか？

  9. © 2023, Amazon Web Services, Inc. or its affiliates. All

    rights reserved. ＜よくあるケース＞ • アプリを更新したがドキュメントの更新が漏れていた ↑コーディングに集中したい…ドキュメント更新面倒… • ドキュメントを更新したが誤記載・typo があった ↑ミスを100％防ぐことは難しい • 忙しさを理由にドキュメント更新を後回しにしてしまう ↑エンジニアは多忙な生き物 ちゃんとメンテできてますか？

  10. © 2023, Amazon Web Services, Inc. or its affiliates. All

    rights reserved. ＜よくあるケース＞ • アプリを更新したがドキュメントの更新が漏れていた ↑コーディングに集中したい…ドキュメント更新面倒… • ドキュメントを更新したが誤記載・typoがあった ↑100％ミスを防ぐことは難しい • 忙しさを理由にドキュメント更新を後回しにしてしまう ↑エンジニアは多忙な生き物 ちゃんとメンテできてますか？ すべて解決します！！

  11. © 2023, Amazon Web Services, Inc. or its affiliates. All

    rights reserved. • 「アプリ更新→ドキュメント自動更新」する仕組みの紹介 • (例) DBテーブルを追加するとDB定義書が自動更新される 紹介する解決方法 アプリに DBテーブルを 追加 GitにPUSH CIで ドキュメント更新

  12. © 2023, Amazon Web Services, Inc. or its affiliates. All

    rights reserved. © 2023, Amazon Web Services, Inc. or its affiliates. All rights reserved. １．アーキテクチャ説明 ２．デモ動画 ３．CI パイプラインの概要 ４．Flyway による DB マイグレーション ５．MySQL からテーブル情報を取得する ６．Confluence REST API を使ったページ更新 ７．開発における ChatGPT の使い所 ８．まとめ アジェンダ

  13. © 2023, Amazon Web Services, Inc. or its affiliates. All

    rights reserved. © 2023, Amazon Web Services, Inc. or its affiliates. All rights reserved. １．アーキテクチャ説明 ２．デモ動画 ３．CI パイプラインの概要 ４．Flyway による DB マイグレーション ５．MySQL からテーブル情報を取得する ６．Confluence REST API を使ったページ更新 ７．開発における ChatGPT の使い所 ８．まとめ アジェンダ

  14. © 2023, Amazon Web Services, Inc. or its affiliates. All

    rights reserved. AWS Cloud AWS CodePipeline ドキュメント (Notion, Confluence等) AWS CodeBuild MySQL (Dockerコンテナ) Flyway ①ソースコードを GitにPUSH ②CodePipeline →CodeBuildの順に CI/CDが起動 ③DB構築＆テーブル情報抽出 ④DBドキュメント更新

  15. © 2023, Amazon Web Services, Inc. or its affiliates. All

    rights reserved. © 2023, Amazon Web Services, Inc. or its affiliates. All rights reserved. １．アーキテクチャ説明 ２．デモ動画 ３．CI パイプラインの概要 ４．Flyway による DB マイグレーション ５．MySQL からテーブル情報を取得する ６．Confluence REST API を使ったページ更新 ７．開発における ChatGPT の使い所 ８．まとめ アジェンダ

  16. © 2023, Amazon Web Services, Inc. or its affiliates. All

    rights reserved. © 2023, Amazon Web Services, Inc. or its affiliates. All rights reserved. デモ見せます ※今から流すデモ動画は私が 業務外で個人的に作成した サンプルアプリの映像です

  17. © 2023, Amazon Web Services, Inc. or its affiliates. All

    rights reserved. © 2023, Amazon Web Services, Inc. or its affiliates. All rights reserved. １．アーキテクチャ説明 ２．デモ動画 ３．CI パイプラインの概要 ４．Flyway による DB マイグレーション ５．MySQL からテーブル情報を取得する ６．Confluence REST API を使ったページ更新 ７．開発における ChatGPT の使い所 ８．まとめ アジェンダ

  18. © 2023, Amazon Web Services, Inc. or its affiliates. All

    rights reserved. AWS Cloud AWS CodePipeline ドキュメント (Notion, Confluence等) AWS CodeBuild MySQL (Dockerコンテナ) Flyway ①ソースコードを GitにPUSH ②CodePipeline →CodeBuildの順に CI/CDが起動 ③DB構築＆テーブル情報抽出 ④DBドキュメント更新

  19. © 2023, Amazon Web Services, Inc. or its affiliates. All

    rights reserved. • AWS 上で CI/CD を構築できるサービス • AWS CodeXXX 系のサービスは他にもある • AWS CodeCommit • AWS CodeBuild • AWS CodeDeploy • AWS CodePipeline • AWS CodeStar AWS CodePipeline

  20. © 2023, Amazon Web Services, Inc. or its affiliates. All

    rights reserved. • AWS 上で CI/CD を構築できるサービス • AWS CodeXXX系 のサービスは他にもある • AWS CodeCommit • AWS CodeBuild ←今回利用 • AWS CodeDeploy • AWS CodePipeline ←今回利用 • AWS CodeStar AWS CodePipeline

  21. © 2023, Amazon Web Services, Inc. or its affiliates. All

    rights reserved. AWS CodeBuild CI で実行する処理をここで 定義する 定義は buildspec.yml という ファイルに記述 VSCode, Microsoft, https://azure.microsoft.com/ja-jp/products/visual-studio-code

  22. © 2023, Amazon Web Services, Inc. or its affiliates. All

    rights reserved. © 2023, Amazon Web Services, Inc. or its affiliates. All rights reserved. １．アーキテクチャ説明 ２．デモ動画 ３．CI パイプラインの概要 ４．Flyway による DB マイグレーション ５．MySQL からテーブル情報を取得する ６．Confluence REST API を使ったページ更新 ７．開発における ChatGPT の使い所 ８．まとめ アジェンダ

  23. © 2023, Amazon Web Services, Inc. or its affiliates. All

    rights reserved. AWS Cloud AWS CodePipeline ドキュメント (Notion, Confluence等) AWS CodeBuild MySQL (Dockerコンテナ) Flyway ①ソースコードを GitにPUSH ②CodePipeline →CodeBuildの順に CI/CDが起動 ③DB構築＆テーブル情報抽出 ④DBドキュメント更新

  24. © 2023, Amazon Web Services, Inc. or its affiliates. All

    rights reserved. • DB のマイグレーションツール • オープンソース • ソースコードを Git でバージョン管理するように、DB の状態をバー ジョン管理可能 Flywayとは？

  25. © 2023, Amazon Web Services, Inc. or its affiliates. All

    rights reserved. Flyway 利用例 DB hoge_tableに `fuga INT` をカラム追加したい hoge_tableに `piyo VARCHAR(256)` をカラム追加したい

  26. © 2023, Amazon Web Services, Inc. or its affiliates. All

    rights reserved. Flyway 利用例ーsql ファイル作成 DB V1.0__add_fuga.sql V2.0__add_piyo.sql

  27. © 2023, Amazon Web Services, Inc. or its affiliates. All

    rights reserved. V1.0__add_fuga.sql V2.0__add_piyo.sql VSCode, Microsoft, https://azure.microsoft.com/ja-jp/products/visual-studio-code Flyway 利用例ーsql ファイル作成

  28. © 2023, Amazon Web Services, Inc. or its affiliates. All

    rights reserved. ├── src │ ├── main │ │ └── resources │ │ ├── db │ │ │ └── migration │ │ │ ├── V1.0__add_fuga.sql │ │ │ ├── V2.0__add_piyo.sql ・・・ ※Java(SpringBoot , Gradle)で実装した場合のディレクトリ例です Flyway 利用例ーsql ファイル配置場所

  29. © 2023, Amazon Web Services, Inc. or its affiliates. All

    rights reserved. Flyway利用例ーマイグレーション実行 CLIよりコマンドを実行することでマイグレーションが実行される ※Java(SpringBoot, Gradle)で実装した場合のコマンド例です ※Mac Terminal

  30. © 2023, Amazon Web Services, Inc. or its affiliates. All

    rights reserved. Flyway利用例ーマイグレーション実行結果 fugaカラム, piyoカラムが追加されていることを確認 ※Mac Terminal

  31. © 2023, Amazon Web Services, Inc. or its affiliates. All

    rights reserved. Flyway を使うことで何がうれしいか • DB スキーマの変更履歴を sql ファイルベースでバージョン管理可能 • 好きな場所・環境で DB ダンプ要らずで DB を構築できる • ローカル上のDockerコンテナ • GitHub ActionsのRunner • 開発/本番環境 • etc…

  32. © 2023, Amazon Web Services, Inc. or its affiliates. All

    rights reserved. AWS Cloud AWS CodePipeline ドキュメント (Notion, Confluence等) AWS CodeBuild MySQL (Dockerコンテナ) Flyway ①ソースコードを GitにPUSH ②CodePipeline →CodeBuildの順に CI/CDが起動 ③DB構築＆テーブル情報抽出 ④DBドキュメント更新 最新のDBスキーマを CodePipeline上の MySQL(Dockerコンテナ) に反映することができる

  33. © 2023, Amazon Web Services, Inc. or its affiliates. All

    rights reserved. © 2023, Amazon Web Services, Inc. or its affiliates. All rights reserved. １．アーキテクチャ説明 ２．デモ動画 ３．CI パイプラインの概要 ４．Flyway による DB マイグレーション ５．MySQL からテーブル情報を取得する ６．Confluence REST API を使ったページ更新 ７．開発における ChatGPT の使い所 ８．まとめ アジェンダ

  34. © 2023, Amazon Web Services, Inc. or its affiliates. All

    rights reserved. • MySQL では information_schema に DB 内の情報が詰まっている • データベース名 • テーブル名 • カラムのデータ型 • アクセス権限 • etc... MySQL の information_schema

  35. © 2023, Amazon Web Services, Inc. or its affiliates. All

    rights reserved. information_schema から情報取得 VSCode, Microsoft, https://azure.microsoft.com/ja-jp/products/visual-studio-code

  36. © 2023, Amazon Web Services, Inc. or its affiliates. All

    rights reserved. information_schema から情報取得 ※Mac Terminal

  37. © 2023, Amazon Web Services, Inc. or its affiliates. All

    rights reserved. information_schema から情報取得 この情報をHTMLに落とし込んで Confluenceを更新します ※Mac Terminal

  38. © 2023, Amazon Web Services, Inc. or its affiliates. All

    rights reserved. • Python の「mysql-connector-python」を利用 • Python から MySQL に接続するライブラリ • https://pypi.org/project/mysql-connector-python/ HTML に落とし込む方法

  39. © 2023, Amazon Web Services, Inc. or its affiliates. All

    rights reserved. HTML に落とし込む方法 VSCode, Microsoft, https://azure.microsoft.com/ja-jp/products/visual-studio-code

  40. © 2023, Amazon Web Services, Inc. or its affiliates. All

    rights reserved. © 2023, Amazon Web Services, Inc. or its affiliates. All rights reserved. １．アーキテクチャ説明 ２．デモ動画 ３．CI パイプラインの概要 ４．Flyway による DB マイグレーション ５．MySQL からテーブル情報を取得する ６．Confluence REST API を使ったページ更新 ７．開発における ChatGPT の使い所 ８．まとめ アジェンダ

  41. © 2023, Amazon Web Services, Inc. or its affiliates. All

    rights reserved. AWS Cloud AWS CodePipeline ドキュメント (Notion, Confluence等) AWS CodeBuild MySQL (Dockerコンテナ) Flyway ①ソースコードを GitにPUSH ②CodePipeline →CodeBuildの順に CI/CDが起動 ③DB構築＆テーブル情報抽出 ④DBドキュメント更新

  42. © 2023, Amazon Web Services, Inc. or its affiliates. All

    rights reserved. • Confluence のページを操作するための REST API が 公式で用意されている • GET : ページ取得 • POST : ページ作成 • PUT : ページ更新 • DELETE : ページ削除 Confluence REST API

  43. © 2023, Amazon Web Services, Inc. or its affiliates. All

    rights reserved. • Confluenceのページを操作するためのREST APIが 公式で用意されている • GET : ページ取得 • POST : ページ作成 • PUT : ページ更新 ←これを使う • DELETE : ページ削除 Confluence REST API

  44. © 2023, Amazon Web Services, Inc. or its affiliates. All

    rights reserved. © 2023, Amazon Web Services, Inc. or its affiliates. All rights reserved. １．アーキテクチャ説明 ２．デモ動画 ３．CI パイプラインの概要 ４．Flyway による DB マイグレーション ５．MySQL からテーブル情報を取得する ６．Confluence REST API を使ったページ更新 ７．開発における ChatGPT の使い所 ８．まとめ アジェンダ

  45. © 2023, Amazon Web Services, Inc. or its affiliates. All

    rights reserved. ChatGPT の使い所 MySQL のテーブル内容を HTML 出力する方法を教えてください ChatGPT, OpenAI, https://chat.openai.com/ アクセス日 5/18

  46. © 2023, Amazon Web Services, Inc. or its affiliates. All

    rights reserved. ChatGPT の使い所 ChatGPT, OpenAI, https://chat.openai.com/ アクセス日 5/18

  47. © 2023, Amazon Web Services, Inc. or its affiliates. All

    rights reserved. ChatGPTの使い所 Confluence のページを 外部から更新する 方法を教えてください ChatGPT, OpenAI, https://chat.openai.com/ アクセス日 5/18

  48. © 2023, Amazon Web Services, Inc. or its affiliates. All

    rights reserved. © 2023, Amazon Web Services, Inc. or its affiliates. All rights reserved. １．アーキテクチャ説明 ２．デモ動画 ３．CI パイプラインの概要 ４．Flyway による DB マイグレーション ５．MySQL からテーブル情報を取得する ６．Confluence REST API を使ったページ更新 ７．開発における ChatGPT の使い所 ８．まとめ アジェンダ

  49. © 2023, Amazon Web Services, Inc. or its affiliates. All

    rights reserved. AWS Cloud AWS CodePipeline ドキュメント (Notion, Confluence等) AWS CodeBuild MySQL (Dockerコンテナ) Flyway ①ソースコードを GitにPUSH ②CodePipeline →CodeBuildの順に CI/CDが起動 ③DB構築＆テーブル情報抽出 ④DBドキュメント更新

  50. © 2023, Amazon Web Services, Inc. or its affiliates. All

    rights reserved. AWS Cloud AWS CodePipeline ドキュメント (Notion, Confluence等) AWS CodeBuild MySQL (Dockerコンテナ) Flyway ①ソースコードを GitにPUSH ②CodePipeline →CodeBuildの順に CI/CDが起動 ③DB構築＆テーブル情報抽出 ④DBドキュメント更新

  51. © 2023, Amazon Web Services, Inc. or its affiliates. All

    rights reserved. AWS Cloud AWS CodePipeline ドキュメント (Notion, Confluence等) AWS CodeBuild MySQL (Dockerコンテナ) Flyway ①ソースコードを GitにPUSH ②CodePipeline →CodeBuildの順に CI/CDが起動 ③DB構築＆テーブル情報抽出 ④DBドキュメント更新 最新の DB スキーマを CodePipeline 上の MySQL(Dockerコンテナ) に反映することができる

  52. © 2023, Amazon Web Services, Inc. or its affiliates. All

    rights reserved. AWS Cloud AWS CodePipeline ドキュメント (Notion, Confluence等) AWS CodeBuild MySQL (Dockerコンテナ) Flyway ①ソースコードを GitにPUSH ②CodePipeline →CodeBuildの順に CI/CDが起動 ③DB構築＆テーブル情報抽出 ④DBドキュメント更新

  53. © 2023, Amazon Web Services, Inc. or its affiliates. All

    rights reserved. ＜よくあるケース＞ • アプリを更新したがドキュメントの更新が漏れていた • ドキュメントを更新したが誤記載・typo があった • 忙しさを理由にドキュメント更新を後回しにしてしまう 【再掲】ちゃんとメンテできてますか？

  54. © 2023, Amazon Web Services, Inc. or its affiliates. All

    rights reserved. ＜よくあるケース＞ • アプリを更新したがドキュメントの更新が漏れていた ↑PUSH 時に自動更新するので漏れなし！ • ドキュメントを更新したが誤記載・typo があった • 忙しさを理由にドキュメント更新を後回しにしてしまう 【再掲】ちゃんとメンテできてますか？

  55. © 2023, Amazon Web Services, Inc. or its affiliates. All

    rights reserved. ＜よくあるケース＞ • アプリを更新したがドキュメントの更新が漏れていた ↑PUSH 時に自動更新するので漏れなし！ • ドキュメントを更新したが誤記載・typo があった ↑information_schema そのままなので間違えようがない！ • 忙しさを理由にドキュメント更新を後回しにしてしまう 【再掲】ちゃんとメンテできてますか？

  56. © 2023, Amazon Web Services, Inc. or its affiliates. All

    rights reserved. ＜よくあるケース＞ • アプリを更新したがドキュメントの更新が漏れていた ↑PUSH 時に自動更新するので漏れなし！ • ドキュメントを更新したが誤記載・typo があった ↑information_schema そのままなので間違えようがない！ • 忙しさを理由にドキュメント更新を後回しにしてしまう ↑CI が勝手にやってくれるので開発に集中できる！ 【再掲】ちゃんとメンテできてますか？

  57. © 2023, Amazon Web Services, Inc. or its affiliates. All

    rights reserved. DB テーブル定義だけでなく、他のドキュメントも自動化 Javadoc を CIで出力させて設計書代わりに…？！ Confluence 以外のサービスへの応用 REST APIがあればなんでもよい AI サービスを組み込む プロンプト次第で可能性は無限大 TRY MORE！

  58. © 2023, Amazon Web Services, Inc. or its affiliates. All

    rights reserved. Thank you! © 2023, Amazon Web Services, Inc. or its affiliates. All rights reserved.