0

0

Deployer 中为不同环境指定 Git 分支的完整配置指南

聖光之護

聖光之護

发布时间:2026-02-03 20:11:02

|

742人浏览过

|

来源于php中文网

原创

Deployer 中为不同环境指定 Git 分支的完整配置指南

deployer 支持为 staging 和 production 等不同部署目标独立指定 git 分支(如 `develop` 或 `master`),只需在对应 host 配置中调用 `->set('branch', 'xxx')` 即可,无需修改部署逻辑。

在默认配置下,Deployer 会从远程仓库拉取 master 分支(或本地当前分支,取决于 git clone 行为),这导致 staging 和 production 始终部署相同代码。要实现「staging 部署 develop、production 部署 master」的精准环境隔离,关键在于为每个 host 显式声明 branch 参数

以下是修正后的完整 deploy.php 片段(仅展示关键变更部分):

host('staging')
    ->hostname('hostname-here')
    ->user('username')
    ->identityFile('~/.ssh/id_rsa')
    ->multiplexing(false)
    ->set('deploy_path', '~/staging')
    ->set('branch', 'develop'); // ? staging 专属分支

host('production')
    ->hostname('hostname-here')
    ->user('username')
    ->identityFile('~/.ssh/id_rsa')
    ->multiplexing(false)
    ->set('deploy_path', '~/production')
    ->set('branch', 'master'); // ? production 专属分支

生效原理:Deployer 的 deploy:prepare 任务会读取 branch 配置项,并在 git clone 或 git fetch && git checkout 步骤中自动使用该分支。你无需重写 deploy:clone 或 deploy:update_code 任务。

⚠️ 注意事项

剪映专业版
剪映专业版

一款全能易用的桌面端剪辑软件

下载
  • branch 值必须是远程仓库中存在的有效分支名(区分大小写),否则部署将失败并抛出 fatal: couldn't find remote ref xxx 错误;
  • 若使用 --tag 或 --commit 部署方式,branch 将被忽略,请确保统一采用分支策略;
  • 推荐在 deploy:unlock 后添加 git:info 任务用于验证实际检出分支(可选调试):
    after('deploy:unlock', 'git:info');

? 进阶建议:为提升可维护性,可将分支名提取为变量或通过环境变量注入,例如:

set('staging_branch', 'develop');
set('production_branch', 'master');

host('staging')->set('branch', get('staging_branch'));
host('production')->set('branch', get('production_branch'));

这样既保持配置清晰,又便于 CI/CD 动态覆盖(如 DEPLOYER_STAGING_BRANCH=release/2.1 deploy staging)。最终,一次 deploy staging 将拉取并部署 develop 分支,而 deploy production 则严格部署 master 分支——真正实现环境与代码流的精准对齐。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
自建git服务器
自建git服务器

git服务器是目前流行的分布式版本控制系统之一,可以让多人协同开发同一个项目。本专题为大家提供自建git服务器相关的各种文章、以及下载和课程。

766

2023.07.05

git和svn的区别
git和svn的区别

git和svn的区别:1、定义不同;2、模型类型不同;3、存储单元不同;4、是否拥有全局版本号;5、内容完整性不同;6、版本库不同;7、克隆目录速度不同;8、分支不同。php中文网为大家带来了git和svn的相关知识、以及相关文章等内容。

565

2023.07.06

git撤销提交的commit
git撤销提交的commit

Git是一个强大的版本控制系统,它提供了很多功能帮助开发人员有效地管理和控制代码的变更,本专题为大家提供git 撤销提交的commit相关的各种文章内容,供大家免费下载体验。

270

2023.07.24

git提交错误怎么撤回
git提交错误怎么撤回

git提交错误撤回的方法:git reset head^:撤回最后一次提交,恢复到提交前状态。git revert head:创建新提交,内容与之前提交相反。git reset :使用提交的 sha-1 哈希撤回指定提交。交互式舞台区:标记要撤回的特定更改,然后提交,排除已撤回更改。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

560

2024.04.09

git怎么对比两个版本的文件内容
git怎么对比两个版本的文件内容

要对比两个版本的 git 文件,请使用 git diff 命令:git diff 比较工作树和暂存区之间的差异。git diff 比较两个提交或标签之间的差异。git diff 输出显示差异块,其中 + 表示添加的行,- 表示删除的行, 表示修改的行。可使用 gitkraken、meld、beyond compare 等可视化工具更直观地查看差异。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

526

2024.04.09

全国统一发票查询平台入口合集
全国统一发票查询平台入口合集

本专题整合了全国统一发票查询入口地址合集,阅读专题下面的文章了解更多详细入口。

17

2026.02.03

短剧入口地址汇总
短剧入口地址汇总

本专题整合了短剧app推荐平台,阅读专题下面的文章了解更多详细入口。

24

2026.02.03

植物大战僵尸版本入口地址汇总
植物大战僵尸版本入口地址汇总

本专题整合了植物大战僵尸版本入口地址汇总,前往文章中寻找想要的答案。

14

2026.02.03

c语言中/相关合集
c语言中/相关合集

本专题整合了c语言中/的用法、含义解释。阅读专题下面的文章了解更多详细内容。

2

2026.02.03

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PHP课程
PHP课程

共137课时 | 10.9万人学习

JavaScript ES5基础线上课程教学
JavaScript ES5基础线上课程教学

共6课时 | 11.2万人学习

PHP新手语法线上课程教学
PHP新手语法线上课程教学

共13课时 | 0.9万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号