$ go version
go version go1.24.3 darwin/arm64
$ protoc --version
libprotoc 31.0

mkdir go-grpc-docker
cd go-grpc-docker

go mod init github.com/yourusername/go-grpc-docker

mkdir proto

// protoのバージョン定義
syntax = "proto3";

package pb;

// 本パッケージの定義
// `github.com/yourusername/go-grpc-docker` まではリポジトリを指定するようです。そうするとモジュールをgithubからインストールできるとか
// `proto` がモジュール名
option go_package = "github.com/yourusername/go-grpc-docker/proto"

import "google/api/annotations.proto";

// Greeterという名前のサービスを定義
service Greeter {
    // SayHelloというRemote Procedure Callを定義
    rpc SayHello (HelloRequest) returns (HelloResponse) {
        // HTTPアノテーション
        // SayHelloメソッドを "v1/hello/{name}" にマッピングしてHTTP呼び出しできるようにする
        // nameは HelloRequest のname
        option (google.api.http) = {
            get: "/v1/hello/{name}"
        };
    }
}

// HelloRequestの型を定義
message HelloRequest {
    // フィールド番号1
    string name = 1;
}

message HelloResponse {
    string message = 1;
}

go install google.golang.org/protobuf/cmd/protoc-gen-go@latest
go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@latest
go install github.com/grpc-ecosystem/grpc-gateway/v2/protoc-gen-grpc-gateway@latest

git clone https://github.com/googleapis/googleapis.git third_party/googleapis

export PATH=~/go/bin:$PATH

protoc -I proto \
  -I third_party/googleapis \
  --go_out proto --go_opt paths=source_relative \
  --go-grpc_out proto --go-grpc_opt paths=source_relative \
  --grpc-gateway_out proto --grpc-gateway_opt paths=source_relative \
  proto/service.proto

mkdir server

package main

import (
	"context"
	"log"
	"net"

	pb "github.com/yourusername/go-grpc-docker/proto"
	"google.golang.org/grpc"
	"google.golang.org/grpc/reflection"
)

// 実装なしのgreeterServer型を定義。Typescriptのinterfaceみたいな状態
type greeterServer struct {
	pb.UnimplementedGreeterServer
}

// `greeterServer`型に対して`SayHello`関数を追加する
func (s *greeterServer) SayHello(ctx context.Context, req *pb.HelloRequest) (*pb.HelloResponse, error) {
	log.Printf("Received request for name: %s", req.Name)
	return &pb.HelloResponse{Message: "Hello, " + req.Name + "!"}, nil
}

// メイン関数
func main() {
	// TCPサーバーを起動。ポート50051で受け付ける。
	lis, err := net.Listen("tcp", ":50051")
	if err != nil {
		log.Fatalf("Failed to listen on port 50051: %v", err)
	}

	// gRPCのサーバーを立てる
	s := grpc.NewServer()
	// gRPCサーバー(s)にgreeterServerを追加
	pb.RegisterGreeterServer(s, &greeterServer{})
	log.Println("gRPC server listening on port 50051...")

	// サーバー起動前に追加
	reflection.Register(s)

	// TCPサーバのリスナーをgRPCサーバーにインジェクトする
	if err := s.Serve(lis); err != nil {
		log.Fatalf("Failed to serve gRPC server: %v", err)
	}
}

mkdir gateway

package main

import (
    "context"
	"flag"
    "log"
    "net/http"
	"os"

    pb "github.com/yourusername/go-grpc-docker/proto"
    "github.com/grpc-ecosystem/grpc-gateway/v2/runtime"
	"google.golang.org/grpc"

)

// mainの引数にgRPCエンドポイントを指定できるようにする
var (
	// --grpc-server-endpoint という指定でエンドポイントを渡せるようになる。
	// localhost:50051 がデフォルトのエンドポイント
    grpcServerEndpoint = flag.String("grpc-server-endpoint", "localhost:50051", "gRPC server endpoint")
)

