internal/website/docs/quickstart.md
Get up and running with go-micro in under 5 minutes.
go install go-micro.dev/v5/cmd/[email protected]
Note: Use a specific version instead of
@latestto avoid module path conflicts. See releases for the latest version.
# Create a new service
micro new helloworld
cd helloworld
# Review the generated code
ls -la
# Run locally with hot reload
micro run
# Test it
curl -X POST http://localhost:8080/api/helloworld/Helloworld.Call \
-H "Content-Type: application/json" \
-d '{"name": "World"}'
package main
import "go-micro.dev/v5"
type Greeter struct{}
func (g *Greeter) Hello(ctx context.Context, req *Request, rsp *Response) error {
rsp.Message = "Hello " + req.Name
return nil
}
func main() {
service := micro.New("greeter")
service.Handle(new(Greeter))
service.Run()
}
import "go-micro.dev/v5"
func main() {
service := micro.New("subscriber")
// Subscribe to events
micro.RegisterSubscriber("user.created", service.Server(),
func(ctx context.Context, event *UserCreatedEvent) error {
log.Infof("User created: %s", event.Email)
return nil
},
)
service.Run()
}
publisher := micro.NewEvent("user.created", client)
publisher.Publish(ctx, &UserCreatedEvent{
Email: "[email protected]",
})