3.8 KiB

Raw Blame History

GitLink CI/CD Demo Project（danshen/CI）

一个用于演示 GitLink / GitHub Actions 风格 CI/CD 的示例项目。

项目结构

.
├── .github/workflows/       # 标准 Actions 目录（多数平台识别这里）
│   ├── ci.yml
│   ├── deploy-staging.yml
│   └── deploy-prod.yml
├── .GitLink/workflows/      # 与上面内容相同；若 GitLink 只认此目录，保留其一即可
│   ├── ci.yml
│   ├── deploy-staging.yml
│   └── deploy-prod.yml
├── Dockerfile
├── src/
├── tests/
├── package.json
├── package-lock.json        # 提交到 Git，CI 里 npm ci 需要
└── README.md

功能特性

greet(name): 生成问候语
add(a, b): 加法运算
isValidEmail(email): 邮箱验证

流水线做什么

工作流	何时运行
CI Pipeline	推送到 `main` / `master` / `develop`，或针对这些分支的 PR；也可手动运行
Deploy to Staging	推送到 `main` 或 `master` 且改动了应用相关路径；也可手动运行
Deploy to Production	仅手动运行，且输入框必须填 deploy

针对仓库 `https://gitlink.org.cn/danshen/CI.git` 的操作示例

你的 GitLink 项目页：danshen/CI（默认分支一般是 master）。流水线入口在顶部 「流水线(devops)」。

1. 在本机绑定远程并推送（PowerShell）

在项目根目录执行（若已添加过 origin，先 git remote remove origin）：

cd d:\Litter\111
git remote add origin https://gitlink.org.cn/danshen/CI.git
git checkout -B master
git add -A
git status
git commit -m "chore: add CI/CD workflows and demo app"

若远程已有一次提交（例如只有 README.md），第一次推送前需要合并历史：

git pull origin master --allow-unrelated-histories
# 若有冲突，按提示解决后：git add -A && git commit -m "merge remote"
git push -u origin master

若你确认可以覆盖远程、只保留本地这一套代码：

git push -u origin master --force

2. 在网页上点哪里

浏览器打开：https://gitlink.org.cn/danshen/CI
点 「流水线(devops)」，应能看到 CI Pipeline、Deploy to Staging、Deploy to Production。
若列表为空：到 「代码库」 确认已推送 .github/workflows/ 或 .GitLink/workflows/ 下的 yml；GitLink 帮助中心里会说明认哪个目录（常见为与 GitHub 类似的 workflows 目录）。

3. 分支说明

本仓库流水线已对 master、main、develop 配置触发；与你当前 GitLink 默认 master 一致，推送到 master 即可跑 CI；合并到 master 也会触发预发布镜像流水线（在改动命中 paths 时）。

你在 GitLink 上还需要做的事（网页权限）

把本仓库推送到 GitLink（见上文命令）。
打开 「流水线(devops)」，确认能看到上述三个工作流。
若同一次推送触发了两套完全相同的流水线（因为同时存在 .github 与 .GitLink 两套 yml）：删掉你平台不读取的那一套目录里的 yml 即可，只保留一个目录。
在 Settings → Environments（或 GitLink 等价菜单）里新建 staging 和 production；生产环境建议开启 审批人。
（可选）在 Secrets 里添加 CODECOV_TOKEN、在 production 环境配置 PROD_API_KEY。
若推镜像到 ghcr.io 失败：在平台文档中开启 Packages 写入权限，或按说明改用个人访问令牌（PAT）登录镜像仓库。

开发命令

npm ci
npm run lint
npm run type-check
npm test
npm run build

许可证

MIT License

3.8 KiB Raw Blame History Unescape Escape