corebundlestarter

Overview ¶

Package main is the entry point for the corebundlestarter example.

This example demonstrates how an external "independent repository" can assemble the three GoCell platform cells (accesscore, auditcore, configcore) using the public runtime/composition API and cellmodules/<cell>.Module() constructors — with zero external infrastructure (memory mode).

It is the M11 dogfood target for issue #1085 (CellModule / SharedDeps / Builder / App public API).

Usage:

GOCELL_BOOTSTRAP_ADMIN_USERNAME=admin GOCELL_BOOTSTRAP_ADMIN_PASSWORD=adminpass1 \
go run ./examples/corebundlestarter

Note: GOCELL_JWT_ISSUER, GOCELL_JWT_AUDIENCE, and GOCELL_SERVICE_SECRET are NOT consumed by this example. The starter uses ephemeral in-process JWT keys and a hardcoded dev HMAC key (devServiceSecret const in run.go) for memory-mode demo purposes. Those env vars are only relevant to cmd/corebundle (the production binary).

run.go is the hand-written composition root for the corebundlestarter example. It demonstrates the public runtime/composition API: constructing a *composition.SharedDeps in dev/memory mode and assembling the three platform cells via cellmodules/<cell>.Module() — with zero external infrastructure.

This is the M11 dogfood target for issue #1085 (CellModule / SharedDeps / Builder / App public API).

AUTH-PLAN-04: auth construction (NewAuthJWTFromAssembly, NewAuthServiceToken) lives HERE in examples/ — not inside runtime/composition or cellmodules/.

ref: uber-go/fx fx.New — single assembly entry point used by both production and tests. ref: kubernetes-sigs/controller-runtime pkg/manager/manager.go — Manager accumulates options and starts via Start(ctx) error.