Pulumi Docker镜像

镜像概述和主要用途

本镜像是***pulumi/pulumi镜像的轻量级替代方案。***镜像因捆绑所有支持的SDK（Go、Python、NodeJS、.NET、Java）而体积较大，本镜像则针对特定SDK优化，仅包含pulumi二进制文件、对应语言运行时及必要组件，显著减小体积，适用于需要精简部署的场景。

核心功能和特性

轻量级设计

针对特定SDK构建，避免捆绑所有SDK导致的体积膨胀，仅包含运行所需的pulumi二进制文件、语言运行时及必要组件。

多架构与操作系统支持

• 操作系统：基于两种基础镜像构建
  • registry.access.redhat.com/ubi9/ubi-minimal（UBI）
  • debian:12-slim（Debian）
• 架构：Base和Debian镜像支持ARM64与AMD64；UBI镜像仅支持AMD64。

灵活的镜像类型

提供两种镜像类型以满足不同需求：

• Base Image：仅含pulumi二进制文件和语言运行时，不含SDK运行时，需自行安装Go/Python/.NET/NodeJS等语言环境。
• SDK Images：包含对应SDK运行时，可直接用于特定语言的Pulumi项目。

精简体积

压缩后体积约150-400MB，远小于***pulumi/pulumi镜像（因无需捆绑所有SDK）。

使用场景和适用范围

• CI/CD流程：需精简资源占用的持续集成/部署场景。
• 特定语言项目：单一语言（Go、Python、NodeJS、.NET或Java）的Pulumi项目开发与运行。
• 资源受限环境：对镜像体积有严格要求的部署环境。

详细的使用方法和配置说明

镜像格式

Base Image

仅包含pulumi二进制文件和语言运行时，格式：

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

默认镜像（不含OS后缀）基于Debian AMD64，使用方式：

pulumi/pulumi-base:<PULUMI_VERSION>

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

操作系统说明

UBI镜像

基于registry.access.redhat.com/ubi9/ubi-minimal，使用microdnf作为包管理器（非yum），仅支持AMD64架构。

Debian镜像

基于debian:12-slim，支持ARM64和AMD64架构。

部署示例

使用docker run运行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.0.0），$STACK为Pulumi栈名称。

注意事项

• 本镜像不包含运行Pulumi提供程序时可能需要的额外工具（如使用pulumi-kubernetes与Helm时需的helm命令），需将本镜像作为基础镜像扩展，或在CI流程中自行安装。
• Base Image需手动安装对应语言环境，SDK Images已包含语言运行时，可直接使用。