好的部署文档中应包含哪些类型的信息？[关闭]

Question

我和同事们在部署文档的组成方面不断发生争执。

每个人都同意文档是必要的。并不是每个人都能找到共同点，特别是在区分大型版本、错误修复和增强功能时应详细程度如何。

您发现什么最适合您？

Answer 1

如果您的文档目的是确保以可重复的方式部署代码，那么以下是推荐的最低实践：

1. 发布内容、更改内容、版本、解决方案文件所在位置等的摘要。
2. 列出可能的依赖项
3. 详细部署流程
4. 安装所需的数据库更改或脚本
5. 有关如何配置应用程序的配置摘要。
6. 可以运行关键功能测试来验证安装是否正常运行。
7. 回滚过程 - 如果需要。

Answer 2

我发现，建立一个工具，允许一个键式部署较周密的部署文档好得多。

Answer 3

什么是你的文件的目的是什么？从那里开始，图什么符合这一目标。

对于我们来说，我们的目标是使一个人全新的组可以执行新的或更新的部署几个不同的系统。我们我们工作的汤到坚果样的操作 - Windows服务，cron作业，数据库备份，网站更新等

在每一种情况下，细节的水平，基于该系统，哪些新的团队成员将需要执行的更新和新的部署。