Go kit 프레임워크

Go Kit은 Go 언어로 작성된 마이크로서비스 아키텍처를 구축하기 위한 라이브러리와 프레임워크입니다. Go Kit은 서비스 간의 통신, 로깅, 인스트루멘테이션, 트레이싱 등과 같은 마이크로서비스 개발의 일반적인 문제를 해결하는 데 중점을 둡니다.

Go Kit의 주요 특징

1. 서비스 지향 아키텍처 지원: Go Kit은 서비스 지향 아키텍처(SOA)를 지원하며, 각 서비스가 독립적으로 배포 및 운영될 수 있도록 설계되었습니다.
2. 모듈성: Go Kit은 모듈형으로 구성되어 있어 필요한 기능만 선택적으로 사용할 수 있습니다.
3. 표준화된 인터페이스: Go Kit은 서비스 인터페이스를 표준화하여 서비스 간의 일관성을 유지합니다.
4. 트랜스포트 계층: HTTP, gRPC, Thrift 등 다양한 트랜스포트 프로토콜을 지원합니다.
5. 미들웨어 지원: 로깅, 인스트루멘테이션, 트레이싱 등의 기능을 미들웨어로 쉽게 추가할 수 있습니다.
6. 테스트 용이성: 테스트 가능성을 염두에 두고 설계되어, 서비스의 각 부분을 독립적으로 테스트할 수 있습니다.

Go Kit의 주요 구성 요소

1. Service: 서비스는 비즈니스 로직을 포함하는 가장 중요한 구성 요소입니다. Go Kit은 서비스 인터페이스와 구현을 정의하여 서비스 로직을 캡슐화합니다.
2. Endpoint: 엔드포인트는 서비스 메서드를 네트워크 호출로 변환하는 함수입니다. 엔드포인트는 미들웨어를 통해 확장될 수 있습니다.
3. Transport: 트랜스포트는 네트워크를 통해 데이터를 주고받는 계층입니다. Go Kit은 HTTP, gRPC, Thrift 등을 지원합니다.
4. Middleware: 미들웨어는 엔드포인트와 트랜스포트의 기능을 확장하기 위한 방법입니다. 로깅, 인증, 인스트루멘테이션 등의 기능을 추가할 수 있습니다.

Go Kit 예제

간단한 서비스 예제를 통해 Go Kit의 사용 방법을 알아보겠습니다.

서비스 인터페이스 정의

먼저 서비스 인터페이스를 정의합니다.

package main

import (
    "context"
    "errors"
    "fmt"
    "net/http"

    "github.com/go-kit/kit/endpoint"
    httptransport "github.com/go-kit/kit/transport/http"
)

// StringService는 문자열 관련 연산을 정의하는 인터페이스입니다.
type StringService interface {
    Uppercase(context.Context, string) (string, error)
    Count(context.Context, string) int
}

// stringService는 StringService 인터페이스를 구현하는 구조체입니다.
type stringService struct{}

func (stringService) Uppercase(_ context.Context, s string) (string, error) {
    if s == "" {
        return "", errors.New("empty string")
    }
    return strings.ToUpper(s), nil
}

func (stringService) Count(_ context.Context, s string) int {
    return len(s)
}

엔드포인트 정의

서비스 메서드를 엔드포인트로 변환합니다.

func makeUppercaseEndpoint(svc StringService) endpoint.Endpoint {
    return func(ctx context.Context, request interface{}) (interface{}, error) {
        req := request.(uppercaseRequest)
        v, err := svc.Uppercase(ctx, req.S)
        if err != nil {
            return uppercaseResponse{v, err.Error()}, nil
        }
        return uppercaseResponse{v, ""}, nil
    }
}

type uppercaseRequest struct {
    S string `json:"s"`
}

type uppercaseResponse struct {
    V   string `json:"v"`
    Err string `json:"err,omitempty"`
}

트랜스포트 정의

HTTP 트랜스포트를 정의합니다.

func main() {
    svc := stringService{}

    uppercaseHandler := httptransport.NewServer(
        makeUppercaseEndpoint(svc),
        decodeUppercaseRequest,
        encodeResponse,
    )

    http.Handle("/uppercase", uppercaseHandler)
    fmt.Println("Listening on port 8080...")
    log.Fatal(http.ListenAndServe(":8080", nil))
}

func decodeUppercaseRequest(_ context.Context, r *http.Request) (interface{}, error) {
    var request uppercaseRequest
    if err := json.NewDecoder(r.Body).Decode(&request); err != nil {
        return nil, err
    }
    return request, nil
}

func encodeResponse(_ context.Context, w http.ResponseWriter, response interface{}) error {
    return json.NewEncoder(w).Encode(response)
}

위 예제는 간단한 문자열 변환 서비스입니다. 클라이언트가 /uppercase 엔드포인트에 요청을 보내면, 서버는 문자열을 대문자로 변환한 결과를 반환합니다.

요약

• Go Kit은 Go 언어로 마이크로서비스를 쉽게 구축할 수 있게 해주는 라이브러리와 프레임워크입니다.
• 모듈성, 표준화된 인터페이스, 다양한 트랜스포트 계층, 미들웨어 지원 등의 특징을 갖추고 있습니다.
• Service, Endpoint, Transport, Middleware는 Go Kit의 주요 구성 요소입니다.
• 예제를 통해 간단한 문자열 변환 서비스를 구현하고, 이를 통해 Go Kit의 사용법을 배울 수 있습니다.

Go Kit을 사용하면 복잡한 마이크로서비스 아키텍처를 더 쉽게 관리하고 개발할 수 있습니다. 이를 통해 확장 가능하고 유지 보수하기 쉬운 애플리케이션을 구축할 수 있습니다.

 

출처 : chatGPT