使用 VS Code Dev Container 搭建 Dapr 开发环境从快速起步到深度定制【免费下载链接】daprDapr is a portable runtime for building distributed applications across cloud and edge, combining event-driven architecture with workflow orchestration.项目地址: https://gitcode.com/GitHub_Trending/da/daprDaprDistributed Application Runtime是一个用于构建跨云与边缘的分布式应用的可移植运行时。为 Dapr 贡献代码前需要一套完整的开发环境——Go 工具链、Dapr CLI、protoc、golangci-lint以及可选的 Kubernetes 集群工具。本文基于 Dapr 仓库自带的 Dev Container 定义系统讲解如何在 Visual Studio Code 中一键进入容器化 Dapr 开发环境并深入剖析其底层配置.devcontainer/devcontainer.json、docker/Dockerfile-dev与初始化脚本帮助你完成用户设置个性化、自定义容器镜像、与宿主机共享 Docker 环境、同步本地 Kubernetes 配置等进阶定制最终直接进入 developing-dapr.md 所描述的实际开发流程。为什么选择 Dev Container 开发 Dapr按照 setup-dapr-development-env.md 手动搭建环境需要依次安装 Git、Docker、Go 1.26.6、Delve、golangci-lint、Helm、Make 等一整套工具并针对 Linux/macOS/Windows 分别处理非 root 用户权限、Git BASH、PATH 等琐碎问题。VS Code 的 Remote - Containers 扩展将开发环境整体封装进容器克隆 Dapr 仓库后VS Code 会检测到仓库根目录下的 Dev Container 定义把项目装进一个预装全部依赖的容器里宿主机只需安装 Docker 与 VS Code。仓库自带的开发镜像默认同时支持 GitHub Codespaces既可用于云端开发也可在本地设备上运行。前置条件DockerWindows 用户建议启用 WSL2 后端与 Docker 集成。Visual Studio CodeVS Code Remote - Containers 扩展快速开始在容器中打开 Dapr 仓库将 Dapr 仓库克隆到本地并直接用 VS Code 打开git clone https://github.com/dapr/dapr.git cd dapr code .VS Code 检测到仓库中的 Dev Container 定义后会在右下角弹出提示询问是否重新在容器中打开也可以按CtrlShiftP打开命令面板执行Remote-Containers: Reopen in Container。容器加载完成后打开 VS Code 内置终端integrated terminal即可直接开始 Developing Daprmake build # 编译当前平台的 Dapr 二进制 make test # 运行单元测试 make check # 格式化 测试 lint 一站式检查容器内已预装 VS Code 扩展Go、Docker、Kubernetes、Dapr、markdownlint并对 Go 语言服务器、go.gopath、构建标签e2e,perf,conftests,unit,integration_test,certtests,allcomponents等做了开箱即用的配置。自定义你的 Dev ContainerDapr 的 Dev Container 默认配置面向 GitHub Codespaces 场景本地运行时可能需要按需调整。所有改动都集中在仓库根目录的 .devcontainer/devcontainer.json 与 docker/Dockerfile-dev 中。个性化用户设置VS Code 支持通过 dotfiles 仓库 将你自己的用户设置如.gitconfig应用到 Dev Container。这只需在你的 VS Codesettings.json中配置即可无需改动容器的镜像或配置。使用自定义容器镜像仓库的 .devcontainer/devcontainer.json 默认使用ghcr.io/dapr/dapr-dev:latest预构建镜像。当你需要修改镜像内容例如 Linux 宿主机的用户 UID 不是 1000 时需要把容器内dapr用户的 UID 重映射为宿主 UID时可以改为从本地的Dockerfile-dev构建编辑 docker/Dockerfile-dev 中的镜像定义。该文件基于golang:1.26.6-bullseye并通过ARG USERNAMEdapr、ARG USER_UID1000、ARG USER_GID$USER_UID控制非 root 用户。在 devcontainer.json 中注释掉image属性取消注释dockerFile属性改为构建并使用的本地Dockerfile-dev{ name: Dapr Dev Environment, // Update container version when you update dev-container // image: docker.io/daprio/dapr-dev:0.1.7, // Replace with uncommented line below to build your own local copy of the image dockerFile: ../docker/Dockerfile-dev, runArgs: [ ...通过命令面板执行Remote-Containers: Rebuild and Reopen in Container重新构建并打开工作区。如果后续只想改devcontainer.json配置而不想重新构建镜像可以把自己构建的镜像发布到私有镜像仓库加速重建。例如注册表名为myregistryexport DAPR_REGISTRYmyregistry make build-dev-container make push-dev-container之后恢复devcontainer.json中的image属性并指向你的镜像{ name: Dapr Dev Environment, // Update container version when you update dev-container image: docker.io/myregistry/dapr-dev:0.1.7, // Replace with uncommented line below to build your own local copy of the image // dockerFile: ../docker/Dockerfile-dev, runArgs: [ ...这两个命令定义在 docker/docker.mkbuild-dev-container使用--build-arg DAPR_CLI_VERSION$(DEV_CONTAINER_CLI_TAG)构建镜像push-dev-container前会通过check-docker-env-for-dev-container校验DAPR_REGISTRY已设置。与 localhost 共享 Docker 环境默认的 Dapr Dev Container 采用 Docker-in-DockerDinD方案容器内启动的 Docker 与宿主机相互隔离互不可见。这样宿主机与开发容器可以各自维护独立的 Dapr 环境例如各自执行dapr init互不干扰。如果需要让 Dev Container 与宿主机或多个 Dev Container 之间共享 Docker 环境需要让 Dev Container 与 localhost 处于同一网络即在devcontainer.json的runArgs中加上--nethostrunArgs: [ ... // Uncomment to bind to host network for local devcontainer; this is necessary if using the // bind-mounted /var/run/docker-host.sock directly. --nethost,方案一在 Dev Container 中为 localhost 创建 Docker context默认的devcontainer.json已经将宿主机 Docker 套接字映射进容器/var/run/docker.sock→/var/run/docker-host.sock可以直接为它单独创建一个 Docker context⚠ 如果你的 localhost 是 Linux 系统注意 Dev Container 是以--privileged运行的以下指令可能修改你的权限。sudo chown root:docker /var/run/docker-host.sock docker context create host-context --description Use localhost Docker environment --docker hostunix:///var/run/docker-host.sock docker context use host-context docker ps此时docker ps应该能看到 Dev Container 自身也出现在 host-context 的容器列表里。用docker context use default可以切回 Docker-in-Docker 配置。方案二把 /var/run/docker.sock 直接重绑定到 localhost如果不希望使用 Docker-in-Docker可以在devcontainer.json中启用BIND_LOCALHOST_DOCKER环境变量让容器内默认的 Docker context 始终指向 localhostcontainerEnv: { ... // Uncomment to disable docker-in-docker and automatically proxy default /var/run/docker.sock to // the localhost bind-mount /var/run/docker-host.sock. BIND_LOCALHOST_DOCKER: true },该方案的额外好处是当 localhost 上的/var/run/docker-host.sock属于 root 时容器启动流程会通过 socat 代理该套接字从而避免修改 Linux 宿主机的权限。这个开关的实际行为可以在 docker/custom-scripts/devcontainer-init.sh 中看到当BIND_LOCALHOST_DOCKERtrue时入口脚本调用docker-bind-mount.sh否则调用标准的docker-init.sh。而 docker/custom-scripts/docker-bind-mount.sh 会检查SOURCE_SOCKET/var/run/docker-host.sock与TARGET_SOCKET/var/run/docker.sock通过建立符号链接或 socat 代理当 socket GID 为 0 且非 root 用户时来转发 Docker 套接字。把 Kubernetes 配置克隆进 Dev Container贡献者与维护者经常需要针对 Kubernetes 环境测试 Dapr 改动因此开发镜像内置了 Kubernetes、Helm 与 Minikube。如果你已有现成的 Kubernetes 配置如 Azure Kubernetes Service 集群 或本地 Minikube 集群可以通过devcontainer.json把这些配置同步进容器需要启用SYNC_LOCALHOST_KUBECONFIG环境变量将本机的 Kubernetes 与 Minikube 配置路径分别 bind mount 到容器内的/home/dapr/.kube-localhost与/home/dapr/.minikube-localhost不用 Minikube 则无需挂载后者。containerEnv: { // Uncomment to overwrite devcontainer .kube/config and .minikube certs with the localhost versions // each time the devcontainer starts, if the respective .kube-localhost/config and .minikube-localhost // folders respectively are bind mounted to the devcontainer. SYNC_LOCALHOST_KUBECONFIG: true, ... }, ... runArgs: [ ... // Uncomment to clone local .kube/config into devcontainer --mount, typebind,source${env:HOME}${env:USERPROFILE}/.kube,target/home/dapr/.kube-localhost, // Uncomment to additionally clone minikube certs into devcontainer for use with .kube/config --mount, typebind,source${env:HOME}${env:USERPROFILE}/.minikube,target/home/dapr/.minikube-localhost, ... ]底层实现在 docker/custom-scripts/devcontainer-init.sh容器每次启动时若SYNC_LOCALHOST_KUBECONFIGtrue且不是 Codespaces 环境脚本会把.kube-localhost的内容复制到~/.kube若同时存在.minikube-localhost还会把 Minikube 的ca.crt、client.crt、client.key复制到~/.minikube并用sed修正~/.kube/config中的证书路径与服务端地址从127.0.0.1改为宿主机 Minikube 的实际 IP 与端口。关于该功能需要注意以下限制SYNC_LOCALHOST_KUBECONFIG只支持把宿主机的配置快照提供给 Dev Container不支持从 Dev Container 反向更新宿主机 Kubernetes 配置复制发生在容器每次启动时容器启动后宿主机侧的变更不会反映到容器内Dev Container 内对~/.kube/config的修改如切换默认 context、更新凭据不会回写宿主机即使底层环境如 AKS 凭据已经变化若使用 Minikube宿主机上必须在 Dev Container 启动前就启动好 Minikube。容器内的 Minikube 配置与宿主机相互独立不能从容器内启动宿主机的 Minikube。该选项只支持把默认 Minikube 凭据克隆进容器供 Kubernetes 配置使用复制操作会用 localhost 的设置覆盖 Dev Container 内的任何既有状态因此不要与 Dev Container 自带的 Minikube 实例混用。深入理解开发镜像的内部结构如果好奇容器里究竟预装了哪些工具可以查看 docker/Dockerfile-dev。它以golang:${GOVERSION}-bullseye默认 Go 1.26.6为基础通过可构建参数控制各工具版本构建参数默认值用途GOVERSION1.26.6Go 基础镜像版本KUBECTL_VERSIONlatestkubectl 版本HELM_VERSIONlatestHelm 版本MINIKUBE_VERSIONlatestMinikube 版本DAPR_CLI_VERSIONlatestDapr CLI 版本PROTOC_VERSION25.4protoc 编译器版本PROTOC_GEN_GO_VERSION1.32.0protoc-gen-go 插件版本PROTOC_GEN_GO_GRPC_VERSION1.3.0protoc-gen-go-grpc 插件版本GOLANGCI_LINT_VERSION1.64.6golangci-lint 版本USERNAME/USER_UID/USER_GIDdapr/1000/1000非 root 用户定义构建过程中依次执行docker/library-scripts与docker/custom-scripts下的脚本配置非 root 用户、安装 Docker-in-DockerDinD、安装 kubectl/Helm/Minikube、安装 Go 工具以及由 install-dapr-tools.sh 安装 Dapr CLI、protoc 与 protoc-gen-go 系列插件、golangci-lint。镜像默认入口为 devcontainer-init.sh配合--init参数与sleep infinity的 CMD 保持容器常驻。几个值得留意的默认行为镜像设置了CGO_ENABLED0与GO111MODULEauto与 Dapr 纯 Go 的构建方式保持一致默认的remoteUser为dapr且runArgs中包含--cap-addSYS_PTRACE与seccompunconfined这是为 Go 语言 ptrace 调试Delve预留的能力--privileged用于启用 Docker-in-Docker如果追求更好的安全性可以注释掉代价是无法使用 DinD容器启动时还会执行 setup-docker-multiarch.sh为多架构构建做好准备。总结通过 Dapr 仓库自带的 Dev Container 定义你可以在一分钟内获得一个依赖齐全、可复现的 Dapr 开发环境省去手动安装 Go、Dapr CLI、protoc、golangci-lint 以及 Kubernetes 工具链的繁琐步骤。本文覆盖了从快速打开容器、个性化用户设置、自定义并发布容器镜像到共享宿主机 Docker、同步 Kubernetes 配置的完整路径每个开关BIND_LOCALHOST_DOCKER、SYNC_LOCALHOST_KUBECONFIG、--nethost在仓库的 devcontainer.json 与 devcontainer-init.sh 中都有对应的实现逻辑可循。进入容器后即可按照 developing-dapr.md 的指引开始构建、测试与调试 Dapr 本身。【免费下载链接】daprDapr is a portable runtime for building distributed applications across cloud and edge, combining event-driven architecture with workflow orchestration.项目地址: https://gitcode.com/GitHub_Trending/da/dapr创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考