Pulumi Docker镜像

概述和主要用途

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

核心功能和特性

• 轻量级设计：仅包含特定SDK所需组件，体积显著小于***全SDK镜像
• 多类型镜像：提供基础镜像（仅含Pulumi二进制和语言运行时）和SDK镜像（含SDK运行时）两种类型
• 多操作系统支持：基于Debian 12-slim（Bookworm）和RedHat UBI9 minimal（ubi）构建
• 多架构支持：Debian基础镜像支持ARM64和AMD64架构，UBI镜像仅支持AMD64架构

镜像类型说明

基础镜像（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）构建，支持ARM64和AMD64架构
• UBI：基于registry.access.redhat.com/ubi9/ubi-minimal构建，仅支持AMD64架构

UBI镜像说明

UBI镜像使用microdnf作为包管理器（非yum），更多信息参见microdnf文档。

使用场景和适用范围

适用于需要使用Pulumi进行基础设施即代码（IaC）开发或部署，且对镜像体积有要求的场景，尤其适合：

• 仅使用单一或特定Pulumi SDK的项目
• CI/CD流水线中需要轻量级容器的环境
• 容器化部署环境中资源受限的场景

使用方法和配置说明

运行Pulumi命令

通过bash命令在容器中运行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_ACCESS_TOKEN：Pulumi访问令牌，需提前设置
• $(pwd):/pulumi/projects：将当前目录挂载到容器内的/pulumi/projects目录
• $IMAGE：指定使用的Pulumi镜像（如pulumi/pulumi-python:3.0.0-debian-amd64）
• $STACK：指定Pulumi堆栈名称

注意事项

本镜像不含运行Pulumi provider时可能需要的额外工具。例如，若使用pulumi-kubernetes配合Helm，需：

• 将本镜像作为基础镜像构建自定义镜像
• 或在CI流程中自行安装helm命令等必要工具