micro--go-micro
76bfeae456
* docs: update all four documentation guides and mark Q2 complete - ai-native-services: add WithMCP one-liner, standalone gateway, WebSocket client example, and OpenTelemetry observability section - mcp-security: add OTel distributed tracing, WebSocket authentication (connection-level and per-message), DeniedReason audit field - tool-descriptions: add manual overrides with WithEndpointDocs and export formats section - agent-patterns: add LangChain/LlamaIndex SDK pattern and standalone gateway production pattern with Docker example - Update roadmap: mark Q2 documentation as complete, Q2 at 100% - Update status: reflect all recent completions, shift priorities https://claude.ai/code/session_01GkduEhcrqcG45rdfYh8dAc * feat: add agent demo example and blog post Add examples/agent-demo with a multi-service project management app (projects, tasks, team) that demonstrates AI agents interacting with Go Micro services through MCP. Includes seed data and example prompts. Add blog post 4 "Agents Meet Microservices: A Hands-On Demo" walking through the example code and showing cross-service agent workflows. https://claude.ai/code/session_01GkduEhcrqcG45rdfYh8dAc * feat: enable multiple services in a single binary Remove global state mutations from service and cmd option functions so that configuring one service no longer overwrites another's settings. Key changes: - service/options.go: remove all DefaultXxx global writes from option functions; newOptions() now creates fresh Server, Client, Store, and Cache per service while sharing Registry, Broker, and Transport - cmd/cmd.go: newCmd() uses local copies instead of pointers to package globals; Before() no longer mutates DefaultXxx vars - cmd/options.go: remove global mutations from all option functions - service/service.go: export ServiceImpl type for cross-package use - service/group.go: new Group type for multi-service lifecycle - micro.go: add Start/Stop to Service interface, expose Group and NewGroup convenience function - examples/multi-service: working example with two services https://claude.ai/code/session_01GkduEhcrqcG45rdfYh8dAc * docs: highlight multi-service binary support Add multi-service section to README with code example, update features list, add to examples index, and note in status summary. https://claude.ai/code/session_01GkduEhcrqcG45rdfYh8dAc * feat: unify service API and clean up developer experience - Unified service creation: micro.New("name", opts...) as canonical API - Clean handler registration: service.Handle(handler, opts...) accepts server.HandlerOption args directly, no need to reach through Server() - Unexported serviceImpl: users interact through Service interface only - Service groups use Service interface (not concrete type) - Fixed Stop() to properly propagate BeforeStop/AfterStop errors - Fixed store init: error-level log instead of fatal on init failure - Updated all examples to use consistent patterns - Updated README, getting-started, MCP docs, and guides - Added blog post about the DX cleanup https://claude.ai/code/session_01GkduEhcrqcG45rdfYh8dAc * fix: add blog post 5 to blog index Blog post 5 (Developer Experience Cleanup) existed as a file but was missing from the blog index page. https://claude.ai/code/session_01GkduEhcrqcG45rdfYh8dAc * feat: make micro new generate MCP-enabled services by default - main.go template includes mcp.WithMCP(":3001") by default - Handler template has agent-friendly doc comments with @example tags - Proto template has descriptive field comments - README includes MCP usage, Claude Code config, and tool description tips - Makefile adds mcp-tools, mcp-test, mcp-serve targets - go.mod updated to Go 1.22 - Added --no-mcp flag to opt out of MCP integration - Post-create output shows MCP endpoint URLs https://claude.ai/code/session_01GkduEhcrqcG45rdfYh8dAc * docs: add MCP migration guide and troubleshooting guide - Migration guide: 3 approaches to add MCP to existing services (WithMCP one-liner, standalone gateway, CLI) - Troubleshooting guide: common issues with agents, WebSocket, Claude Code, auth, rate limiting, and performance https://claude.ai/code/session_01GkduEhcrqcG45rdfYh8dAc * refactor: rename model/ package to ai/ for AI model providers The model/ package name conflicted with the conventional use of "model" for data models. Renamed to ai/ which better describes the package's purpose (AI provider abstraction for Anthropic, OpenAI, etc.) and frees up model/ for future data model layer use. - Rename model/ → ai/ with package name change - Update all Go imports from go-micro.dev/v5/model to go-micro.dev/v5/ai - Update cmd/micro/server/server.go references (model.X → ai.X) - Update all documentation and roadmap references - All tests pass, CLI builds successfully https://claude.ai/code/session_01GkduEhcrqcG45rdfYh8dAc * feat: add model package for typed data access with CRUD and queries New model/ package provides a typed data model layer using Go generics. Supports structured CRUD operations, WHERE filters, ordering, pagination, and automatic schema creation from struct tags. Three backends: - memory: in-memory for development and testing - sqlite: embedded SQL for dev and single-node production - postgres: full PostgreSQL for production deployments Key features: - Generic Model[T] with Create/Read/Update/Delete/List/Count - Query builder: Where(), WhereOp(), OrderAsc/Desc(), Limit(), Offset() - Struct tags: model:"key" for primary key, model:"index" for indexes - Auto table creation from struct schema - 19 tests passing across memory and sqlite backends https://claude.ai/code/session_01GkduEhcrqcG45rdfYh8dAc * feat: add model code generation to protoc-gen-micro Extend the micro plugin to generate model structs from proto messages annotated with // @model. Generated alongside client/server code in the same .pb.micro.go file. For a proto message like: // @model message User { string id = 1; string name = 2; } Generates: - UserModel struct with model:"key" and json tags - NewUserModel(db) factory returning *model.Model[UserModel] - UserModelFromProto(*User) *UserModel converter - (*UserModel).ToProto() *User converter Supports @model(table=custom_table, key=custom_field) options. Adds GetComments() to generator for plugin comment inspection. https://claude.ai/code/session_01GkduEhcrqcG45rdfYh8dAc * feat: add Model() to Service interface for Client/Server/Model trifecta Every service now exposes Client(), Server(), and Model() — call services, handle requests, and save/query data from the same interface. Includes README docs, blog post, and a full model guide on the docs site. https://claude.ai/code/session_01GkduEhcrqcG45rdfYh8dAc --------- Co-authored-by: Claude <noreply@anthropic.com>
216 行
4.3 KiB
Go
216 行
4.3 KiB
Go
package service
|
|
|
|
import (
|
|
"os"
|
|
"os/signal"
|
|
rtime "runtime"
|
|
"sync"
|
|
|
|
"go-micro.dev/v5/client"
|
|
"go-micro.dev/v5/cmd"
|
|
log "go-micro.dev/v5/logger"
|
|
"go-micro.dev/v5/model"
|
|
"go-micro.dev/v5/server"
|
|
"go-micro.dev/v5/store"
|
|
signalutil "go-micro.dev/v5/util/signal"
|
|
)
|
|
|
|
// Service is the interface for a go-micro service.
|
|
type Service interface {
|
|
// Name returns the service name.
|
|
Name() string
|
|
// Init initializes options. Parses command line flags on first call.
|
|
Init(...Option)
|
|
// Options returns the current options.
|
|
Options() Options
|
|
// Handle registers a handler with optional server.HandlerOption args.
|
|
Handle(v interface{}, opts ...server.HandlerOption) error
|
|
// Client returns the RPC client.
|
|
Client() client.Client
|
|
// Server returns the RPC server.
|
|
Server() server.Server
|
|
// Model returns the data model database.
|
|
Model() model.Database
|
|
// Start the service (non-blocking).
|
|
Start() error
|
|
// Stop the service.
|
|
Stop() error
|
|
// Run starts the service, blocks on signal/context, then stops.
|
|
Run() error
|
|
// String returns the implementation name.
|
|
String() string
|
|
}
|
|
|
|
type serviceImpl struct {
|
|
opts Options
|
|
|
|
once sync.Once
|
|
}
|
|
|
|
// New creates a new service with the given options.
|
|
func New(opts ...Option) Service {
|
|
return &serviceImpl{
|
|
opts: newOptions(opts...),
|
|
}
|
|
}
|
|
|
|
func (s *serviceImpl) Name() string {
|
|
return s.opts.Server.Options().Name
|
|
}
|
|
|
|
// Init initializes options. Additionally it calls cmd.Init
|
|
// which parses command line flags. cmd.Init is only called
|
|
// on first Init.
|
|
func (s *serviceImpl) Init(opts ...Option) {
|
|
// process options
|
|
for _, o := range opts {
|
|
o(&s.opts)
|
|
}
|
|
|
|
s.once.Do(func() {
|
|
// set cmd name
|
|
if len(s.opts.Cmd.App().Name) == 0 {
|
|
s.opts.Cmd.App().Name = s.Server().Options().Name
|
|
}
|
|
|
|
// Initialize the command flags, overriding new service
|
|
if err := s.opts.Cmd.Init(
|
|
cmd.Auth(&s.opts.Auth),
|
|
cmd.Broker(&s.opts.Broker),
|
|
cmd.Registry(&s.opts.Registry),
|
|
cmd.Transport(&s.opts.Transport),
|
|
cmd.Client(&s.opts.Client),
|
|
cmd.Config(&s.opts.Config),
|
|
cmd.Server(&s.opts.Server),
|
|
cmd.Store(&s.opts.Store),
|
|
cmd.Profile(&s.opts.Profile),
|
|
); err != nil {
|
|
s.opts.Logger.Log(log.FatalLevel, err)
|
|
}
|
|
|
|
// Initialize the store with the service name as table
|
|
name := s.opts.Cmd.App().Name
|
|
if err := s.opts.Store.Init(store.Table(name)); err != nil {
|
|
s.opts.Logger.Logf(log.ErrorLevel, "error initializing store: %v", err)
|
|
}
|
|
})
|
|
}
|
|
|
|
func (s *serviceImpl) Options() Options {
|
|
return s.opts
|
|
}
|
|
|
|
func (s *serviceImpl) Client() client.Client {
|
|
return s.opts.Client
|
|
}
|
|
|
|
func (s *serviceImpl) Server() server.Server {
|
|
return s.opts.Server
|
|
}
|
|
|
|
func (s *serviceImpl) Model() model.Database {
|
|
return s.opts.Model
|
|
}
|
|
|
|
|
|
func (s *serviceImpl) String() string {
|
|
return "micro"
|
|
}
|
|
|
|
func (s *serviceImpl) Start() error {
|
|
for _, fn := range s.opts.BeforeStart {
|
|
if err := fn(); err != nil {
|
|
return err
|
|
}
|
|
}
|
|
|
|
if err := s.opts.Server.Start(); err != nil {
|
|
return err
|
|
}
|
|
|
|
for _, fn := range s.opts.AfterStart {
|
|
if err := fn(); err != nil {
|
|
return err
|
|
}
|
|
}
|
|
|
|
return nil
|
|
}
|
|
|
|
func (s *serviceImpl) Stop() error {
|
|
var gerr error
|
|
|
|
for _, fn := range s.opts.BeforeStop {
|
|
if err := fn(); err != nil {
|
|
gerr = err
|
|
}
|
|
}
|
|
|
|
if err := s.opts.Server.Stop(); err != nil {
|
|
return err
|
|
}
|
|
|
|
for _, fn := range s.opts.AfterStop {
|
|
if err := fn(); err != nil {
|
|
gerr = err
|
|
}
|
|
}
|
|
|
|
return gerr
|
|
}
|
|
|
|
func (s *serviceImpl) Handle(v interface{}, opts ...server.HandlerOption) error {
|
|
return s.opts.Server.Handle(
|
|
s.opts.Server.NewHandler(v, opts...),
|
|
)
|
|
}
|
|
|
|
func (s *serviceImpl) Run() (err error) {
|
|
logger := s.opts.Logger
|
|
|
|
// exit when help flag is provided
|
|
for _, v := range os.Args[1:] {
|
|
if v == "-h" || v == "--help" {
|
|
os.Exit(0)
|
|
}
|
|
}
|
|
|
|
// start the profiler
|
|
if s.opts.Profile != nil {
|
|
// to view mutex contention
|
|
rtime.SetMutexProfileFraction(5)
|
|
// to view blocking profile
|
|
rtime.SetBlockProfileRate(1)
|
|
|
|
if err = s.opts.Profile.Start(); err != nil {
|
|
return err
|
|
}
|
|
|
|
defer func() {
|
|
if nerr := s.opts.Profile.Stop(); nerr != nil {
|
|
logger.Log(log.ErrorLevel, nerr)
|
|
}
|
|
}()
|
|
}
|
|
|
|
logger.Logf(log.InfoLevel, "Starting [service] %s", s.Name())
|
|
|
|
if err = s.Start(); err != nil {
|
|
return err
|
|
}
|
|
|
|
ch := make(chan os.Signal, 1)
|
|
if s.opts.Signal {
|
|
signal.Notify(ch, signalutil.Shutdown()...)
|
|
}
|
|
|
|
select {
|
|
// wait on kill signal
|
|
case <-ch:
|
|
// wait on context cancel
|
|
case <-s.opts.Context.Done():
|
|
}
|
|
|
|
return s.Stop()
|
|
}
|