メンテナンス作業手順の書き方

この記事は「ex-KAYAC Advent Calendar 2018」の11日目の記事です(遅れてすみません 🙇)。 カヤックでの私について⌗ソーシャルゲームのバックエンドエンジニアとして 3 ヵ月、クライアントワークのバックエンドエンジニアとして9 ヵ月の経験を積んだ後、Web のインフラエンジニア(以降、インフラエンジニア)として 4年半従事しました(2018年12月現在、中途採用ページを見るとインフラエンジニアになっていましたが、現在は SRE になっているはずです)。 主にソーシャルゲームの担当で、社内評価システムの実装・運用・保守や Redmine を定期的にアップグレードしたりもしていました。 もともとインフラエンジニア志望だったのですが、私が新卒入社したころはインフラの上で動くアプリケーションのこともわからないといけないということで、まずはバックエンドのエンジニアとして経

[munyaX]

こういう手順書の9割くらいをAnsible化してコマンド一発にまとめたい派です。

[ngsw]

手順書作るのにちゃんと時間かけて、本番時に鼻ほじりながら作業するのが好き。本番環境で試行錯誤する人を許せない気持ちになる。

[yabu_kyu]

止める前に動いてること確認せんの…？

[kenzy_n]

優しく分かりやすい手順書は大切

[donchan922]

コマンドは載せておくべきですよね。

[diveintounlimit]

基本的な事。ここすっ飛ばして悪い例出してくるやつまぁまぁ居るけど信用ならん。

[yatmsu]

こういう現場感があるやつ読みたい

[toritori0318]

良い

[hiro14aki]

「メンテナンス作業は神経を使うので、心配事は少ないほど良い」これはほんとにそう思う。

[braitom]

手順書について。なぜ手順書を書くのか、どのように書くとよいかが書かれている。認識の齟齬が起きないように作業はコピペで実行できるようにしておく、GUI操作はスクリーンショットを貼っておくなど

[massa142]

“作業は基本的にコピー&ペーストして実行するだけで進めていけるようにしておくと安心です”

[new3]

"正常に監視できている前提であれば省略しても良いかなと思います" そういう前提こそ省略せず書くのが手順書として大切だと思います…

[htnmiki]

ヘルプ見ても長々と説明されてるだけでコマンドが書かれてないと本当につらい。説明はあとでいいからまずコマンドを知りたいんだ。

[meganeya3]

手順書にはすべての手順が必要であり、「作業」であるならコンピュータの入力ができるレベルの人間用のものを準備しておけば、不測の事態が起こってプロパーは誰も動けないときも作業員を派遣すれば済む

[atori07]

大事

[otihateten3510]

これが苦手なのよ

[tianbale-battle]

本当これ大事

[ken39arg]

ありがとうございます。