nexbus/go-pulumi

circle ci base go:1.18-node 镜像文档

1. 镜像概述

本镜像为CircleCI环境设计的基础镜像，基于官方go:1.18-node镜像构建，预集成了golangci-lint（代码静态分析工具）和Pulumi（云资源编排工具）。旨在为Go项目提供开箱即用的CI/CD环境，简化构建、测试、代码质量检查及云资源部署流程，减少环境配置时间。

2. 核心功能与特性

2.1 基础环境

• Go版本：1.18，支持Go 1.18特性及标准库
• Node.js：继承自go:1.18-node基础镜像，版本与官方go:1.18-node保持一致，满足前端依赖或Node.js相关工具需求

2.2 预安装工具

• golangci-lint：Go语言静态代码分析工具，集成多种linter（如golint、govet、errcheck等），支持代码质量检查与规范校验
• Pulumi：多云资源编排工具，支持使用Go等编程语言定义和部署云资源（AWS、Azure、GCP等）

2.3 其他特性

• 与CircleCI环境兼容，可直接作为CI/CD流水线的基础执行环境
• 工具版本预固定，确保构建环境一致性，避免版本差异导致的构建问题

3. 使用场景

• Go项目的CI/CD流水线：适用于基于Go开发的应用，需在CircleCI中完成构建、测试、代码检查的场景
• 代码质量管控：通过预安装的golangci-lint，自动化执行代码静态分析，确保代码规范
• 云资源部署：结合Pulumi，在CI/CD流程中集成云资源的定义与部署，实现基础设施即代码（IaC）
• 多工具协同场景：需同时使用Go、Node.js、代码检查工具及云部署工具的复杂项目构建流程

4. 使用方法与配置说明

4.1 本地测试（Docker Run）

通过以下命令启动容器，验证环境配置：

bash
docker run -it --rm circleci/base-go:1.18-node /bin/bash

在容器内验证工具版本：

bash
# 验证Go版本
go version  # 输出：go version go1.18 ...

# 验证Node.js版本
node -v     # 输出Node.js版本（继承自go:1.18-node）

# 验证golangci-lint版本
golangci-lint --version  # 输出golangci-lint版本信息

# 验证Pulumi版本
pulumi version  # 输出Pulumi版本信息

4.2 Docker Compose配置示例

在docker-compose.yml中使用该镜像：

yaml
version: '3'
services:
  ci-environment:
    image: circleci/base-go:1.18-node
    volumes:
      - ./:/app  # 挂载本地项目目录
    working_dir: /app
    command: /bin/bash -c "go mod download && golangci-lint run && pulumi preview"

启动服务：

bash
docker-compose up

4.3 CircleCI配置示例（.circleci/config.yml）

在CircleCI流水线中使用该镜像：

yaml
version: 2.1
jobs:
  build-and-test:
    docker:
      - image: circleci/base-go:1.18-node
    steps:
      - checkout  # 拉取代码
      - run: go mod download  # 下载Go依赖
      - run: go test ./...    # 执行Go测试
      - run: golangci-lint run  # 执行代码静态检查
      - run: pulumi login  # 登录Pulumi（需提前配置PULUMI_ACCESS_TOKEN环境变量）
      - run: pulumi up -y  # 部署云资源

workflows:
  main:
    jobs:
      - build-and-test

4.4 环境变量说明

• 继承自go:1.18-node的环境变量（如GOPATH、NODE_PATH等）
• Pulumi相关环境变量（如PULUMI_ACCESS_TOKEN）需在CircleCI项目设置中配置，用于Pulumi登录认证

5. 注意事项

• 该镜像专为CircleCI设计，生产环境使用需评估安全性及资源需求
• 如需更新工具版本，需重新构建镜像或通过apt-get/npm手动升级（不建议，可能破坏环境一致性）
• 本地测试时，确保Docker引擎版本支持该镜像的基础架构（如amd64架构）