Pulumi Docker镜像

镜像概述

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

核心功能与特性

• 轻量化设计：仅包含特定SDK所需组件，避免全量SDK带来的体积冗余
• 多架构支持：debian和基础镜像支持ARM64与AMD64架构，UBI镜像仅支持AMD64
• 灵活镜像类型：提供基础镜像（Base Image）和包含SDK运行时的SDK镜像两种类型
• 多操作系统支持：基于Debian 12-slim（debian）和Red Hat UBI9 minimal（ubi）构建

镜像类型

基础镜像（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运行时的镜像，针对特定Pulumi 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
• ubi：基于registry.access.redhat.com/ubi9/ubi-minimal

架构说明：debian和基础镜像支持ARM64与AMD64架构；UBI镜像仅支持AMD64架构。

UBI镜像说明

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

使用方法

基本运行示例

通过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"

参数说明：

• -e "PULUMI_ACCESS_TOKEN=$PULUMI_ACCESS_TOKEN"：传递Pulumi访问令牌
• -v $(pwd):/pulumi/projects：挂载当前目录到容器内的/pulumi/projects路径
• $IMAGE：替换为实际使用的镜像名称（如pulumi/pulumi-python:3.0.0）
• $STACK：替换为Pulumi栈名称

注意事项

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