#381 作業手順書どう作ってる?
2025/8/13 ·
-
この番組はエンジニアの成長は楽しい学びからおもっとうに日々インプットした話題をWi-Fiをお届けするラジオになっています本日もお届けしてまいりましょうお願いします本日なんですけどちょっとトークテーマ持ってきた系なんですが作業手順書っていうものあるじゃないですかいわゆる本番環境に対して何か操作するときの手順書
-
本番環境に対して何か操作する時の手順書はいインフラ的な方向ですかねまあそうですね確かにいやどっちもあるですね例えば管理画面操作する時の手順書あるかもしれないマニュアルって意味じゃなくて設定変更するための手順書みたいなおー
-
AWSコンソール操作する手順もあるかもしれないですね確かに作業手順書って今のりさんに言われて思ったのがマニュアルみたいなのもあり得るしあとはチーム内に展開するこういう設定するときはこうやるといいよみたいな手順書もあったりするんですけど今日話したいのは本番作業やるときの手順書
-
のイメージですで僕今新卒で入った会社で出向してたりとかするんで今2社目なんですけど会社自体は今1,2,3,44つ目なんですね結構会社の色出るなと思ってて色ってか個性一緒かはい
-
と思っててちょっと世の中の手順書というかなんか皆さんどんな感じでやってましたっていうのをちょっと話せると面白いかなっていうのでなるほどね絶対色出るなこれそうですよね僕多分画流でしかやったことないっすねなんか会社とかチームでとかでもなくなんかそういうフォーマット特になくてはいはいはいなんか作った系は大体
-
こう書いとけばわかるっしょっていうフィーリングで書いてることしかないですねなるほどそれも大いにあると思うんですよ何に書いてるとかフォーマットどうしてるとかあとは手順書作るときに意識してるというかここを押さえて作りたいよねみたいなものをすり合わせていって
-
最後にインターネット上の情報を見てなるほどなるほどってやって終わる回にはいなるほどっていうので順番にこんなことしてますみたいなのを言っていきたいなと思うんですがいつも通り順平から話してって言っても言い切れたりするもんですじゃあ行ってみちゃいますか行ってみちゃってください僕もそうですね三現場経験して確かに色はある2種類ですかねいやうー
-
3種類ぐらいかもしれない1個はExcelまずどのプラトンというかサービスでやるかみたいなところで言うとExcelとワードもあったかワードもあってワードってどうなってるんだもう自分で箇条書きみたいな段付けてこうやってこうやってみたいな感じで書くタイミングもありましたね
-
パワポもあってあとあれだ3つ言いましたが4つでしたプロジェクトのGit上のプロジェクトの中でそういうドキュメントファイルを作るマークダウンってこと?デプロイメントMD.MDとかのを作る4パターンがあったかな
-
エクセルのやつは一番最初の現場でウォーターフォールの現場で本番用に適用するためのドキュメントでしたね今まで経験してきたというよりはじゅんぺいがそれを受けて今作れって言われたらどうするみたいな話
-
のがなんか分かりやすいかもこういうのあったな話はちょっと面白かったわだからそれは言いつつでそうですね僕も今まで書いてきてベースある中で書いていくもそうですしゼロから作ったパターンもあるんでただその中で今まで自分の中でフォーマットがあったかって言われると特になくってみんなが滞りなく作業できるようにっていう思想で基本書いてると思いますねで
-
大体書いてるのがやっぱり背景も最初の方に書くかもしれないですね何のためにこれ用意してるのかとかうん書いてる気がするなあと実際作業手順を分かりやすくって言ったらあれなんでそこの部分もちろん詳細にですよねまあそうね言語化されてればいいかな分かりやすいって何があったら分かりやすいと思ってるかみたいな確かにそうですね
-
手順をもちろん完成したらレビューしてもらうと思うんでそのレビューの際にそこに今回実施する作業に対して知見がない人にできるだけレビューをお願いしていて僕はほうなのでそんな人でもつまらずに作業が完了できるみたいなところを目安に置いてるかもしれないですなので画面にも例えばユーザーっていう言葉が
-
ユーザーって最後伸ばす棒あるパターンと最後伸ばさないユーザーパターンとかあるじゃないですかこういうちょっと細かい一時の違いとかでも超厳密な人ってあれこのボタンじゃないのかなとかって思っちゃったりすることもあるなと思ってるんですよそういう厳密さとかは結構守るようにはしてますねドキュメントとかだとはい
-
っていうところかなあとはまあ諸々ある注意事項とかは忘れずに最後に書いたりとかですかねざっと話すとうんうんうんなんか項目ってどういう流度で分けてる項目っていうか1ステップっていうのなるほど1ステップ場合によるとかもあるかもしれないけどそうですねできるなら一問一答みたいな感じの方が分かりやすいのかなと思ってて
-
でも一問一答が言いたいことだよね例えばワンステップワンアクションだけにするっていうの複数アクションをワンステップに入れないみたいなイメージなのかなそうですね複数あっちゃうとやっぱ漏れちゃうことってあると思うのでできるだけですけどねそうはいかない時もあると思うんでなるほどなんか追加で聞いちゃうんですけど例えばLinuxコマンドを
-
実行する手順とかってあるじゃないですかサーバーに対して設定する系とかああいうのってコマンドをまとめるか絶対まとめないかそれは難しいけど僕ここ非常に議論ポイントだと思ってる僕はできればまとめない方がいいかなって思ってますねその時ってドキュメント内でコードブロックにする
-
ですよ僕はコードブロックにした時にまとめてるとコピーボタンを全部コピーされちゃうじゃないですか僕はそれ個人的にはあんま好きじゃないんで一行ずつコピーできるようにできるだけしたいですがそれがあまりにもバーっていっぱいあるんだったら分けるの微妙かもなって思ったりしますねその境目なんかあるの基準
-
多分感覚だと思うよちょっとコードスメルじゃないけどさこんだけあるとなんか1個に分けるとうぜえなーっていうのがあるのかなと思ってるんだけど5個ぐらいあったらちょっと多いなって思っちゃうかもしれないですねなるほどね感覚ですけどあとは1行あたりに1行ワンステップに書く項目ってどんなのある手順書く手順には例えばエトセスラエトセに
-
チェンジディレクトリするっていうステップがあったとしてもっといい例え欲しいけどもっといい例え欲しいけどあったとしてそのステップに何を書きますかおーえすらえたぜチェンジディレクトリマジでいい例え欲しいなんかないかな設定ファイルに技術追加するみたいなあーはいはいはいじゃあ設定.yamlに
-
設定.yamlに順平トゥルーっていう設定を入れる設定の有効化とかは考えないでファイルの編集だけを思ったときにどういうステップにしますか多分これまでのコンテキストでターミナルをいじってる感じになってるんじゃないかと予想してるんですか開いてるところからそうなるとそこを開いてくださいみたいな手順はもちろん書かずにそこの
-
設定.yamlに順平トゥルーにするコマンドをコードブロックで貼っておいてエディターで編集する感じですかemaxかviかターミナル上でその設定.yamlにそれだとやりづらいのかセドとかそういう系でやろうとしてる?してましたなるほどセドだとどうなるんだ?マツビに入れる以外ってどうやってやるんでしょう?えっと
-
目的の行の上の行とかをキャプチャしてその行のコピープラス開業して次の行に文字つけるみたいなことできるんじゃない?なるほどちょっとやりづらいですね手順としては結構いいんじゃないかなと思ってビムとかのやつで書いた時に書き方むずくない?設定ファイルが100行ぐらいあった時にどこまでコードブロックの中に書こうみたいな
-
全部書くとコードブロック長すぎるけど省略するときに相手がギリギリ分かりやすいレベルの長さにしなきゃいけないなプラス設定ファイルの中にここが追加ですよっていうのを表さなきゃいけない感じもまたちょっとめんどくさいよね一方で確認者が確認しやすいのはあるかもしれないですねやることがシンプル漏れが出る可能性はありますけどねもちろんコマンド
-
間違えてた時に気づけないみたいなここもセドでやるのが理想ですけどね一旦何かのコマンドがあって何かのコマンドこれをやってくださいみたいなコードブロックがあります実行してもらったらそのコードブロックがあって次は実際に挿入されたかどうかそのファイル編集されたかどうかを確認するコマンドをバーンって置いて
-
このコマンドはその結果を確認するコマンドですみたいな書いてOKそうだったら次の手順に進んでくださいぐらいの感じかなと思いましたOKそうだったら次の手順に進んでくださいっていうのってどう表現するんですかドキュメント上手順の中にそれが書いてるイメージですか実行コマンドの下ぐらいに今思ったのは言った後であれなんですけど多分文言書くならそのコードブロックの上かなって思いましたね
-
正道で順平トゥルー入れました次のコマンドを実行すると実際にできたかどうか確認できます次のコードで実際にできたかどうかを確認してくださいコードブロックで確認するコマンドでキャットか何かで出すのかできなかった場合は上に戻らせるのかまた別の対応策のコマンドがあればそれを貼るみたいな感じになるかな
-
うんうんうんはいありがとうございますトップバッター多分なんか今言えてないところもいろいろある気もするけど一旦こんなもんにしておきましょうかその角度あったわって絶対後から出てくるからはいノリさんもいいですかえーとですね僕はあの
-
割とLLM以前と以後で分かれてたりするんですけどまず従来だったら僕は結構パワーポイントキーノートとか使うことが多かったですねさっきの例で出てきたLinuxコマンドとかってやるならまたちょっと多分ドキュメントの形式変えると思うんですけど僕作ってた手順書結構GUIで操作する系の手順書多かったんですよなるほどなんで僕のスタイルはもうだいたい決まってて
-
画面に動きがあるたびにスクショして何をしなきゃいけないかをテキストでセットにするみたいなのをスライドショーを作るみたいな感じのイメージが多かったですねだから手順書を読む相手が僕その全然職でなんて言うんでしょうね上司室の外注みたいなことをやってたんですけどその
-
作業で手順書作るってなった時に読むのって大体そのクライアントの中で作業を担当する人とかなんですよへーその人って別にエンジニアじゃない人が多いというかエンジニアだったらあんまりそういうの外注しないんでちょっとパソコンに詳しいエンジニアじゃない人みたいなのが読むことが多いんですねうんうん
-
なんでその人たちがやっても作業できるようにっていうことでもう絶対間違いない方法って見た目でやるっきゃないでしょって思っててっていうのがあるんでスクショプラス文章で1ページに対して1アクションで何かしらのサースを操作することが多いんですようんうんうんうんなので例えばなんでしょう
-
セールスフォースみたいなセールスフォースとかお名前.comとかあとはなんだろうなノーコード系のツールとかを触ることも多いですねここを押してくださいねみたいなショッピファイの管理画面とかもありますねなのでまずページ遷移は絶対ワンスクショプラス何かクリックしなきゃいけないっていう時は画像にちゃんと赤枠でどこクリックするか分かるようにする
-
赤々のとこクリックしてくださいみたいなでページ遷移せずにモーダル出るケースあるじゃないですかありますね画面の形が画面の形が変わるたびにスクショ撮りますねでそれを一個一個手順にしてスライドショーにしちゃうでそういう系が多かったんでむしろ手順書というか動画で送りつけることもありましたねここを操作しちゃいけますよみたいなおもろうん
-
動画早いな確かに作るのも楽だし簡単な操作ならいいんだけど長くなるとちょっと見返しにくいから細かくいろいろ入力するとかだとコピペできないしそうそうそうそうそこはちょっとケースバイケースでしたねスライドにする方が多かったかなおもろーLLM以後これは完全にGoogle Docsで作ることが多いですねどうやって作るんですか
-
手順をジェミニに作ってもらってドキュメントにエクスポートするんですよGoogleドキュメントにジェミニっぽい部分を極力なくすどういうことですか参照とかどのサイトを参照にしましたみたいなリンク集が下にバーってきたりとかあとなんかLLMっぽいなっていう文章
-
ノリさんっぽいなっていう文章に変えるとか気になるなそれクリックしてくださいとかをクリックするんだよみたいに変えるってこと?そんなね体操のお兄さんみたいなトーンじゃない気もするけどそうですね
-
にじみ出るLLM感をなるべく減らすみたいななるほどGoogleドキュメントに手順書くときってどういうフォーマットになってるんですか?過剰書きなんですか?見出し本文場合によってはコードブロックかリストみたいな感じじゃないですかね
-
じゃあ見出しごとにワンステップがあるみたいなイメージですかねそうそうそうそう見出しごとにワンステップよりはもうちょい細かく分かれてるかも大見出し中見出しぐらいの感じで分かれてるかもしれないあれですか番号付き箇条書きみたいなのでステップが書かれてるイメージですかあーっていう時もあるねうんうんうん大枠はもう見出しで区切られてて
-
目的に応じた大見出しがあってそれをチャンクした中見出しみたいなのがあってその中に必要に応じてリストだったりとかコードブロックが載ってるみたいな感じになるかなLLMにやらせたことないからなんかいいな未来の働き方でやらせたいんだよな本当にディープリサーチ使うといいですよ
-
ちなみになんですけどLLMに手順作らせるときってLLMが読み取れるシステムか何かの手順あとはコマンドでもいいのかコマンド系のやつだってかつ汎用的なやつ
-
はディープリサーチでいいかなと思ってる確かにファイルの場所と中身だけ渡しちゃえばあそうそうそうそうあそうだそこも書き直すねなんかだいたいパスと言わファイルみたいな感じで書かれるからのパスの部分とかその辺とか実際のサーバーの値に書き換えられないなんか置換すればいいだけですしねそうそうそうそう
-
めっちゃやらせてで別に手順の確認は後でやればいいからそうでやっぱねディープリサーチャーハルシネーションが少なくていいっすねそうなんすねだいたい動くえーすごい面白い手順書作成マジ人間の仕事じゃないなって思いながらやってるんでもうね違くなっちゃった羨ましいな確かにめっちゃありだなマークダウンでやりたいなありがとうございますなんか
-
じゅんぺい気になったことが何を下げていた?いや、参考になりますっていうじゃあ僕もう一個聞きたいのが画像の赤枠つけるのってどうやってやってます?僕はプレビューでやってますねやっぱそうですよねあれ最速?あれ最速だと思うだよなスクショ撮って保存する前に赤枠ぶち込んで保存するみたいなちなみにそこもちょっとさらに聞きたいんですけどはい
-
スクショ撮って赤枠つけるまでのステップ1個ずつ教えてほしいですまずコマンドシフト読んでスクショ撮りたい範囲選びますはいマックですねこれそうマックの場合なんですけどそうすると右下にニュって出てきてニュって出てきますねそれクリックしますとニュって大きくなりますそうするとプレビュー開かれるんで右上の謎の丸三角みたいな
-
編集みたいなやつねどんなアイコンだったっけペンマークとかじゃなかったっけペンですね丸にペンが写ってるみたいなそれをクリックすると編集モードになるんでその中から
-
上にアイコン並んでる中に丸と四角が重なってる図形側のところがあってそこから四角ボタンを押すと画面にとりあえず四角がボンって出るんですよあとはそれを位置調整して大きさ調整して色が違ったりとか太さが微妙だなってなったらそこを調整してダウンで保存しておしまいですね
-
なるほどそこ最後だけ僕とちょっと違いました嘘これ一本道じゃないんだ一本道じゃないですそっかでしかものりさんが英語モードで使ってるっていうのが今分かりましたねダンなんですよそこがフィリピンに行った時からずっと英語なんですよなるほど僕ちょっと官僚って言ってたんででえっとじゃあそれでファインダーのなんかデフォルトのフォルダにボーンってスクショがいってデフォルトってデスクトップに行くからはい
-
でそれを手順書にドラッグ&ドロップして貼り付けるみたいなイメージなんですねそうでもとりあえず一通りスクショ取ってから作るかも手順書どれがどれだか分かんなくなんないですかたまになるだいたい順番通りに並んでるからそうですねなるほどなありがとうございますちょっと聞いてよかったです
-
何が違ったんだでもえっと僕もう僕が違うのはそのノリさんと同じ 四角つけるところで一緒ですでその後にコントロールコマンドシフトコントロール読んでクリップボードに部分スクショできるモードにして で今作ったスクショのプレビューをスクショします
-
そうするとクリップボードに乗るんでそれをそのまま資料にペーストしてましたなるほどそれは元の資料元の資料とか元の画像には図形乗ってない形にしたいみたいなそういうこと?いいえ違うの?ドラッグ&ドロップがだるいこれ保存すると一回閉じちゃうじゃないですかドラッグ&ドロップがだるいそういうこと?だるいっていうかそっちの方が楽かもしれないです
-
ただなんか僕は画流でスクショしたやつをさらにスクショするっていうことをやっててこれって本当に合ってんだろうかっていう気持ちをずっと持ってるって聞いてみたその方法にまずたどり着いてなかったですね検討したことなかったそんなコマンドあるんですねそうクリップボードに保存できるよそれはMacデフォルトですかデフォルトだと思うよコマンドシフトコントロール4ってめちゃくちゃ押しにくいな
-
多分わかんないです僕が変えたのかなでも元々ありますクリップボードに保存するスクショは部分スクショの機能があるんで資料にスクショを貼るときは楽スクリーンショットってたまるじゃないですかたまるねあれが嫌なんでしかもファイル名いちいち変えないからどれ消していいやつかわかんないしそれはわかるわチェックめんどくさいから全部消しちゃうんだよね困らないですよね
-
個人的にはこのクリップボードにスクショ保存する方が使うですねレイキャストで貼れるしレイキャストで貼れるんだよちゃんと画像そうなんだ便利だな今見たら入ってましたねレイキャストにレイキャストマジすごいありがとうございますそこが今気になったというか気になったのでありがとうございます最後開地手順書基本的な
-
手順書のフォーマットは表形式が多いですね僕はGUIだったとしてもCUIだったとしてもで作る上で大事にしてるのは何も考えなくてもミスないでできるみたいなやっぱり皆さんと一緒ででこれはなんか僕が作るならみたいな話になるんですけど
-
3列あります1行に1行に3列はい表になってて1行に3列ありますでやること概要を実際にやるアクション確認項目ごめんなさい4列でしたD列まであるってことですねはい
-
やること概要を実際にやる手順確認項目チェックチェックボックスユーザビリティを考慮しているはいなんかそうですねっていうのが多分てか今まで大体そうでしたねチェックボックスいいなチェックボックスいいよあの
-
表だとやってるうちにどの行までやったかわけわかんなくなるんですよ僕はそれが追いやすいけどチェックボックス使いやすいチェックボックスと使いづらいチェックボックスありますけどそうなの?例えばオンラインで同期的に更新されるチェックボックスと更新されないチェックボックスがあるんであーそういうことかで
-
項目的にはそうなってますあとは順平と一緒でワンステップワンアクションを意識してやりたい手順についてはコマンドそのままコピペできるような形でコードブロックにしておくようなイメージですかねあとは小石必要系何かを実行して出力されたのを取っておく必要があるんだったらそれ用の
-
貼り付けてねスペースみたいなのも置いておきますねすごいなってことは基本はスプレッドシート的なのでやってる?スプレッドシートでやんないんですけどやんないんだなんかあのドキュメントツールで表みたいなのを使うことが多いですね
-
ノーシャン的なのをイメージしたらいいのかそうですね大体もしくはアトラシアンジラのやつアトラシアンの製品で手順書作れるやつがあるんですよねあれもなんか表とチェックボックスみたいなのがあってなおかつ確かね記憶違いだったら申し訳ないんですけど手順書とあとなんか
-
作業ログが取れるみたいなやつがあってそういうのを使ってやってた記憶がありますでも大体はドキュメントツールの表みたいなやつを使ってやることが多いですねでなんで何も考えずにやって確認項目が具体的にあってこれがこうなっていること例えばさっきの設定やむる編集するコマンドがあったらキャットキャット
-
あとで入れてとりあえずセットのコマンドについては成功したらOKキャットについてはこの部分がこうなってればOKみたいな何見ればいいか分かるように書く全てが全てできてるかはあれかもしれないですけどっていうのを意識してやってますただ最近手順書作ってるんですけど僕
-
このワンステップワンアクションっていうところにメスを入れたいなと思ってておーあれというのも手順書多いと死ぬほど時間がかかるんですねうーんでお客様の停止時間とか考慮するとその時間を最小限にした方がいいんじゃないかって思うんですよやっぱりなるほどで作業の中で過逆的作業と不過逆的作業があると思っててうん
-
例えばチェンジディレクトリは過逆的作業じゃないですか確かに例えばダウングレードできないやつをアップグレードするのは不可逆的作業じゃないですかうんマジで確認した方がいいのって不可逆的作業だと思うんですよ確かに
-
それゆえちょっと科学的作業の中でも色はあると色じゃないなレベル感っていうんですかもちろんあると思うんですけど人間が認知できる範囲でコマンドまとめてやった方がいいんじゃないかというかコマンドだなとかって思ったりするんですねなるほどある程度こうアンドアンドで区切ってまとめちゃうみたいなはいそうですし複数行
-
同時実行するっていうんですかうんうんうんまあセミコロンかうんセミコロンで繋げますよね繋げるはいセミコロンで繋げてうんっていうのをなんかちょっと最近思う今はワンステップワンアクションでやってるんですけどはいそれゆえめちゃくちゃ時間かかるなっていうそれはもう作る側もやる側もって感じ?あそうそうそうそうそうそうなんか例えばなんですけどCICDってうん複数行一気に実行してるってことじゃないですかうん
-
言うてしまえばあれは不可逆的作業も含まれるんですけどねあれに落とし込めないものについても可逆的作業というかまとめられるものをまとめてなおかつそれに対する確認項目がたくさん過ぎない人間の認知できる7個以内とかもっと少なくて5個以内ぐらいで確認できる単位ぐらいでまとめた方が作業する側も
-
メンテされる側も幸せなのではないだろうかみたいなのをちょっと最近思ったりしますね確かにな誰が読むかが大事な気がするねそうですね確かにノリさんの言ってたような画面操作する系はあれはワンステップアクションであるべきだと思うんですけどねコマンドが結構まとめられてると駆け出しエンジニア的には結構不安な気持ちになった記憶がありますね
-
一気に実行しちゃってこれいいのかなみたいなコマンドって一行ずつやるもんじゃないんかなみたいなあとは一気に実行してるんで何かエラーが出た時の切り分けが別になんですけどね当時の駆け出しエンジニアはなるほどねここぐらいコマンドあって3つ目でこけたらどうしようみたいなとか気持ちありましたね確かにそれもあるよねなんか
-
僕の今喋ってたイメージはステージング環境で検証できてる手順書があるっていうんですかそういうイメージではあったんですけど言うて全く一緒ってことはほぼほぼないと思うんでなんかあった時に切り分けめんどいよねは確かにおっしゃる通りあるかもしれない手があるなとは思う作業者のレベルに応じてなのかなやっぱりね
-
思ったより時間がいってしまったんで最後にキータにあった僕が考えた最強の作業手順書っていうページすごいなんかライトに分かりやすくていいなと思ったんでこちらを紹介して皆さんどう思いますかで終わろうと思いますじゃあちょっとさらっと読んでいくんですけどポイント9つあるんでサクサクいきますねはい
-
1つ目存在しているっていうところで作業手順書ない状態でやるなんてありえないよねっていうのが1つ目ですなるほどね2つ目保存されているこれ作業手順書あるけどちゃんとどっかに保存されていることそうしないと同じような作業があるときに使い回せない
-
みたいなイメージ決まった場所で共有ちゃんとされててそれをみんなが認識してるよねってこと?そうですね3つ目レビューされているこれも大事ですねちょっと本当にカツカツのところだったらレビューしないでいってしまうこともあるのかもしれないですけど最悪リハーサルなのかリハーサル前にレビューしてもらうのが一番ですけどレビューされているのが大事ですよねっていうところだと思います
-
4つ目テストされているですねごめんなさいリハーサルって言ってるのはこっちですねテストはステージング環境で同じ作業やりましょうって話をしてます5つ目出力は全て記録するこれはやれてなかったですけど僕はなるほどと思うんですけどログの自動保存とか
-
あとは画面録画とかなのかな後でこれでやった作業を調査しなきゃいけなくなった時に追跡できるように記録しておきましょうねみたいなことを言ってると思いますそういうことねiTerm2にはログを自動で保存できるんですけどとはいえじゃあAWSのコンソール操作するよねとかっていうところまで入ってくると映像なのかなどうなんでしょうね
-
確かにな画面収録一番手軽だなって思ったりするんですけど僕は6つ目コピペで実行できる
-
これみんな言ってたことですね大事8つ目問題発生時の応急処置が指示されているそれは確かに大事だけどむずいポイントだなこれむずいなと思っててどこまで書くんですかっていう確かにねここ落ちりそうだなっていうのを書いてあげる作成者の優しさで賄われるところかもしれないですねここシングルコートとバックコート間違えそうだなみたいな
-
ちょっとおもてなしがすごすぎるなそうですねコピペしてくれよですもんね確かに例えばですけどなんか
-
システムの状態が思った状態じゃなかった時とかですよねきっとここでシステムが稼働していることっていう確認項目があった時に動いてない場合みたいなエラーが表示されている場合みたいなところは書くのかもしれないですけど多分エラーが起きていた場合ってエラーに対するアクション具体的なのないじゃないですか見ないと分からないじゃないですかどこに連絡するみたいなのが書くのかもしれないですね
-
誰に連絡するみたいなもしくは大声で叫ぶとかねお家で一人でそういうこと最後自動化されているって書いてますね誰でも実行できる手順書はそれって自動化できるから頑張って自動化しましょうってことが書いてますそういうことなるほどね例えばですけどテラフォームとかも対応してないし
-
オンプレとかはそうですね特に対応してなかったりするんでねそれとかどこまでも残るかもしれないですけどこれらを意識するといい手順書になるんじゃないっていうところで出力の記録部分はあんまりやってなかったな思ってたレイヤーの話少なかったな
-
そうですねちょっと心がけ部分ですけど正直あんまり手順書レベルの具体的なフォーマットというかこうあるべきみたいなのって見たことないんで知見ある方いればシェアいただけるとありがたいです多分あれだろうね作業の種類によってフォーマット違いすぎるんだろうな適切なありそうてかなんか思考停止で作るなっていうメッセージかもしれないですねはい
-
じゃあ締めますハッシュタグひまじんプログラマーでSNSネックスでフィードバック募集してますので本日のエピソードの感想とかもしくはこういう情報あるよみたいなのがありましたら共有いただけるとありがたいのでお願いします我が社に伝わる伝統の手順書みたいな誰も読み解けない伝説の手順書みたいな
-
誰も読み解けないダメじゃんないなあとはポッドキャストの説明欄からグーグルフォームで番組の要望・感想・質問何でもお待ちしてますコミュニティできてからそっちで話題が上がるようになって全く来ません確かに
-
それは確かに思ってたわコミュニティで消化されちゃいますねそうなんですよねコミュニティで質問してコミュニティの人がみんなで解決してエピソードにならなかったりしてるんで回収しに行くしかないかもね一旦ストップインターセプトちょっと待って
-
コミュニティの参加リンクもチャンネル説明欄の方に番組じゃなくてエピソード説明欄じゃなくてチャンネル説明欄の方にあるのでお願いします最後にポッドキャストプラットフォームフォロー高評価お願いします待ってますそれではまた次回バイバイやめて!ラーのバグ侵入の特殊能力でマスターザブランチが焼き払われたら闇のスパゲティコードと密結合しているジュンペイチの心までクラッシュしちゃう
-
お願い死なないでじゅんぺうちあんたがここでクラッシュしたら戦法との契約はどうなっちゃうのソースコードはまだ修正の余地があるここを耐えればコードを納品できるんだから次回納期間に合わずデバッグスタンバイ
#381 作業手順書どう作ってる?