
平臺(tái) 論壇博客文庫(kù)

› 論壇 › IT運(yùn)維 › 監(jiān)控及自動(dòng)化運(yùn)維技術(shù) › 【原創(chuàng)】如何寫一本技術(shù)類的書

[puppet] 【原創(chuàng)】如何寫一本技術(shù)類的書 [復(fù)制鏈接]

7717060

版主

論壇徽章:: 0

電梯直達(dá)

1樓 [收藏(0)] [報(bào)告]

發(fā)表于 2015-11-11 21:35 |只看該作者 |倒序?yàn)g覽

源文：http://blog.puppeter.com/read.php?13
開篇
雖然工作多年，但是對(duì)系統(tǒng)技術(shù)癡迷熱情從未改變，所以在2015年初，歷時(shí)1年多寫的《Puppet權(quán)威指南》書發(fā)行了。在與很多朋友技術(shù)交流過程當(dāng)中了解很多人也有類似寫書的想法，經(jīng)常有人問你出書的流程是什么？如何來寫一本書？出書的收益又如何？等問題。綜合這些問題，我也來分享一下：

如何萌生寫書想法；
寫書的流程是什么；
如何將過程轉(zhuǎn)化為收益。

希望通過介紹整個(gè)過程，能讓更多有意的朋友能為業(yè)界提供更多的思路與創(chuàng)新技術(shù)(注：由于筆者能力水平有限，在寫作過程中難免會(huì)有錯(cuò)字、語句不通順等情況。如果大家有任何疑問可以給我留言，我會(huì)盡快回復(fù)與更正，非常感謝)。

如何萌生寫書想法
回憶了一下，首先從來沒想要寫書，只是偶然的機(jī)會(huì)而已。在2001年左右，上高中時(shí)很喜Photoshop和3Dmax，在那時(shí)我就已經(jīng)會(huì)安裝Windows 98操作系統(tǒng)，在班級(jí)中公認(rèn)的是一個(gè)計(jì)算機(jī)高手。另外，我也經(jīng)常買《電腦報(bào)》、《網(wǎng)友世界》和《黑客X檔案》雜志，通過XCAN來掃描遠(yuǎn)程服務(wù)器開放端口，并根據(jù)掃描后端口確認(rèn)是否有漏洞，這些對(duì)于那時(shí)的我會(huì)帶來很多的成就感與自豪感，記憶中曾多次一條命令就可以讓網(wǎng)吧遠(yuǎn)程的系統(tǒng)藍(lán)屏，但有一次在網(wǎng)上遇到了牛人，他能隨意改我的QQ密碼，盜取我的163賬號(hào)，查IP地址能定位到我的家門牌號(hào)，那一刻我覺得自己弱爆了，后來經(jīng)常與他交流學(xué)習(xí)經(jīng)驗(yàn)，那時(shí)我最不喜歡學(xué)習(xí)編程語言，而他說你要做為一個(gè)優(yōu)秀的黑客就要去學(xué)習(xí)編程語言和網(wǎng)絡(luò)協(xié)議，也是那時(shí)他讓我第一次知道TCP/IP協(xié)議的三卷書，通過與他交流與指導(dǎo)，我開始自學(xué)C編程語言，學(xué)了才知道C語言并沒有想象中那么難。

