Pulumi Docker镜像

镜像概述和主要用途

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

核心功能和特性

• 轻量级设计：针对特定SDK优化，仅包含必要组件，体积显著小于***全量镜像
• 多操作系统支持：基于两种基础镜像构建：
  • RedHat Universal Base Image（registry.access.redhat.com/ubi9/ubi-minimal，简称UBI）
  • Debian Slim（debian:12-slim）
• 多架构支持：Base和Debian镜像支持ARM64与AMD64架构，UBI镜像仅支持AMD64
• 两种镜像类型：提供Base Image（不含SDK运行时）和SDK Images（含SDK运行时），满足不同场景需求

镜像类型详情

Base Image

仅包含pulumi二进制和语言运行时，不含SDK运行时。若使用此镜像，需自行安装Go/Python/Dotnet/NodeJS等SDK运行时。镜像格式：

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

默认镜像基于Debian AMD64，可省略OS直接使用：

pulumi/pulumi-base:<PULUMI_VERSION>

SDK Images

包含对应SDK运行时的镜像，格式：

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

默认镜像基于Debian AMD64，可省略OS或使用latest标签：

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

镜像大小

各镜像压缩后体积约为150-400MB，具体取决于基础操作系统和依赖，均显著小于***全量镜像。

操作系统支持

• Debian：基于Debian Bookworm（debian:12-slim）
• UBI：基于RedHat Universal Base Image（registry.access.redhat.com/ubi9/ubi-minimal）

UBI镜像说明

UBI镜像使用microdnf作为包管理器（非yum），详情参见microdnf文档。

使用方法

镜像格式示例

• Base Image（默认Debian AMD64）：

  pulumi/pulumi-base:3.100.0
  

• Base Image（指定OS和架构）：

  pulumi/pulumi-base:3.100.0-debian-arm64
  pulumi/pulumi-base:3.100.0-ubi-amd64
  

• SDK Image（默认Debian AMD64）：

  pulumi/pulumi-python:3.100.0
  pulumi/pulumi-nodejs:latest
  

• SDK Image（指定OS和架构）：

  pulumi/pulumi-go:3.100.0-debian-arm64
  pulumi/pulumi-dotnet:3.100.0-ubi-amd64
  

基本运行命令

通过bash命令在容器中执行Pulumi操作：

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

其中$IMAGE为具体镜像名称（如pulumi/pulumi-python:3.100.0），$STACK为Pulumi栈名称。

使用场景和适用范围

• 需要轻量级Pulumi环境以减少资源占用的场景
• CI/CD流程中仅需特定SDK的自动化部署任务
• 对镜像体积有严格要求的环境（如边缘计算、资源受限的容器平台）
• 需要在不同架构（ARM64/AMD64）或操作系统（UBI/Debian）中运行Pulumi的场景

注意事项

本镜像不包含运行Pulumi Provider时可能需要的额外工具。例如，使用pulumi-kubernetes结合Helm时，需以此镜像为基础镜像构建新镜像，或在CI流程中额外安装helm命令。