Skip to content

配置差异与提升

比较配置快照差异并将变更提升到目标环境。

Updated View as Markdown

目标

理解两个环境之间的配置差异(缺失变量、不同值、Secret 状态差异),并把验证过的配置安全提升到目标环境,而不是直接覆盖历史部署。

适用场景

  • 上线前确认 staging 和 production 的配置是否一致。
  • 在 staging 验证过一组新变量后,把它们提升到 production。

前置条件

  • 来源环境和目标环境都已存在,且都不处于锁定状态。

输入与默认值

输入说明
来源环境提供参考配置的环境,例如 staging
目标环境接收变更的环境,例如 production
Secret 处理方式提升时如何处理来源环境的 Secret(默认不会暴露明文)

CLI 操作步骤

# 比较两个环境的配置差异
appaloft env diff env_staging env_prod

# 提升配置到目标环境(会创建新的配置状态,不直接覆盖历史部署)
appaloft env promote env_staging env_prod

预期输出与状态

diff 会列出:目标环境缺失的变量、值不同的变量,以及 Secret 状态的差异(是否存在、是否近期更新),但不会显示 Secret 明文本身。promote 会在目标环境创建一份新的配置状态;这不等于立即重新部署——已经在运行的实例不会因为 promote 而自动重启。

验证

Promote 之后,检查目标环境的变量列表是否符合预期,再决定是否需要触发一次新部署让运行中的实例读取新配置。

回滚 / 恢复

Promote 不会覆盖历史部署快照——如果提升后的新部署出现问题,仍然可以按回滚与恢复中的步骤回滚到提升前的部署。

故障排查链接

相关参考页面

注意事项

Promote 前应该先确认:目标环境是否正确、Secret 应该重新生成还是复用引用、以及是否需要在 promote 完成后立即触发一次新部署。

Navigation

Type to search…

↑↓ navigate↵ selectEsc close