Go アプリをデプロイする

Lizard (lizard.build) に Go アプリをデプロイするには、go.mod ファイルを含むモジュールをアップロードするか push します。lizardpack は go 行の Go バージョンでビルドし、静的バイナリ（CGO_ENABLED=0）をコンパイルして Alpine Linux 上で実行します。サービスポートは 8080 で、Lizard はそれを PORT でプロセスに渡します。PORT を読み取り、すべてのインターフェースで待ち受けてください。

テスト状況: 以下のサンプルアプリは Go 1.24 を使ってローカルでビルド・実行でき、ビルドプランは、Lizard が使う lizardpack で確認しました。このガイドのデプロイ手順は、まだ最初から最後まで試していません。

始める前に

• デプロイするディレクトリに go.mod があり、依存関係がある場合は go.sum もある Go モジュール。
• lizard login でサインイン済みで、Pro または 7 日間の Pro トライアル（カードが必要）を利用している Lizard CLI。料金を参照してください。

最小構成のアプリ

go.mod:

module example.com/hello

go 1.24

main.go:

package main
 
import (
	"fmt"
	"log"
	"net/http"
	"os"
)
 
func main() {
	port := os.Getenv("PORT")
	if port == "" {
		port = "8080"
	}
 
	http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
		fmt.Fprintln(w, "Hello from Go on Lizard")
	})
	http.HandleFunc("/healthz", func(w http.ResponseWriter, r *http.Request) {
		fmt.Fprintln(w, "ok")
	})
 
	log.Printf("listening on :%s", port)
	log.Fatal(http.ListenAndServe(":"+port, nil))
}

":"+port はすべてのインターフェースで待ち受けます。127.0.0.1:8080 のようなアドレスではコンテナ内からの接続しか受け付けず、デプロイはいつまでも healthy になりません。

ローカルで確認します:

go run .
curl http://localhost:8080/healthz

lizardpack がビルドするもの

生成される Dockerfile:

FROM golang:1.24-alpine AS build
WORKDIR /app
COPY go.mod go.sum* ./
RUN go mod download
COPY . .
RUN CGO_ENABLED=0 GOOS=linux go build -ldflags='-s -w' -o /app/server .
 
FROM alpine:3.19
RUN apk add --no-cache ca-certificates tzdata
WORKDIR /app
COPY --from=build /app /app
EXPOSE 8080
CMD ["/app/server"]

このイメージを使うには、サービスのビルドコマンドと起動コマンドを空のままにしてください。どちらかが設定されていると、Lizard はそのコマンドから別の Dockerfile を生成し、go 行を無視します。その場合、go build … コマンドは Go 1.24 でビルドされます。すべてのステップを自分で制御するには、独自の Dockerfile をコミットしてください。Dockerfile から Docker コンテナをデプロイするを参照してください。

デプロイ

モジュールのルートから実行します:

lizard init --name go-app
lizard add --service api
lizard up --service api --port 8080

lizard up はディレクトリをアップロードし、Lizard のビルドマシンでビルドして URL を表示します。コマンドを実行するマシンに Docker や Go は必要ありません。git push to deploy を使う場合は、lizard add -r your-org/your-app -n api で GitHub リポジトリを接続 し、lizard port --service api が 8080 を表示することを確認してください。

フレームワーク

• net/http、chi、gorilla/mux: 上の例のように、http.ListenAndServe に ":" + os.Getenv("PORT") を渡します。
• Gin: アドレスなしの r.Run() は PORT を読み取り、なければ :8080 を使います。サービスに GIN_MODE=release を設定してください。
• Echo、Fiber: アドレスを自分で渡します。e.Start(":" + os.Getenv("PORT")) または app.Listen(":" + os.Getenv("PORT")) を使ってください。

変数とデータベース

サービスに設定を追加し、os.Getenv で読み取ります:

lizard secrets set GIN_MODE=release API_KEY=change-me --service api

データベースには Managed Postgres を追加し、参照 を使ってそのプライベート URL を渡します:

lizard add postgres
lizard secrets set DATABASE_URL='${{postgres.DATABASE_PRIVATE_URL}}' --service api

その後、pgxpool.New(ctx, os.Getenv("DATABASE_URL")) のようにドライバーで接続します。変数を変更すると、再ビルドなしでサービスが再起動します。

動作を確認する

lizard logs --build --service api
lizard logs --service api --tail 100
lizard ps

lizard up が表示した URL で /healthz をリクエストし、続いて実際の処理を行うルートをリクエストします。ビルドログには、ビルドに使われた golang: イメージが表示されます。

よくある問題

キューコンシューマーのように HTTP を提供しない Go プロセスは、--port 0 を付けて バックグラウンドワーカー として実行します。

関連項目

• フレームワークガイド
• ビルドパイプライン
• 変数とシークレット
• ネットワークとドメイン

更新日 2026年10月12日