northseadl/norix-skills / cnb-cool-integration
cnb-cool-integration
Verified针对 cnb.cool 的云原生构建(CNB Build):生成/修改 .cnb.yml 流水线、触发规则、 构建环境、runner 资源、缓存、环境变量、手动触发与调试。 在接入、迁移、优化或排查 CNB 构建配置时使用。
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 3.7 KB |
| agents/openai.yaml | config | 350 B |
| references/cache.md | markdown | 1.4 KB |
| references/cnb-yml.md | markdown | 1.3 KB |
| references/debug.md | markdown | 555 B |
| references/docker-and-runner.md | markdown | 2.2 KB |
| references/env.md | markdown | 876 B |
| references/file-reference.md | markdown | 1.4 KB |
| references/intro.md | markdown | 1.5 KB |
| references/recipes.md | markdown | 1.5 KB |
| references/trigger-rule.md | markdown | 1.1 KB |
| references/web-trigger.md | markdown | 1.6 KB |
references/docker-and-runner.md
View on GitHub# 构建环境(docker)与资源(runner)
## docker:三种方式(三选一)
同一个 pipeline 的 `docker` 只允许三选一:
- `docker.image`:直接指定镜像(最常用)
- `docker.build`:用仓库里的 Dockerfile 构建镜像后作为环境
- `docker.devcontainer`:使用 devcontainer 作为环境
### `docker.image`
```yaml
docker:
image: cnbcool/default:node
```
### `docker.build`
常见字段(按需使用):
- `dockerfile`:默认 `Dockerfile`
- `context`:默认 `.`
- `buildArgs`:构建参数(会影响缓存/版本计算)
- `versionBy`:决定“镜像版本”如何计算(例如是否忽略 buildArgs)
### `docker.devcontainer`
常见字段(按需使用):
- `devcontainer`:devcontainer 配置文件路径
- `workspaceFolder`:工作目录(默认 `/workspace`)
## docker.volumes:缓存与跨 stage 数据传递
```yaml
docker:
image: cnbcool/default:node
volumes:
cache: /cache
```
语义要点:
- volumes 用于缓存(如依赖缓存、编译产物)与跨 stage 共享文件。
- CNB 使用 copy-on-write:每个 stage 开始会复制上一 stage 的卷快照;stage 结束会生成新的快照。
- 如果你的 Dockerfile 声明了 `VOLUME`,该目录也会在插件任务里共享(适合插件复用缓存/产物)。
## runner:资源与调度
```yaml
runner:
cpus: 8
mem: 8g
disk: 50
tags:
- run:docker
```
要点:
- `cpus`:影响可用计算资源,通常也是调度的重要依据
- `mem`:支持 `g/m` 单位
- `disk`:单位是 GB
- `tags`:用于选择特定构建节点(例如需要 Docker socket 的节点)
## git:克隆策略
```yaml
git:
depth: 1
submodules: false
options:
- "--single-branch"
```
要点:
- `depth: 0` 表示全量克隆
- 需要 submodule 时显式打开
## services:启动依赖服务(MySQL/Redis 等)
```yaml
services:
- name: mysql
image: mysql:8
ports: [3306]
env:
MYSQL_ROOT_PASSWORD: root
```
语义要点:
- runner 会启动 service 容器并等待 `ports` 就绪,再开始 jobs。
- 会注入环境变量:
- `CNB_SERVICES`:形如 `mysql=host:3306;redis=host:6379`
- `CNB_SERVICE_<NAME>_HOST` / `CNB_SERVICE_<NAME>_PORT`
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |