GitLab CI Docker Runner中Terragrunt命令未找到的PATH问题

方案1：使用官方维护的Terragrunt镜像 #

alpine/terragrunt镜像可能存在路径配置异常，换用Gruntwork官方维护的镜像可直接解决命令找不到的问题：

your_terragrunt_task:
  image: gruntwork/terragrunt:v1.3.6
  script:
    - terragrunt --version
    - # 后续Terragrunt/Terraform执行命令

该镜像已预配置好正确的环境变量，无需手动调整PATH。

方案2：动态定位Terragrunt路径并修正PATH #

如果坚持使用alpine/terragrunt镜像，可在CI任务中先定位Terragrunt的实际路径，再动态更新环境变量：

your_terragrunt_task:
  image: alpine/terragrunt:1.3.6
  script:
    - # 查找Terragrunt的绝对路径，过滤错误输出
    - TG_PATH=$(find / -name terragrunt 2>/dev/null)
    - # 将路径所在目录加入PATH
    - export PATH=$(dirname $TG_PATH):$PATH
    - terragrunt --version

方案3：自定义预安装镜像（多任务场景推荐） #

针对多任务重复安装的痛点，自定义包含Terraform和Terragrunt的基础镜像，推送到GitLab容器仓库后可全局复用：

1. 编写Dockerfile：

FROM alpine:3.18

# 安装依赖工具
RUN apk add --no-cache curl unzip

# 安装指定版本的Terraform（按需替换版本号）
ENV TF_VERSION=1.5.7
RUN curl -LO https://releases.hashicorp.com/terraform/${TF_VERSION}/terraform_${TF_VERSION}_linux_amd64.zip && \
    unzip terraform_${TF_VERSION}_linux_amd64.zip && \
    mv terraform /usr/local/bin/ && \
    rm terraform_${TF_VERSION}_linux_amd64.zip

# 安装Terragrunt 1.3.6
ENV TG_VERSION=1.3.6
RUN curl -LO https://github.com/gruntwork-io/terragrunt/releases/download/v${TG_VERSION}/terragrunt_linux_amd64 && \
    chmod +x terragrunt_linux_amd64 && \
    mv terragrunt_linux_amd64 /usr/local/bin/terragrunt

# 验证安装有效性
RUN terraform --version && terragrunt --version

2. 构建并推送到GitLab容器注册表：

docker build -t registry.gitlab.com/your-group/your-project/terra-tg-base:v1.0 .
docker push registry.gitlab.com/your-group/your-project/terra-tg-base:v1.0

3. 在CI任务中直接使用该镜像：

your_terragrunt_task:
  image: registry.gitlab.com/your-group/your-project/terra-tg-base:v1.0
  script:
    - terragrunt plan
    - # 其他任务执行命令

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