后來上了大學(xué)，操作系統(tǒng)中學(xué)了Linux，了解他歷史的都應(yīng)該知道玩Linux才是真正的黑客，所以那時(shí)去電腦市場(chǎng)買了一個(gè)Redhat6.0版本的系統(tǒng)盤來安裝，安裝后不知道怎么用，在網(wǎng)上查資料時(shí)知道了www.chinaunx.net（簡(jiǎn)稱CU），那年是2006年，因?yàn)槲业腃U ID（研究生）注冊(cè)時(shí)間就是2006年。從CU學(xué)到了很多東西，譬如記憶深刻的《門戶網(wǎng)站運(yùn)維abc》、《Shell能力測(cè)試》和《Shell基礎(chǔ)20篇》等都是很好的學(xué)習(xí)資料, 還有一篇文章來描述如何學(xué)習(xí)Linux，大概中心是要想學(xué)好Linux；
多看書；
多實(shí)踐；
多總結(jié)沉淀；
遇到問題自己查找資料解決，解決不了再尋求幫助；
如果學(xué)習(xí)的知識(shí)點(diǎn)都掌握了，多去幫助他人解決問題，其實(shí)幫助他人也是自己學(xué)習(xí)的一個(gè)過程。
所以，在CU經(jīng)常找別人問的問題，看是否能解決，如果解決不了再去網(wǎng)上找解決思路與過程，那時(shí)也是因?yàn)檫@原因，我寫了很多文檔，由于看了Shell編程13問的文章，忽然覺得我的文檔總結(jié)可以寫成一本書的形式與別的朋友進(jìn)行分享，經(jīng)過對(duì)文檔總結(jié)提煉與打磨，最終在2008年寫出了第一版本，不過現(xiàn)在已經(jīng)找不到最初的版本了，在電腦里找到了2010年最后變更時(shí)間的書，無意間人生的第一本書就這樣的寫完了。

2008年在北京工作后，一天在QQ忽然有人問我，看你CU比較活躍是否可以可以來我們這里幫講一些網(wǎng)絡(luò)的課程，我抱著試試看的態(tài)度應(yīng)邀去了華章的編輯社，去了才知道這是有名的機(jī)械工業(yè)出版社，我很喜歡買他們書。到了后是一位美女來接我，交談中我說我寫過書，美女說是否可以發(fā)我看看，幾天后我提交了一份書的原本發(fā)給編輯社，美女幫我指定了出版策劃（楊福川），第一次與福川見面時(shí)在中關(guān)村的麥當(dāng)勞，感覺一見如故與技術(shù)人交談很開心，他看過我給的文檔后，給了我很多出書的建議，說對(duì)于剛出茅廬的我書的內(nèi)容還是很好的，但對(duì)于出版來說要走的路還要很多，不過也鼓勵(lì)我，希望有機(jī)會(huì)能合作出一本書。就這樣幾年過去了，應(yīng)該是2012年系統(tǒng)架構(gòu)師大會(huì)，再次遇見福川，福川問是否有興趣來寫書，我說OK沒問題，正好由于內(nèi)部部門產(chǎn)品變動(dòng)，我負(fù)責(zé)的系統(tǒng)沒有運(yùn)營(yíng)工具，我對(duì)Puppet進(jìn)行研究并在線上應(yīng)用。那時(shí)Puppet知道人并不是很多，所以一拍即合開始寫人生的第二本書《Puppet權(quán)威指南》。

寫書的流程
下定決心后寫書并不復(fù)雜，以下為寫書流程：
1）尋找一個(gè)靠譜出版社，因?yàn)樗麜?huì)有渠道幫你做后續(xù)推廣；
2）確認(rèn)寫書的標(biāo)題與大綱，其中大綱很重要，有一個(gè)目標(biāo)才好量化時(shí)間與寫作進(jìn)度。寫作大綱中一般還包含選題思路、讀者對(duì)象、內(nèi)容簡(jiǎn)介、市場(chǎng)分析、賣點(diǎn)分析、作者簡(jiǎn)介和營(yíng)銷建議這7項(xiàng)；
3）簽約合同，合同是雙方利益保障，對(duì)于出書者來說寫完出版社不出版，可以通過合同來約束。當(dāng)然，反過來沒按照預(yù)定寫出來，還是要陪違約金的（這也是簽約后動(dòng)力之一）。除此之外，還要確認(rèn)付款方式，兩種：
方式1：一次性買斷書的版權(quán)，即一次打完所有歀。
方式2：是按出版發(fā)行量計(jì)費(fèi)，根據(jù)書的售賣情況打款（我簽約的這種）
大家可以自己來確定付款方式（寫書并不掙錢，但是收益還是有很多的，一會(huì)會(huì)介紹）。
4）合同確認(rèn)后，策劃會(huì)分配一個(gè)編輯給作者。我的編輯（孫海亮）海亮給我的感覺三個(gè)詞形容，積極、專業(yè)和耐心。編輯會(huì)把控整體的進(jìn)度、寫作風(fēng)格、語句是否通順、是否能很好的讀者學(xué)習(xí)了解書中的專業(yè)知識(shí)內(nèi)容，然后就是定期發(fā)文稿給編輯；
5）最終出版社收到完整的書稿（齊、清、定）后會(huì)制定編輯加工計(jì)劃，并以書的形式打印出來各章，確認(rèn)排版與最終效果是否一致，前后有三次校對(duì)過程；
6）最后確定封面，出版與推廣；
7）根據(jù)約定出版社付稿酬。

