Pulumi Docker镜像

概述

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

核心功能与特性

• 轻量级设计：相比***镜像体积显著减小，压缩后大小约150-400MB（取决于操作系统和依赖）
• 特定SDK支持：针对不同Pulumi语言SDK构建专用镜像，避免冗余
• 多操作系统支持：基于两种基础镜像构建：
  • registry.access.redhat.com/ubi9/ubi-minimal（ubi）
  • debian:12-slim（debian）
• 多架构支持：base和debian镜像支持ARM64与AMD64架构，UBI镜像仅支持AMD64架构

镜像类型

Base Image

仅包含Pulumi二进制文件和语言运行时，不含SDK运行时（如Go、Python等），需用户自行安装SDK运行时。
格式：

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

默认镜像（基于Debian AMD64，可省略OS）：

pulumi/pulumi-base:<PULUMI_VERSION>

SDK Images

包含SDK运行时的镜像，针对特定SDK优化。
格式：

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

默认镜像（基于Debian AMD64，可省略OS）：

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

操作系统说明

• UBI镜像：使用microdnf作为包管理器（非yum），详情参见microdnf文档
• Debian镜像：基于Debian 12（Bookworm）slim版本

使用方法

运行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：挂载当前目录到容器内项目路径
• $IMAGE：指定使用的镜像（如pulumi/pulumi-python:3.0.0）
• $STACK：Pulumi堆栈名称

注意事项

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