Submit Search
Upload
20110827 restudy-pyconjp2011
•
0 likes
•
932 views
Hirokazu Hatano
Follow
ドキュメントのない作業は「業務が存在しない」に等しい。ドキュメントを作ろう、It's 業務資産!
Read less
Read more
Engineering
Report
Share
Report
Share
1 of 26
Download now
Download to read offline
Recommended
運用現場の過去、現在、未来
運用現場の過去、現在、未来
Hirokazu Hatano
JAWS FESTA KANSAI アンカン 関西のおっちゃんの口説き方
JAWS FESTA KANSAI アンカン 関西のおっちゃんの口説き方
Toshiyuki Konparu
レガシーなアプリにWeb apiを実装してなみだ目になったのでちょっといろいろ教えてください
レガシーなアプリにWeb apiを実装してなみだ目になったのでちょっといろいろ教えてください
Isamu Suzuki
Node.jsで使えるファイルDB"NeDB"のススメ
Node.jsで使えるファイルDB"NeDB"のススメ
Isamu Suzuki
Viewを使って開発を楽にする話
Viewを使って開発を楽にする話
Isamu Watanabe
Ansible はじめてみました
Ansible はじめてみました
Takeshi Kuramochi
5分では終わりそうにないfunctionsの話
5分では終わりそうにないfunctionsの話
Yoshiyuki Taniguchi
新卒3年目のぼくが、でぶおぷす???なオジサンだらけのエンプラ金融PJにAnsibleを導入してみた
新卒3年目のぼくが、でぶおぷす???なオジサンだらけのエンプラ金融PJにAnsibleを導入してみた
Shuntaro Saiba
Recommended
運用現場の過去、現在、未来
運用現場の過去、現在、未来
Hirokazu Hatano
JAWS FESTA KANSAI アンカン 関西のおっちゃんの口説き方
JAWS FESTA KANSAI アンカン 関西のおっちゃんの口説き方
Toshiyuki Konparu
レガシーなアプリにWeb apiを実装してなみだ目になったのでちょっといろいろ教えてください
レガシーなアプリにWeb apiを実装してなみだ目になったのでちょっといろいろ教えてください
Isamu Suzuki
Node.jsで使えるファイルDB"NeDB"のススメ
Node.jsで使えるファイルDB"NeDB"のススメ
Isamu Suzuki
Viewを使って開発を楽にする話
Viewを使って開発を楽にする話
Isamu Watanabe
Ansible はじめてみました
Ansible はじめてみました
Takeshi Kuramochi
5分では終わりそうにないfunctionsの話
5分では終わりそうにないfunctionsの話
Yoshiyuki Taniguchi
新卒3年目のぼくが、でぶおぷす???なオジサンだらけのエンプラ金融PJにAnsibleを導入してみた
新卒3年目のぼくが、でぶおぷす???なオジサンだらけのエンプラ金融PJにAnsibleを導入してみた
Shuntaro Saiba
Node.jsに縁のない職場でnode.jsを使い始める戦術
Node.jsに縁のない職場でnode.jsを使い始める戦術
Isamu Suzuki
OSS/linux on Azureの活用方法と勘所
OSS/linux on Azureの活用方法と勘所
Kuniteru Asami
Zabbix+group replication
Zabbix+group replication
bri nger
とある AWS サービスの運用移管〜データストア編〜 #jawsmeguro
とある AWS サービスの運用移管〜データストア編〜 #jawsmeguro
IKEDA Kiyoshi
実プロジェクトの経験から学ぶazureサービス適用パターン
実プロジェクトの経験から学ぶazureサービス適用パターン
Kuniteru Asami
サーバーサイド技術者不足に効くChef
サーバーサイド技術者不足に効くChef
Maho Takara
テスト駆動インフラ構築-Chefとserverspecを使ったインフラ自動化のすすめ-
テスト駆動インフラ構築-Chefとserverspecを使ったインフラ自動化のすすめ-
賢 秋穂
AnsibleによるHWプロビジョニング -OneViewの連携-
AnsibleによるHWプロビジョニング -OneViewの連携-
Takahiro Kida
障害を防ぎ、サービスを守るために #gotandapm
障害を防ぎ、サービスを守るために #gotandapm
IKEDA Kiyoshi
Ansible provisioning
Ansible provisioning
Naoki Watanabe
Slackから始めるChatOps
Slackから始めるChatOps
Yuto Suzuki
スマイルゼミの裏側(db編)
スマイルゼミの裏側(db編)
JustSystems Corporation
2014-07-26 jawsug-chiba ドキュメントを書こう! 運用自動化時代のドキュメンテーション
2014-07-26 jawsug-chiba ドキュメントを書こう! 運用自動化時代のドキュメンテーション
Operation Lab, LLC.
2014-12-17 #ssmjp 運用現場における"品質"とは
2014-12-17 #ssmjp 運用現場における"品質"とは
Operation Lab, LLC.
JAWS-UG CLI #07 VPC
JAWS-UG CLI #07 VPC
Operation Lab, LLC.
2015-09-01 クラウド時代の運用エンジニアは何が変わるのか
2015-09-01 クラウド時代の運用エンジニアは何が変わるのか
Operation Lab, LLC.
2015-03-27 ザ・運用 ~ 運用とは何か、運用とはどのようであるべきか
2015-03-27 ザ・運用 ~ 運用とは何か、運用とはどのようであるべきか
Operation Lab, LLC.
2014-10-27 #ssmjp 腹を割って話そう (運用xセキュリティ)
2014-10-27 #ssmjp 腹を割って話そう (運用xセキュリティ)
Operation Lab, LLC.
運用ドキュメントの構造化(案)
運用ドキュメントの構造化(案)
Operation Lab, LLC.
運用ドキュメントの分類と構造化
運用ドキュメントの分類と構造化
Hirokazu Hatano
AWSCLI AutoScaling
AWSCLI AutoScaling
Operation Lab, LLC.
API Gateway / AWS CLI
API Gateway / AWS CLI
Operation Lab, LLC.
More Related Content
What's hot
Node.jsに縁のない職場でnode.jsを使い始める戦術
Node.jsに縁のない職場でnode.jsを使い始める戦術
Isamu Suzuki
OSS/linux on Azureの活用方法と勘所
OSS/linux on Azureの活用方法と勘所
Kuniteru Asami
Zabbix+group replication
Zabbix+group replication
bri nger
とある AWS サービスの運用移管〜データストア編〜 #jawsmeguro
とある AWS サービスの運用移管〜データストア編〜 #jawsmeguro
IKEDA Kiyoshi
実プロジェクトの経験から学ぶazureサービス適用パターン
実プロジェクトの経験から学ぶazureサービス適用パターン
Kuniteru Asami
サーバーサイド技術者不足に効くChef
サーバーサイド技術者不足に効くChef
Maho Takara
テスト駆動インフラ構築-Chefとserverspecを使ったインフラ自動化のすすめ-
テスト駆動インフラ構築-Chefとserverspecを使ったインフラ自動化のすすめ-
賢 秋穂
AnsibleによるHWプロビジョニング -OneViewの連携-
AnsibleによるHWプロビジョニング -OneViewの連携-
Takahiro Kida
障害を防ぎ、サービスを守るために #gotandapm
障害を防ぎ、サービスを守るために #gotandapm
IKEDA Kiyoshi
Ansible provisioning
Ansible provisioning
Naoki Watanabe
Slackから始めるChatOps
Slackから始めるChatOps
Yuto Suzuki
スマイルゼミの裏側(db編)
スマイルゼミの裏側(db編)
JustSystems Corporation
What's hot
(12)
Node.jsに縁のない職場でnode.jsを使い始める戦術
Node.jsに縁のない職場でnode.jsを使い始める戦術
OSS/linux on Azureの活用方法と勘所
OSS/linux on Azureの活用方法と勘所
Zabbix+group replication
Zabbix+group replication
とある AWS サービスの運用移管〜データストア編〜 #jawsmeguro
とある AWS サービスの運用移管〜データストア編〜 #jawsmeguro
実プロジェクトの経験から学ぶazureサービス適用パターン
実プロジェクトの経験から学ぶazureサービス適用パターン
サーバーサイド技術者不足に効くChef
サーバーサイド技術者不足に効くChef
テスト駆動インフラ構築-Chefとserverspecを使ったインフラ自動化のすすめ-
テスト駆動インフラ構築-Chefとserverspecを使ったインフラ自動化のすすめ-
AnsibleによるHWプロビジョニング -OneViewの連携-
AnsibleによるHWプロビジョニング -OneViewの連携-
障害を防ぎ、サービスを守るために #gotandapm
障害を防ぎ、サービスを守るために #gotandapm
Ansible provisioning
Ansible provisioning
Slackから始めるChatOps
Slackから始めるChatOps
スマイルゼミの裏側(db編)
スマイルゼミの裏側(db編)
Viewers also liked
2014-07-26 jawsug-chiba ドキュメントを書こう! 運用自動化時代のドキュメンテーション
2014-07-26 jawsug-chiba ドキュメントを書こう! 運用自動化時代のドキュメンテーション
Operation Lab, LLC.
2014-12-17 #ssmjp 運用現場における"品質"とは
2014-12-17 #ssmjp 運用現場における"品質"とは
Operation Lab, LLC.
JAWS-UG CLI #07 VPC
JAWS-UG CLI #07 VPC
Operation Lab, LLC.
2015-09-01 クラウド時代の運用エンジニアは何が変わるのか
2015-09-01 クラウド時代の運用エンジニアは何が変わるのか
Operation Lab, LLC.
2015-03-27 ザ・運用 ~ 運用とは何か、運用とはどのようであるべきか
2015-03-27 ザ・運用 ~ 運用とは何か、運用とはどのようであるべきか
Operation Lab, LLC.
2014-10-27 #ssmjp 腹を割って話そう (運用xセキュリティ)
2014-10-27 #ssmjp 腹を割って話そう (運用xセキュリティ)
Operation Lab, LLC.
運用ドキュメントの構造化(案)
運用ドキュメントの構造化(案)
Operation Lab, LLC.
運用ドキュメントの分類と構造化
運用ドキュメントの分類と構造化
Hirokazu Hatano
AWSCLI AutoScaling
AWSCLI AutoScaling
Operation Lab, LLC.
API Gateway / AWS CLI
API Gateway / AWS CLI
Operation Lab, LLC.
『運用屋さんのためのVBA入門』 ~ 運用方法論 運用工程設計・自動化概論 〜
『運用屋さんのためのVBA入門』 ~ 運用方法論 運用工程設計・自動化概論 〜
Hirokazu Hatano
2015-10-31 クラウドネイティヴ時代の運用を考える 〜 ドキュメント駆動運用へ
2015-10-31 クラウドネイティヴ時代の運用を考える 〜 ドキュメント駆動運用へ
Operation Lab, LLC.
「運用改善」を考える 〜「自動化」を考える前に
「運用改善」を考える 〜「自動化」を考える前に
Operation Lab, LLC.
AWSCLI Lambda
AWSCLI Lambda
Operation Lab, LLC.
2015-05-23 クラウドの運用になって インフラエンジニアは何が変わるのか?
2015-05-23 クラウドの運用になって インフラエンジニアは何が変わるのか?
Operation Lab, LLC.
Viewers also liked
(15)
2014-07-26 jawsug-chiba ドキュメントを書こう! 運用自動化時代のドキュメンテーション
2014-07-26 jawsug-chiba ドキュメントを書こう! 運用自動化時代のドキュメンテーション
2014-12-17 #ssmjp 運用現場における"品質"とは
2014-12-17 #ssmjp 運用現場における"品質"とは
JAWS-UG CLI #07 VPC
JAWS-UG CLI #07 VPC
2015-09-01 クラウド時代の運用エンジニアは何が変わるのか
2015-09-01 クラウド時代の運用エンジニアは何が変わるのか
2015-03-27 ザ・運用 ~ 運用とは何か、運用とはどのようであるべきか
2015-03-27 ザ・運用 ~ 運用とは何か、運用とはどのようであるべきか
2014-10-27 #ssmjp 腹を割って話そう (運用xセキュリティ)
2014-10-27 #ssmjp 腹を割って話そう (運用xセキュリティ)
運用ドキュメントの構造化(案)
運用ドキュメントの構造化(案)
運用ドキュメントの分類と構造化
運用ドキュメントの分類と構造化
AWSCLI AutoScaling
AWSCLI AutoScaling
API Gateway / AWS CLI
API Gateway / AWS CLI
『運用屋さんのためのVBA入門』 ~ 運用方法論 運用工程設計・自動化概論 〜
『運用屋さんのためのVBA入門』 ~ 運用方法論 運用工程設計・自動化概論 〜
2015-10-31 クラウドネイティヴ時代の運用を考える 〜 ドキュメント駆動運用へ
2015-10-31 クラウドネイティヴ時代の運用を考える 〜 ドキュメント駆動運用へ
「運用改善」を考える 〜「自動化」を考える前に
「運用改善」を考える 〜「自動化」を考える前に
AWSCLI Lambda
AWSCLI Lambda
2015-05-23 クラウドの運用になって インフラエンジニアは何が変わるのか?
2015-05-23 クラウドの運用になって インフラエンジニアは何が変わるのか?
20110827 restudy-pyconjp2011
1.
reSTudy ∼ STudy group
about reST ∼ 波田野 裕一 (reSTudy / 日本UNIXユーザ会) PyConJP 2011 / 2011-08-27
2.
abstruct reSTructured Text (reST)
によるドキュメント サンプルをまとめる活動を行う、reSTudyに ついて紹介します。 ! 活動の成果(?)などを紹介します。
3.
おまえダレよ ADSLキャリアでISP運用 小規模ISPの立ち上げ支援 官庁小規模システムの運用/Close ASPでの運用設計PPyytthhoonn 全く書けません
4.
最近 運用業務モデリングが趣味に 週末reST ドキュメント書いてばかり で、奥さんを嘆かせている 「運用の暗い話」ばかり得意に 運用の方から来ました
5.
少し語らせてください 夢悪
6.
「運用は何をやっているのか よくわからない」 とおっしゃる方がいます、が お題
7.
「やっている方もよくわかって ないんですよ」、と 答え までは、言えませんが、なんだかうまく説明できない。
8.
ドキュメントのない作業は 「業務が存在しない」に等しい
9.
ミスが多発 ドキュメントが無いと 異動で混乱 運用でカバー
10.
運用現場の制御不能状態を加速する 運用でカバー 運用でカバー運用でカバー運用でカバー 理想は No Document, No
Operation.
11.
http://thinkit.co.jp/ 運用でカバー
12.
13.
クラウドに吸い込まれる運用現場 尖ったモノを持つ「攻める」運用現場 変化に柔軟に対応高度な専門性 短納期/スピード 費用対効果が明確 スケーラビリティ スティッキー 一般的な専門性
硬直的 意思決定に時間 どんぶり勘定 高コスト体質 非合理的 二極化する運用現場
14.
5. 運用設計の諸要素 「運用基盤」3要素 ✓ まずは作業内容を的確に表現したドキュメントがあることが大前提 ! ✓
それではじめて作業内容に必要なスキル(教育内容)が明確になる。 ! ✓ 前提となる作業とスキルが明確になって、はじめてツールの話ができる。 ドキュメント スキル (教育) ツール 運用基盤とは
15.
運用現場における典型的な声 (1/3) ✓ 業務が多岐に渡り、全てを把握することが困難になっている。 ✓
ドキュメントが整備されていない。あっても更新されていない。 ✓ どんなドキュメントが必要なのかがわからない。書き方がわからない。 ✓ 一部の人間にしかできない業務があり、業務が集中している。 ✓ 属人化が進み、ノウハウの継承ができていない。 ✓ 異動により現場が混乱することが多い。
16.
ドキュメントを作ろう It's 業務資産!
17.
運用ドキュメントが必要な理由 ‣ ドキュメントのない作業は、運用現場自身でも正確な内容把握が難しいため、 作業内容のブレやモレを生みやすく、ミスやトラブルの温床になりやすい。 ‣ ドキュメントのない作業は、正確な業務引き継ぎが困難であり、メンバーの >異動や退職により運用現場を混乱させるリスクが高い。 ‣
ドキュメントのない作業は、対外的な説明が難しく、(ユーザー視点では) 存在しないことに近い。そのため評価されにくい。 ‣ ドキュメントのない作業においては、その作業に必要なスキルやツールを、 運用現場が的確に定義し、正確に相手に提示することが難しい。
18.
運用ドキュメントに求められるもの 「簡単に」「誰でも」書ける「正確な」ドキュメントが求められる。 ! ! * 正確性 (正確なドキュメント) ! *
内容が論理的に正確であること (論理的正確性) * 内容が最新のものであること (時間的正確性) * 文書内の参照関係が正確であること (構造的正確性) ! * 容易性 (簡単に書けるドキュメント) ! * その気になったときに簡単に書けること (着手の容易性) * 書く事に集中できること (記述の容易性) * 一度書いた文書を使いまわしできること (再利用の容易性) ! * 継続性 (誰でも書けるドキュメント) ! * 置き場を誰でも知っていること (閲覧の継続性) * 更新方法を誰でも知っていること (更新方法の継続性) * 誰が更新しても良い (更新者の継続性)
19.
未来へ進もう 現
20.
今年は運用ドキュメントが熱い 2010年10月 OSC2011 Tokyo/Fall 2010年11月
手順書友の会 発足 (JANOG系) 2010年12月 jus勉強会 ドキュメントを作りたくなる魔法のツール Sphinx 2011年 6月 odstudy 発足 Operation & Documentation (渋川さん、清水川さん、山口さん)
21.
道具もそろってきた いいバージョン管理システム Mercurial 手順書のための構造化言語 構造化記法 reST +
ドキュメントプロセッサ Sphinx 手順書管理媒体 バグトラッキングシステム Redmine リポジトリ連携 + ReSTfulAPI blockdiagシリーズ (#世界の小宮さん)
22.
次はこれだ ✓ 業務が多岐に渡り、全てを把握することが困難になっている。 ✓ ドキュメントが整備されていない。あっても更新されていない。 ✓
どんなドキュメントが必要なのかがわからない。書き方がわからない。 ✓ 一部の人間にしかできない業務があり、業務が集中している。 ✓ 属人化が進み、ノウハウの継承ができていない。 ✓ 異動により現場が混乱することが多い。
23.
あるあるSphinx ‣ Sphinx イイネ! ‣
とりあえず、はじめる。それもわるくはない。 ‣ しかし、後で知るとガーンとなることも多い。 ‣ ごりごりテーブル書いていた -> list-table ‣ ごりごり内部リンク書いていた ->クロスリファレンス ‣ リストで注意書き書いていた -> note & warnings ‣ だったら先に知っておきたいことを押えておくのが得策 ‣ よかろう、それが re(ry
24.
あるあるdocumentation ‣ 作り方はわかった、じゃ次は「何をどう作るか」、だ。 ‣ ドキュメントって、必要必要と言う割にテンプレートがばらばら。 ‣
うまく汎用的なテンプレートがあると嬉しいよね。 ‣ テンプレートや知見、悩み相談みたいな場が欲しい。 ‣ よかろう、それが re(ry
25.
ドキュメントを作ろう Let's reSTudy!
26.
ここからはreSTドキュメントで.....
Download now