ドキュメント価格ブログ
お問い合わせ
ログイン無料で新規登録
Back to Tech Articles

GoとgRPCによる高性能マイクロサービスの構築

7月 26, 2025
# Misc

Lukas Schneider

DevOps Engineer · Leapcell

この記事はEnglish、한국어、Deutschでも利用できます
Cover of "GoとgRPCによる高性能マイクロサービスの構築"

はじめに

今日の急速に進化するソフトウェアランドスケープにおいて、マイクロサービスアーキテクチャは、スケーラブルで、回復力があり、独立してデプロイ可能なアプリケーションを構築するための支配的なパラダイムとして登場しました。組織がこのアーキテクチャスタイルを採用するにつれて、サービス間通信プロトコルの選択が最も重要になります。従来のREST APIは、柔軟性がありますが、テキストベースの性質と冗長なデータシリアライゼーションのために、オーバーヘッドを導入することがあります。ここで、高性能なオープンソースのユニバーサルRPCフレームワークであるgRPCが輝きます。HTTP/2上に構築され、効率的なデータシリアライゼーションのためにProtocol Buffersを活用するgRPCは、マイクロサービス間、特にポリグロット環境での、より高速で効率的な通信を実現するための魅力的な代替手段を提供します。この記事では、GoにおけるgRPCの世界を掘り下げ、その強力な機能を活用して、堅牢でパフォーマンスの高いマイクロサービス間通信を構築する方法を実証します。

コアコンセプトの理解

実用的な実装に入る前に、gRPCの中心となるいくつかの基本的な概念を明確にしましょう。

  • RPC（Remote Procedure Call）: RPCの核心は、プログラムが、あたかもローカルプロシージャ呼び出しであるかのように、異なるアドレス空間（通常はリモートコンピュータ）にあるプロシージャ（または関数）を呼び出すことを可能にすることです。RPCの魔法は、バックグラウンドでネットワーク通信、データシリアライゼーション、およびデシリアライゼーションを処理することに関係しています。
  • Protocol Buffers（protobuf）: これは、構造化データをシリアライズするための、Googleの言語ニュートラル、プラットフォームニュートラル、拡張可能なメカニズムです。XMLやJSONとは異なり、Protocol Buffersはバイナリ形式であり、解析が大幅に小さく高速になります。.protoファイルでデータ構造を定義し、その後protoc（Protocol Buffersコンパイラ）がさまざまな言語でコードを生成し、構造化データを簡単に読み書きできるようにします。
  • IDL（Interface Definition Language）: Protocol Buffersは、gRPCのIDLとして機能します。これは、サービスインターフェースと、クライアントとサーバー間で交換されるメッセージ構造を定義するために使用されます。
  • HTTP/2: gRPCは、基盤となるトランスポートプロトコルとしてHTTP/2を利用します。HTTP/2は、HTTP/1.1に比べて、多重化（単一のTCP接続での複数リクエスト/レスポンス）、ヘッダー圧縮、サーバープッシュなど、いくつかの利点を提供しており、これらはすべてgRPCの高性能に貢献しています。
  • スタブ/クライアント: .protoファイルから生成されたクライアントサイドライブラリで、アプリケーションがリモートgRPCサービスへの呼び出しを行うことを可能にします。
  • サーバー: .protoファイルで定義されたサービスの、クライアントからのリクエストを受け取り、レスポンスを送信する実装です。

Go gRPCサービスの Студия**

実用的な例として、シンプルなProduct Catalogマイクロサービスを構築して、gRPCの力を実証しましょう。

1. Protocol Buffersによるサービス定義

まず、.protoファイルでサービスとメッセージタイプを定義します。product.protoという名前のファイルを作成します。

syntax = "proto3";

option go_package = "./pb"; // 生成されるコードのGoパッケージを指定

package product_service;

// Product is a single product in the catalog
message Product {
  string id = 1;
  string name = 2;
  string description = 3;
  float price = 4;
}

// Request to get a product by ID
message GetProductRequest {
  string id = 1;
}

