Submit Search
Upload
運用ドキュメントの構造化(案)
•
16 likes
•
3,890 views
Operation Lab, LLC.
Follow
議論の叩き台資料のため、逐次更新予定です。 (完成度は低いです。ご了承ください。)
Read less
Read more
Engineering
Report
Share
Report
Share
1 of 26
Download now
Download to read offline
Recommended
2015-10-31 クラウドネイティヴ時代の運用を考える 〜 ドキュメント駆動運用へ
2015-10-31 クラウドネイティヴ時代の運用を考える 〜 ドキュメント駆動運用へ
Operation Lab, LLC.
リーン開発の本質 公開用
リーン開発の本質 公開用
ESM SEC
営業・運用を支える "気付ける" 管理画面
営業・運用を支える "気付ける" 管理画面
Masao Maeda
ペアプログラミング ホントのところ
ペアプログラミング ホントのところ
Takuto Wada
フロー効率性とリソース効率性、再入門 #devlove #devkan
フロー効率性とリソース効率性、再入門 #devlove #devkan
Itsuki Kuroda
運用ドキュメントの分類と構造化
運用ドキュメントの分類と構造化
Hirokazu Hatano
JIRAを使った簡単リリースプランニング
JIRAを使った簡単リリースプランニング
Narichika Kajihara
アジャイルにモデリングは必要か
アジャイルにモデリングは必要か
Hiromasa Oka
Recommended
2015-10-31 クラウドネイティヴ時代の運用を考える 〜 ドキュメント駆動運用へ
2015-10-31 クラウドネイティヴ時代の運用を考える 〜 ドキュメント駆動運用へ
Operation Lab, LLC.
リーン開発の本質 公開用
リーン開発の本質 公開用
ESM SEC
営業・運用を支える "気付ける" 管理画面
営業・運用を支える "気付ける" 管理画面
Masao Maeda
ペアプログラミング ホントのところ
ペアプログラミング ホントのところ
Takuto Wada
フロー効率性とリソース効率性、再入門 #devlove #devkan
フロー効率性とリソース効率性、再入門 #devlove #devkan
Itsuki Kuroda
運用ドキュメントの分類と構造化
運用ドキュメントの分類と構造化
Hirokazu Hatano
JIRAを使った簡単リリースプランニング
JIRAを使った簡単リリースプランニング
Narichika Kajihara
アジャイルにモデリングは必要か
アジャイルにモデリングは必要か
Hiromasa Oka
NVIDIA GPUで作るHeadless X11 Linux
NVIDIA GPUで作るHeadless X11 Linux
Tomoki SHISHIKURA
MLflowによる機械学習モデルのライフサイクルの管理
MLflowによる機械学習モデルのライフサイクルの管理
Takeshi Yamamuro
リアルタイムPoint cloudデータのビジュアライゼーションについて
リアルタイムPoint cloudデータのビジュアライゼーションについて
Ryousuke Wayama
Laravel×DevOps -インフラ構築の自動化から運用ログの監視まで-
Laravel×DevOps -インフラ構築の自動化から運用ログの監視まで-
Shinichiro Yoshida
Web開発者にお勧め .NET MAUI Blazor App
Web開発者にお勧め .NET MAUI Blazor App
TomomitsuKusaba
卒論パワポVer3 伊東純平
卒論パワポVer3 伊東純平
純平 伊東
[DO08] 『変わらない開発現場』を変えていくために ~エンプラ系レガシー SIer のための DevOps 再入門~
[DO08] 『変わらない開発現場』を変えていくために ~エンプラ系レガシー SIer のための DevOps 再入門~
de:code 2017
ソフトウェアにおける 複雑さとは何なのか?
ソフトウェアにおける 複雑さとは何なのか?
Yoshitaka Kawashima
Foss4G Japan 2021 シェープファイルの真の後継規格 FlatGeobufの普及啓蒙活動
Foss4G Japan 2021 シェープファイルの真の後継規格 FlatGeobufの普及啓蒙活動
Kanahiro Iguchi
エンジニアライクにドキュメントを作成してみた件
エンジニアライクにドキュメントを作成してみた件
Mass310
上っ面スクラムチームにならないために気を付けたいこと
上っ面スクラムチームにならないために気を付けたいこと
IIJ
大企業アジャイルの勘所 #devlovex #devlovexd
大企業アジャイルの勘所 #devlovex #devlovexd
Itsuki Kuroda
「運用改善」を考える 〜「自動化」を考える前に
「運用改善」を考える 〜「自動化」を考える前に
Operation Lab, LLC.
モノタロウの1900万商品を検索する Elasticsearch構築運用事例(2022-10-26 第50回Elasticsearch 勉強会発表資料)
モノタロウの1900万商品を検索する Elasticsearch構築運用事例(2022-10-26 第50回Elasticsearch 勉強会発表資料)
株式会社MonotaRO Tech Team
[Slide]闇アジャイラーvs光アジャイラーforDevLOVE(EnergizedWorkLT祭)
[Slide]闇アジャイラーvs光アジャイラーforDevLOVE(EnergizedWorkLT祭)
masashi takehara
機械学習で泣かないためのコード設計
機械学習で泣かないためのコード設計
Takahiro Kubo
Android/iOS端末におけるエッジ推論のチューニング
Android/iOS端末におけるエッジ推論のチューニング
Deep Learning Lab(ディープラーニング・ラボ)
Redmineでメトリクスを見える化する方法
Redmineでメトリクスを見える化する方法
Hidehisa Matsutani
インセプションデッキ:やらないことリストとトレードオフスライダーをやってる話
インセプションデッキ:やらないことリストとトレードオフスライダーをやってる話
Nobuhiro Yoshitake
トランクベース開発を活用して爆速に開発した話
トランクベース開発を活用して爆速に開発した話
Tier_IV
運用設計の必要性と5年後のIT部門の姿について
運用設計の必要性と5年後のIT部門の姿について
UNIRITA Incorporated
設計・構築においてのドキュメントの重要性について
設計・構築においてのドキュメントの重要性について
Takayuki Higashi
More Related Content
What's hot
NVIDIA GPUで作るHeadless X11 Linux
NVIDIA GPUで作るHeadless X11 Linux
Tomoki SHISHIKURA
MLflowによる機械学習モデルのライフサイクルの管理
MLflowによる機械学習モデルのライフサイクルの管理
Takeshi Yamamuro
リアルタイムPoint cloudデータのビジュアライゼーションについて
リアルタイムPoint cloudデータのビジュアライゼーションについて
Ryousuke Wayama
Laravel×DevOps -インフラ構築の自動化から運用ログの監視まで-
Laravel×DevOps -インフラ構築の自動化から運用ログの監視まで-
Shinichiro Yoshida
Web開発者にお勧め .NET MAUI Blazor App
Web開発者にお勧め .NET MAUI Blazor App
TomomitsuKusaba
卒論パワポVer3 伊東純平
卒論パワポVer3 伊東純平
純平 伊東
[DO08] 『変わらない開発現場』を変えていくために ~エンプラ系レガシー SIer のための DevOps 再入門~
[DO08] 『変わらない開発現場』を変えていくために ~エンプラ系レガシー SIer のための DevOps 再入門~
de:code 2017
ソフトウェアにおける 複雑さとは何なのか?
ソフトウェアにおける 複雑さとは何なのか?
Yoshitaka Kawashima
Foss4G Japan 2021 シェープファイルの真の後継規格 FlatGeobufの普及啓蒙活動
Foss4G Japan 2021 シェープファイルの真の後継規格 FlatGeobufの普及啓蒙活動
Kanahiro Iguchi
エンジニアライクにドキュメントを作成してみた件
エンジニアライクにドキュメントを作成してみた件
Mass310
上っ面スクラムチームにならないために気を付けたいこと
上っ面スクラムチームにならないために気を付けたいこと
IIJ
大企業アジャイルの勘所 #devlovex #devlovexd
大企業アジャイルの勘所 #devlovex #devlovexd
Itsuki Kuroda
「運用改善」を考える 〜「自動化」を考える前に
「運用改善」を考える 〜「自動化」を考える前に
Operation Lab, LLC.
モノタロウの1900万商品を検索する Elasticsearch構築運用事例(2022-10-26 第50回Elasticsearch 勉強会発表資料)
モノタロウの1900万商品を検索する Elasticsearch構築運用事例(2022-10-26 第50回Elasticsearch 勉強会発表資料)
株式会社MonotaRO Tech Team
[Slide]闇アジャイラーvs光アジャイラーforDevLOVE(EnergizedWorkLT祭)
[Slide]闇アジャイラーvs光アジャイラーforDevLOVE(EnergizedWorkLT祭)
masashi takehara
機械学習で泣かないためのコード設計
機械学習で泣かないためのコード設計
Takahiro Kubo
Android/iOS端末におけるエッジ推論のチューニング
Android/iOS端末におけるエッジ推論のチューニング
Deep Learning Lab(ディープラーニング・ラボ)
Redmineでメトリクスを見える化する方法
Redmineでメトリクスを見える化する方法
Hidehisa Matsutani
インセプションデッキ:やらないことリストとトレードオフスライダーをやってる話
インセプションデッキ:やらないことリストとトレードオフスライダーをやってる話
Nobuhiro Yoshitake
トランクベース開発を活用して爆速に開発した話
トランクベース開発を活用して爆速に開発した話
Tier_IV
What's hot
(20)
NVIDIA GPUで作るHeadless X11 Linux
NVIDIA GPUで作るHeadless X11 Linux
MLflowによる機械学習モデルのライフサイクルの管理
MLflowによる機械学習モデルのライフサイクルの管理
リアルタイムPoint cloudデータのビジュアライゼーションについて
リアルタイムPoint cloudデータのビジュアライゼーションについて
Laravel×DevOps -インフラ構築の自動化から運用ログの監視まで-
Laravel×DevOps -インフラ構築の自動化から運用ログの監視まで-
Web開発者にお勧め .NET MAUI Blazor App
Web開発者にお勧め .NET MAUI Blazor App
卒論パワポVer3 伊東純平
卒論パワポVer3 伊東純平
[DO08] 『変わらない開発現場』を変えていくために ~エンプラ系レガシー SIer のための DevOps 再入門~
[DO08] 『変わらない開発現場』を変えていくために ~エンプラ系レガシー SIer のための DevOps 再入門~
ソフトウェアにおける 複雑さとは何なのか?
ソフトウェアにおける 複雑さとは何なのか?
Foss4G Japan 2021 シェープファイルの真の後継規格 FlatGeobufの普及啓蒙活動
Foss4G Japan 2021 シェープファイルの真の後継規格 FlatGeobufの普及啓蒙活動
エンジニアライクにドキュメントを作成してみた件
エンジニアライクにドキュメントを作成してみた件
上っ面スクラムチームにならないために気を付けたいこと
上っ面スクラムチームにならないために気を付けたいこと
大企業アジャイルの勘所 #devlovex #devlovexd
大企業アジャイルの勘所 #devlovex #devlovexd
「運用改善」を考える 〜「自動化」を考える前に
「運用改善」を考える 〜「自動化」を考える前に
モノタロウの1900万商品を検索する Elasticsearch構築運用事例(2022-10-26 第50回Elasticsearch 勉強会発表資料)
モノタロウの1900万商品を検索する Elasticsearch構築運用事例(2022-10-26 第50回Elasticsearch 勉強会発表資料)
[Slide]闇アジャイラーvs光アジャイラーforDevLOVE(EnergizedWorkLT祭)
[Slide]闇アジャイラーvs光アジャイラーforDevLOVE(EnergizedWorkLT祭)
機械学習で泣かないためのコード設計
機械学習で泣かないためのコード設計
Android/iOS端末におけるエッジ推論のチューニング
Android/iOS端末におけるエッジ推論のチューニング
Redmineでメトリクスを見える化する方法
Redmineでメトリクスを見える化する方法
インセプションデッキ:やらないことリストとトレードオフスライダーをやってる話
インセプションデッキ:やらないことリストとトレードオフスライダーをやってる話
トランクベース開発を活用して爆速に開発した話
トランクベース開発を活用して爆速に開発した話
Viewers also liked
運用設計の必要性と5年後のIT部門の姿について
運用設計の必要性と5年後のIT部門の姿について
UNIRITA Incorporated
設計・構築においてのドキュメントの重要性について
設計・構築においてのドキュメントの重要性について
Takayuki Higashi
2015-03-27 ザ・運用 ~ 運用とは何か、運用とはどのようであるべきか
2015-03-27 ザ・運用 ~ 運用とは何か、運用とはどのようであるべきか
Operation Lab, LLC.
2015-05-23 クラウドの運用になって インフラエンジニアは何が変わるのか?
2015-05-23 クラウドの運用になって インフラエンジニアは何が変わるのか?
Operation Lab, LLC.
CloudConductorの特長と最新動向(OSSユーザーのための勉強会#7)
CloudConductorの特長と最新動向(OSSユーザーのための勉強会#7)
cloudconductor
20110827 restudy-pyconjp2011
20110827 restudy-pyconjp2011
Hirokazu Hatano
2014-07-26 jawsug-chiba ドキュメントを書こう! 運用自動化時代のドキュメンテーション
2014-07-26 jawsug-chiba ドキュメントを書こう! 運用自動化時代のドキュメンテーション
Operation Lab, LLC.
JAWS-UG CLI #07 VPC
JAWS-UG CLI #07 VPC
Operation Lab, LLC.
2014-12-17 #ssmjp 運用現場における"品質"とは
2014-12-17 #ssmjp 運用現場における"品質"とは
Operation Lab, LLC.
運用現場の過去、現在、未来
運用現場の過去、現在、未来
Hirokazu Hatano
2015-09-01 クラウド時代の運用エンジニアは何が変わるのか
2015-09-01 クラウド時代の運用エンジニアは何が変わるのか
Operation Lab, LLC.
2014-10-27 #ssmjp 腹を割って話そう (運用xセキュリティ)
2014-10-27 #ssmjp 腹を割って話そう (運用xセキュリティ)
Operation Lab, LLC.
安全コンセプトチェックシートの概要(池田博康)
安全コンセプトチェックシートの概要(池田博康)
robotcare
AWSCLI AutoScaling
AWSCLI AutoScaling
Operation Lab, LLC.
API Gateway / AWS CLI
API Gateway / AWS CLI
Operation Lab, LLC.
『運用屋さんのためのVBA入門』 ~ 運用方法論 運用工程設計・自動化概論 〜
『運用屋さんのためのVBA入門』 ~ 運用方法論 運用工程設計・自動化概論 〜
Hirokazu Hatano
cloudpackサーバ仕様書(サンプル)
cloudpackサーバ仕様書(サンプル)
iret, Inc.
PDCAのΠ
PDCAのΠ
Ryo Nagai
PDCAで仕事を進める
PDCAで仕事を進める
junji44
シンギュラリティ以後
シンギュラリティ以後
Hiroshi Nakagawa
Viewers also liked
(20)
運用設計の必要性と5年後のIT部門の姿について
運用設計の必要性と5年後のIT部門の姿について
設計・構築においてのドキュメントの重要性について
設計・構築においてのドキュメントの重要性について
2015-03-27 ザ・運用 ~ 運用とは何か、運用とはどのようであるべきか
2015-03-27 ザ・運用 ~ 運用とは何か、運用とはどのようであるべきか
2015-05-23 クラウドの運用になって インフラエンジニアは何が変わるのか?
2015-05-23 クラウドの運用になって インフラエンジニアは何が変わるのか?
CloudConductorの特長と最新動向(OSSユーザーのための勉強会#7)
CloudConductorの特長と最新動向(OSSユーザーのための勉強会#7)
20110827 restudy-pyconjp2011
20110827 restudy-pyconjp2011
2014-07-26 jawsug-chiba ドキュメントを書こう! 運用自動化時代のドキュメンテーション
2014-07-26 jawsug-chiba ドキュメントを書こう! 運用自動化時代のドキュメンテーション
JAWS-UG CLI #07 VPC
JAWS-UG CLI #07 VPC
2014-12-17 #ssmjp 運用現場における"品質"とは
2014-12-17 #ssmjp 運用現場における"品質"とは
運用現場の過去、現在、未来
運用現場の過去、現在、未来
2015-09-01 クラウド時代の運用エンジニアは何が変わるのか
2015-09-01 クラウド時代の運用エンジニアは何が変わるのか
2014-10-27 #ssmjp 腹を割って話そう (運用xセキュリティ)
2014-10-27 #ssmjp 腹を割って話そう (運用xセキュリティ)
安全コンセプトチェックシートの概要(池田博康)
安全コンセプトチェックシートの概要(池田博康)
AWSCLI AutoScaling
AWSCLI AutoScaling
API Gateway / AWS CLI
API Gateway / AWS CLI
『運用屋さんのためのVBA入門』 ~ 運用方法論 運用工程設計・自動化概論 〜
『運用屋さんのためのVBA入門』 ~ 運用方法論 運用工程設計・自動化概論 〜
cloudpackサーバ仕様書(サンプル)
cloudpackサーバ仕様書(サンプル)
PDCAのΠ
PDCAのΠ
PDCAで仕事を進める
PDCAで仕事を進める
シンギュラリティ以後
シンギュラリティ以後
Similar to 運用ドキュメントの構造化(案)
『これからの.NETアプリケーション開発』セミナー .NET用アプリケーション フレームワーク Open 棟梁 概説
『これからの.NETアプリケーション開発』セミナー .NET用アプリケーション フレームワーク Open 棟梁 概説
Daisuke Nishino
Intalio japan special cloud workshop
Intalio japan special cloud workshop
Daisuke Sugai
ToolChainを使った次世代DevOps環境の作り方
ToolChainを使った次世代DevOps環境の作り方
Harada Kazuki
わんくま東京勉強会#46 Azureセッション資料
わんくま東京勉強会#46 Azureセッション資料
Shinichiro Isago
わんくま東京勉強会#46 Azureセッション資料
わんくま東京勉強会#46 Azureセッション資料
guest628c07
OSC2018 hiroshima session slide by OSSC
OSC2018 hiroshima session slide by OSSC
Daisuke Nishino
concrete5で社内システムのお話し
concrete5で社内システムのお話し
Tao Sasaki
クラウド開発に役立つ OSS あれこれ
クラウド開発に役立つ OSS あれこれ
Masataka MIZUNO
オープンクラウド基盤の価値と導入へ向けた考慮点 〜IaaSからPaaSまで - EMC様セミナー 「あなたのビジネスを高速化!DevOpsとアジャイル開発...
オープンクラウド基盤の価値と導入へ向けた考慮点 〜IaaSからPaaSまで - EMC様セミナー 「あなたのビジネスを高速化!DevOpsとアジャイル開発...
VirtualTech Japan Inc.
オープンクラウド基盤の価値と導入へ向けた考慮点 〜IaaSからPaaSまで - EMC様セミナー 「あなたのビジネスを高速化!DevOpsとアジャイル開発...
オープンクラウド基盤の価値と導入へ向けた考慮点 〜IaaSからPaaSまで - EMC様セミナー 「あなたのビジネスを高速化!DevOpsとアジャイル開発...
Nobuyuki Tamaoki
DevLove Kansai AWS
DevLove Kansai AWS
Takuro Sasaki
IaC化の3つのポイント
IaC化の3つのポイント
山下 達也
JAWS-UG三都物語 クラウドとデバイスが連携するアジェンダ
JAWS-UG三都物語 クラウドとデバイスが連携するアジェンダ
Kenichi Yoshida
Cloud principles and paradigms kimtea-2010-04-24
Cloud principles and paradigms kimtea-2010-04-24
Kazuki Aranami
とあるメーカーのRedmine活用事例
とあるメーカーのRedmine活用事例
agileware_jp
これからのOpenShiftの話をしよう
これからのOpenShiftの話をしよう
Kazuto Kusama
OpenStack Summit Vancouver YVR Ops
OpenStack Summit Vancouver YVR Ops
NTT Communications Technology Development
Azure DevOps と開発管理
Azure DevOps と開発管理
Tsukasa Kato
”試してみた”で終わらない サーバーレスアプリケーションの実践開発
”試してみた”で終わらない サーバーレスアプリケーションの実践開発
Yuta Matsumura
現場開発者視点で答えるWindows Azure
現場開発者視点で答えるWindows Azure
Keiichi Hashimoto
Similar to 運用ドキュメントの構造化(案)
(20)
『これからの.NETアプリケーション開発』セミナー .NET用アプリケーション フレームワーク Open 棟梁 概説
『これからの.NETアプリケーション開発』セミナー .NET用アプリケーション フレームワーク Open 棟梁 概説
Intalio japan special cloud workshop
Intalio japan special cloud workshop
ToolChainを使った次世代DevOps環境の作り方
ToolChainを使った次世代DevOps環境の作り方
わんくま東京勉強会#46 Azureセッション資料
わんくま東京勉強会#46 Azureセッション資料
わんくま東京勉強会#46 Azureセッション資料
わんくま東京勉強会#46 Azureセッション資料
OSC2018 hiroshima session slide by OSSC
OSC2018 hiroshima session slide by OSSC
concrete5で社内システムのお話し
concrete5で社内システムのお話し
クラウド開発に役立つ OSS あれこれ
クラウド開発に役立つ OSS あれこれ
オープンクラウド基盤の価値と導入へ向けた考慮点 〜IaaSからPaaSまで - EMC様セミナー 「あなたのビジネスを高速化!DevOpsとアジャイル開発...
オープンクラウド基盤の価値と導入へ向けた考慮点 〜IaaSからPaaSまで - EMC様セミナー 「あなたのビジネスを高速化!DevOpsとアジャイル開発...
オープンクラウド基盤の価値と導入へ向けた考慮点 〜IaaSからPaaSまで - EMC様セミナー 「あなたのビジネスを高速化!DevOpsとアジャイル開発...
オープンクラウド基盤の価値と導入へ向けた考慮点 〜IaaSからPaaSまで - EMC様セミナー 「あなたのビジネスを高速化!DevOpsとアジャイル開発...
DevLove Kansai AWS
DevLove Kansai AWS
IaC化の3つのポイント
IaC化の3つのポイント
JAWS-UG三都物語 クラウドとデバイスが連携するアジェンダ
JAWS-UG三都物語 クラウドとデバイスが連携するアジェンダ
Cloud principles and paradigms kimtea-2010-04-24
Cloud principles and paradigms kimtea-2010-04-24
とあるメーカーのRedmine活用事例
とあるメーカーのRedmine活用事例
これからのOpenShiftの話をしよう
これからのOpenShiftの話をしよう
OpenStack Summit Vancouver YVR Ops
OpenStack Summit Vancouver YVR Ops
Azure DevOps と開発管理
Azure DevOps と開発管理
”試してみた”で終わらない サーバーレスアプリケーションの実践開発
”試してみた”で終わらない サーバーレスアプリケーションの実践開発
現場開発者視点で答えるWindows Azure
現場開発者視点で答えるWindows Azure
運用ドキュメントの構造化(案)
1.
Operation Lab 運用設計ラボ 運用ドキュメントの構造化(案) 運用設計ラボ合同会社 シニアアーキテクト 波田野
裕一 2014-06-22 メモ書き第2版 議論の叩き台につき未完成 (適宜更新予定)
2.
Operation Lab 運用設計ラボ 主張: クラウド時代の運用ドキュメンテーション •
WhatやHowはコード(Infrastructure As Code)に残るが、Whyは人 が自らドキュメントに書かなければ残らない。 • クラウド時代になって、オンプレミスと比較してあらゆる制約が減少。 制約が無い中で「なぜそうしたか(Why)」を残す重要性が増加。 • 人(Why)とシステム(What/How)が分担してドキュメントを書く時代。 How + Why = KnowHow 実装 設計 運用現場の資産 出典: JAWS-UG東京第22回勉強会「運用自動化時代のドキュメンテーショント」 (2014-06)
3.
Operation Lab 運用設計ラボ 価値基準によるドキュメントの構造
4.
Operation Lab 運用設計ラボ ドキュメントテーマの3類型 時間軸 activity活動 状 態 変化後 変化 変化前 What 何を書く? SCA分析
(仮称) ‣Status(状態) ‣Change(変化) ‣Activity (活動) 出典: Internet Week 2011 「運用ドキュメント2011 ∼手軽にスピーディに継続的に保守するためのツール入門」 Part-1
5.
Operation Lab 運用設計ラボ ドキュメントテーマによる価値 (仮説) activity活動 変化 状 態 •
反復・再利用性の高いドキュメント(資産性ドキュメント)。 • 「変化」「活動」の起点・終点となる最も重要なドキュメント • 何らかの形で売却できる場合「収益性」があると言える。 • 反復作成されるが再利用はしにくい。(費用性ドキュメント) • 「運用の費用対効果」を説明するためのドキュメントとなるた め「収益性」があると考えることもできる。 • 「活動」の蓄積が変化を生む。 • [留意]「変化させない事」が重要とされる業務もある。 • 反復作成されるが再利用はしにくい。(費用性ドキュメント) • コストが直接配賦されれば「収益性」があるが、共通配賦され る場合は、作成自体が「運用コスト」と評価される。 What 何を書く? 出典: Internet Week 2011 「運用ドキュメント2011 ∼手軽にスピーディに継続的に保守するためのツール入門」 Part-1 Quality Delivery Cost Qualityの向上 Deliveryの改善 活動=Cost
6.
Operation Lab 運用設計ラボ 6つのドキュメント要素 activity活動 変化 状 態 /activity.rst
/change.rst /define/ 人による活動情報 人による変化情報 • ドキュメントを利用する活動のト ラッカー • ドキュメント自体のトラッカ (更 新、要望) • 変化(実績)レポート (外部) • ドキュメントのリポジトリ(web) 人による状態情報 費用性ドキュメント 収益性ドキュメント 資産性ドキュメント バージョン管理の対象 システムの状態情報 システムによる随時更新 実装 設計 Why What How 「振り返り」(顧客レポートや考課に活用) 「事業継続性」「再現性」「反復性」などの基盤 システムの変化情報システムの活動情報 インクルード対象 インクルード対象 インクルード対象 • ログ • アラート • MRTG/DDR • CloudWatch • CloudFormation • OpsWorks (Chef) • AMI情報、など 「説明責任」(証拠、エビデンス) Quality Delivery Cost インクルード対象 QCD(F)のための基礎情報 議論ポイント 議論ポイント 議論ポイント
7.
Operation Lab 運用設計ラボ 運用ドキュメントの構造 状 態 人による状態情報 バージョン管理の対象 設計 Why ヒトによる資産性ドキュメント
8.
Operation Lab 運用設計ラボ 余談: サービスの立ち位置
(「設計」の最上位) ミッション ポリシー サービス 理想 制約 現実的な落しどころ ここまで書けるか? /define/mission /define/policy /define/service 対立
9.
Operation Lab 運用設計ラボ サービス サービス運用アーキテクチャの全体像 (仮説) 作 業 カ タ ロ グ サ ー ビ ス カ タ ロ グ リソースカタログ 運用フロー ライブラリ 情報
要員 予算 OperatorUser 人による状態情報
10.
Operation Lab 運用設計ラボ 「人による状態情報」ドキュメント構造 /define/service/ service-catalog/ ユーザが利用する公式情報 resource-catalog/ work-catalog/ サービスカタログ
作業カタログリソースカタログ リソースに関する公式情報 運用現場が利用する情報 インクルード インクルード • 第1レベル: リソース別 • 第2レベル: 利用形態別 • API • CLI • WebUIなど 運用フロー ライブラリ インクルードインクルード lib/
11.
Operation Lab 運用設計ラボ システムの状態情報の構造 状 態 システムの状態情報 システムによる随時更新 実装 What How システムによる資産性ドキュメント 議論ポイントインクルード対象
12.
Operation Lab 運用設計ラボ 「システムによる状態情報」ドキュメント構造 /define/service/resource-catalog/automation/(シンボリックリンク) • 単体構成情報
(JSON、ソースコードなど) • 単体定義情報 (replace定義など) • 関係情報 (定義間の関係、構成間の関係) • ディレクトリ構成 • 第一レベル: リソース別 (プロダクト毎) • 第二レベル: 取得方法別 (API/CLI/WebUI) システムによる随時自動更新 議論ポイント
13.
Operation Lab 運用設計ラボ 人による変化情報の構造 変化 人による変化情報 • 変化(実績)レポート
(外部) • ドキュメントのリポジトリ(web) 「振り返り」(顧客レポートや考課に活用) ヒトによる収益性ドキュメント Quality Delivery
14.
Operation Lab 運用設計ラボ 「人による変化情報」ドキュメント構造 /change.rst 人による変化情報 • 変化(実績)レポート
(外部) • ドキュメントのリポジトリ(web) 「振り返り」(顧客レポートや考課に活用)
15.
Operation Lab 運用設計ラボ システムの変化情報の構造 変化 「振り返り」(顧客レポートや考課に活用) システムの変化情報 インクルード対象 • MRTG/DDR •
CloudWatch システムによる収益性ドキュメント Quality Delivery 議論ポイント
16.
Operation Lab 運用設計ラボ 「振り返り」(顧客レポートや考課に活用) システムの変化情報 インクルード対象 •MRTG/DDR •CloudWatch 「システムの変化情報」ドキュメント構造 外部ドキュメント 議論ポイント
17.
Operation Lab 運用設計ラボ 人による活動情報の構造 • ドキュメントを利用する活動のト ラッカー •
ドキュメント自体のトラッカ (更 新、要望) activity活動 /activity.rst 人による活動情報 「説明責任」(証拠、エビデンス) ヒトによる費用性ドキュメント Cost
18.
Operation Lab 運用設計ラボ • ドキュメントを利用する活動のトラッカー •
ドキュメント自体のトラッカ (更新、要望) 「説明責任」(証拠、エビデンス) 「人による活動情報」ドキュメント構造 /activity.rst 人による活動情報
19.
Operation Lab 運用設計ラボ システムの活動情報の構造 activity活動 /activity.rst システムの活動情報 インクルード対象 • ログ •
アラート 「説明責任」(証拠、エビデンス) システムによる費用性ドキュメント Cost 議論ポイント
20.
Operation Lab 運用設計ラボ システムの活動情報 •ログ •アラート •PullRequestでのレビュー •実際のtaskでの説明
(資産性の可能性あり) 「説明責任」(証拠、エビデンス) 「システムの活動情報」ドキュメント構造 インクルード対象外部ドキュメント 議論ポイント
21.
Operation Lab 運用設計ラボ ドキュメントマップ
22.
Operation Lab 運用設計ラボ 運用ドキュメントのマップ • /define/ •
mission/ • policy/ • service/ • service-catalog/ (ユーザ向けメニュー) • work-catalog/ (運用現場向けメニュー) • resource-catalog/ (API/CLI/WebUIなどのリファレンス) • プロダクト別ドキュメント • automation/ (外部情報へのシンボリックリンク) • lib/ (手順パーツ、スクリプト、関数、ライブラリ) • /activity.rst • /change.rst • /words.rst (用語定義)
23.
Operation Lab 運用設計ラボ プロダクトドキュメントのマップ • /define/ •
work-catalog/ (運用現場向けメニュー) • resource-catalog/ • (API/CLI/WebUIなどのリファレンス) • automation/ (外部情報へのシンボリックリンク) • lib/ (手順パーツ、スクリプト、関数、ライブラリ) • /activity.rst • /change.rst • /words.rst (用語定義)
24.
Operation Lab 運用設計ラボ memo
25.
Operation Lab 運用設計ラボ memo • プロダクト単体のドキュメントについては、このモデル のサブセット&独立リポジトリで疎結合ドキュメンテー ションを実現するべき •
ドキュメントのtopレベル • resource-catalog(リファレンス/マニュアル) • work-catalog(作業手順) • lib(自動化ライブラリ)
26.
Operation Lab 運用設計ラボ http://www.operation-lab.co.jp/
Download now