mercari microservices example

Mercari 마이크로서비스 예시

노트북에서 Go, gRPC, Kubernetes 및 Istio로 구성된 Mercari 같은 마이크로서비스를 살펴보겠습니다!

마이크로서비스

/services 디렉터리에서 각 마이크로서비스의 구현 및 gRPC API 정의를 찾을 수 있습니다.

게이트웨이

• 이는 Kubernetes 클러스터의 외부를 향하고 있으며 단순한 프록시 역할을 하는 유일한 마이크로서비스입니다.
• 이 마이크로서비스는 Authority 마이크로서비스에서 가져올 수 있는 공개 키로 액세스 토큰(JWT)을 확인하여 요청을 인증하는 역할을 합니다.
• 또한 이 마이크로서비스는 JSON 요청을 gRPC 프로토콜 버퍼로 트랜스코딩합니다.

권한

• 이 마이크로서비스는 고객 앱에 대한 액세스 토큰(JWT) 발급을 담당합니다.
• 또한 이 마이크로서비스는 공개 키를 gRPC 엔드포인트로 제공하여 다른 마이크로서비스가 액세스 토큰의 서명을 확인할 수 있도록 합니다.

목록

• 이 마이크로서비스는 API 호출자가 쉽게 사용할 수 있도록 고객 및 항목 마이크로서비스의 데이터를 집계하는 역할을 합니다.
• 이 마이크로서비스는 BFF(Backend For Frontend)처럼 작동합니다.

고객

• 이 마이크로서비스는 고객 정보를 데이터베이스에 저장하고 이를 API로 제공하는 역할을 담당합니다.

목

• 이 마이크로서비스는 아이템 정보를 데이터베이스에 저장하고 이를 API로 제공하는 역할을 담당합니다.

용법

전제 조건

• 가다
• 도커

Kubernetes 클러스터 실행

 make cluster

이 make 대상은 다음 작업을 수행합니다.

• 종류를 사용하여 노트북에서 Kubernetes 클러스터를 시작합니다.
• Kubernetes 클러스터에 Istio를 설치합니다.
• /services 디렉터리에 있는 모든 마이크로서비스의 Docker 이미지를 빌드합니다.
• 모든 마이크로서비스를 Kubernetes 클러스터에 배포합니다.

이 make 대상이 완료된 후 아래와 같이 kubectl 에 대한 작은 래퍼인 ./script/kubectl 을 사용하여 마이크로서비스 상태를 확인할 수 있습니다.

 ./script/kubectl get pods --all-namespaces | grep -E '^(gateway|authority|catalog|customer|item)' 

 authority   app-7b559dfd9f-dcr2v   2/2     Running     0   44s
authority   app-7b559dfd9f-z8c54   2/2     Running     0   44s
catalog     app-67cc897d9c-dhcv7   2/2     Running     0   36s
catalog     app-67cc897d9c-nfk7x   2/2     Running     0   36s
customer    app-565bfc5884-bgb8r   2/2     Running     0   28s
customer    app-565bfc5884-lt6q2   2/2     Running     0   28s
gateway     app-cc456cf4d-nsghg    2/2     Running     0   51s
gateway     app-cc456cf4d-wq47s    2/2     Running     0   51s
item        app-84db48bdf-h7q7b    2/2     Running     0   19s
item        app-84db48bdf-l5mnl    2/2     Running     0   19s

이제 Mercari-ish 서비스는 포트 30000 에서 수신 대기하고 있으며 아래와 같이 탐색할 수 있습니다!

API

가입

 curl -s -XPOST -d '{"name":"gopher"}' localhost:30000/auth/signup | jq . 

{
    "customer" : {
        "id" : " ec1fcc77-b565-4477-b609-62bf0c403903 " ,
        "name" : " gopher "
    }
}

로그인

 TOKEN=$(curl -s -XPOST -d '{"name":"gopher"}' localhost:30000/auth/signin | jq .access_token -r) 

항목 만들기

 curl -s -XPOST -d '{"title":"Keyboard","price":30000}' -H "authorization: bearer $TOKEN" localhost:30000/catalog/items | jq . 

{
    "item" : {
        "id" : " bda92da6-3270-4255-a756-dbe7d0aa333e " ,
        "customer_id" : " ec1fcc77-b565-4477-b609-62bf0c403903 " ,
        "title" : " Keyboard " ,
        "price" : " 30000 "
    }
}

목록 항목

 curl -s -XGET -H "authorization: bearer $TOKEN" localhost:30000/catalog/items | jq . 

{
    "items" : [
        {
            "id" : " 3c287306-6753-4ab6-acde-d17297e2939e " ,
            "title" : " Keyboard " ,
            "price" : " 30000 "
        },
        {
            "id" : " e0e58243-4138-48e5-8aba-448a8888e2ff " ,
            "title" : " Mobile Phone " ,
            "price" : " 10000 "
        },
        {
            "id" : " 0b185d96-d6fa-4eaf-97f6-3f6d2c1649b6 " ,
            "title" : " Laptop " ,
            "price" : " 20000 "
        }
    ]
}

항목 세부정보 가져오기

 curl -s -XGET -H "authorization: bearer $TOKEN" localhost:30000/catalog/items/e0e58243-4138-48e5-8aba-448a8888e2ff | jq . 

{
    "item" : {
        "id" : " e0e58243-4138-48e5-8aba-448a8888e2ff " ,
        "customer_id" : " 7c0cde05-4df0-47f4-94c4-978dd9f56e5c " ,
        "customer_name" : " goldie " ,
        "title" : " Mobile Phone " ,
        "price" : " 10000 "
    }
}

정리하다

 make clean