{"id":23256801,"url":"https://github.com/dmdv/micro-server","last_synced_at":"2025-04-06T04:25:28.113Z","repository":{"id":141044358,"uuid":"431840831","full_name":"Dmdv/micro-server","owner":"Dmdv","description":null,"archived":false,"fork":false,"pushed_at":"2022-01-06T09:36:36.000Z","size":60,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-02-12T10:28:21.780Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Dmdv.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-11-25T12:40:25.000Z","updated_at":"2022-01-06T09:36:39.000Z","dependencies_parsed_at":"2024-06-20T03:19:54.341Z","dependency_job_id":null,"html_url":"https://github.com/Dmdv/micro-server","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dmdv%2Fmicro-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dmdv%2Fmicro-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dmdv%2Fmicro-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dmdv%2Fmicro-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Dmdv","download_url":"https://codeload.github.com/Dmdv/micro-server/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247432451,"owners_count":20938159,"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":[],"created_at":"2024-12-19T12:19:39.874Z","updated_at":"2025-04-06T04:25:27.969Z","avatar_url":"https://github.com/Dmdv.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# GO-MICRO: Missing documentation\n\n##### Prerequisites\n```shell\nmake prerequisites\n```\n- Install helm\n- Install minikube\n- Install skaffold (`https://skaffold.dev/docs/quickstart`)\n- Install micro\n\n# Micro installation\n```shell\ngo install go-micro.dev/v4/cmd/micro@a40f6e8fae19018ead6778a2887c0daf970a9882\n```\n\n## How to build\n\n```shell\nmake proto update tidy\n```\n\n## How to run\n\n```shell\nmicro run\n```\n\nor if you want to use config map\n\n```shell\nskaffold dev\n```\n\nor if you want to deploy to a local minikube cluster (depending on the current context)\n\n```shell\nskaffold run\n```\n\n## Known issues\n\nIf you run with `micro run` then the service name will be default: `go.micro.client`\nTo assign the service name, use `micro.Name` option\n\nAny explicit server declarations must go before any other options\n\n```go\n\t// Create service\n\tsrv := micro.NewService(\n\t\tmicro.Client(grpc.NewClient()), // must come before any other options\n\t\tmicro.Name(service),\n\t\tmicro.Version(version))\n\tsrv.Init()\n```\n\nIf you define transport as grpc in ENV then we have the issue when service name is not set\nIn that case you'll have to declare grpc transport explicitly\n\n```yaml\n---\n\napiVersion: v1\nkind: ConfigMap\nmetadata:\n  name: micro-server-env\ndata:\n  MICRO_REGISTRY: kubernetes\n  MICRO_SERVER: grpc\n\n```\n\nSetting `MICRO_SERVER_NAME` explicitly in config map solves this issue\n\n## The list of known ENV variable:\n\nMICRO_CLIENT - Client for go-micro  \nMICRO_CLIENT_REQUEST_TIMEOUT - Sets the client request timeout. e.g 500ms, 5s, 1m. Default: 5s  \nMICRO_CLIENT_RETRIES - Sets the client retries. Default: 1  \nMICRO_CLIENT_POOL_SIZE - Sets the client connection pool size. Default: 1  \nMICRO_CLIENT_POOL_TTL - Sets the client connection pool ttl. e.g 500ms, 5s, 1m. Default: 1m  \nMICRO_REGISTER_TTL - Register TTL in seconds  \nMICRO_REGISTER_INTERVAL - Register interval in seconds  \nMICRO_SERVER - Server for go-micro; rpc  \nMICRO_SERVER_NAME - Name of the server. go.micro.srv.example  \nMICRO_SERVER_VERSION - Version of the server. 1.1.0  \nMICRO_SERVER_ID - Id of the server. Auto-generated if not specified  \nMICRO_SERVER_ADDRESS - Bind address for the server. 127.0.0.1:8080  \nMICRO_SERVER_ADVERTISE - Used instead of the server_address when registering with discovery. 127.0.0.1:8080  \nMICRO_SERVER_METADATA - A list of key-value pairs defining metadata. version=1.0.0  \nMICRO_BROKER - Broker for pub/sub. http, nats, rabbitmq  \nMICRO_BROKER_ADDRESS - Comma-separated list of broker addresses  \nMICRO_DEBUG_PROFILE - Debug profiler for cpu and memory stats  \nMICRO_REGISTRY - Registry for discovery. etcd, mdns  \nMICRO_REGISTRY_ADDRESS - Comma-separated list of registry addresses  \nMICRO_RUNTIME - Runtime for building and running services e.g local, kubernetes  \nMICRO_RUNTIME_SOURCE - Runtime source for building and running services e.g github.com/micro/service  \nMICRO_SELECTOR - Selector used to pick nodes for querying  \nMICRO_STORE - Store used for key-value storage  \nMICRO_STORE_ADDRESS - Comma-separated list of store addresses  \nMICRO_STORE_DATABASE - Database option for the underlying store  \nMICRO_STORE_TABLE - Table option for the underlying store  \nMICRO_TRANSPORT - Transport mechanism used; http  \nMICRO_TRANSPORT_ADDRESS - Comma-separated list of transport addresses  \nMICRO_TRACER - \"Tracer for distributed tracing, e.g. memory, jaeger  \nMICRO_TRACER_ADDRESS - Comma-separated list of tracer addresses  \nMICRO_AUTH - Auth for role based access control, e.g. service  \nMICRO_AUTH_ID - Account ID used for client authentication  \nMICRO_AUTH_SECRET - Account secret used for client authentication  \nMICRO_AUTH_NAMESPACE - Namespace for the services auth account, go.micro  \nMICRO_AUTH_PUBLIC_KEY - Public key for JWT auth (base64 encoded PEM)  \nMICRO_AUTH_PRIVATE_KEY - Private key for JWT auth (base64 encoded PEM)  \nMICRO_CONFIG - The source of the config to be used to get configuration  \n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdmdv%2Fmicro-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdmdv%2Fmicro-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdmdv%2Fmicro-server/lists"}