SVN運用を属人化させない方法｜「あの人しか分からない」をなくす引き継ぎとドキュメント

SVNのアカウント追加や障害対応を、特定の担当者だけが行っていませんか。構成や設定の理由が共有されていないと、その担当者が不在のときに、権限変更や復旧作業を進められないことがあります。

まず確認したいのは、担当者以外が資料を見て必要な作業を行えるかどうかです。この記事では、引き継ぎに必要な資料と、手順の確認方法、外部へ依頼する範囲の整理について説明します。

担当者が不在になると止まる作業を確認する

構築した担当者が管理を続け、アカウント追加や設定変更の手順を記録していない場合、別の担当者は作業方法を確認するところから始める必要があります。

確認が必要なのは、管理アクセス、バックアップからの復元、権限の説明、OSやSVNの更新です。それぞれについて「誰が実施できるか」「必要な資料はどこにあるか」を確認してください。

引き継ぎの確認項目

次の8項目から、担当者が不在になると進められない作業を確認します。

「いいえ」が付いた項目には、進められない作業と業務への影響を記録します。管理アクセスを利用できない、バックアップから復元できないなど、障害対応を妨げる項目から整えてください。このチェックは、回答数で危険度を判定するものではありません。

引き継ぎに向けて整える5つの作業

1. 資料4点をそろえる

構成、権限、復元方法、連絡先を確認できる資料を用意します。

この4点を、引き継ぎと運用説明の基礎資料にします。監査で使う場合は、求められる記録や保存期間も確認してください。

2. 手順を実行して確認する

手順書には、必要な権限、実行するコマンドやスクリプト、結果の確認方法を記載します。定型作業を自動化する場合も、実行条件と失敗時の対応を残してください。

検証環境で、担当者以外が手順書を使って復元を試します。必要な権限、コマンド、確認方法が足りているかを確かめ、実行日と結果を残してください。確認の頻度は復旧要件や変更頻度に合わせ、構成やバックアップ方法を変更したときにも見直します。

3. 代行する作業を決める

既存の担当者や委託先の中で、アカウント追加、権限変更、障害時の連絡を誰が代行するか決めます。必要な権限を用意し、手順に沿って実際に作業できることを確認してください。

4. 設定の変更履歴を管理する

権限設定やフックスクリプトをバージョン管理し、変更理由をコミットログや変更票に残します。パスワード、秘密鍵、トークンは記録せず、専用の保管先で管理してください。復旧に必要な設定と手順は、対象のSVNサーバーが停止していても取り出せるようにします。

5. 設定変更と同時に資料を更新する

権限や設定を変更したときに、対応する手順書と一覧も更新します。作業の完了条件に資料の更新を含めれば、引き継ぎ時に変更内容をさかのぼって調べる作業を減らせます。

外部へ依頼する作業と自社に残す作業を分ける

OSの保守やサーバー監視など、自社で継続することが難しい作業は外部へ依頼する選択肢があります。契約前に、バックアップ、復元依頼、障害時の連絡、対応時間がどこまで含まれるかを確認してください。

ホスティングを利用しても、利用者の追加・削除、権限の承認、外部連携の設定、社内への周知などは自社側の作業として残ります。提供元との分担を一覧にし、それぞれの担当者と手順を決めます。

まとめ

最初に、構成図、アカウントと権限の一覧、バックアップと復元の手順、障害時の連絡先をそろえます。担当者以外が手順を使い、不足している情報を補ってください。

tracpathの利用や移行を検討している方は、現在の管理方法と、社内で対応が難しい作業をお知らせください。提供サービスで対応できる範囲と、自社に残る作業をご相談いただけます。

→SVN運用・移行について相談する

関連記事

• SVNのバックアップとBCP｜障害・災害から守る運用
• SVNサーバーのOSサポートが終了したら｜やるべきことと移行の選択肢
• SVNサーバーの自社運用、限界はどこ？｜クラウド移行を検討すべきサイン

この記事の著者

株式会社オープングルーヴ／tracpath編集部。バージョン管理サービスtracpathを提供。