用途:创建和更新 Coder Registry 工作区模板。模板位于 registry/<namespace>/templates/<name>/,用于预配工作区运行的基础设施。
主要能力:支持 Docker、AWS、GCP、Azure、Kubernetes 等平台,可定义 VM、容器、devcontainer 等工作区;通过 coder_parameter 暴露区域、实例类型、CPU、内存、磁盘、镜像等参数;支持动态参数、工作区预设(coder_workspace_preset)与预构建(Premium);可消费 registry 中已有模块,避免重复实现。
使用方式:新建模板时在仓库根目录运行 ./scripts/new_template.sh namespace/template-name,名称须为小写字母数字加连字符,会生成 main.tf 与 README.md。更新已有模板时直接编辑其文件。实现前先阅读现有模板与模块的 main.tf、README.md,确认变量、输出与前置条件;模块源 URL 使用 registry.coder.com/<namespace>/<module>/coder。
适用场景:需要为团队提供标准化、可参数化的工作区基础设施定义,并复用社区模块时。
限制:Premium 功能需 Coder Premium 许可;模板不要求 .tftest.hcl 或 main.test.ts,测试通过推送到 Coder 部署完成;模块前置条件需自行确认基础镜像满足,否则仅在启动时暴露问题。具体收费、价格与平台支持细节暂未提供。