メインコンテンツへスキップ
見出し画像

手順書どおりに進めた。それでも作業は失敗した。見落としていた「前提条件」

    手順書には、設定ファイルを変更し、サービスを再起動し、動作を確認すると書かれている。作業者はその順番で進め、コマンドも間違えていない。それでも再起動後にサービスが正常に動かない。

    こうしたとき、まず疑うのは手順の途中ではないでしょうか。コマンドを間違えたのではないか、手順を一つ飛ばしたのではないか、入力値が違ったのではないか。もちろん、それらは確認すべきです。

    ただ、原因が「手順1」より前に存在していることもあります。

    そのサーバーのOSやバージョンは、手順書が想定しているものと同じだったのか。必要な権限はあったのか。接続先は正しかったのか。関連サービスは正常だったのか。証明書は有効だったのか。

    作業失敗は、間違った操作をしたときだけ起きるわけではありません。操作自体は正しくても、それを実行した条件が違えば、期待した結果にならないことがあります。

    手順書を守ることは大切です。ただ、手順書が正しいことと、今その手順を実行してよい状態であることは別です。

    正しい操作を、違う条件で実行していないか

    たとえば、手順書に「サービスを再起動する」と書かれていたとします。文章だけを見れば、やることは明確です。

    しかし実際には、その一行の前に多くの条件があります。

    対象サーバーは正しいか。現在のユーザーに必要な権限があるか。対象バージョンは手順書と一致しているか。依存しているサービスは正常か。設定ファイルは想定された場所にあるか。問題が起きた場合に戻せる状態になっているか。

    つまり、「サービスを再起動する」という一文は、実務上、それらの条件が成立していることを前提にした操作です。

    手順書に書かれた「何をするか」は、「どの条件ならそれをしてよいか」と組み合わさって初めて意味を持ちます。

    Splunkで見落としていた「証明書の期限」

    ディーシステムの運用ナレッジにも、前提条件の重要性が見える事例があります。

    記録されているのは、Splunkの内部証明書が期限切れになっている状態で、Confファイルなどへの設定変更とサーバー再起動が行われ、その後、サーバー上の多くの機能が利用できなくなる事象が発生したケースです。

    この事例について、「正式な手順書を一字一句守っていたのに障害が起きた」と確認できているわけではありません。また、証明書の期限切れだけが唯一の原因だったとも断定できません。

    それでも、ここから読み取れる運用上の示唆があります。

    設定変更や再起動という操作だけを見ていると、その前から存在していた「証明書の状態」は見えにくくなります。操作そのものではなく、操作を始める前の環境状態が、その後の結果に影響していた可能性があるということです。

    現在のナレッジでは、server.pemを対象にOpenSSLを使ってnotAfterを確認し、証明書の有効期限を見る方法が整理されています。期限切れの場合には、証明書の削除、Splunkの再起動、自動生成された証明書の確認、新しい有効期限の確認までが記録されています。

    Splunk自身も、TLS証明書の更新や交換を独立した運用事項として扱っています。

    Splunk|Steps for securing your Splunk Enterprise deployment with TLS

    ここで重要なのは、再起動の方法を知っているかどうかだけではありません。操作を始める前から存在していた状態が、その後の結果を左右することがあるという点です。

    Prerequisitesは、特別な運用ルールではない

    「前提条件を確認する」というと、慎重な現場だけが行う特殊なルールのように聞こえるかもしれません。

    しかし、大手クラウドサービスの公式手順を見ると、Prerequisitesはごく普通に登場します。

    AWS CodeDeployでEC2インスタンスへデプロイする場合、AWSの公式ドキュメントでは、IAM instance profile、必要なアクセス権限、対象インスタンスのタグ、CodeDeploy Agentなど、デプロイ前に整っているべき条件が示されています。

    AWS|Configure an Amazon EC2 instance to work with CodeDeploy

    つまり、「どうデプロイするか」を知っているだけでは不十分で、そのEC2インスタンスが、そもそもCodeDeployでデプロイできる状態になっているかを確認する必要があります。

    Azure Bastionにも同じ構造があります。

    Microsoftの公式ドキュメントでは、専用構成で利用する場合にAzureBastionSubnetというサブネットを用意し、必要なサイズやネットワーク条件を満たすことが求められています。

    Microsoft Learn|Azure Bastion の構成設定について

    「Azure Bastionを作成する」という操作だけを知っていても、その前提となるネットワーク構成が違えば、同じ手順は成立しません。

    AWSでもAzureでも、操作方法の前に成立条件があります。Prerequisitesは単なる注意事項ではなく、手順そのものを成立させる一部だと考えた方が、実態に近いでしょう。

    前提条件を6つに分けてみる

    では、実際の運用では何を確認すればよいのでしょうか。

    すべての作業に同じチェックリストが使えるわけではありませんが、前提条件は大きく六つに分けて考えることができます。

    一つ目は環境です。OS、バージョン、ミドルウェア、ファイル配置場所、実行場所などが該当します。同じコマンドでも、OSやバージョンが違えば挙動が変わることがあります。

    二つ目は権限です。ログインユーザー、管理者権限、IAM、ファイルアクセス権、ネットワークアクセス権などがあります。

    三つ目は対象です。hostname、IPアドレス、対象サーバー、本番環境か検証環境か、どのサービスを対象としているのかを確認します。

    四つ目は依存関係です。Agent、ネットワーク、マウント、外部接続、関連サービスなど、その処理が成立するために必要なものです。

    五つ目は状態です。証明書の期限、サービスの稼働状態、ジョブの状態、接続ユーザー、バックアップ状態などがあります。

    六つ目は作業条件です。作業時間帯、関係者への周知、バックアップ、ロールバック、開始条件、中止条件、成功判定などです。

    重要なのは、この六分類を暗記することではありません。

    今回の手順が、どのような状態を前提として作られているのかを、作業前に確認できることです。

    whoamiとhostnameが教えること

    前提条件という言葉は抽象的ですが、現場での確認はもっと具体的です。

    ディーシステムの運用ナレッジでは、アカウントを切り替えたあとにwhoamiを実行し、現在どのユーザーとして操作しているのかを確認することが記録されています。

    また、リモートサーバーへ接続した際には、hostnameやipconfig /all、whoamiなどを使って対象を確認します。

    こうした確認は、一見すると単純です。

    しかし、手順書に書かれたコマンド自体が正しくても、違うユーザーとして実行していたり、別のサーバーへ接続していたりすれば、同じコマンドでも別の作業になります。検証環境のつもりで本番環境へ入っている場合も同じです。

    だから確認すべきなのは、「何を実行するか」だけではありません。

    どこで、誰として実行するのかまで含めて作業になります。

    同じインストーラーでも、「どこから実行するか」が違う

    ソフトウェアのインストールにも、同じ考え方があります。

    ディーシステムのナレッジでは、ZIPファイル内から直接実行せず、いったん解凍すること、ローカルフォルダへ配置すること、OneDriveなどの同期フォルダから実行しないこと、必要に応じて管理者権限を利用することなどが記録されています。

    実行するファイル自体は同じでも、どこから実行するのか、どの権限で実行するのかによって結果が変わる可能性があります。

    「このインストーラーを実行する」という一つの操作にも、実行場所や権限という条件が含まれています。

    バックアップ処理が正しくても、バックアップできるとは限らない

    バックアップも分かりやすい例です。

    手順書に「NASへバックアップする」と書かれていて、バックアップコマンドも正しかったとしても、NASへアクセスできなければ保存できません。マウントされていなければ書き込めず、書き込み権限がなければバックアップは成立しません。

    ディーシステムの運用ナレッジでも、バックアップ前にNASへのアクセス、mount状態、書き込み権限などを確認する考え方が整理されています。

    ここでも、処理自体の正しさと、その処理が成立する環境は別です。

    「バックアップを実行する」と「バックアップできる状態になっている」は、同じではありません。

    手順書は「条件付き命令」と考える

    ここまでを整理すると、手順書の見え方も少し変わります。

    たとえば「サービスを再起動する」という一文は、そのまま読むと単純な操作命令です。

    しかし実務では、対象サーバーが正しく、必要な権限があり、関連する状態に問題がなく、バックアップや復旧条件も成立していることを前提として実行します。

    プログラムに置き換えるなら、操作の前にいくつものifが付いているようなものです。

    手順書の一行は、実際には「もし前提条件A・B・Cが成立していれば、操作Xを行う」という条件付きの命令だと考えられます。

    この見方をすると、前提条件の確認は作業前のおまけではなく、操作そのものを成立させる工程になります。

    良い手順書は「何をするか」だけを書かない

    ここで、作業者側だけでなく、手順書そのものにも視点を移してみます。

    作業者に「手順書をよく読んで注意してください」と言うだけでは、運用品質を個人の注意力に依存させることになります。

    重要な作業であれば、対象環境や対象バージョン、必要権限、依存関係だけでなく、開始条件、バックアップ、成功判定、中止条件、異常時対応、ロールバックまで共有されていた方が、作業者は「進めてよい状態」と「止まるべき状態」を判断しやすくなります。

    ディーシステムでも重要作業では、アクセス権限、資材配置、バックアップ、詳細手順、ロールバック、異常時判断、作業前後のテスト、正誤判定などを作業計画の中で整理しています。

    実際の作業も、開始条件を確認し、操作し、結果を確認して、成功条件を満たしたか判断するという流れになります。異常があればそこで中止し、必要に応じてロールバックやエスカレーションへ移ります。

    NIST SP 800-128でも、構成管理におけるbaseline configurationは、将来のbuild、release、changeの基準となる構成として扱われています。

    NIST|SP 800-128, Guide for Security-Focused Configuration Management of Information Systems

    変更後の状態だけを見るのではなく、変更前にどのような状態だったのかを把握することにも意味があります。

    前提条件の確認は、今の実環境が手順の想定している状態と一致しているかを見る仕事とも言えます。

    良い手順書は、次に何をすればよいかが詳しいだけではありません。

    どの状態なら始めてよく、どの状態なら進めてはいけないかまで分かることが重要です。

    「この条件では進めない」と言えるか

    運用の仕事では、手順書を最後まで終えることが成功に見えがちです。

    予定していた作業をすべて実施し、時間内に完了し、チェック欄を埋める。それ自体はもちろん大切です。

    ただ、本番環境では別の能力も必要になります。

    作業を始めようとしたら、バージョンが想定と違っていた。hostnameが違った。必要な権限がなかった。証明書が期限切れだった。バックアップが取れなかった。

    そうした状態に気づいたとき、手順書の続きをそのまま進めるのではなく、「この条件では進めない」と判断する必要があります。

    作業そのものは予定どおり完了しません。

    それでも、予定外の条件で変更を進めなかったという意味では、正しい運用です。

    ディーシステムの前提条件チェックでも、実際のサーバーやサービスについて画面やコマンドで条件を確認し、想定と異なる場合は作業を中断して関係者へ確認する考え方が整理されています。

    本番運用では、予定どおり進められることだけが技術ではありません。

    予定と違う状態を見つけたときに止まれることも、運用者に求められる判断の一つです。

    前提条件を、注意力ではなく工程にする

    この話を、「ベテランなら事前に気づける」で終わらせるべきではありません。

    経験豊富なエンジニアは、バージョンは合っているか、このユーザーでよいか、証明書は切れていないか、バックアップ先へ書き込めるか、といった条件を頭の中で確認しているかもしれません。

    しかし、その確認が個人の経験だけに依存していれば、チーム全体の運用品質にはなりません。

    だからこそ、前提条件を確認する行為自体を工程にする必要があります。

    OSやバージョンを確認する。whoamiを実行する。hostnameを見る。証明書期限を確認する。バックアップ可能な状態を確かめる。そして条件が違えば止まる。

    AWSやAzureの公式ドキュメントがPrerequisitesを明示しているのと同じように、現場の手順書や作業計画でも、作業を始めてよい条件を見える形にしておく。

    前提条件は、経験者が頭の中で覚えておくものではなく、誰でも確認できる工程へ移していく方がよいでしょう。

    そうすることで、「もっと注意してください」以外の方法で事故を減らすことができます。

    AIが手順を作れる時代にも、前提条件は残る

    生成AIを使えば、コマンドや設定例、インストール手順、トラブルシューティング方法を短時間で調べられるようになりました。

    「何をすればよいか」を得るコストは、以前より下がっています。

    ただ、そのコマンドを今このサーバーで、このユーザーとして実行してよいのかという判断は残ります。

    AIが一般的に正しい手順を示したとしても、実環境のバージョンや権限、接続先、証明書、依存サービスが違えば、そのまま適用できるとは限りません。

    AIが「何をするか」を教えやすくなるほど、今その操作をしてよい条件なのかを確認する仕事の意味は、むしろ分かりやすくなるのかもしれません。

    正しい手順を、正しい条件で実行する

    手順書があれば、作業者は考えなくてもよい。

    そう捉えてしまうと、手順書に書かれていない環境の差を見落とします。

    実際のシステムは、OS、バージョン、権限、接続先、ネットワーク、証明書、その瞬間のサービス状態など、さまざまな条件の上で動いています。

    だから、手順書を守った上で、「次の操作は何か」だけではなく、その手順を今実行してよい状態なのかまで確認する必要があります。

    条件が違えば、そこで止まる。必要なら手順を見直し、関係者へ確認する。

    そして、そうした判断を個人の注意力に任せず、開始条件や中止条件として手順書やナレッジへ残していく。

    手順書とは、人が考えなくて済むようにする文書ではありません。どの条件で実施し、どの条件なら止まるべきかまで共有する文書でもあります。

    正しい手順を、正しい条件で実行する。それもまた、運用の仕事です。


    次に読む記事

    設定変更は、変更する前から始まっている

    作業前に前提条件を確認したら、次は変更前後の状態をどう残し、何をもって作業完了とするかを決める必要があります。

    Before、Change、Afterという考え方から、設定変更を安全に進めるための実務を整理しています。


    問題が起きたあと、最初に何を確認するのか

    前提条件を確認して作業しても、問題が起きる可能性をゼロにはできません。

    障害発生後にログを読み込む前に、まず「再現するか」を確認し、事実を切り分ける理由を紹介します。


    そもそも、なぜシステム全体を理解してから変更する必要があるのか

    個別の手順や前提条件だけでなく、その変更がどの処理や周辺システムへ影響するかを判断するには、構成全体の理解が必要です。

    改修前にシステム構成を調べ、当初案より影響の小さい方法へ変更した実例を紹介します。


     
     
    現場に眠る経験や判断を、AIと仕組みで組織資産へ変えるIT・DX支援会社です。 製薬・ライフサイエンスを中心に、ERP、IT運用、業務改善、生成AI活用を支援しています。 品質・文書管理・業務知識で培った実践をもとに、利益改善、人材育成、離職防止の成長課題にも取り組んでいます。

    あなたへのおすすめ