「プロジェクトの引き継ぎ」のベストプラクティスを探す旅

Transcript

1. 『プロジェクトの引き継ぎ』の ベストプラクティスを探す旅 2024.10.23 OpsJAWS Meetup31 泥臭いOPSのLT
2. 自己紹介 NHN テコラス株式会社 ソリューションアーキテクト 坂田 裕二 2021.7 ~ 某AWSパートナー会社に入社 (運用・監視) 2023.9 ~ NHN テコラス株式会社 入社(提案・構築・運用)
3. 自己紹介 趣味
4. 自己紹介 ↑ 行きます。
5. 本編
6. 本編 今プロジェクトの主担当のみなさん これからプロジェクトの主担当になるみなさん 引き継ぎドキュメントの要点、５分で出来るだけ教えます。 (※筆者も旅の途中です。) 伝えたい事
7. 本編 「テクニカルな話じゃないのかよ」 「もっとキラキラした改善話をきかせろ」
8. 本編 お前も泥臭くしてやろうか
9. 本編 連絡先 • 関係者の一覧 • ロール＆特性＆連絡先 • 連絡ツール • Backlog, Redmine, Jira, Slack, Teams… • 連絡の際に、担当者/お知らせに誰を入れるかまであると◎
10. 本編 構成図 • 構成図 • あればあるだけありがたい。 • 処理や経路に番号を振って、図の横で解説があると◎ • 格段に全景を掴みやすくなる。
11. 本編 > Guidance for Driving Airline Loyalty Through Personalized Promotions on AWS https://aws.amazon.com/jp/solutions/guidance/driving-airline-loyalty-through-personalized-promotions-on-aws/ Tips例
12. 本編 • EC2/RDS等の接続情報 • 秘密鍵の保管場所(ドライブ) • あえて明記することを標準化して縛る事で 「担当のローカルに置いたまま」なんて事態を防ぐ。 接続情報
13. 本編 • 過去作業のログ置き場 • 課題 → 作業内容 → 結果＆残課題 まで、書いてあると◎ • 何もない所に降ってくる「去年と同じことやって」ほど怖いものは ない。 作業ログ
14. 本編 • 運用手順 • 実際にあるタスク＆起きうる課題に対するアプローチを書く。 • 「書かなくてもこの程度分かるだろ」は幻想。 • 「IaCのコード見れば、何をしたいか分かるだろ」は幻想。 • まず、IaC運用の存在自体に気づかないと意味がない 運用手順
15. 本編 「設定を変更してほしい」 という依頼をザックリと想定 例
16. 本編 例
17. 本編 やるべき作業の実態 • CodeCommitからtfコードをclone • ブランチ切って編集してpush • mainブランチにマージ • パイプラインが起動 • CodeBuildが出したplanの内容を見て、承認。
18. 本編 ドリフト検出 シテ 通知シタラ イイノニ… ガードレール ヲ 整備シタラ イイノニ…
19. 本編 タスクの進め方 ← ひとそれぞれ ただし、前任者がどんな進め方をしていたかを 後任者は一番知りたがっている。
20. まとめ 「自分の持ち案件はどうかな」と立ち返ってみると 全員幸せになるかもしれません。 今日のまとめ 「こういう引き継ぎ資料が残ってて役に立った」 「こういう情報が残ってなくて辛かった」 の例を、こっそり教えてくれると嬉しいです。
21. おまけ
22. おまけ
23. おまけ
24. おまけ