A dynamic router (API Gatway) for go-micro.

  • By Go Micro
  • Last update: Sep 1, 2022
  • Comments: 0

router

A dynamic router (API Gatway) for go-micro.

It looks for services that host "proto/routerclientpb/routerclientpb.RouterClientService" and ask's them for routes/endpoints, then it registers that endpoints via a proxy method within gin.

Caveats

  • gin doesn't allow to delete routes, so if you want to delete a route you have to restart go-micro/router.

Todo

  • Add (more) examples.
  • Add support for Streams / WebSockets.
  • Add support for debug.
  • Maybe add optional support for auth.

Examples

Have a look at internalService or the author's FOSS project microlobby.

Here some code from the microlobby project

import (
	"github.com/go-micro/router"
	"github.com/urfave/cli/v2"
	"go-micro.dev/v4"
	"wz2100.net/microlobby/shared/proto/authservicepb/v1"
)

func main() {
	service := micro.NewService()

	service.Init(
		micro.Action(func(c *cli.Context) error {
			s := service.Server()
			r := router.NewHandler(
				config.RouterURI,
				router.NewRoute(
					router.Method(router.MethodGet),
					router.Path("/"),
					router.Endpoint(authservicepb.AuthV1Service.UserList),
					router.Params("limit", "offset"),
				),
				router.NewRoute(
					router.Method(router.MethodPost),
					router.Path("/login"),
					router.Endpoint(authservicepb.AuthV1Service.Login),
				),
				router.NewRoute(
					router.Method(router.MethodPost),
					router.Path("/register"),
					router.Endpoint(authservicepb.AuthV1Service.Register),
				),
				router.NewRoute(
					router.Method(router.MethodPost),
					router.Path("/refresh"),
					router.Endpoint(authservicepb.AuthV1Service.Refresh),
				),
				router.NewRoute(
					router.Method(router.MethodDelete),
					router.Path("/:userId"),
					router.Endpoint(authservicepb.AuthV1Service.UserDelete),
					router.Params("userId"),
				),
				router.NewRoute(
					router.Method(router.MethodGet),
					router.Path("/:userId"),
					router.Endpoint(authservicepb.AuthV1Service.UserDetail),
					router.Params("userId"),
				),
				router.NewRoute(
					router.Method(router.MethodPut),
					router.Path("/:userId/roles"),
					router.Endpoint(authservicepb.AuthV1Service.UserUpdateRoles),
					router.Params("userId"),
				),
			)
			r.RegisterWithServer(s)
		}
	)
}

Build podman/docker image

Prerequesits

Build

task

Remove everything except the resulting podman images created by task

task rm

Authors

License

Its dual licensed:

  • Apache-2.0
  • GPL-2.0-or-later

Download

router.zip

Popular Tag

Related