Pulumi Docker镜像

镜像概述和主要用途

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

核心功能和特性

• 轻量级设计：相比***镜像体积更小，针对特定SDK精简，避免冗余组件
• 多架构支持：基础和Debian版本支持ARM64与AMD64架构，UBI版本仅支持AMD64
• 灵活镜像选择：提供基础镜像（需自行安装SDK运行时）和预包含SDK运行时的专用镜像
• 多操作系统支持：基于Red Hat通用基础镜像（UBI）和Debian 12-slim构建

镜像详情

基础镜像（Base Image）

仅包含pulumi二进制文件和语言运行时，不含SDK运行时。若使用此镜像，需自行安装Go、Python、Dotnet或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

镜像大小

各镜像压缩后体积约为150-400MB，具体取决于构建时使用的操作系统及依赖组件，均显著小于***合并镜像。

支持的操作系统

当前构建基于以下操作系统镜像：

• Debian：debian:12-slim（Debian Bookworm）
• UBI：registry.access.redhat.com/ubi9/ubi-minimal（Red Hat通用基础镜像）

UBI镜像说明

UBI版本镜像使用microdnf作为包管理器（非yum），详情参见microdnf项目。

使用方法

在容器中运行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"

注意事项

镜像不包含Pulumi提供程序可能依赖的额外工具。例如，使用pulumi-kubernetes搭配Helm时，需以本镜像为基础构建新镜像，或在CI流程中额外安装helm命令。