Pulumi Docker镜像（针对Python SDK）

镜像概述和主要用途

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

核心功能和特性

• 精简体积：相比包含所有SDK的pulumi/pulumi镜像，本镜像体积更小，专注于Python SDK
• 完整组件：包含pulumi二进制文件、Python语言运行时及Python SDK所需的必要组件
• 多架构与操作系统支持：提供基于不同操作系统的镜像，支持多种架构（AMD64/ARM64，UBI镜像仅支持AMD64）

镜像类型

基础镜像（Base Image）

基础镜像仅包含pulumi二进制文件和语言运行时，不含SDK运行时。若使用基础镜像，需自行安装Python等SDK运行时。镜像格式如下：

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

默认不含OS后缀的镜像基于Debian AMD64，使用示例：

pulumi/pulumi-base:<PULUMI_VERSION>

SDK镜像（SDK Images）

包含SDK运行时的镜像（针对Python SDK）格式如下：

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

默认不含OS后缀的镜像基于Debian AMD64，使用示例：

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

镜像大小

各镜像体积远小于包含所有SDK的pulumi/pulumi容器，压缩后大小约为150-400MB，具体取决于所基于的操作系统。

操作系统支持

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

• registry.access.redhat.com/ubi9/ubi-minimal（ubi）
• debian:12-slim（debian）

基础镜像和Debian镜像支持ARM64与AMD64架构，UBI镜像仅支持AMD64架构。

UBI镜像说明

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

使用方法

在容器中运行Pulumi命令时，可通过以下方式传递bash命令：

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

注意事项

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