// Request to create a new product
message CreateProductRequest {
  string name = 1;
  string description = 2;
  float price = 3;
}

// Response after creating a product
message CreateProductResponse {
  Product product = 1;
}

// Service definition
service ProductService {
  rpc GetProduct (GetProductRequest) returns (Product);
  rpc CreateProduct (CreateProductRequest) returns (CreateProductResponse);
}

2. ProtobufからのGoコード生成

次に、protocコンパイラを使用して.protoファイルからGoコードを生成します。protocとGo gRPCプラグインをインストールする必要があります。

# protoc をインストール (まだインストールされていない場合)
# 公式ドキュメント: https://grpc.io/docs/protoc-installation/
# macOS の場合: brew install protobuf

# Go gRPC プラグインをインストール
go install google.golang.org/protobuf/cmd/protoc-gen-go@latest
go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@latest

次に、Goコードを生成します。

protoc --go_out=./pb --go_opt=paths=source_relative \
       --go-grpc_out=./pb --go-grpc_opt=paths=source_relative \
       product.proto

このコマンドは、pbディレクトリを生成し、product.pb.go（メッセージ定義）とproduct_grpc.pb.go（サービスインターフェースとスタブ）が含まれます。

3. gRPCサーバーの実装

次に、GoでProductServiceサーバーを実装しましょう。

// server/main.go
package main

import (
	"context"
	"fmt"
	"log"
	"net"
	"sync"

	"google.golang.org/grpc"
	"google.golang.org/grpc/codes"
	"google.golang.org/grpc/status"

	pb "your-module-path/pb" // あなたの実際のモジュールパスに置き換えてください
)

// server implements pb.ProductServiceServer
type server struct {
	pb.UnimplementedProductServiceServer // 将来互換性のために埋め込む必要があります
	products map[string]*pb.Product
	mu       sync.RWMutex
	nextID   int
}

func newServer() *server {
	return &server{
		products: make(map[string]*pb.Product),
		nextID:   1,
	}
}

func (s *server) GetProduct(ctx context.Context, req *pb.GetProductRequest) (*pb.Product, error) {
	s.mu.RLock()
	defer s.mu.RUnlock()

	product, ok := s.products[req.GetId()]
	if !ok {
		return nil, status.Errorf(codes.NotFound, "Product with ID %s not found", req.GetId())
	}
	log.Printf("Fetched product: %v", product)
	return product, nil
}

func (s *server) CreateProduct(ctx context.Context, req *pb.CreateProductRequest) (*pb.CreateProductResponse, error) {
	s.mu.Lock()
	defer s.mu.Unlock()

	productID := fmt.Sprintf("prod-%d", s.nextID)
	s.nextID++

	newProduct := &pb.Product{
		Id:          productID,
		Name:        req.GetName(),
		Description: req.GetDescription(),
		Price:       req.GetPrice(),
	}

	s.products[productID] = newProduct
	log.Printf("Created new product: %v", newProduct)
	return &pb.CreateProductResponse{Product: newProduct}, nil
}

func main() {
	lis, err := net.Listen("tcp", ":50051")
	if err != nil {
		log.Fatalf("failed to listen: %v", err)
	}

	ss := grpc.NewServer()
	pb.RegisterProductServiceServer(ss, newServer()) // 私たちのサービス実装を登録

	log.Printf("server listening at %v", lis.Addr())
	if err := ss.Serve(lis); err != nil {
		log.Fatalf("failed to serve: %v", err)
	}
}

4. gRPCクライアントの構築

次に、ProductServiceと対話するクライアントを作成しましょう。

// client/main.go
package main

import (
	"context"
	"log"
	"time"

	"google.golang.org/grpc"
	"google.golang.org/grpc/credentials/insecure"

	pb "your-module-path/pb" // あなたの実際のモジュールパスに置き換えてください
)

