｢手順書｣のススメ - Masteries

こんにちは, id:papix です. この記事は, ｢はてなエンジニア Advent Calendar 2018｣の9日目の記事です. qiita.com 昨日は id:wtatsuru さんによる, ｢基盤開発観点からみたはてなのAWS活用のこれまでとこれから｣でした. wtatsuru.hatenadiary.com ｢手順書｣のススメ さて, 早速本題に入っていきましょう. 皆さんは｢手順書｣を書いていますか? 自分はと言うと, 最近そこそこの規模のオペレーションが必要なタスクを担当する機会が多く, その度に手順書を書いて, レビューしてもらってからオペレーションをするようにしています. 例えば, 今年実施した｢はてなが提供するドメインを利用したブログのHTTPS化対応｣のリリースの時は, このような手順書を書いていました: この時は, GitHubのIssueに手順書を用意してい

[papix]

駆け込みで書きました, 良いネタがなかったので最近やった｢手順書｣についてアレコレ書きました

[camellow]

ExcelやWordの使用を強要され、各ステップに必ずスクリーンショット、細かいフォントの違いを指摘されるという地獄みたいな手順書作りを思い出す。

[sasasin_net]

“中止基準や切り戻し方法も定めておく”、ここが最重要。事前に分岐をシミュレーションして、中止や切り戻しだとしても絶対に生還できるようにするのです。

[yoiIT]

SIerだと当たり前だけど、Web系だと手順書作ってないとかあるから恐ろしい。

[bump_sunbear]

一度やった作業はwikiなり何なりにまとめて極力属人化しないように努める。ただ、メンテを怠ると手順書が原因で問題が発生するのでメンテだけはしっかり行う。

[mate_gai]

手順書、確かに面倒ではあるのですが一度作ってしまえば、教育のコストがかからない（自分の業務時間を割かれない）という利点がありますね。人の入れ替わりの激しいところとか特にそう。

[skyfall007]

手順書を書いてみてやたらと説明が長くなる部分は、運用方法自体を見直すきっかけにもなります

[rryu]

リハーサル済みの手順書を実行する時のあの安心感は何物にも代えられない。

[nida3001]

イケイケウェブエンジニアが「手順書はクソ！全てをansible化すべし！」ってブコメ書いて5億スター集めてなかった

[Harnoncourt]

「私が消えても代わりはいるから」と言えるレベルの手順書を用意することを心がけましょう／余命半年という状況から生還した自分がいうと説得力が違うのです(；´Д｀)

[gfx]

よさがある。

[braitom]

手順書の利点、書くときに気をつけることについて。オペレーションの際考えるべきことが減る、中止基準や切り戻し方法も書いておくなど。

[hokkai7go]

中止基準についても書いてあってよいですね。あとサーバだけでなく、実行ユーザー名についても書いておくのが良いなと感じています。

[indication]

切り戻し手順も難しい

[morygonzalez]

繰り返し行わない作業はコード化できないかするメリットがなく手順書化した方がいい。これを wiki にして属人性が云々と言ってるのは繰り返し行う作業を手順書化してる疑いがあり、そういうのはコード化した方が良い。

[tesla_quet]

手順書を書くと曖昧なところが炙り出されて良いのだ。ってのと手順書通りに何も考えずに出来るように洗練できたら今度はその作業の自動化を検討するといいよね。あと自動化しても手順書は残すこと。

[type99]

最初の上司は「マニュアル人間になるから手順書作るなソース読め」と言った。次の上司は「手順書は作れ、しかしコマンドは記述せず抽象化して書け」と言った。皆こっそり自分専用の手順者を書いてチームは崩壊した。

[nakag0711]

そもそもWindowsなんかは一定の順序でインストールしないとバグが出るとか他のコンポーネントを認識しないとかで動かなくなるアプリなんて当たり前だから検証済みの順番で作業しないと何が起こるかわからぬ

[K-Ono]

おっと、WinShotインストールしなきゃ。

[momonga_dash]

手順書…うっ…頭が…

[umai_bow]

手順書は書くことは簡単なんだけど、それが存在することを周知するのが難しい

[shin0O]

ささっとチェックリスト作れるのでmd手順書は良い

[kura-2]

ちゃんと１から書くのもあるし、断片揃っていたらまとめてコードにしちゃうのもある。

[natu3kan]

手順書もプログラムと同じで、最初の製作に時間かかるけど。何度も起こる反復動作を同じ精度でやらせるには有効な方法。技術の更新とかで手順が変わる可能性があるから手順書の定期的な更新やメンテも必要か

[sionsou]

二度と再現できないサーバー環境とか開発環境とか多くてね・・・今の会社もいっぱいマニュアル作って更新してるよ。てか大事なのは失敗してもリカバリー出来ることと、変更があったら継続更新すること。

[hatomugicha]

手順書が無いのは論外だし手順書をメンテしないのも論外だし、手順書が属人化して1人が作る文化は仕方なくても論外で、結果を想定しやすい情報系と想定し辛くて危ない科学化学土木建築系と分野の違いを理解したい

[YaSuYuKi]

物理作業のように、現代の技術では自動化困難なものもあるので、作ることは不可欠。また、自動化の際の指針にもなる

[kaorun]

手順書はある種のUndo/Redoバッファである、という学び。

[kamayan1980]

手順書を作るのが大変なのは最初の一回目だけで、二回目以降は一回目のコピー＆変更ですぐ作れるのでオススメ。書類作業だから嫌がるエンジニア多いけどね。

[ykore52]

ボタンクリック１つまで手順書に落とすようなSI式手順書は馬鹿馬鹿しいといつも思ってるけど、どんな人材が来るか分からない現場だと低スキル者に合わせざるを得ないのでツラみがある。読み手に合わせて作ることが重

[hisawooo]

手順書の手順書だ

[atori07]

SIerでは手順書だらけ

[otihateten3510]

苦手なんだよなあ　ネットに溢れてる分かりやすい記事って手順書として良く出来てるよね

[manaten]

技術に特化したエンジニアだと、手順書や動作確認を軽視したり、書いても不備だらけだったり他人が理解できなかったりするよのなあ。手順書作成の手順書が必要

[honeybe]

自動化出来るところは自動化すればよいし無理な所は手順書書く。あと自動化するにあたって一度手順書に書き出すと要件整理されてよい。 / 体裁にこだわり出すとクソになるのはどのドキュメントでも共通。

[ot2sy39]

問題は、3年に1回の作業とかで、2年後にシステムに変更が入って手順書修正する必要があるのに誰も気づかないってヤツ。

[aoki789]

手順書の棚卸しも必要ですよね

[k_ume75]

自分用に手順書書いてるけど（すぐ忘れるので）、「トラブルが起きた時悩まずに判断」できるのいいな！そーゆーのもちゃんと書いておこう。