用途:创建和更新 Coder Registry 模块。模块是位于 registry/<namespace>/modules/<name>/ 下的可复用 Terraform 组件,供模板通过 module 块引用。
主要能力:提供新模块脚手架脚本 ./scripts/new_module.sh namespace/module-name,生成 main.tf、README.md、MODULE_NAME.tftest.hcl 和 run.sh;规范变量命名(snake_case)、默认值、图标路径、README frontmatter 与用法示例;要求编写 Terraform 原生测试(.tftest.hcl),可选 TypeScript 测试(main.test.ts);通过 .github/scripts/version-bump.sh patch|minor|major 管理版本。
使用方式:先理解需求并查阅目标工具官方文档,检索现有模块避免重复,核对 Coder provider 文档;命名空间需与用户确认。脚本逻辑可用根目录 run.sh + templatefile()、scripts/ 目录 + file() 或内联 heredoc 三种模式。常用命令:bun run fmt、bun run check:terraform、bun run check:typescript、bun run check:shellcheck、./scripts/terraform_validate.sh。
适用场景:为 Coder 模板开发工具集成、IDE、CLI 等可复用模块,并需要测试与版本发布流程。
限制:资料未提供具体收费、价格或平台支持信息;新命名空间需自行补充 .images/avatar.svg 并填写 README 占位字段,status 必须为 official、partner 或 community;README 不得枚举变量、参数或输出,图标路径需为相对路径。