lumosdang/coder

Coder自定义Docker镜像

镜像概述

本镜像是基于官方Coder v2.2.0镜像构建的自定义版本，专为需要使用Terraform的开发环境设计。它预装了指定版本的Terraform，并配置了Terraform提供商镜像，同时包含了多个常用的Terraform提供商，可直接用于Coder平台的基础设施即代码环境。

核心功能和特性

• 基于官方Coder v2.2.0镜像构建
• 预装指定版本的Terraform（默认1.5.7，可自定义）
• 配置了Terraform提供商镜像机制
• 预包含多个常用Terraform提供商：
  • coder/coder v0.12.1
  • kreuzwerker/docker v3.0.2
  • hashicorp/kubernetes v2.23.0
  • aws/aws v5.19.0
• 支持两种镜像配置方式：文件系统镜像和网络镜像

使用场景和适用范围

• Coder平台环境部署
• 需要集成Terraform的开发环境
• 基础设施即代码(IaC)开发工作流
• 需要离线或私有环境使用Terraform的场景

使用方法和配置说明

构建镜像

bash
# 构建默认版本
docker build -t custom-coder-image .

# 构建时指定不同的Terraform版本
docker build --build-arg TERRAFORM_VERSION=1.6.0 -t custom-coder-image .

# 构建时指定不同的提供商版本
docker build \
  --build-arg TERRAFORM_VERSION=1.6.0 \
  --build-arg CODER_PROVIDER_VERSION=0.13.0 \
  --build-arg DOCKER_PROVIDER_VERSION=3.1.0 \
  -t custom-coder-image .

运行容器

bash
docker run -d -p 3000:3000 --name coder-server custom-coder-image

配置说明

Terraform镜像配置

本镜像支持两种Terraform提供商镜像配置方式：

1. 文件系统镜像（默认）:

   • 提供商存储在/opt/terraform/plugins目录
   • 配置文件: /opt/terraform/config.tfrc
   • 可通过挂载卷扩展提供商:

     bash
     docker run -d -p 3000:3000 -v /path/to/local/plugins:/opt/terraform/plugins --name coder-server custom-coder-image
     

2. 网络镜像:

   • 需修改Dockerfile，取消注释"Option 2"部分
   • 修改network-mirror.tfrc文件，指定网络镜像URL
   • 重新构建镜像

环境变量

• TF_CLI_CONFIG_FILE: Terraform CLI配置文件路径，默认为/opt/terraform/config.tfrc
• PATH: 包含了Terraform可执行文件路径/opt/terraform

Docker Compose配置示例

yaml
version: '3.8'

services:
  coder:
    build:
      context: .
      args:
        TERRAFORM_VERSION: 1.5.7
        CODER_PROVIDER_VERSION: 0.12.1
    ports:
      - "3000:3000"
    volumes:
      - coder-data:/home/coder
      # 可选：挂载自定义提供商目录
      # - ./custom-plugins:/opt/terraform/plugins
    environment:
      - CODER_ACCESS_URL=http://localhost:3000
      - CODER_PG_CONNECTION_URL=postgresql://username:password@postgres:5432/coder?sslmode=disable

  postgres:
    image: postgres:14
    environment:
      - POSTGRES_USER=username
      - POSTGRES_PASSWORD=password
      - POSTGRES_DB=coder
    volumes:
      - postgres-data:/var/lib/postgresql/data

volumes:
  coder-data:
  postgres-data:

自定义提供商

要添加额外的Terraform提供商，可以：

1. 在Dockerfile中添加类似以下的代码：

   Dockerfile
   ARG CUSTOM_PROVIDER_VERSION=1.0.0
   RUN echo "Adding custom/provider v${CUSTOM_PROVIDER_VERSION}" \
       && mkdir -p custom/provider && cd custom/provider \
       && curl -LOs https://example.com/terraform-provider-custom_${CUSTOM_PROVIDER_VERSION}_linux_amd64.zip
   

2. 或通过卷挂载方式在运行时添加：

   bash
   docker run -v /path/to/your/providers:/opt/terraform/plugins/registry.terraform.io/custom/provider custom-coder-image