deliveroo/circleci-golang-kafka

镜像概述

该Docker镜像为Golang环境，专为CircleCI和ECS（Amazon Elastic Container Service）设计，内置最新版本的Kafka C/C++库，可无缝配合Confluent Go客户端使用，便于开发和部署依赖Kafka的Golang应用程序。

核心功能与特性

• 完整Golang环境：提供标准Golang开发和运行环境，支持Golang应用的构建与执行。
• 最新Kafka C/C++库：集成最新版Kafka C/C++客户端库，满足与Kafka集群交互的底层依赖需求。
• 多环境兼容：针对CircleCI（持续集成环境）和ECS（容器编排服务）优化，确保在自动化构建和云部署场景中的稳定性。
• Confluent Go客户端支持：可直接与Confluent Go客户端（如confluent-kafka-go）配合使用，简化Kafka消息生产/消费功能的开发。

使用场景

• CircleCI构建流程：在CircleCI流水线中用于构建、测试依赖Kafka的Golang项目，解决Kafka C/C++库的依赖问题。
• ECS服务部署：作为基础镜像在ECS中部署需要与Kafka集群通信的Golang微服务。
• 本地开发调试：在本地环境中快速搭建包含Kafka依赖的Golang开发环境，减少依赖配置时间。

使用方法与配置说明

基本使用

拉取镜像

bash
docker pull deliveroo/circleci-golang-kafka:latest

运行容器

bash
docker run -it --rm deliveroo/circleci-golang-kafka:latest go version

上述命令可验证Golang环境是否正常，输出Golang版本信息。

在CircleCI中使用

在.circleci/config.yml中指定该镜像作为构建环境：

yaml
version: 2.1
jobs:
  build:
    docker:
      - image: deliveroo/circleci-golang-kafka:latest
    steps:
      - checkout
      - run: go mod download
      - run: go build -o app ./cmd/main.go
      - run: ./app

在ECS中使用

在ECS任务定义中引用该镜像，示例片段：

json
{
  "containerDefinitions": [
    {
      "name": "golang-kafka-app",
      "image": "deliveroo/circleci-golang-kafka:latest",
      "essential": true,
      "command": ["go", "run", "main.go"]
    }
  ]
}

依赖验证

进入容器后，可通过以下命令验证Kafka C/C++库是否安装：

bash
ldconfig -p | grep librdkafka

若输出包含librdkafka相关库文件，表明Kafka C/C++库已成功集成。

相关链接

• 源码仓库：https://github.com/deliveroo/circleci-golang-kafka