流程中有很多值得分享的案例：
案例1:（做任何事，大多數(shù)人都會(huì)有一個(gè)熱情期，當(dāng)熱情變成負(fù)擔(dān)，這時(shí)如何來磨練自己讓負(fù)擔(dān)再轉(zhuǎn)為熱情？）
開始我寫書很有熱情第一個(gè)月就寫了兩章，將文稿發(fā)給海亮很快回復(fù)了我的郵件，當(dāng)我打開文稿到是挺喜慶的，滿篇的紅字，感覺像老師改小學(xué)生作文一樣，在其中提出了很多意見與建議，如何從讀者的角度來寫書等，其實(shí)那一時(shí)刻熱情已然不在，更多的是覺得變成的負(fù)擔(dān)，心想如果按照這樣寫下去何日能寫好，用一個(gè)月寫的文稿按海亮要求基本要從改一遍。果不其然，開始一個(gè)月寫兩章，到半年時(shí)我才寫了4章。不過，需要承認(rèn)海亮提的意見是非常好的，在寫過第6章回頭再看的時(shí)候，首先覺得是有成就感的，因?yàn)槲艺娴目偨Y(jié)出了很多內(nèi)容，接著對(duì)文章不斷的實(shí)踐與打磨，我對(duì)Puppet認(rèn)識(shí)也更加深入，所以日常的實(shí)踐打磨到后續(xù)的價(jià)值轉(zhuǎn)化，最后負(fù)擔(dān)又轉(zhuǎn)為了熱情。

案例2:（出版社很專業(yè)從一些細(xì)微的案例可以體現(xiàn)到）
在Puppet編程語言中有自己的if..else，如果作為我專業(yè)人士來描述，我會(huì)寫if 為真，怎么樣，否則為假怎么樣。海亮很耐心的和我解釋這里應(yīng)該如何寫，建議借鑒譚浩強(qiáng)老師寫的C語言編程中的對(duì)if..else描述，當(dāng)時(shí)我做了對(duì)比差異確實(shí)很大。
另外，我的書大約是2014年10月份最終完成，11月份印刷完畢，直到2015年1月份才正式出版，推遲兩個(gè)多月，原因是很多書店年底會(huì)清貨，11月份出版很容易被清理到書店不容器看到的地方，所以推遲發(fā)行。我相信這些建議與意見都是從日常工作中摸索總結(jié)出來的，是專業(yè)的表現(xiàn)。

案例3:（工作+寫書的時(shí)間分配）
如何的合理利用時(shí)間，通常我是周一到周五每天早上拿出半小時(shí)來閱讀之前寫的內(nèi)容，中午午休1小時(shí)來實(shí)踐Puppet，晚上1小時(shí)來繼續(xù)寫Puppet 。周六也拿出半天或一天時(shí)間來寫和改，保持一個(gè)節(jié)奏，這樣會(huì)比較輕松一點(diǎn)。

