创建.devcontainer配置仓库的格式规范及相关指引咨询
内部共享devcontainer配置仓库格式说明
你提到的Repository Configuration Paths是VS Code Dev Containers扩展提供的组织级共享配置功能,对应的共享配置仓库格式要求如下:
- 基础目录结构:仓库根目录下每一套独立配置对应一个单独的子目录,目录名可自定义为配置的标识名,比如
java-17-maven、go-1.20-alpine - 单套配置结构:每个配置子目录下必须包含标准的
.devcontainer文件夹,内部的devcontainer.json、Dockerfile、启动脚本等文件格式和单项目使用的devcontainer配置完全一致,不需要额外修改 - 可选说明文件:可以在每个配置子目录下添加
README.md文件,填写该配置的适用场景、预装依赖、使用注意事项,用户选择配置时会自动展示该说明内容 - 可选索引文件:可以在仓库根目录添加
index.json文件,自定义配置的展示顺序、分类标签、官方描述等信息,参考格式如下:
{ "version": "1.0", "templates": [ { "id": "debian11-node18", "name": "Debian 11 + Node.js 18", "description": "适用于前端全栈项目,预装pnpm、git、curl等常用工具", "path": "./debian-11-node18", "tags": ["node", "debian", "frontend"] } ] }
你可以直接在VS Code设置中找到Dev Containers: Repository Configuration Paths配置项,添加你的内部仓库地址即可,支持本地文件路径、内部Git仓库地址,Git地址可以通过加#版本号/分支名的方式锁定配置版本。配置完成后,新建 devcontainer 环境时即可在可选配置列表中看到你内部仓库的所有配置,直接选择使用即可。
内容的提问来源于stack exchange,提问作者Dave Medvitz
相关产品推荐
相关产品推荐