func main() {
	conn, err := grpc.Dial("localhost:50051", grpc.WithTransportCredentials(insecure.NewCredentials()))
	if err != nil {
		log.Fatalf("did not connect: %v", err)
	}
	defer conn.Close()
	c := pb.NewProductServiceClient(conn) // 新しいクライアントを作成

	ctx, cancel := context.WithTimeout(context.Background(), time.Second)
	defer cancel()

	// 製品を作成
	createRes, err := c.CreateProduct(ctx, &pb.CreateProductRequest{
		Name:        "Laptop Pro",
		Description: "High-performance laptop for professionals",
		Price:       1200.00,
	})
	if err != nil {
		log.Fatalf("could not create product: %v", err)
	}
	log.Printf("Created Product: %s", createRes.GetProduct().GetId())

	// 作成された製品を取得
	getProductRes, err := c.GetProduct(ctx, &pb.GetProductRequest{Id: createRes.GetProduct().GetId()})
	if err != nil {
		log.Fatalf("could not get product: %v", err)
	}
	log.Printf("Retrieved Product: %s - %s (%.2f)", getProductRes.GetId(), getProductRes.GetName(), getProductRes.GetPrice())

	// 存在しない製品を取得しようとする
	_, err = c.GetProduct(ctx, &pb.GetProductRequest{Id: "non-existent-id"})
	if err != nil {
		log.Printf("Error getting non-existent product (expected): %v", err)
	}
}

例の実行

  1. Goモジュールを初期化します。 
    go mod init your-module-path # 例: go mod init example.com/grpc-demo
go mod tidy
  2. protobufコードを生成します（上記参照）。
  3. サーバーを起動します。 
    go run server/main.go
  4. 別のターミナルでクライアントを実行します。 
    go run client/main.go

サーバーは製品の作成と取得のログを表示し、クライアントは成功した操作と存在しない製品に対する期待されるエラーをログに記録します。

アプリケーションシナリオ

gRPCは、さまざまなマイクロサービス通信パターンに特に適しています。

  • 内部マイクロサービス間通信: 同一組織内で開発された複数のサービスで構成されるシステムを構築する場合、gRPCは非常に効率的で厳密に型付けされた通信メカニズムを提供します。
  • ポリグロット環境: Protocol Buffersを通じて達成される言語に依存しない性質は、異なるプログラミング言語（例：Goバックエンド、Python機械学習サービス、Java決済サービス）で記述されたサービスにとって優れた選択肢となります。
  • リアルタイムおよび低遅延アプリケーション: HTTP/2の多重化とバイナリシリアライゼーションにより、gRPCは、IoTデバイス、ゲームバックエンド、または金融取引システムなどの高スループットと低遅延を必要とするシナリオで優れています。
  • ストリーミングデータ: gRPCは、サーバーサイド、クライアントサイド、双方向ストリーミングなど、さまざまなストリーミングタイプをネイティブにサポートしており、ライブアップデート、チャットアプリケーション、またはデータパイプラインなどのシナリオに最適です。
  • モバイルクライアント: 一般公開APIではHTTP/JSONほど一般的ではありませんが、gRPCはモバイルアプリとバックエンドサービス間の通信に使用でき、特にネットワーク帯域幅が懸念される場合にパフォーマンス上の利点を提供します。

結論

GoとgRPCは、高性能で堅牢かつスケーラブルなマイクロサービスを構築するための強力な組み合わせを形成します。効率的なデータシリアライゼーションのためのProtocol BuffersとトランスポートのためのHTTP/2を活用することで、gRPCは通信オーバーヘッドを大幅に削減し、厳密な型チェックとコード生成を通じて開発者の生産性を向上させます。gRPCを採用することで、より効率的なサービス間通信と、より回復力のあるマイクロサービスアーキテクチャを実現できます。開発者は、次のマイクロサービスプロジェクトでこのフレームワークを採用することで、大幅なパフォーマンス向上と合理化された開発体験を達成できます。

Share this article

HackerNews

More Posts from Leapcell

cover

TDDを活用した堅牢なGoアプリケーションの構築：`testing`と`testify`の利用

cover

Goにおける依存性注入のアプローチ - Wire、fx、および手動のベストプラクティス

Popular Posts