案例4：（如何豐富寫作內(nèi)容）
如果單寫Puppet工具應(yīng)用確實(shí)內(nèi)容不是很多，所以我從對(duì)比角度出發(fā)，首先是業(yè)界流行的配置管理工具都有哪些（Puppet vs Cfengine vs Chef）他們優(yōu)缺點(diǎn)是什么、我為什么選擇Puppet、與老牌配置管理工具Cfengine相比Puppet為什么可以彎道超車、Puppet都誰在應(yīng)用它、未來前景如何、它整套架構(gòu)與運(yùn)行原理如何、到最后實(shí)踐如何應(yīng)用它、都哪些場(chǎng)景適合使用它等。Puppet與很多工具軟件一樣，官方提供了詳細(xì)的文檔（http://docs.puppetlabs.com/）我們可以從這里獲取很多信息。更主要的是獲取信息后就是如何應(yīng)用在自己的工作場(chǎng)景中，解決了自己實(shí)際問題同時(shí)也讓讀者在真是需求場(chǎng)景下，能夠印象更加的深刻。

如何將過程轉(zhuǎn)化為收益
看一本書容易，但寫一本書還是挺難的，需要有毅力和時(shí)間去寫，寫的過程中需要不斷的對(duì)軟件應(yīng)用、實(shí)踐與打磨,具備了這些，我們就肯定會(huì)從寫作過程中得到收益。而寫書除了money更多是無形的收益，其中對(duì)于我個(gè)人的職業(yè)技術(shù)生涯收益，我抽象了以下五點(diǎn)：

1）總結(jié)沉淀與轉(zhuǎn)化能力
寫一本運(yùn)維工具相關(guān)的書，不但要對(duì)工具了解，還要了解工具的歷史，以Puppet工具為例它的作者（Luke Kanies）是一位優(yōu)秀的運(yùn)維工程師，有著多年的運(yùn)維工作經(jīng)歷，做運(yùn)維的都有過類似的經(jīng)歷接手一套產(chǎn)品相關(guān)的運(yùn)營(yíng)系統(tǒng)沒有運(yùn)營(yíng)文檔或者運(yùn)營(yíng)文檔不全是很悲劇的事情，當(dāng)然有的公司會(huì)強(qiáng)制要求員工寫文檔或者Wiki，優(yōu)勢(shì)是當(dāng)系統(tǒng)交接時(shí)，被交接的對(duì)象會(huì)通過文檔繞過一些坑，而且這也是比較好的習(xí)慣，但也有他的缺點(diǎn)就是這些系統(tǒng)文檔或Wiki并不實(shí)時(shí)與準(zhǔn)確，相信Puppet作者也有過這樣的經(jīng)歷，所以Puppet的解決思路是以編程語言形式，將當(dāng)前系統(tǒng)所需要的安裝軟件包配置描繪出來，通過輔助工具還可以以圖形式看到模塊之前的依賴狀況，而這一切都是實(shí)時(shí)的，一旦錯(cuò)誤線上馬上會(huì)體現(xiàn)出來，Puppet思路很好的解決的我們?cè)?jīng)面臨問題。而對(duì)于我后續(xù)做運(yùn)營(yíng)工具的思考，我的總結(jié)是“從運(yùn)維過程中獲取經(jīng)驗(yàn)，根據(jù)經(jīng)驗(yàn)發(fā)明創(chuàng)造改進(jìn)工具，接著根據(jù)工具創(chuàng)造提煉技術(shù)，最后根據(jù)技術(shù)再提煉原理”。有理由相信這也是Puppet開發(fā)運(yùn)和營(yíng)過程中的體現(xiàn)。

