使用 Supervisor 管理不同 Git 分支的应用部署

本文旨在讲解如何利用 Supervisor 管理部署在不同 Git 分支上的应用程序。Supervisor 本身不直接感知 Git 分支，但通过在不同目录下检出不同分支的代码，并配置 Supervisor 针对不同目录下的应用程序进行管理，可以实现灵活的部署方案。这种方法允许你在同一服务器上运行不同版本的应用程序，便于测试、灰度发布或维护多个稳定版本。

Supervisor 与 Git 分支管理

Supervisor 是一个进程管理工具，它负责监控和管理 Linux 系统中的进程。它并不知道 Git 的存在，也不关心你的代码是如何管理的。Supervisor 仅仅是执行文件系统中的可执行文件。因此，要使用 Supervisor 管理不同 Git 分支的应用，核心思路是将不同分支的代码检出到不同的目录，然后配置 Supervisor 针对这些目录下的应用进行管理。

实现步骤

1. 创建不同的目录:

   为每个需要运行的 Git 分支创建一个独立的目录。例如，你可以创建 app_master 和 app_branch_1 两个目录，分别用于存放 master 分支和 branch_1 分支的代码。

   mkdir /home/ubuntu/app_master
   mkdir /home/ubuntu/app_branch_1

2. 检出不同的 Git 分支:

   使用 git clone 命令将代码仓库克隆到每个目录中，并切换到相应的分支。

   cd /home/ubuntu/app_master
   git clone <your_git_repository_url> .
   git checkout master
   
   cd /home/ubuntu/app_branch_1
   git clone <your_git_repository_url> .
   git checkout branch_1

3. 配置 Supervisor:

   修改 Supervisor 的配置文件，为每个分支的应用创建一个独立的程序配置。 关键在于 directory 选项，它指定了 Supervisor 运行应用的目录。

   [program:app_master]
   command=/home/ubuntu/app_master/a-venv/bin/uvicorn a.path.main:app --host=0.0.0.0 --port 9009 --loop uvloop --log-level info
   directory=/home/ubuntu/app_master
   user=ubuntu
   autostart=true
   autorestart=true
   
   [program:app_branch_1]
   command=/home/ubuntu/app_branch_1/a-venv/bin/uvicorn a.path.main:app --host=0.0.0.0 --port 9009 --loop uvloop --log-level info
   directory=/home/ubuntu/app_branch_1
   user=ubuntu
   autostart=true
   autorestart=true

   注意: 确保 command 选项中指定的可执行文件路径与对应的分支目录一致。 另外，确保虚拟环境的路径也是正确的，每个分支都应该有独立的虚拟环境。

4. 更新 Supervisor 配置:

   使用 supervisorctl 命令更新 Supervisor 的配置，并启动相应的程序。

   sudo supervisorctl reread
   sudo supervisorctl update
   sudo supervisorctl start app_master
   sudo supervisorctl start app_branch_1

示例

假设你的 Git 仓库地址为 git@github.com:your_username/your_repo.git，你的应用入口文件为 a/path/main.py，并且你已经创建了虚拟环境。以下是一个完整的示例：

1. 创建目录并检出代码:

   mkdir /home/ubuntu/app_master
   cd /home/ubuntu/app_master
   git clone git@github.com:your_username/your_repo.git .
   git checkout master
   python3 -m venv a-venv
   source a-venv/bin/activate
   pip install -r requirements.txt  # 如果有 requirements.txt 文件
   
   mkdir /home/ubuntu/app_branch_1
   cd /home/ubuntu/app_branch_1
   git clone git@github.com:your_username/your_repo.git .
   git checkout branch_1
   python3 -m venv a-venv
   source a-venv/bin/activate
   pip install -r requirements.txt # 如果有 requirements.txt 文件

2. 配置 Supervisor:

   将以下内容添加到 /etc/supervisor/conf.d/your_app.conf 文件中：

   [program:app_master]
   command=/home/ubuntu/app_master/a-venv/bin/uvicorn a.path.main:app --host=0.0.0.0 --port 9009 --loop uvloop --log-level info
   directory=/home/ubuntu/app_master
   user=ubuntu
   autostart=true
   autorestart=true
   environment=PATH="/home/ubuntu/app_master/a-venv/bin:%(ENV_PATH)s"
   
   [program:app_branch_1]
   command=/home/ubuntu/app_branch_1/a-venv/bin/uvicorn a.path.main:app --host=0.0.0.0 --port 9009 --loop uvloop --log-level info
   directory=/home/ubuntu/app_branch_1
   user=ubuntu
   autostart=true
   autorestart=true
   environment=PATH="/home/ubuntu/app_branch_1/a-venv/bin:%(ENV_PATH)s"

   注意: environment 选项用于确保 Supervisor 运行的应用能够找到虚拟环境中的可执行文件。

3. 更新并启动 Supervisor:

   sudo supervisorctl reread
   sudo supervisorctl update
   sudo supervisorctl start app_master
   sudo supervisorctl start app_branch_1

注意事项

• 虚拟环境: 强烈建议为每个分支创建独立的虚拟环境，以避免依赖冲突。
• 目录结构: 确保每个分支的代码都位于独立的目录中，并且 directory 选项指向正确的目录。
• 配置文件: Supervisor 的配置文件应该清晰易懂，方便维护。
• 部署脚本: 可以编写脚本自动化代码检出、虚拟环境创建和 Supervisor 配置更新等步骤，简化部署流程。
• 端口冲突: 如果两个应用使用相同的端口，需要修改其中一个应用的端口配置，避免端口冲突。
• 资源占用: 同时运行多个分支的应用会消耗更多的系统资源，需要根据服务器的配置进行调整。

总结

通过在不同的目录下检出不同的 Git 分支，并配置 Supervisor 针对这些目录下的应用进行管理，可以实现灵活的部署方案。 这种方法允许你在同一服务器上运行不同版本的应用程序，便于测试、灰度发布或维护多个稳定版本。 在实际应用中，应该结合具体的项目需求和服务器配置，选择合适的部署方案。 记住，Supervisor 只是一个进程管理工具，它并不直接感知 Git 的存在，关键在于如何组织文件系统，并正确配置 Supervisor。

以上就是使用 Supervisor 管理不同 Git 分支的应用部署的详细内容，更多请关注php中文网其它相关文章！