atholeque/goterracloud

镜像概述

本Docker镜像预集成了Golang、Terraform和gcloud SDK，旨在提供一站式开发环境，简化云基础设施开发、Go应用构建及Google Cloud平台操作流程。通过整合核心工具，减少环境配置时间，确保开发、测试与部署环境的一致性。

核心功能与特性

工具集成

• Golang：包含Go编程语言开发环境，支持Go应用的编译、测试与调试
• Terraform：集成基础设施即代码(IaC)工具，支持云资源定义、部署与版本管理
• gcloud SDK：内置Google Cloud命令行工具，支持Google Cloud平台资源操作、认证与服务管理

协同能力

• 工具间无缝协同：支持在同一环境中完成"Go应用开发→Terraform资源定义→gcloud部署"全流程
• 依赖预配置：已解决工具间依赖冲突，确保Golang编译环境、Terraform插件与gcloud组件兼容

环境优势

• 一致性保障：消除"本地环境差异"问题，确保团队成员及CI/CD流程使用统一工具版本
• 轻量级设计：基于官方轻量级基础镜像（如Alpine或Debian Slim），优化镜像体积与启动速度

使用场景

• 云基础设施开发：使用Terraform编写Google Cloud资源配置，同时通过Go开发自定义Terraform Provider或模块
• Go应用全流程开发：在容器中完成Go应用编码、测试、编译，并通过gcloud直接部署至Google Cloud（GKE、Cloud Run等）
• CI/CD流程集成：作为CI/CD流水线的构建/部署节点，执行代码编译、基础设施部署、云资源巡检等任务
• 学习与测试环境：快速搭建临时环境，用于学习Go编程、Terraform语法或Google Cloud平台操作

使用方法与配置说明

基础使用

通过docker run命令启动交互式终端，直接使用集成工具：

bash
docker run -it --rm [镜像名称] /bin/bash

挂载本地项目（开发模式）

将本地项目目录挂载至容器，实现代码实时同步与开发：

bash
# 挂载当前目录至容器/workspace，并设置为工作目录
docker run -it --rm -v $(pwd):/workspace -w /workspace [镜像名称] /bin/bash

工具使用示例

1. Terraform操作Google Cloud资源

bash
# 1. 进入Terraform项目目录（假设已挂载本地项目）
cd /workspace/terraform-gcp-project

# 2. 通过gcloud认证（首次使用需执行）
gcloud auth login  # 交互式登录，或使用服务账号密钥：
# gcloud auth activate-service-account --key-file=/path/to/key.json

# 3. 初始化Terraform（下载GCP Provider等依赖）
terraform init

# 4. 预览资源变更计划
terraform plan

# 5. 应用资源配置
terraform apply

2. Go应用开发与编译

bash
# 1. 进入Go项目目录
cd /workspace/go-app

# 2. 下载依赖
go mod download

# 3. 编译应用（生成可执行文件）
GOOS=linux GOARCH=amd64 go build -o app-linux main.go

# 4. 通过gcloud部署至Cloud Run
gcloud run deploy my-go-app --image gcr.io/[project-id]/app-linux --platform managed

高级配置

指定工具版本（构建时）

构建镜像时可通过--build-arg指定工具版本：

bash
docker build \
  --build-arg GO_VERSION=1.21.0 \
  --build-arg TERRAFORM_VERSION=1.6.2 \
  --build-arg GCLOUD_VERSION=450.0.0 \
  -t [自定义镜像名称] .

持久化gcloud配置

挂载本地gcloud配置目录，避免重复认证：

bash
docker run -it --rm \
  -v ~/.config/gcloud:/root/.config/gcloud \
  -v $(pwd):/workspace \
  -w /workspace \
  [镜像名称] /bin/bash

注意事项

• 权限管理：运行容器时根据需求挂载必要凭证（如SSH密钥、GCP服务账号密钥），避免容器内权限过度开放
• 数据持久化：容器默认无持久化存储，需通过挂载卷保存项目代码、配置文件等关键数据
• 版本兼容性：工具版本升级可能引入兼容性变化，建议在生产环境中明确指定工具版本