如何自定义Docker开发环境 预安装Terraform、GCloud等CLI工具

核心问题原因 #

你之前的安装命令不生效通常是三个常见错误导致：

• 未切换root用户执行安装，基础镜像默认运行用户为无系统目录写入权限的vscode用户
• 下载的二进制包与Alpine的musl运行环境不兼容，或未将可执行文件放入全局PATH路径
• 修改配置后使用了缓存构建，新的安装命令未实际执行

1. 替换为正确的.devcontainer/Dockerfile内容 #

# [Choice] Alpine version: 3.13, 3.12, 3.11, 3.10
ARG VARIANT="3.13"
FROM mcr.microsoft.com/vscode/devcontainers/base:0-alpine-${VARIANT}

# 切换到root权限执行安装操作
USER root

# 安装系统基础依赖
RUN apk add --no-cache curl unzip bash

# 安装Terraform CLI
ARG TERRAFORM_VERSION="1.5.7"
RUN curl -fsSL "https://releases.hashicorp.com/terraform/${TERRAFORM_VERSION}/terraform_${TERRAFORM_VERSION}_linux_amd64.zip" -o terraform.zip \
    && unzip terraform.zip \
    && mv terraform /usr/local/bin/ \
    && chmod +x /usr/local/bin/terraform \
    && rm -f terraform.zip

# 安装GCloud SDK
ARG GCLOUD_VERSION="444.0.0"
RUN curl -fsSL "https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/google-cloud-cli-${GCLOUD_VERSION}-linux-x86_64.tar.gz" -o gcloud.tar.gz \
    && tar -xf gcloud.tar.gz \
    && ./google-cloud-sdk/install.sh --quiet --install-dir=/usr/local --path-update=true \
    && rm -rf gcloud.tar.gz google-cloud-sdk

# 切回默认非root用户
USER vscode

2. 无缓存重建容器 #

修改完成后必须执行无缓存重建，否则旧的镜像缓存会导致新配置不生效：

• 打开VSCode命令面板（Windows/Linux快捷键Ctrl+Shift+P，macOS快捷键Cmd+Shift+P）
• 选择 Dev Containers: Rebuild Container Without Cache
  等待构建完成后进入容器终端，执行terraform --version即可验证安装结果。

可选调整 #

• 可直接修改Dockerfile中TERRAFORM_VERSION、GCLOUD_VERSION参数值，固定你需要的工具版本
• 若使用ARM架构设备，将下载链接中的amd64、x86_64替换为arm64即可适配

内容的提问来源于stack exchange，提问作者Ari