pospomeが思う "理想のインフラ作業手順書" の書き方について - pospomeのプログラミング日記

株式会社カミナシで VPoE を務めている pospome です。 (´・ω・`) 最近業務でインフラ作業の手順書について関わることがあったので、 自分が思う理想の手順書についてまとめようと思います。 作業手順書はとても重要 手順書を書くときに気をつけるポイント 1枚のドキュメントで完結させること 上から下に読んでいけばいい構成にすること コピペするだけでいいようにすること 他人がレビューできるようにすること 理想はパブリッククラウドの手順書 まとめ 宣伝 作業手順書はとても重要 プロダクトを開発・運用する過程で、たまーに発生するのがインフラ作業です。 AWSのコンソール画面やTerraformで簡単に変更できるような設定・作業であれば、わざわざ手順書を作る必要もないと思いますが、 複雑な作業になると手順書を作る機会があると思います。 pospomeも過去に複雑なインフラ作業を経験したこと