Pulumi Docker镜像

镜像概述和主要用途

本镜像是***pulumi/pulumi镜像的替代方案。***镜像因需捆绑Pulumi支持的所有SDK（Go、Python、NodeJS、.NET、Java）而体积较大，本镜像则为特定SDK提供精简版本，仅包含Pulumi二进制文件、对应SDK的语言运行时及必要组件，显著减小容器体积。

核心功能和特性

• 精简体积：仅包含特定SDK所需组件，压缩后体积约150-400MB，远小于***全SDK镜像
• 多架构支持：基础镜像和Debian镜像支持ARM64与AMD64架构，UBI镜像仅支持AMD64
• 多OS基础：基于Debian 12-slim（debian）和RedHat UBI9最小化版（ubi）构建
• 灵活镜像类型：提供基础镜像（仅含Pulumi二进制和语言运行时）和SDK镜像（包含完整SDK运行时）

镜像类型

基础镜像（Base Image）

仅包含Pulumi二进制文件和语言运行时，不含SDK运行时。若使用此镜像，需自行安装Go、Python、.NET或NodeJS等SDK运行时。

镜像格式：

pulumi/pulumi-base:<PULUMI_VERSION>-<OS>-<ARCH>

默认镜像（未指定OS时，基于Debian AMD64）：

pulumi/pulumi-base:<PULUMI_VERSION>

SDK镜像（SDK Images）

包含完整SDK运行时，无需额外安装对应语言环境。

镜像格式：

pulumi/pulumi-<PULUMI_SDK>:<PULUMI_VERSION>-<OS>-<ARCH>

默认镜像（未指定OS时，基于Debian AMD64）：

pulumi/pulumi-<PULUMI_SDK>:<PULUMI_VERSION>
pulumi/pulumi-<PULUMI_SDK>:latest

操作系统和架构支持

使用方法

Docker Run示例

执行Pulumi命令时，需挂载项目目录并传入必要环境变量：

bash
docker run --rm \
  -e "PULUMI_ACCESS_TOKEN=$PULUMI_ACCESS_TOKEN" \
  -v $(pwd):/pulumi/projects \
  $IMAGE bash -c "pulumi install && pulumi preview -s $STACK"

其中：

• -e "PULUMI_ACCESS_TOKEN=$PULUMI_ACCESS_TOKEN": 传入Pulumi访问令牌
• -v $(pwd):/pulumi/projects: 挂载本地项目目录到容器内/pulumi/projects
• $IMAGE: 替换为实际使用的镜像名（如pulumi/pulumi-go:3.100.0-debian-amd64）
• pulumi install && pulumi preview -s $STACK: 执行Pulumi命令（安装依赖并预览指定栈）

注意事项

• 不含额外工具：本镜像不包含Pulumi Provider可能依赖的工具（如使用pulumi-kubernetes搭配Helm时所需的helm命令）。需以此镜像为基础构建新镜像，或在CI流程中额外安装相关工具。
• UBI镜像包管理器：UBI镜像使用microdnf而非yum，具体使用可参考microdnf文档。