pulumi/console

Self-Hosted Pulumi Service - Console 镜像文档

镜像概述和主要用途

Self-Hosted Pulumi Service Console 镜像是 Pulumi 自托管服务的核心组件之一，用于在组织内部环境中部署 Pulumi 平台的用户界面。该镜像提供与 Pulumi SaaS 控制台一致的交互体验，需与 https://www.pulumi.com/docs/guides/self-hosted/api/ 配合使用，共同构成完整的自托管 Pulumi 服务架构。

核心功能和特性

• SaaS 风格控制台界面：提供与 Pulumi 官方 SaaS 服务一致的用户界面，支持堆栈管理、资源可视化、部署历史查看等核心操作。
• 与 Pulumi API 服务深度集成：依赖 Pulumi API 服务提供数据支撑，需配置 API 服务地址以实现功能联动。
• 自托管环境适配：针对企业内部网络环境设计，支持私有部署场景下的访问控制与资源隔离。

使用场景和适用范围

适用场景

• 企业或组织需在内部环境（而非 Pulumi 官方 SaaS）部署 Pulumi 服务。
• 对数据隐私、合规性有严格要求，需将基础设施即代码（IaC）管理平台部署在私有网络中的场景。
• 需要构建内部自助式 IaC 平台，供团队成员通过统一界面管理 Pulumi 堆栈、资源和部署流程的场景。

适用范围

• 具备自托管基础设施（如私有云、数据中心）的企业或团队。
• 已部署或计划部署 Self-Hosted Pulumi API 服务的环境。
• 需要满足行业合规标准（如 GDPR、HIPAA），要求数据本地化存储的组织。

使用方法和配置说明

前提条件

• 已部署 Self-Hosted Pulumi API 服务，并确保 Console 镜像可访问该 API 服务地址。
• 安装 Docker 或 Docker Compose 环境。

镜像拉取

从 Pulumi 官方镜像仓库拉取最新版本 Console 镜像：

bash
docker pull docker.xuanyuan.run/pulumi/console:latest

容器运行（docker run）

通过以下命令启动 Console 容器，需指定 Pulumi API 服务地址等必要配置：

bash
docker run -d \
  --name pulumi-console \
  -p 8080:8080 \
  -e PULUMI_API_URL="http://pulumi-api:8080" \  # 指向 Self-Hosted Pulumi API 服务地址
  -e LOG_LEVEL="info" \                         # 日志级别（可选，默认 info）
  pulumi/console:latest

• 端口映射：默认容器内端口为 8080，可通过 -p 映射至主机端口（如示例中的 8080:8080）。
• 环境变量 PULUMI_API_URL 为必填项，需指向已部署的 Pulumi API 服务地址（支持 HTTP/HTTPS）。

Docker Compose 配置示例

若需与 Pulumi API 服务协同部署，可使用以下 docker-compose.yml 示例：

yaml
version: "3.8"
services:
  pulumi-api:
    image: docker.xuanyuan.run/pulumi/api:latest
    ports:
      - "8081:8080"
    # API 服务配置（参考 Pulumi API 镜像文档）
    environment:
      - DATABASE_URL="postgresql://user:password@db:5432/pulumi"
    depends_on:
      - db

  pulumi-console:
    image: docker.xuanyuan.run/pulumi/console:latest
    ports:
      - "8080:8080"
    environment:
      - PULUMI_API_URL="http://pulumi-api:8080"  # 容器内访问 API 服务的地址
      - LOG_LEVEL="info"
    depends_on:
      - pulumi-api

  db:
    image: docker.xuanyuan.run/postgres:14
    environment:
      - POSTGRES_USER="user"
      - POSTGRES_PASSWORD="password"
      - POSTGRES_DB="pulumi"
    volumes:
      - postgres-data:/var/lib/postgresql/data

volumes:
  postgres-data:

环境变量配置说明

参考链接

• https://www.pulumi.com/product/self-hosted
• https://www.pulumi.com/docs/guides/self-hosted/
• https://github.com/pulumi/pulumi-self-hosted-installers