自社開発企業のインフラエンジニアは、手順書を作成するのか否か

Question

現在、私は、Slerでインフラエンジニアをしています。

おそらく、属人化を防ぐために手順書を作成する機会がよくあるのですが、
この工程って自社開発企業のエンジニアも行うのですか？

行うのであれば、全業務時間の何割を占めますか？

ご多用のところ恐れ入りますが、ご返答よろしくお願いいたします。

Comments

[Zuishin]

そんなもの職場によっても人によっても違うでしょう。

[asdfrgthyj]

全体の傾向として、どんな割合なのかな〜って気になったんですが、まあ返答の通りですよね。ありがとうございます。

Answer 1

質問とはちょっとずれるけど、
ある会社でOracle Databaseのパフォーマンス・チューニングに呼ばれた時のこと、SQLコードがあまりにも幼稚。

インフラチュームになぜこの初期化パラメータはこの値になっているのか？これではパフォーマンスが悪いけど？って質問したら、新橋のインフラと開発を依頼した会社が方式設計書などのドキュメントが一切納品されていないし、電話もメールも連絡も取れないのでわからない。

SQLは3ヶ月かかってわたしの担当部分を全部作り直して処理時間を10分の1に改善。チューニングじゃなくて尻拭いでした。
ちなみにわたしが参加した時点でカットオーバーが予定より1年以上遅れていていて、あと半年遅れたら部長の首が飛ぶとのことでした。

必要なドキュメントはきちんと残しましょう。

Comments

[asdfrgthyj]

ドキュメントを書かなければ起きるリスクを知って、ドキュメントの必要性を再実感しました。
脳死で書いてる文化があったので、フラストレーション溜まってたんですけど、、、

Answer 2

組織と状況と要件によるとしか言えません。

モダンな環境（と言っても現在なら割と普通ですが）なら手順書では無くコードによる構成管理と冪等性の確保を行っているでしょうし、
1~数人のチームでやっている場合で、そこだけ属人化を排除しても意味が無い場合やコストを書けれない場合は全くやらないところもあることでしょう。

おそらく、属人化を防ぐために手順書を作成する機会がよくあるのですが、

属人化を防ぐ以外にも色々と理由はある（ISOの絡みだったり、納品物として必要だったり、事前にレビューをするためだったり、問題発生時に見直すためであったり）ので、現在している作業の要件を明確にしてみると発見があるかと思いますよ。

Comments

[asdfrgthyj]

ご返信ありがとうございます。
コードによる管理が手順書の替わりになるって発想なかったので、ハッとさせられました。