跳转到主要内容

CI 密钥注入标准

对于远程适配器,请将密钥保存在您的 CI 密钥管理器中,并且仅在调用 hyperlocalise sync 的作业中注入它们。
  • 仅在 *Env 变量名于 i18n.yml 中提交。
  • 通过作业级环境变量在运行时注入令牌值。
  • 对只读检查和启用写入的同步任务使用单独的凭据。
  • 避免在流水线步骤中打印环境变量。

在 GitHub Actions 中安装 CLI

使用安装操作下载发布二进制文件,并将hyperlocalise添加到PATH中,以便后续步骤使用。这是直接运行 CLI 命令的 CI 作业的推荐设置。
在你想要更严格的变更控制时,固定到特定版本:
输入:
  • version:要安装的发布标签。默认为 latest
  • install-dir:可选安装目录。默认为运行器临时目录。
对于无需手动编写 CLI 步骤的拉取请求漂移和完整性检查,请改用 GitHub Action drift check 复合操作。

建议检查

先安装 CLI,然后在你的作业中运行这些命令。

3. 同步预览门控

计划拉取同步(只读,安全默认)

要将远程更改应用到 CI 中的本地文件,请切换到:

计划推送同步(可写,启用中)

用于非变更验证遍历,请使用:
对于可写入的任务,优先使用受保护的环境、审批门和最小权限的服务凭据。

计划同步任务示例

将这些 GitHub Actions 示例作为基准。根据你的 CI 平台调整密钥名称和审批规则。

2. 状态快照

仅在明确授权可写入本地文件或远程系统的作业中运行,不要包含--dry-run

1. 配置 + 规划冒烟测试

sync pullsync push 默认会应用更改。为非变更的 CI 预览作业添加 --dry-run
将 CSV 作为构建产物存储,以便进行趋势跟踪。