TE
科技回声
首页24小时热榜最新最佳问答展示工作
GitHubTwitter
首页

科技回声

基于 Next.js 构建的科技新闻平台,提供全球科技新闻和讨论内容。

GitHubTwitter

首页

首页最新最佳问答展示工作

资源链接

HackerNews API原版 HackerNewsNext.js

© 2025 科技回声. 版权所有。

Ask HN: How do you document a server?

1 点作者 rxlim超过 8 年前
<p><pre><code> - Do you describe all steps from OS installation to application setup? - What do you use to create the documentation? - Where do you store the documentation? </code></pre> Any information related to server documentation is relevant.

2 条评论

snowcrshd超过 8 年前
Hmm, interesting question. I&#x27;d like to know how other people do it.<p>At work, we generally don&#x27;t write narrative documentation for server setup. It requires quite the effort to make sure it doesn&#x27;t go stale.<p>Instead, we keep Ansible playbooks on a Git repository. Every change we make to the server setup is done through the playbooks. Git commits provide a history of the changes made (we usually write the why in the long commit message).<p>Usually just having a README with information on how to run the playbooks and which distro the playbooks are based on is enough.
savethefuture超过 8 年前
Recently, I&#x27;ve been wanting to document how I setup my servers. I would start from a blank slate base linux install and go from there, listing each command I run and what it does. Then building off each command into the next leading the reader through the steps of configuration and installation of software. This is all for a blog, so take that into consideration.