2）模仿能力
如果領(lǐng)導(dǎo)讓我開發(fā)一套配置管理工具，相信我是有能力做出來的，但我也相信開發(fā)出來的配置管理工具只能滿足臨時(shí)的需求，長(zhǎng)期來看它根據(jù)需求要不斷的完善、重寫與迭代，而配置管理系統(tǒng)在業(yè)界有很多，譬如Puppet、Ansible、Cfengine和chef等，他們均是配置管理工具，其實(shí)更好的方式是使用它們，模仿它們和改造它們?yōu)槲覀児ぷ魉�，因�(yàn)樗鼈冇凶约旱拈_發(fā)社區(qū)、有多年的積淀、有非常好的思想能讓你去借鑒、它們像一種協(xié)議一樣統(tǒng)一了大家的思想，而這種思想對(duì)未來應(yīng)用到其他領(lǐng)域是十分有幫助的，所以這里如何借鑒與模仿很重要。

3）換位思考能力
對(duì)于一個(gè)專業(yè)的互聯(lián)網(wǎng)從業(yè)人員來講，希望把書介紹的盡量詳細(xì)與專業(yè)，書中可能會(huì)有一些工作中的術(shù)語，譬如“灰度”對(duì)于有工作經(jīng)驗(yàn)的朋友肯定知道他的含義，但是對(duì)于那些剛?cè)胄械呐笥褏s不知所云，所以我們要換位思考，以讀者而且是剛?cè)胄械淖x者角度，盡量的白話書中的專業(yè)術(shù)語。這種換位思考能力不但可以應(yīng)用寫書，還可以在生活與工作中得到借鑒。

4）溝通與分享能力
思想就是武器，能說才是火力，光有武器火力不太猛還不行，如何在寫書過程中不斷的補(bǔ)充武器來提升火力很重要，因?yàn)槿魏我恍袠I(yè)都要有交流溝通，特別是互聯(lián)網(wǎng)行業(yè)尤為突出，所以總結(jié)每一章后，要想如何把他講出來分享給其他人，這種分享過程可能先是文章、然后是技術(shù)博客、接著抽象出原理，最后是與同事來分享它，提升自己溝通與分享能力。

5）運(yùn)營(yíng)能力
等書出來了，最后就是自己的運(yùn)營(yíng)能力。引用
網(wǎng)上有一篇文章（Google通過Puppet管理超過6000臺(tái)的蘋果桌面操作系統(tǒng)）地址：http://my.oschina.net/HankCN/blog/180105

，我個(gè)人覺得這是一句有炒作的嫌疑，當(dāng)時(shí)Puppet管理服務(wù)器能力并不是很強(qiáng)，而Google是很多技術(shù)公司的標(biāo)桿，所以此新聞一出有一定的炒作意義，既然標(biāo)桿用的都是Puppet工具，相信它也可以用在更多的公司中，而之所以Puppet使用廣泛可以彎道超車與他的公司運(yùn)營(yíng)能力也有一定的關(guān)系。

最后，我想說的是寫書分為兩種，一種是有時(shí)效性的，一種是相對(duì)沒有時(shí)效性的，TCP/IP三卷書就是相對(duì)沒有時(shí)效性的，如果TCP/IP協(xié)議不變，寫一本這樣的書收益可以一直延續(xù)下去，而我寫的工具書是有時(shí)效性的也許是1-2年，因?yàn)镻uppet版本是在不斷的迭代變更，但不管他如何改變，他值得學(xué)習(xí)的創(chuàng)新思路是永遠(yuǎn)不變的。所以走過這條路，也許繞了很多彎，調(diào)整心態(tài)，堅(jiān)持走下去，即便是彎路，也可以收獲美景。

鳴謝
很多書會(huì)在開篇提起感謝很多人，開始沒什么感覺，寫過書之后才體會(huì)到了這一點(diǎn)，因?yàn)橛辛四銈兊闹С郑艜?huì)讓我堅(jiān)持又堅(jiān)持完成這本書，所以這篇文章最后要感謝曾經(jīng)在寫作過程中幫助過我的人，特別是我的老婆，感謝。