mercari microservices example

Beispiel für Mercari-Microservices

Lassen Sie uns die Mercari-ähnlichen Mikrodienste, bestehend aus Go, gRPC, Kubernetes und Istio, auf Ihrem Laptop erkunden!

Mikrodienste

Die Implementierung und die gRPC-API-Definitionen der einzelnen Mikrodienste finden Sie im Verzeichnis /services .

Tor

• Dies ist der einzige Mikrodienst, der der Außenseite des Kubernetes-Clusters zugewandt ist und lediglich als Proxy fungiert.
• Dieser Microservice ist für die Authentifizierung der Anfrage verantwortlich, indem er das Zugriffstoken (JWT) mit öffentlichen Schlüsseln überprüft, die vom Authority-Microservice abgerufen werden können.
• Dieser Microservice transkodiert auch die JSON-Anfragen in die gRPC-Protokollpuffer.

Behörde

• Dieser Microservice ist für die Ausstellung des Zugriffstokens (JWT) für die Kunden-App verantwortlich.
• Dieser Microservice stellt auch öffentliche Schlüssel als gRPC-Endpunkt bereit, damit andere Microservices die Signatur des Zugriffstokens überprüfen können.

Katalog

• Dieser Microservice ist dafür verantwortlich, Daten aus den Microservices „Kunde“ und „Artikel“ zu aggregieren, damit ein API-Aufrufer sie problemlos nutzen kann.
• Dieser Microservice verhält sich wie ein Backend For Frontend (BFF).

Kunde

• Dieser Microservice ist dafür verantwortlich, die Kundeninformationen in der Datenbank zu speichern und als APIs bereitzustellen.

Artikel

• Dieser Microservice ist dafür verantwortlich, die Artikelinformationen in der Datenbank zu speichern und als APIs bereitzustellen.

Verwendung

Voraussetzungen

• Gehen
• Docker

Lanuch der Kubernetes-Cluster

 make cluster

Dieses Make-Ziel erledigt folgende Aufgaben:

• Starten Sie den Kubernetes-Cluster auf Ihrem Laptop mit kind.
• Installieren Sie Istio im Kubernetes-Cluster.
• Erstellen Sie Docker-Images aller Microservices, die im Verzeichnis /services abgelegt sind.
• Stellen Sie alle Microservices im Kubernetes-Cluster bereit.

Nachdem dieses Make-Ziel abgeschlossen ist, können Sie den Status der Microservices mit ./script/kubectl überprüfen, einem winzigen Wrapper für kubectl wie folgt:

 ./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

Jetzt lauscht der Mercari-Dienst auf Port 30000 und Sie können ihn wie unten beschrieben erkunden!

API

Melden Sie sich an

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

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

anmelden

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

Erstellen Sie einen Artikel

 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 "
    }
}

Artikel auflisten

 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 "
        }
    ]
}

Holen Sie sich ein Artikeldetail

 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 "
    }
}

Aufräumen

 make clean