Deployinator 使用指南

1. 项目目录结构及介绍

Deployinator 是一个由 Etsy 开发并维护的部署框架，旨在简化代码部署流程。以下是基于 etsy/deployinator 的典型项目目录结构概述：

• config: 此目录存储着 Deployinator 的核心配置文件。base.rb 是基础配置，定义了应用的基本设置，包括栈（stacks）的基础配置。
• lib: 包含主要的业务逻辑和类定义，是 Deployinator 功能实现的核心部分。
• log: 日志存放位置，包括部署操作的日志记录。
• public: 如果有前端交互或静态资源，它们通常放在这里，但在 Deployinator 中这可能用于前端界面相关的静态资源。
• Rakefile: 定义 Rake 任务，如初始化新的栈配置或管理部署任务。
• script: 可能包含一些脚本文件，用于特定的操作或辅助开发过程。
• Gemfile: 描述了项目的依赖关系，对于部署和运行 Deployinator 至关重要。
• config.ru: Rack 应用的入口点，用于启动Sinatra或者其它Rack兼容服务器。

2. 项目的启动文件介绍

config.ru

这是部署应用的启动脚本，用于 Rack 兼容的服务器（比如 Puma）。它加载 Deployinator 的应用程序上下文并准备服务请求。基本结构会启动你的Sinatra应用，通过指定的服务器来监听网络连接。示例配置中，启动命令可能是这样的：

require ::File.expand_path('../config/environment',  __FILE__)
run Deployinator::App

这意味着当你运行类似 bundle exec puma -b tcp://0.0.0.0:7777 config.ru 的命令时，它将通过Puma在指定端口上启动Deployinator的服务。

3. 项目的配置文件介绍

config/base.rb

这是配置的核心，包含了整个部署系统的通用设定。值得注意的关键配置项有：

• Stacks定义: 在这里划分不同的部署栈，如“web”、“search”，以及各自对应的环境（如“staging”、“production”）。
• 部署路径和仓库信息: 指定每个栈的源码克隆位置、部署目标主机等。
• 部署行为配置: 包括自动部署触发条件（比如每次成功构建后自动部署）、符号链接、配置文件处理等。

例如，你需要替换 test_stack 为你的实际栈名，并配置相应的生产主机地址和检出路径：

Deployinator.app_context['your_stack_name_config'] = [
  :prod_host => "your.production.host",
  :checkout_path => "/path/to/your/deployment/"
]

此外，配置文件还允许定制化Git仓库URL、部署步骤、日志记录和统计显示等。

总结起来，Deployinator通过精心设计的目录结构和配置选项提供了高度灵活且可定制化的部署解决方案。正确配置这些关键组件是成功部署应用的前提。