【Go言語でホットリロード】AirとDockerによるAPI開発環境

.
├── Dockerfile
├── .air.toml
├── docker-compose.yaml
├── go.mod
├── go.sum
├── main.go

FROM golang:1.20.4-bullseye

RUN go install github.com/cosmtrek/air@latest

version: "3.8"

services:
  go:
    container_name: air_sample
    volumes:
      - ./:/project/
    working_dir: /project
    tty: true
    build: "./"
    ports:
      - 8080:8080
    command: sh -c 'go mod tidy && air'

root = "."
testdata_dir = "testdata"
tmp_dir = "tmp"
[build]
  args_bin = []
  bin = "./tmp/main"
  cmd = "go build -o ./tmp/main ."
  delay = 0
  exclude_dir = ["assets", "tmp", "vendor", "testdata"]
  exclude_file = []
  exclude_regex = ["_test.go"]
  exclude_unchanged = false
  follow_symlink = false
  full_bin = ""
  include_dir = []
  include_ext = ["go", "tpl", "tmpl", "html"]
  include_file = []
  kill_delay = "0s"
  log = "build-errors.log"
  poll = false
  poll_interval = 0
  rerun = false
  rerun_delay = 500
  send_interrupt = false
  stop_on_error = false
[color]
  app = ""
  build = "yellow"
  main = "magenta"
  runner = "green"
  watcher = "cyan"
[log]
  main_only = false
  time = false
[misc]
  clean_on_exit = false
[screen]
  clear_on_rebuild = false
  keep_scroll = true

.air.tomlはAirの設定ファイルであり air init で生成したファイルをそのまま利用します。

簡単に説明をすると

• “_test” を含むファイルと”assets”, “tmp”, “vendor”, “testdata” ディレクトリはビルドの対象外とする

• tmp/ ディレクトリにmainという実行ファイルをビルドして実行する

という設定にしています。

go.mod, go.sum

これらはgoが自動で生成するファイルのため内容は省略します。

$ go mod init <プロジェクト名>
$ go mod tidy

を実行して作成しました。

main.go

package main

import "github.com/gin-gonic/gin"

func main() {
	r := gin.Default()
	r.GET("/ping", func(c *gin.Context) {
		c.JSON(200, gin.H{
			"message": "pong",
		})
	})
	r.Run()
}

動作チェック

HTTPサーバーが起動するか

コンテナを起動するためにdocker compose upを実行します。

$ docker compose up
[+] Running 1/0
 ✔ Container air_sample  Created           0.0s
Attaching to air_sample
air_sample  |
air_sample  |   __    _   ___
air_sample  |  / /\  | | | |_)
air_sample  | /_/--\ |_| |_| \_ , built with Go
air_sample  |
~中略~
air_sample  | [GIN-debug] Listening and serving HTTP on :8080

$ curl localhost:8080/ping
{"message":"pong"}