{"id":21699608,"url":"https://github.com/cage1016/gokitconsul","last_synced_at":"2025-04-12T13:13:28.307Z","repository":{"id":57512531,"uuid":"192446768","full_name":"cage1016/gokitconsul","owner":"cage1016","description":"go kit microservice demo with consul \u0026 zipkin","archived":false,"fork":false,"pushed_at":"2019-08-21T08:14:23.000Z","size":4647,"stargazers_count":4,"open_issues_count":1,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-12T13:13:24.541Z","etag":null,"topics":["consul","docker","docker-compose","go-kit","microservice","zipkin"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cage1016.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-06-18T01:58:02.000Z","updated_at":"2022-01-14T04:10:34.000Z","dependencies_parsed_at":"2022-09-26T17:50:17.094Z","dependency_job_id":null,"html_url":"https://github.com/cage1016/gokitconsul","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cage1016%2Fgokitconsul","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cage1016%2Fgokitconsul/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cage1016%2Fgokitconsul/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cage1016%2Fgokitconsul/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cage1016","download_url":"https://codeload.github.com/cage1016/gokitconsul/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248571863,"owners_count":21126522,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["consul","docker","docker-compose","go-kit","microservice","zipkin"],"created_at":"2024-11-25T20:10:32.527Z","updated_at":"2025-04-12T13:13:28.289Z","avatar_url":"https://github.com/cage1016.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003eWelcome to gokitconsul 👋\u003c/h1\u003e\n\u003cp\u003e\n  \u003ca href=\"https://github.com/cage1016/gokitconsul/blob/master/LICENSE\"\u003e\n    \u003cimg alt=\"License: MIT\" src=\"https://img.shields.io/badge/License-MIT-yellow.svg\" target=\"_blank\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://twitter.com/CageChung\"\u003e\n    \u003cimg alt=\"Twitter: CageChung\" src=\"https://img.shields.io/twitter/follow/CageChung.svg?style=social\" target=\"_blank\" /\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\u003e go kit microservice demo with consul \u0026 zipkin\n\n## Dependency\n\n- consul as discover service\n- prometheus monitor service\n- grafana analytics service\n- zipkin as trace service\n- fluentd\n- kibana\n- elasticsearch\n- gateway\n    - http → grpc (8000)\n    - grpc proxy (8001)\n\n## Services\n\n- pkg/addsvc\n- pkg/foosvc\n\n## Install\n\n```sh\n# build docker image form bindary\nmake dockers_dev\n\n# clear build (options)\nmake dockers\n```\n\n## Usage\n\n```sh\n# start full feature\n$ make u\ndocker-compose -f deployments/docker/docker-compose.yaml up -d\nCreating network \"net\" with driver \"bridge\"\nRecreating gokitconsul-elasticsearch ... done\nCreating gokitconsul-fluentd         ... done\nRecreating gokitconsul-grafana       ... done\nRecreating gokitconsul-consul        ... done\nRecreating gokitconsul-prometheus    ... done\nRecreating gokitconsul-zipkin        ... done\nCreating gokitconsul-kibana          ... done\nCreating gokitconsul-addsvc          ... done\nCreating gokitconsul-gateway         ... done\nCreating gokitconsul-foosvc          ... done\n\nor\n\n# run without elasticsearch/fluentd/grafana/kibana/prometheus\n$ docker-compose -f deployments/docker/docker-compose-dev.yaml up -d\n\n\n$ docker ps\nCONTAINER ID        IMAGE                                 COMMAND                  CREATED             STATUS              PORTS                                                                                                            NAMES\n7da33c5f4ae8        cage1016/gokitconsul-gateway:latest   \"/exe\"                   4 seconds ago       Up 3 seconds        0.0.0.0:8000-8001-\u003e8000-8001/tcp                                                                                 gokitconsul-gateway\nc5521d8d8879        cage1016/gokitconsul-foosvc:latest    \"/exe\"                   4 seconds ago       Up 3 seconds                                                                                                                         gokitconsul-foosvc\n3804cea4fa33        cage1016/gokitconsul-addsvc:latest    \"/exe\"                   6 seconds ago       Up 4 seconds                                                                                                                         gokitconsul-addsvc\n0225bdb521a2        grafana/grafana                       \"/run.sh\"                8 seconds ago       Up 6 seconds        0.0.0.0:3000-\u003e3000/tcp                                                                                           gokitconsul-grafana\n17d3253f5e98        openzipkin/zipkin                     \"/busybox/sh run.sh\"     8 seconds ago       Up 7 seconds        9410/tcp, 0.0.0.0:9411-\u003e9411/tcp                                                                                 gokitconsul-zipkin\nf157f98e2651        prom/prometheus                       \"/bin/prometheus --c…\"   8 seconds ago       Up 6 seconds        0.0.0.0:9090-\u003e9090/tcp                                                                                           gokitconsul-prometheus\n240b055c29bb        consul:1.5.1                          \"docker-entrypoint.s…\"   8 seconds ago       Up 6 seconds        0.0.0.0:8400-\u003e8400/tcp, 8301-8302/udp, 0.0.0.0:8500-\u003e8500/tcp, 8300-8302/tcp, 8600/udp, 0.0.0.0:8600-\u003e8600/tcp   gokitconsul-consul\n013a30314238        kibana:6.6.1                          \"/usr/local/bin/kiba…\"   8 seconds ago       Up 7 seconds        0.0.0.0:5601-\u003e5601/tcp                                                                                           gokitconsul-kibana\nd67f9970fef9        docker_fluentd                        \"tini -- /bin/entryp…\"   9 seconds ago       Up 8 seconds        5140/tcp, 0.0.0.0:24224-\u003e24224/tcp, 0.0.0.0:24224-\u003e24224/udp                                                     gokitconsul-fluentd\n9590182d4175        elasticsearch:6.6.1                   \"/usr/local/bin/dock…\"   10 seconds ago      Up 9 seconds        0.0.0.0:9200-\u003e9200/tcp, 9300/tcp                                                                                 gokitconsul-elasticsearch\n```\n\n## Test\n\n```sh\n# sum\n$ curl -X \"POST\" \"https://localhost:8000/addsvc/sum\" -H 'Content-Type: application/json; charset=utf-8' -d $'{ \"a\": 133, \"b\": 10333}'\n{\"rs\":10466,\"err\":null}\n\n# concat\n$ curl -X \"POST\" \"https://localhost:8000/addsvc/concat\" -H 'Content-Type: application/json; charset=utf-8' -d $'{ \"a\": \"133\", \"b\": \"10333\"}'\n{\"rs\":\"13310333\",\"err\":null}\n\n# foo\n$ curl -X \"POST\" \"https://localhost:8000/foosvc/foo\" -H 'Content-Type: application/json; charset=utf-8' -d $'{ \"s\": \"😆\"}'\n{\"res\":\"foo 😆\",\"err\":null}\n\n$ curl -X \"POST\" \"https://localhost:8000/foosvc/foo\" -H 'Content-Type: application/json; charset=utf-8' -d $'{ \"s\": \"hello gokit 😆\"}'\n{\"error\":\"result exceeds maximum size\"}\n\n# addcli through grpc proxy\n$ go run cmd/addcli/main.go -grpc-addr localhost:8001 -method sum 1 22\n1 + 22 = 23\n\n$ go run cmd/addcli/main.go -grpc-addr localhost:8001 -method concat 1 22\n\"1\" + \"22\" = \"122\"\n\n# foocli throuth grpc proxy\n$ go run cmd/foocli/main.go -grpc-addr localhost:8001 world\nFoo world = foo world\n```\n\n## Consul \u0026 zipkin\n\n_consult_\nvisit http://localhost:8500\n![Consul](./screenshots/consul.jpg)\n\n_zipkin_\nvisit http://localhost:9411\n![zipkin success](./screenshots/zipkin.jpg)\n\n![zipkin bad request](./screenshots/zipkin2.jpg)\n\n_prometheus_\nvisit http://localhost:9000\n![](./screenshots/prometheus.jpg)\n\n_grafana_\nvisit http://localhost:3000 (admin/password)\n![](./screenshots/grafana.jpg)\n\n_kibana_\nvisit http://localhost:5601\n![](./screenshots/kibana.jpg)\n\n## Stop\n\n```sh\n# docker-compose down\n$ make d\n```\n\n## Author\n\n👤 **KAI-CHU CHUNG**\n\n* Twitter: [@CageChung](https://twitter.com/CageChung)\n* Github: [@cage1016](https://github.com/cage1016)\n\n## 🤝 Contributing\n\nContributions, issues and feature requests are welcome!\u003cbr /\u003eFeel free to check [issues page](https://github.com/cage1016/gokitconsul/issues).\n\n## Show your support\n\nGive a ⭐️ if this project helped you!\n\n## 📝 License\n\nCopyright © 2019 [KAI-CHU CHUNG](https://github.com/cage1016).\u003cbr /\u003e\nThis project is [MIT](https://github.com/cage1016/gokitconsul/blob/master/LICENSE) licensed.\n\n***\n_This README was generated with ❤️ by [readme-md-generator](https://github.com/kefranabg/readme-md-generator)_","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcage1016%2Fgokitconsul","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcage1016%2Fgokitconsul","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcage1016%2Fgokitconsul/lists"}