func main() {
	// プログラムの引数追加。pythonの`argparse`みたいなやつ
    flag.Parse()

	// 環境変数 GRPC_SERVER_ENDPOINT が設定されていれば優先して使う
	if envEndpoint := os.Getenv("GRPC_SERVER_ENDPOINT"); envEndpoint != "" {
		*grpcServerEndpoint = envEndpoint
	}

	// トップレベルのコンテキストを生成。後でサーバーに渡してサーバー処理の制御をする
    ctx := context.Background()
	// コンテキストにキャンセルを追加
    ctx, cancel := context.WithCancel(ctx)
	// main関数終了後にcancelを遅延実行する
    defer cancel()

	// gRPC-Gatewayが提供するHTTPリクエストをgRPC呼び出しに変換するルータを生成
	// マルチプレクササーバ
    mux := runtime.NewServeMux()
	// gRPC接続オプションを指定。本番は`WithTransportCredentials`を使う必要がある
	opts := []grpc.DialOption{grpc.WithInsecure()}

	// protoコンパイルで自動生成される`RegisterGreeterHandlerFromEndpoint`関数を使って、サーバ、マルチプレクサ、コンテキスト、を紐づける
	// サーバ処理を、RESTfulに使え、キャンセルができる、ようになる
    err := pb.RegisterGreeterHandlerFromEndpoint(ctx, mux, *grpcServerEndpoint, opts)
    if err != nil {
        log.Fatalf("Failed to register handler server: %v", err)
    }

	// 8080ポートでRESTfulリッスン
    log.Println("HTTP server listening on port 8080...")
    if err := http.ListenAndServe(":8080", mux); err != nil {
        log.Fatalf("Failed to serve HTTP server: %v", err)
    }
}

type greeterServer struct {
    pb.UnimplementedGreeterServer
}

func (s *greeterServer) SayHello(ctx context.Context, req *pb.HelloRequest) (*pb.HelloResponse, error) {
    return &pb.HelloResponse{Message: "Hello, " + req.Name + "!"}, nil
}

go mod tidy

# ビルド環境
FROM golang:alpine3.21 AS builder

# Dockerコンテナ内の作業ディレクトリ
WORKDIR /app

# go.modとgo.sumをDockerコンテナにコピー
COPY go.mod go.sum ./

# Docker コンテナでモジュールをダウンロード
RUN go mod download

# ソースコードをDockerコンテナにコピー
COPY . .

# gRPCサーバーをビルド
RUN go build -o bin/server ./server/main.go

# gRPC-Gatewayサーバをビルド
RUN go build -o bin/gateway ./gateway/main.go

# gRPCサーバの実行環境
FROM alpine:latest AS server

WORKDIR /app

COPY --from=builder /app/bin/server .

EXPOSE 50051

ENTRYPOINT ["./server"]

# gRPC-Gatewayサーバの実行環境
FROM alpine:latest AS gateway

WORKDIR /app

COPY --from=builder /app/bin/gateway .

EXPOSE 8080

ENTRYPOINT ["./gateway"]

docker-compose up --build

...
[+] Running 6/6way  Building                                                                            12.8s 
 ✔ Service server                      Built                                                            26.7s 
 ✔ Service gateway                     Built                                                            12.8s 
 ✔ gateway                             Built                                                             0.0s 
 ✔ server                              Built                                                             0.0s 
 ✔ Container go-grpc-docker-server-1   Created                                                           0.0s 
 ✔ Container go-grpc-docker-gateway-1  Created                                                           0.0s 
Attaching to gateway-1, server-1
server-1   | 2025/05/25 06:53:18 gRPC server listening on port 50051...
gateway-1  | 2025/05/25 06:53:18 HTTP server listening on port 8080...

go install github.com/fullstorydev/grpcurl/cmd/grpcurl@latest

$ grpcurl -plaintext -d '{"name": "Docker"}' localhost:50051 pb.Greeter/SayHello
{
  "message": "Hello, Docker!"
}
$ curl http://localhost:8080/v1/hello/Docker

{"message":"Hello, Docker!"}%

grpcurl -plaintext localhost:50051 pb.Greeter/SayHello -d '{"name": "Docker"}

grpcurl -plaintext \
  -import-path ./proto \
  -import-path ./third_party/googleapis \
  -proto ./proto/service.proto \
  -d '{"name": "Docker"}' \
  localhost:50051 \
  pb.Greeter/SayHello
{
  "message": "Hello, Docker!"
}