跳到正文
⁨NDDev OpenNetwork⁩,首页
社区
语言: 简体中文
显示
主题
动效

GitHub Device Sync 与 CI/CD 技术栈:基于 GitHub Actions 配置 CI/CD

NDDev 的 GitHub Device Sync 与 CI/CD 技术栈用于为 GitHub 上的代码仓库群配置 CI/CD。GDS 在同一来源中描述代码仓库、策略与设备,并通过计划与确认机制执行变更。与之协同运行的还有 CI-workflows 库、CD-workflows 交付契约以及官方运行器安装方案。代码基于 AGPL-3.0 协议开源,NDDev 自身的代码仓库也使用这套技术栈管理。

适合谁?

面向在 GitHub 上拥有众多代码仓库,需要一致的检查、清晰的变更规则以及用于私有代码的自有运行器的团队。

  • 同一份描述涵盖代码仓库与设备
  • 计划、确认与日志
  • 可复用的 workflow
  • 自有的 GitHub Actions 运行器

技术栈的四个部分

GitHub Device Sync 将通常混杂在一起的要素拆分开来:代码仓库的身份标识、分类、Git 拓扑结构、在设备上的存放位置、可观测状态以及面向 AI 智能体的上下文。它依据规范描述,以确定性的方式为每个代码仓库构建策略与文件。读取命令只执行读取。每项变更都按照已保存的计划推进:确认、重新检查条件、验证结果并写入日志。

  • 所有者、选择器与设备的规范描述
  • 每个代码仓库中确定性生成的策略文件与智能体上下文文件
  • 每项变更均经过计划、确认、应用、检查与日志记录
  • 适用于 Python、Node、Go、Rust、Java、.NET、Dart 与 Flutter 及其他语言的 CI 套件
  • 面向开源代码的 CodeQL、OSSF Scorecard、gitleaks、actionlint、zizmor 与 SBOM
  • 具备不可变计划与精确回滚的交付契约
  • 带有 nddev-linux 标签的运行器槽位,每个槽位运行在独立的 systemd 服务中
  • 整个技术栈采用 AGPL-3.0 许可证

CI-workflows 是通过 SHA 锁定版本的可复用 GitHub Actions workflow 库,包含语言检查、安全扫描、SBOM 和发布链路。方案按代码仓库的可见性与 GitHub 付费功能划分:开源代码、基础套餐下的私有仓库,以及单独购买了附加功能的私有仓库。CD-workflows 用于定义交付:不可变计划、确认绑定、检查、证据以及精确回滚。

GitHub Actions light 在 Linux 上安装官方 actions/runner:使用锁定校验和的发布版本,为每个槽位配置独立的 systemd 服务,并在组织或代码仓库中注册。队列、权限和状态保留在 GitHub 中。公开代码仓库与来自复刻仓库的 pull request 在 GitHub 运行器上运行,私有代码则在您的槽位上执行。

CI/CD 分步配置流程

我们为您的组织接入这套技术栈的步骤顺序。

  1. 清点梳理

    汇总代码仓库、所有者与设备清单,并在 GDS 中完成描述。

  2. 检查

    根据代码仓库的可见性和您的 GitHub 套餐选择 CI 方案,并通过简短调用在每个代码仓库中接入 workflow。

  3. 运行器

    在您的 Linux 服务器上安装 GitHub Actions light 槽位,并将其注册到组织中。

  4. 交付

    用 CD-workflows 交付契约定义部署:计划、确认、应用、检查与回滚。

  5. 移交

    向团队演示如何查看计划与日志,并留下每个步骤的操作说明。

关于 GDS 与 CI/CD 技术栈的常见问题

如果我们用 GitLab,这套技术栈适用吗?

这套技术栈围绕 GitHub 与 GitHub Actions 构建。其他平台上的 CI/CD 由我们通过 NDDev.Dev 的独立服务进行配置。

需要购买 GitHub 付费套餐吗?

针对开源代码仓库,库中提供完整的免费安全检查套件。针对基础套餐下的私有代码仓库,也有对应的专属方案。付费功能仅在您已购买的范围内启用。

部署凭据保存在哪里?

保存在交付执行器一侧,与运行器隔离。CD-workflows 交付契约向其传递封装好的计划,执行器只执行该计划。

用通俗的话来说,GDS 是什么?

它是对您所有代码仓库的一份统一描述:归谁所有、适用哪些规则、存放在哪些设备上,以及 AI 智能体掌握关于它们的哪些信息。GDS 会将这份描述与实际情况进行比对,并给出变更计划。

可以只选用其中一部分吗?

可以。每个部分都在各自的代码仓库中维护并可独立运行:您可以只接入 workflow,或只接入运行器。

配置费用是多少?

费用取决于代码仓库、运行器以及交付环境的数量。我们在梳理情况后给出评估报价,并将最终结果写入技术规格书;编写技术规格书已包含在项目费用中。

帮您理顺代码仓库与流水线

欢迎告知您现有的代码仓库数量以及当前的版本发布方式。我们将为您建议从哪个部分着手。

我们将在 24 小时内回复

助手

正在加载助手…