acim/go-reflex

用于自动重新编译和自动重启Golang服务器应用的Docker镜像

!Docker Architecture !Docker Architecture

镜像概述和主要用途

本Docker镜像专为Golang服务器应用设计，提供自动重新编译和自动重启功能。通过监控代码文件变化，实现开发过程中的实时更新，提升Golang应用的开发效率。支持与docker-compose和Kubernetes（kind）集成，适用于本地开发环境。

核心功能和特性

• 兼容https://github.com/docker/compose%E5%92%8Chttps://github.com/kubernetes-sigs/kind
• 使用https://github.com/cespare/reflex%E7%9B%91%E6%8E%A7.go%E5%92%8C.html%E6%96%87%E4%BB%B6%E5%8F%98%E5%8C%96%EF%BC%8C%E8%87%AA%E5%8A%A8%E9%87%8D%E6%96%B0%E7%BC%96%E8%AF%91%E5%B9%B6%E9%87%8D%E5%90%AF%E6%9C%8D%E5%8A%A1%E5%99%A8%E5%BA%94%E7%94%A8
• 可选启用数据竞争检测器
• 支持amd64和arm64架构

功能请求

• 请提交https://github.com/acim/go-reflex/issues/new

使用场景和适用范围

适用于Golang服务器应用的本地开发环境，尤其适合需要频繁修改代码并实时查看效果的开发场景。支持单机docker-compose部署和Kubernetes（kind）集群部署。

详细使用方法和配置说明

使用docker-compose

在项目根目录放置docker-compose.yml文件，运行docker-compose up --build启动。

主包位于项目根目录的docker-compose.yml示例

yaml
version: '3.8'

services:
  myservice:
    image: acim/go-reflex
    environment:
      - RACE_DETECTOR=1
    volumes:
      - .:/app
    ports:
      - 3000:3000

注意：将端口号替换为您应用的实际端口号。

主包不在项目根目录的docker-compose.yml示例

yaml
version: '3.8'

services:
  myservice:
    image: acim/go-reflex
    environment:
      - RACE_DETECTOR=1
      - BUILD_ARGS=./cmd/server/server.go
    volumes:
      - .:/app
    ports:
      - 3000:3000

使用kind（Kubernetes）

安装kind

sh
go install sigs.k8s.io/kind@latest

创建本地集群

sh
kind create cluster --config=config.yaml

config.yaml示例

yaml
apiVersion: kind.x-k8s.io/v1alpha4
kind: Cluster
nodes:
  - role: control-plane
    extraMounts:
      - hostPath: /path/to/your/project/root
        containerPath: /app

部署应用

sh
kubectl apply -f deploy.yaml

deploy.yaml示例

yaml
apiVersion: v1
kind: Pod
metadata:
  name: your-app-name
  namespace: default
spec:
  containers:
    - image: acim/go-reflex
      name: your-app-name
      env:
        - name: RACE_DETECTOR
          value: '1'
      volumeMounts:
        - mountPath: /app
          name: app
  restartPolicy: Never
  volumes:
    - hostPath:
        path: /app
      name: app

启动端口转发

sh
kubectl port-forward your-app-name 3000:3000

注意：将端口号替换为您应用的实际端口号。

可选环境变量

• RACE_DETECTOR=1 - 启用数据竞争检测器编译二进制文件
• RUN_ARGS - 用于为二进制文件调用添加子命令和/或标志（例如：serve --verbose）
• BUILD_ARGS - 用于为go build命令添加标志（例如："./cmd/myapp/main.go"）
• APT_INSTALL - 用于安装额外软件包（实验性，效率不高）