├── .gitignore ├── Content ├── Along-the-WaySyndrome.md ├── AmbigiousTalk.md ├── Anti-Automation.md ├── AutomationFever.md ├── Big-bangAutomation.md ├── BluePrint.md ├── Cat-and-MouseGameofReliability.md ├── Dashboard.md ├── DawnOfCivilization.md ├── ExtensionBuildings.md ├── IndianaJones.md ├── Introduction.md ├── LikeACharm.md ├── MostEfficientPartFitst.md ├── NeedHero.md ├── NotOnlyForTesting.md ├── Old-GuardsUprising.md ├── QuakAndExpensiveGoodDoctor.md ├── README.md ├── RestartWithoutReset.md ├── SUMMARY.md ├── TestClassification.md ├── Three-minuteCooking.md ├── WeAreMeisters.md └── YouAreHuman.md ├── patterns.dot └── readme.md /.gitignore: -------------------------------------------------------------------------------- 1 | Content/_book/ -------------------------------------------------------------------------------- /Content/Along-the-WaySyndrome.md: -------------------------------------------------------------------------------- 1 | ## ついで症候群 2 | ### 文脈 3 | 自動化に対する組織の理解が不足しているが、導入自体はできている。 4 | 5 | ### 問題 6 | 自動化ツールのマーケティングを鵜呑みにして導入してしまい、増大する維持コストを抑えられない。あれもこれもと自動化ツールに押しつけてしまい、身動きが取れなくなっている。 7 | 8 | ### フォース 9 | 自動化に対する誤解は根深く、実体験を伴わないとわかり辛いものである。説明されれば理解は示すが、いざ実践するとなると「ついでに」と適用範囲を拡げがち。知識は持っていても、自分がまさに誤解のパターンに当てはまっていることはわかりづらいものである。 10 | 11 | ### 解決 12 | 失敗を自覚できるようする。失敗の程度を大きくするか、失敗の判断を早くするかは組織それぞれ。 13 | 14 | ### 結果 15 | ユメミガチなことは言わなくなった。副作用として[アンチ自動化](Anti-Automation.html)になる場合もある。 16 | -------------------------------------------------------------------------------- /Content/AmbigiousTalk.md: -------------------------------------------------------------------------------- 1 | ## クラウドトーク（もやもやした会話） 2 | ### 文脈 3 | [求む！英雄](NeedHero.html)の登場により、自動化の環境開発を進める活動を開始したが、開発対象を特定する際に「テスト自動化」という1つの言葉で説明しようとしてしまう。 4 | （例えば、テストデータの生成のツールを作る話と、テスト結果を判定するツールの内容を「自動化ツール」と表現してしまうことにより、話し手と受け手の理解が異なってしまう。） 5 | 結果として、話し手と受け手の理解が異なるもやもやした会話となっていまい、意思疎通が図れない状態となってしまう。 6 | 7 | ### 問題 8 | 自動化の用語特定が出来ていない。 9 | それぞれが頭に考えている自動化を言葉で特定することが出来ないため、対話時に浮かぶイメージが異なってしまうことで意識齟齬に繋がってしまう。 10 | また、必要な技術要素の特定が出来ないことから、実施したい目標や成果物が不明確となり、自動化の環境構築を推し進めるコトが困難となる。 11 | 12 | 結果の1つとして、[建て増し旅館](ExtensionBuildings.html)風のイマイチな自動化システムを作りこんでしまう可能性が高い。 13 | 14 | ### フォース 15 | * 自動化を進める際には、ついつい手が先になり、用語や知見が十分で無い状態に陥ることがある。 16 | * （一般的にも）用語が整備されていないことも背景として存在する。 17 | * 上記の知見が仮にあったとしても、チーム全体の共通認識がない状態で、突っ走ってしまいがち([自動化ハイ](AutomationFavor.html))である。 18 | 19 | ### 解決 20 | * 具体的に自動化の範囲、対象を特定する用語を定義する。 21 | * さらに、モデル図で整理した表現と組合せることにより、意思疎通を行いやすくなる。 22 | 23 | ### 結果 24 | 自動化の開発を進めるための用語認識が統一されており、意思疎通が出来る状況となっている。 25 | また、自動化を特定する用語を分けることによる副次効果として分割特定した項目を深堀、イメージしやすくなり、より高度な技術へとつなげることが出来る可能性が発生している。 26 | -------------------------------------------------------------------------------- /Content/Anti-Automation.md: -------------------------------------------------------------------------------- 1 | ## アンチ自動化 2 | ### 文脈 3 | * [ついで症候群](Along-the-WaySyndrome.html)にこりて、「自動化は面倒臭い」という誤解が根付いてしまっている 4 | * [験担ぎ](LikeACharm.html)のテストが増加し、自動テストから便益を享受できていない、という間隔が大きくなっている。 5 | 6 | ### 問題 7 | 自動化に対する不信感により、手動テストへの回帰を望む人が多くなっている。 8 | 9 | ### フォース 10 | 多くの人にとって、やはり手動が自然な状態で、自動化は特殊な状態である。なので、自動化による便益が少ないという考えが起こってしまうと簡単に自動化に不信感を抱いてしまう。 11 | 12 | ### 解決 13 | * 自動化への誤解を一つ一つといていこう。たった一つのツールで全てが賄われることはない。ツールベンダの言葉に踊らされず、自分たちなりの活用方法をアピールしよう。場合によっては、別のツールを試そう。 14 | * 動きの怪しい自動化システムに意味は無い。懐疑する人々を勢いづかせないためにも、[信頼性バトル（信頼性イタチごっこ）](Cat-and-MouseGameofReliability.html)と[ブラックジャックによる治療](QuakAndExpensiveGoodDoctor.html)、[テスト仕分け](TestClassification.html)で土台を固めていこう。 15 | 16 | ### 結果 17 | 自動化への誤解が解け、気持よく自動化を推進して行くことができる。 18 | -------------------------------------------------------------------------------- /Content/AutomationFever.md: -------------------------------------------------------------------------------- 1 | ## 自動化ハイ 2 | ### 文脈 3 | [3分クッキング](Three-minuteCooking.html)などにより、自動化の導入には成功している。いよいよこれからが、自動化を全体に進めていく時である。 4 | 5 | ### 問題 6 | 試験的に導入した自動化の面白さに取り憑かれ、全体の設計をしないままに自動化をどんどん推し進めようとしている。その結果、似たようなシステムが乱立し、以後の管理が困難な状態（[建て増し旅館](ExtensionBuildings.html)）になりかけている。 7 | 8 | ### フォース 9 | * 特に現場手動で自動化を行っている場合、どんどん実装を行い自動化を進めて行きたくなってしまう。 10 | * プログラマの性として、一度うまく行き始めると、その勢いのままコードを書き進めてしまうことは大いに有り得る。 11 | 12 | ### 解決 13 | 一度冷静になり、[全体像を描く](BluePrint.html)ようにしよう。我々の目的はテスト作業の省力化・効率化であり、自動テストの実装はその手段にすぎない。どのようなテストが本当に必要なのか、メンテナンス性も含めて全体最適されているのか、現在の自動化システムで今後の拡張に耐えうるのか、冷静に判断をしよう。 14 | 15 | ### 結果 16 | 自動化の[全体像を描き](BluePrint.html)、今後の拡張やメンテナンス性を考慮した自動化システムを構築することができるようになる。 17 | -------------------------------------------------------------------------------- /Content/Big-bangAutomation.md: -------------------------------------------------------------------------------- 1 | ## ビッグバン自動化 2 | ### 文脈 3 | もしくはバズワードとして自動化を受け取ったエライ人がトップダウンで自動化を推奨しようとした結果、全て（もしくは大部分）の自動化を作りこんだ後に一気に実施しようとして、全体のシステムを作りこむ事態が発生する。 4 | そして、一度に自動化を開始しようとした結果、まったく動かない状況が発生してデスマーチ的に不具合対処に追われてしまう。 5 | 6 | ### 問題 7 | 一度に全ての試験を自動実行しようとしてしまっている。 8 | SUTのテストを、自動化システムを含めてまとめて実行してしまおうとしてしまう。 9 | また、自動化システムのデバッグも同時発生する状況になるケースがあり、SUTの不具合か、自動化システムの不具合かを切り分けることも困難になる状況も発生する可能性が高い。 10 | 結果として、[原住民蜂起](Old-GuardsUprising.html)が発生して自動化システムが使われない状況になるか、自動化システムの構築が原因で工期が延びてしまう。 11 | 12 | ### フォース 13 | WFの環境や自動化に過剰に期待を持つ組織で発生しやすい。本現象はビックバンテストの発生と同様の状況で起こりうる。SUTと自動化システムの双方のデバッグが必要であるため、少しずつ積み上げながらSUTと自動化環境を構築しないと厳しい。 14 | 15 | ### 解決 16 | * [信頼性バトル（信頼性イタチゴッコ）](Cat-and-MouseGameofReliability.html)により、SUTと自動化システムのボトルネックとなる部分を1つずつ解決していく。 17 | * 開発やテストのプロセスに、自動化システムをどう組み込むかを考え、全体プロセスを構築して活動を行う。（[全体像を描く](BluePrint.html)活動を積極的に行う。） 18 | 19 | ### 結果 20 | 開発に関わるメンバー担当者がSUTと自動化システムを一つずつ積み上げながら動作確認して、出来る範囲を広げている。 21 | エライ人や暴走した人がまとめて自動化システムを一気に実施する！といった発言をしない。 22 | -------------------------------------------------------------------------------- /Content/BluePrint.md: -------------------------------------------------------------------------------- 1 | ## 全体像を描く 2 | ### 文脈 3 | [3分クッキング](Three-minuteCooking.html)により、自動化の導入は進み始めているが、まだまだテスト自動化の初期段階である。 4 | 5 | ### 問題 6 | 自動化をまず導入しては見たものの、このまま全体に適用するのは難しいように思える。 7 | 8 | ### フォース 9 | * まず自動化を導入できたとしても、現在の設計では自動化が不可能な場合も多い。このまま邁進しても、強引な手段で自動化を行うことになり、[ついで症候群](Along-the-WaySyndrome.html)に陥りやすい。 10 | * 自動化をさっさと行い、先に進みたい要求も強くなってくる（[自動化ハイ](AutomationFavor.html)） 11 | 12 | ### 解決 13 | * システムの全体像を描き、その中に自動テストをどうすれば効果的に適用できるかを考える。 14 | * システムの中に自動テストに不都合な箇所があり、かつそこを自動化するのが効果的ならば設計にも手を入れることを考える。 15 | 16 | ### 結果 17 | * 全体像を定義することで、[クラウドトーク（もやもやした会話）](AmbigiousTalk.html)から脱却することができる。 18 | * [建て増し旅館](ExtensionBuildings.html)的なメンテナンスしにくい自動化を行わない力が働くようになる。 19 | * 全体を俯瞰することで、[まずは"効く"ところから](MostEfficientPartFitst.html)始められるようになる 20 | -------------------------------------------------------------------------------- /Content/Cat-and-MouseGameofReliability.md: -------------------------------------------------------------------------------- 1 | ## 信頼性バトル（信頼性イタチゴッコ） 2 | ### 文脈 3 | SUTと自動化システムとの間で信頼性を競い合う争いが行われる。 4 | 自動化システムでテストを行おうとした場合に、片方が止まってデバッグ⇒他の課題でまた止まる⇒を繰り返す。 5 | たとえば、自動化ツールがダウンする状況を改善したところ、今度はSUT側の不具合で自動化が進まない…という状況が発生する。 6 | (結局は、信頼性が低い側が足枷になり続ける) 7 | 8 | ### 問題 9 | 自動化を動かして試験をするという際に、見積もり作業期間とは異なり、しばらくデバッグが続く状況が発生する。 10 | 一筋縄ではいかない、という理解が少ない場合には、 [ビッグバン自動化](Big-bangAutomation.html) を実施したうえでデバッグ期間を短く見積もってしまい、デスマーチに陥ってしまうなどが発生してしまう。 11 | 結果として「自動化はダメだ」という[原住民蜂起](Old-GuardsUprising.html)に繋がる偏見的な判断を持ってしまう可能性が発生する。 12 | 13 | ### フォース 14 | WFの環境や自動化に過剰に期待を持つ組織、SUTと自動化システムの双方に対してデバッグが必要で、信頼性が求められることを理解していない場合に発生しやすい。 15 | [ビックバン自動化](Big-bangAutomation.html)を行ってしまったチームや組織が本対処を実施することが多い。 16 | 17 | ### 解決 18 | 信頼性が低いサブシステムを一つ一つ改善していくことで、双方の信頼性が少しずつ高める。ひとつずつ課題を解決することで、自動化システム自体を安定化させるだけでなく、SUT自体の信頼性向上も行われる事になる。 19 | 20 | ### 結果 21 | * 双方の改善の結果、徐々に全体の品質が上がってくる 22 | * 自動化試験を実施する場合には信頼性向上が必要で、チーム内の共通認識が行われている。 23 | * エライ人や暴走した人による[ビッグバン自動化](Big-bangAutomation.html)に対する抑制がかかり、自動化環境の構築に時間がかかるということを体験として理解できるようになる。 24 | -------------------------------------------------------------------------------- /Content/Dashboard.md: -------------------------------------------------------------------------------- 1 | ## ダッシュボード 2 | ### 文脈 3 | [3分クッキング](Three-minuteCooking.html)などにより自動化そのものを取り入れることはできたが、まだ自動化を活用できているとは言いがたい。 4 | 5 | ### 問題 6 | テスト結果を適切に分析し、活用することができていない。取られてはいるものの、活用されていない結果レポートが多く存在する。 7 | 8 | ### フォース 9 | 自動ビルドツールによって、多くのメトリクスを並べることができる。ただし多くの情報を解釈するには担当者のリソースが必要となる。無目的に結果を垂れ流してしまった場合、メトリクスに意味はなくなってしまう。 10 | 11 | ### 解決 12 | 考えなしにレポートを出すのではなく、目的をもった結果レポートを出力するようにする。また、多くの指標を理解できるよう担当者のレベルを上げるとともに、差分を表示し変化を追うことにより、特徴的な指標をみつけやすくする。場合によっては、結果レポートのエラーから自動でバグチケットを作成するなど、レポートからアクションを行う部分も自動化し、省力化する。 13 | 14 | ### 結果 15 | * 自動化したテストの恩恵を最大化し、素早い対応が行えるようになる。 16 | * 記録したメトリクスを[テスト仕分け](TestClassification.html)など自動化システムの改良に用いることができるようになる。 17 | -------------------------------------------------------------------------------- /Content/DawnOfCivilization.md: -------------------------------------------------------------------------------- 1 | ## 文明の曙 2 | * システム全体を考え、常に改善をまわしていく、というエンジニアとしては当たり前のPDCAサイクルを、開発プロセス自体に適用できるようになるパターン。 3 | -------------------------------------------------------------------------------- /Content/ExtensionBuildings.md: -------------------------------------------------------------------------------- 1 | ## 建て増し旅館 2 | ### 文脈 3 | テスト自動化が職場に導入され、少しずつ適用範囲が増えていっている。 4 | 5 | ### 問題 6 | 自動化システムが、場当たり的な改修によりメンテナンス性が損なわれていってしまう。たとえば、類似のスクリプトをコピペで量産し始めたり、自動化対象（SUT）と自動化システムのギャップを強引な手法で解決し始めたりする。 7 | 8 | ### フォース 9 | 自動テストの実装を進めていくと、当初の想定とは異なる状況に出くわすことはよくある。そんなときに、立ち止まって考えず、「とりあえず動かそう」という気持ちで実装を進めてしまう。 10 | 特に、[自動化ハイ](AutomationFavor.html)に陥った自動化チームは、全体を考えずに自動化実装をまい進することが多い。 11 | 12 | ### 解決 13 | テスト自動化はそれ自体が複雑なシステムであることを理解しよう。それぞれが勝手な実装を進めればいつかは崩壊してしまう。 14 | まずは、実装を進める前に[全体像を描く](BluePrint.html)ことを習慣づけよう。もし、すでに建て増された部分がある場合は、[ブラックジャック](QuakAndExpensiveGoodDoctor.html)に依頼して改修をするか、作りなおそう。 15 | 16 | ### 結果 17 | 建て増されたテストのうち、有用なものの効果を残しながらも、メンテナンス性を確保した自動化システムを創ることができる。 18 | -------------------------------------------------------------------------------- /Content/IndianaJones.md: -------------------------------------------------------------------------------- 1 | ## インディ・ジョーンズ 2 | ### 文脈 3 | * 現在稼働している自動化環境はない。 4 | * 過去にすごいエンジニアが何やらすごいことをしていた、という噂が流れている。 5 | 6 | ### 問題 7 | * 自動化対象のシステムが複雑すぎて、どこから手を付ければいいか分からない状態になってしまっている。 8 | 9 | ### フォース 10 | * すでに稼働している環境に対して自動テストを追加するのは、対象システムの深い理解と自動テストに対する理解両方が必要になり、非常に困難な作業である。 11 | 12 | ### 解決 13 | * 過去に構築していた自動化システムを再稼働し、短期間で自動テストを行えるように持っていく 14 | 15 | ### 結果 16 | * 過去の遺産により、ひとまず導入の第一歩を超えることができた。しかし、これらのシステムは[験担ぎ]に成り下がった後に[原住民蜂起]により打ち捨てられたものである可能性が高く、平行して[全体像を描き](IndianaJones.html)見直しを行うことが必要となる。 17 | -------------------------------------------------------------------------------- /Content/Introduction.md: -------------------------------------------------------------------------------- 1 | # テスト自動化パタン言語 オーバービュー 2 | 3 | 4 | 5 | -------------------------------------------------------------------------------- /Content/LikeACharm.md: -------------------------------------------------------------------------------- 1 | ## 験担ぎ 2 | ### 文脈 3 | テスト自動化環境が構築されて、少なくとも一度は効果が出た状況である。継続的にテスト自動化でのテスト実施が行われている状態ではあるが、効果がある活用と運用がされていない。「このエラーは出ても問題は無い」という意思決定で運用が行われている。 4 | 5 | ### 問題 6 | テスト自動化実施が定められているので自動化環境を動かす活動は行われている。テスト実施はされているが、明らかなエラーが検出されたとき以外は結果を誰も確認しない。 7 | 結果として、テスト資産が形骸化・陳腐化している。 8 | 9 | ### フォース 10 | 仕様変更などでテスト資産を変化に対して追従させる必要があるが、自動化環境はなぜか無視される。（担当者が異動になった場合などに発生することが多い：たこつぼ化） 11 | 12 | ### 解決 13 | * 最新のSUTと自動化環境の差を分析して、テスト資産を追従させる。 14 | * エラーが出ていることが、現場でもみ消せないようにプロセスを整備する。 15 | * エラーが出ない環境を作り、そのためのチームの規律を構築する。 16 | * 自動化環境の保守を行う担当者{自動化奉行}を決める。 17 | * 改善コストがあわないなら、そんな自動化やめちまえ。 18 | 19 | ### 結果 20 | SUTに適した自動化環境が整備され、変化に追従されている。 21 | 変化に追従した環境により、テスト自動化の効果が得られる状態になっている。 22 | 意味のないテスト自動化環境が無くなっている。 23 | -------------------------------------------------------------------------------- /Content/MostEfficientPartFitst.md: -------------------------------------------------------------------------------- 1 | ## まずは"効く"ところから 2 | ### 文脈 3 | [3分クッキング](Three-minuteCooking.html)により、自動化の導入は進み始めている。最初に手を付けたところから次の場所を探そうとしている。 4 | 5 | ### 問題 6 | 次に手を付ける場所について、決定することができない。 7 | 8 | ### フォース 9 | * 自動化の効果に対しある程度イメージが湧くと、どうしても重厚長大なシステムを計画し[ビッグバン自動化](Big-bangAutomation.html)を行ってしまいがちである。 10 | * また、自動化が実装され始めると、[自動化ハイ](AutomationFavor.html)に浮かされ、[ついで症候群](Along-the-WaySyndrome.html)に羅患し、闇雲な自動化が行われることになる。 11 | 12 | ### 解決 13 | * まずは[全体像を描き](BluePrint.html)、自動化しようとしているシステムの特徴について捉える。そののち、全体の中で自動化の効果が早く見込める場所、即ちもっとも少ない投資で最大の効果を発揮する箇所を見定め、ターゲットを決定する。 14 | * 効果の算定の際には、現状のシステムの自動化に対する適合度、手動テストの負荷や頻度などを考慮する。 15 | * 効果をトラッキング・表示するために適切な[ダッシュボード](Dashboard.html)を設定するとよい。 16 | 17 | ### 結果 18 | * 自動化のスタートアップとして、効果を組織内にアピールすることができる。 19 | * 成功例があがることで、即効性はあまりないが長期的効果は大きいような改善につなげることができる。目指すは[文明の曙](DawnOfCivilization.html)である。 20 | -------------------------------------------------------------------------------- /Content/NeedHero.md: -------------------------------------------------------------------------------- 1 | ## 求む！英雄 2 | ### 文脈 3 | 現場で、自動化しようという意識はあり、改善のアイデアもあり、世の中のツールを使用すると効率が良くなると感じている。「ないものは作れ」で自力で作成することがあたりまえになっている。 4 | 5 | ### 問題 6 | * 世にあるツールと同程度もしくは程度の低いツールを作成するために、リソースを浪費している。リソースの制約により自動化が進まない。 7 | * 世の中には便利なツールがあるにもかかわらず、それを知らない。 8 | * 世の中には便利なツールがあるにもかかわらず、それを知ろうとしない。 9 | * 世の中の便利なツールは知っていても、導入に至らない。 10 | 11 | ### フォース 12 | * 組織内でツールを導入するプロセスが重たく、新規のツールを導入しづらい。 13 | * 導入しづらい環境では、外部のツールを導入するより自分で道具を作ってしまう方が効果的と考えてしまう場合がある。 14 | 15 | ### 解決 16 | * [3分クッキング](Three-minuteCooking.html)による変化の第一歩。誰かがツールを使えるようになり、実際に使って見せて、効果を知る機会をつくる。作業担当者が気軽に使いたいと思えるようにしていく。 17 | * [インディ・ジョーンズ](IndianaJones.html)の遺産の発見により、一気に自動化が進むこともある。 18 | * [強くてニューゲーム](RestartWithoutReset.html)した強者を発見できれば、今後の運用も含めて貴重な意見を聞くことができる。 19 | 20 | ### 結果 21 | 現場においてツールの導入や選定ができるようになり、自動化が少しずつ進み始めた。 22 | -------------------------------------------------------------------------------- /Content/NotOnlyForTesting.md: -------------------------------------------------------------------------------- 1 | ## テストだけとか勿体無い！ 2 | 自動テストを突き詰めていくと、デプロイなどテスト以外のところにも目が行くようになってくる。DevOps的な技術を活用し、テスト以外にも自動化の網をひろげていくことで、より効率的でミスの少ない開発体制の構築が可能になる、というパターン。 3 | -------------------------------------------------------------------------------- /Content/Old-GuardsUprising.md: -------------------------------------------------------------------------------- 1 | ## 原住民蜂起 2 | ### 文脈 3 | 昔ながらの製法で、伝統を大切に守りながらのテストが行われている組織である。自動化をする開発環境ではなく、周りに自動テストの事例が殆どない状態にある。そんな中で、一部の興味を持った人が自動テストを導入しようとしている。 4 | 5 | ### 問題 6 | 推進できる人が自動化に関する追加の作業で忙しくなり、取り組みに対する効果が出てこない。また、管理職からの支援がなく、工数に見合った結果が出ていないとの評価で取り組みが失敗に終わる。 7 | 8 | ### フォース 9 | 歴史をもつ保守的な組織は、変化を好まない傾向にある。自動テストを導入しようとしている人達には伝統的なテストを壊すだけの力を持ち合わせていない。 10 | 11 | ### 解決 12 | * 自動テストをやりたい人が、手探りながら事例を積み上げる。 13 | * 組織を変えるために理解を求める努力を行う。 14 | * 裏で対抗組織の力を蓄える(能力)。 15 | 16 | ### 結果 17 | * 自動テストに対する理解が高まりつつある。 18 | * 自動テストを実施可能な知識や技術が蓄えられている。 19 | * 10週打ち切りまでに、上位の理解を得ていく。 20 | -------------------------------------------------------------------------------- /Content/QuakAndExpensiveGoodDoctor.md: -------------------------------------------------------------------------------- 1 | ## ヤブ医者とブラックジャック 2 | ### 文脈 3 | [ダッシュボード](Dashboard.html)により結果も整備されるようになった。 4 | ある日から「ソースコードもテストも修正していないのに、NGになった」「テストされていなかっただけで、デグレは起きていた」と頻繁に報告されるようになった。 5 | 6 | ### 問題 7 | テスト自動化の信頼性が低い ( = 「テストのしかけ」の信頼性が低く、テスト結果に間違いがある。または、テスト結果は正しいがデグレード検知に向いたテストになっていない) 8 | 9 | ### フォース 10 | * テストの結果をもって品質を判断するとした場合、その判断は「テストのしかけ」の品質に依存する。が、「テストのしかけ」の品質を評価することは導入時点では難しい。 11 | * 人は、判断の際、定性的な報告・事実であるかどうかを確認する必要がある情報よりも、定量的な報告・機械的な情報のほうを信じたくなる。 12 | * 回帰テストが十分であるかどうかは、テスト自動化とは直接は関係ない。が、自動的なシステムが動き出すと、そのシステムという箱で信じてしまう。 13 | 14 | ### 解決 15 | テストのしかけの信頼性が低いことによる損失と、修理する費用とで天秤をかけよう。回帰テストが十分かどうかについて、気になった時点でテスト設計を確認しよう。ただし、そういったことを確認できる人は自動化環境を前提としたプロジェクトでは維持できていないことが多く、その場合かなりの費用を支払うことを覚悟しておきたい。 16 | 17 | ### 結果 18 | * 直した分だけテストの結果を信用できるようになる。（ただし、老化とともに再発するが） 19 | * 辛抱強く「テストのしかけ」を回収することで、自動化を導入した環境においても人材が成長し、[全員がブラックジャック](WeAreMeisters.html)になれるかもしれない。 20 | -------------------------------------------------------------------------------- /Content/README.md: -------------------------------------------------------------------------------- 1 | # テスト自動化パターン言語プロジェクト 2 | 3 | これは、[関西検証コレクション](http://connpass.com/series/489/) にて議論された、テスト自動化の暗黙知について、パターン言語へとまとめる試みを行っている[プロジェクト](https://github.com/KenColle/AutomationPatternLanguage)です。 4 | 表現のおかしな所や異論がある場合は、Issuesに投げてもらうか、Forkしてプルリクをいただければ全力で検討を行います！ 5 | 6 | 7 | --- 8 | #### ライセンスについて 9 | クリエイティブ・コモンズ・ライセンス
この 作品 は クリエイティブ・コモンズ 表示 3.0 非移植 ライセンスの下に提供されています。 10 | -------------------------------------------------------------------------------- /Content/RestartWithoutReset.md: -------------------------------------------------------------------------------- 1 | ## 強くてニューゲーム 2 | ### 文脈 3 | 自動化を試みていたが、[原住民蜂起](Old-GuardsUprising.html)により既存の手動テストが復活し、文化は一度滅びてしまった。 4 | 5 | ### 問題 6 | 一度滅びてしまったものを立て直せず、再手動化されたテストを淡々とこなしてしまっている。 7 | 8 | ### フォース 9 | 自動化を取り巻く環境は厳しく、諦めさせられるような罠も各所にある。手探りで自動化を運用し始めた場合には、それらを避けて自動化を実施することは非常に困難である。 10 | 11 | ### 解決 12 | 一度失敗したとしても、どこに失敗があったのかを振り返ろう。例えば… 13 | 14 | * [自動化ハイ](AutomationFavor.html)になったせいでメンテナンス不能な[建て増し旅館](ExtensionBuildings.html)を構築してしまった 15 | * [テスト仕分け](TestClassification.html)を怠ったせいで[験担ぎ](LikeACharm.html)の意味が無いテストが増えすぎた 16 | 17 | ### 結果 18 | 失敗を活かし、同じ罠にはまらないようにテスト自動化を進めていくことが可能になる。 19 | -------------------------------------------------------------------------------- /Content/SUMMARY.md: -------------------------------------------------------------------------------- 1 | * [テスト自動化パタン言語 オーバービュー](Introduction.md) 2 | * 自動化開始のためのパターン 3 | * [求む！英雄](NeedHero.md) 4 | * [3分クッキング](Three-minuteCooking.md) 5 | * [インディ・ジョーンズ](IndianaJones.md) 6 | * 自動化導入のためのパターン 7 | * [クラウドトーク（もやもやした会話）](AmbigiousTalk.md) 8 | * [全体像を描く](BluePrint.md) 9 | * [まずは“効く”ところから](MostEfficientPartFitst.md) 10 | * [ダッシュボード](Dashboard.md) 11 | * [自動化ハイ](AutomationFavor.md) 12 | * [ビッグバン自動化](Big-bangAutomation.md) 13 | * [ついで症候群](Along-the-WaySyndrome.md) 14 | * [建て増し旅館](ExtensionBuildings.md) 15 | * [テスト仕分け](TestClassification.md) 16 | * [信頼性バトル（信頼性イタチゴッコ）](Cat-and-MouseGameofReliability.md) 17 | * [ヤブ医者とブラックジャック](QuakAndExpensiveGoodDoctor.md) 18 | * 自動化の定着、あるいは終了 19 | * [俺たち全員ブラックジャック](WeAreMeisters.md) 20 | * [テストだけとか勿体無い！](NotOnlyForTesting.md) 21 | * [もっと、人間らしく](YouAreHuman.md) 22 | * [文明の曙](DawnOfCivilization.md) 23 | * [験担ぎ](LikeACharm.md) 24 | * [アンチ自動化](Anti-Automation.md) 25 | * [原住民蜂起](Old-GuardsUprising.md) 26 | * [強くてニューゲーム](RestartWithoutReset.md) 27 | -------------------------------------------------------------------------------- /Content/TestClassification.md: -------------------------------------------------------------------------------- 1 | ## テスト仕分け 2 | ### 文脈 3 | シナリオベースの自動化テストで、何をテストしたいのかわからないテストコードに埋め尽くされており、プロダクトコードが価値を実現できているかわからなくなってきている。 4 | 5 | ### 問題 6 | 目的不明なテストをパスすることが足かせになり、プロダクトコードのメンテナンスが困難になっている。 7 | 8 | ### フォース 9 | * テストを書く人が何を検証すべきなのか理解できていない。 10 | * エンジニアにドメイン知識が伝わっていない 11 | * エンジニア同士のコミュニケーションの断絶 12 | 13 | ### 解決 14 | テストの意図を調べ、確認できなかったテストコードを捨てる。 15 | 重要なシナリオを抽出して、その価値を検証するテストケースを自動化する 16 | 17 | ### 結果 18 | * 無駄なテストコードが消えることで、プロダクトコードの変更がやりやすくなる 19 | -------------------------------------------------------------------------------- /Content/Three-minuteCooking.md: -------------------------------------------------------------------------------- 1 | ## 3分クッキング 2 | ### 文脈 3 | 自動化は組織にとって殆ど初めての経験であり、知見などはほとんど蓄積されていない。識者も「自分だけ」という状況である。 4 | 5 | ### 問題 6 | * 自動化ツールのハードルが高く、どうやって導入すればいいか分からない 7 | * 自動化の導入に工数を割くことが難しい 8 | 9 | ### フォース 10 | * 開発の中で、うまくいくかわからないものに時間を割くことが難しいことが多い 11 | * 仮に苦しんで自動化ツールを導入できたとしても、時間だけがかかり効果があまり目に見えるものにならなかった場合、あまりインパクトを与えられない。 12 | * 導入においては、コストパフォーマンスが高いように見せることが重要である。 13 | 14 | ### 解決 15 | * 事前に自分の環境で、ある程度の構築をしておき、ツールなどを紹介すると同時に一気に運用までもっていけるよう紹介した。 16 | 17 | ### 結果 18 | * まず第一関門を突破。これ以降、[クラウドトーク（もやもやした会話）](AmbigiousTalk.html)に陥らないようコミュニケーションを取りながら、まず[全体像を描き](BluePrint.html)、堅実に進めていくことが重要である。 19 | -------------------------------------------------------------------------------- /Content/WeAreMeisters.md: -------------------------------------------------------------------------------- 1 | ## 俺たち全員ブラックジャック 2 | ### 文脈 3 | 自動化システムが成長し、適宜のメンテナンスが必要な状態となっている。 4 | 5 | ### 問題 6 | 成長したシステムが、しばしば落ちるようになってしまっている。それを修正できる人間は設計者であるブラックジャックであり、属人化してしまっている。 7 | 8 | ### フォース 9 | テスト自動化の結果、テストは文書に書かれたテストスクリプトを実行していく単純な作業ではもはやない。そんな時には、スキルの未熟な[ヤブ医者](QuakAndExpensiveGoodDoctor.html)により、テスト自動化システムの全体設計を無視したようなテストのしかけを追加されることがある。またそういった不具合を修正しようとする場合、スキルの高い一部の技術者に頼ってしまうことになりがちである。 10 | 11 | 12 | ### 解決 13 | 一人のスーパーマンだけがメンテナンスするのではなく、複数人の技術者によりメンテナンスを行い、技術の継承、及びメンバーのスキルアップを図ろう。 14 | 15 | ### 結果 16 | メンバー全員のスキルが上がり、だれでも自動化システムのメンテナンスを行うことができるようになった。また、自動テストの実装は自動化システムだけでなく、テスト対象の理解を促進する効果もある。 17 | -------------------------------------------------------------------------------- /Content/YouAreHuman.md: -------------------------------------------------------------------------------- 1 | ## もっと、人間らしく 2 | * 元来手動で行っていた、自動化できるテストを自動化し、より人間の力が必要となるテストに集中させることができる、というパターン。 3 | -------------------------------------------------------------------------------- /patterns.dot: -------------------------------------------------------------------------------- 1 | digraph graphname { 2 | rankdir = LR; 3 | 4 | node [shape=ellipse style=filled colorscheme=accent6]; 5 | graph [concentrate = true]; 6 | 7 | subgraph cluster_0 { 8 | "求む！英雄"[color=1] 9 | "３分クッキング"[color=1] 10 | "インディジョーンズ"[color=1] 11 | 12 | label = "自動化開始のためのパターン" 13 | 14 | { rank = same; 求む！英雄 } 15 | { rank = same; ３分クッキング; インディジョーンズ } 16 | 17 | } 18 | 19 | subgraph cluster_1{ 20 | 21 | "全体像を描く"[color=1] 22 | "ダッシュボード"[color=1] 23 | 24 | 25 | "クラウドトーク"[color=6] 26 | "自動化ハイ"[color=6] 27 | "ビッグバン自動化"[color=6] 28 | "ついで症候群"[color=6] 29 | "建て増し旅館"[color=6] 30 | 31 | "まずは”効く”ところから"[color=1] 32 | 33 | "テスト仕分け"[color=1] 34 | "信頼性バトル"[color=1] 35 | "ヤブ医者とブラックジャック"[color=1] 36 | 37 | "皮をむく"[color=1] 38 | "ピンを生やす"[color=1] 39 | "皮もおいしく"[color=1] 40 | 41 | label = "自動化導入期のパターン" 42 | 43 | { rank = same; 全体像を描く; クラウドトーク;自動化ハイ;} 44 | { rank = same; ダッシュボード; 建て増し旅館; ビッグバン自動化; ついで症候群;まずは”効く”ところから} 45 | { rank = same; テスト仕分け;信頼性バトル;ヤブ医者とブラックジャック} 46 | 47 | } 48 | 49 | 50 | subgraph cluster_2{ 51 | "アンチ自動化"[color=6] 52 | "文明の曙"[color=1] 53 | "もっと、人間らしく"[color=1] 54 | "俺たち全員ブラックジャック"[color=1] 55 | "テストだけとか勿体無い！"[color=1] 56 | "験担ぎ"[color=6] 57 | "原住民蜂起"[color=6] 58 | "強くてニューゲーム"[color=1] 59 | 60 | "自動家を作る"[color=1] 61 | 62 | label = "自動化の定着、あるいは終焉のパターン" 63 | 64 | { rank = same; もっと、人間らしく;俺たち全員ブラックジャック; 験担ぎ; アンチ自動化} 65 | { rank = same; テストだけとか勿体無い！;原住民蜂起;} 66 | { rank = same; 文明の曙;強くてニューゲーム;} 67 | } 68 | 69 | 70 | 求む！英雄 -> ３分クッキング -> クラウドトーク -> 建て増し旅館 -> ヤブ医者とブラックジャック -> 俺たち全員ブラックジャック -> 文明の曙 71 | 求む！英雄 -> インディジョーンズ -> 全体像を描く-> まずは”効く”ところから 72 | 求む！英雄 -> 強くてニューゲーム 73 | 74 | 75 | ３分クッキング -> 全体像を描く; 76 | ３分クッキング -> 自動化ハイ; 77 | 78 | 79 | インディジョーンズ -> 自動化ハイ; 80 | 81 | 全体像を描く -> ダッシュボード 82 | 全体像を描く -> もっと、人間らしく 83 | 全体像を描く -> テストだけとか勿体無い！ 84 | 85 | まずは”効く”ところから -> ダッシュボード 86 | 87 | クラウドトーク -> ビッグバン自動化 88 | クラウドトーク -> ついで症候群 89 | 自動化ハイ -> 建て増し旅館 90 | 91 | 92 | 建て増し旅館 -> 験担ぎ 93 | 94 | ビッグバン自動化 -> 信頼性バトル -> 俺たち全員ブラックジャック 95 | 96 | ついで症候群 -> アンチ自動化 97 | ついで症候群 -> テスト仕分け 98 | 99 | 100 | テストだけとか勿体無い！ -> 文明の曙 101 | 102 | 俺たち全員ブラックジャック -> 文明の曙 103 | 104 | 験担ぎ -> アンチ自動化 105 | 106 | アンチ自動化 -> 原住民蜂起 107 | 108 | 原住民蜂起 -> インディジョーンズ 109 | 原住民蜂起 -> 強くてニューゲーム 110 | } -------------------------------------------------------------------------------- /readme.md: -------------------------------------------------------------------------------- 1 | # テスト自動化パターン言語プロジェクト 2 | 3 | これは、[関西検証コレクション](http://connpass.com/series/489/) にて議論された、テスト自動化の暗黙知について、パターン言語へとまとめる試みを行っているプロジェクトです。 4 | 表現のおかしな所や異論がある場合は、Issuesに投げてもらうか、Forkしてプルリクをいただければ全力で検討を行います！ 5 | 6 | Github Pagesによるホスティングは[こちら](http://kencolle.github.io/AutomationPatternLanguage/)。 7 | 8 | --- 9 | #### ライセンスについて 10 | クリエイティブ・コモンズ・ライセンス
この 作品 は クリエイティブ・コモンズ 表示 3.0 非移植 ライセンスの下に提供されています。 11 | --------------------------------------------------------------------------------