builder

func (*Server) Build ¶

func (r *Server) Build(ctx context.Context) (*Command, error)

Build returns a Command used to run the apiserver

func (*Server) Execute ¶

func (r *Server) Execute(ctx context.Context) error

Execute builds and executes the apiserver Command.

func (*Server) WithConfigFns ¶

func (r *Server) WithConfigFns(fns ...func(config *server.RecommendedConfig) *server.RecommendedConfig) *Server

WithConfigFns sets functions to customize the RecommendedConfig

func (*Server) WithEtcdPath ¶

func (r *Server) WithEtcdPath(etcdPath string) *Server

func (*Server) WithFlagFns ¶

func (r *Server) WithFlagFns(fns ...func(set *pflag.FlagSet) *pflag.FlagSet) *Server

WithFlagFns sets functions to customize the flags for the compiled binary.

func (*Server) WithLocalDebugExtension ¶

func (a *Server) WithLocalDebugExtension() *Server

WithLocalDebugExtension adds an optional local-debug mode to the apiserver so that it can be tested locally without involving a complete kubernetes cluster. A flag named "--standalone-debug-mode" will also be added the binary which forcily requires "--bind-address" to be "127.0.0.1" in order to avoid security issues.

func (*Server) WithOpenAPIDefinitions ¶

func (r *Server) WithOpenAPIDefinitions(
	name, version string,
	defs openapicommon.GetOpenAPIDefinitions) *Server

WithOpenAPIDefinitions registers OpenAPI definitions for the API server.

Root cause of the ~1 / SSA / kubectl issue ¶

kube-openapi builds $ref strings as:

"#/.../schemas/" + EscapeJsonPointer(GetDefinitionName(goPath))

GetDefinitionName for non-GVK types falls back to returning the name unchanged (containing "/"). EscapeJsonPointer then converts "/" → "~1".

If we override GetDefinitionName to return "~1"-encoded names (which is what we need so that component KEYS are "~1"-encoded and the TypeConverter can find them), EscapeJsonPointer double-encodes the "~" → "~0", yielding "~01" in the $ref. In newer kube-openapi, BuildOpenAPIDefinitionsForResources finds sub-types by looking up the raw $ref content in the definitions map. "~01" is NOT a key in the map (map has "~1" aliases and "/" Go-path keys), so TargetStatus/ConfigStatus/etc. are never included in the TypeConverter's schema. The TypeConverter then fails with "no type found matching: ~1-name".

Fix: bypass EscapeJsonPointer with a custom ReferenceCallback ¶

By providing our OWN ref callback to GetOpenAPIDefinitions — one that inserts the GetDefinitionName output DIRECTLY into the $ref without calling EscapeJsonPointer — we ensure:

$ref  = GetDefinitionName(goPath)  = "github.com~1sdcio~1...TargetStatus"
key   = GetDefinitionName(goPath)  = "github.com~1sdcio~1...TargetStatus"
$ref == key  →  raw lookup always works, no double-encoding

This satisfies BOTH the TypeConverter (which does a raw lookup of the $ref content in its schema) AND kubectl (which looks up component names literally).

The "~1"-encoded alias entries in the definitions map are still needed so that BuildOpenAPIDefinitionsForResources can find root types when getResourceNamesForGroup passes their canonical (~1-encoded) names.

func (*Server) WithOptionsFns ¶

func (r *Server) WithOptionsFns(fns ...func(*ServerOptions) *ServerOptions) *Server

WithOptionsFns sets functions to customize the ServerOptions used to create the apiserver

func (*Server) WithResourceAndHandler ¶

func (r *Server) WithResourceAndHandler(obj resource.Object, sp *rest.StorageProvider) *Server

WithResourceAndHandler registers a request handler for the resource rather than the default etcd backend storage.

Note: WithResourceAndHandler should never be called after the GroupResource has already been registered with another version.

Note: WithResourceAndHandler will NOT register the "status" subresource for the resource object.

func (*Server) WithServerFns ¶

func (r *Server) WithServerFns(fns ...func(server *GenericAPIServer) *GenericAPIServer) *Server

WithServerFns sets functions to customize the GenericAPIServer

func (*Server) WithServerName ¶

func (r *Server) WithServerName(serverName string) *Server

func (*Server) WithoutEtcd ¶

func (r *Server) WithoutEtcd() *Server

WithoutEtcd removes etcd related settings from apiserver.

func (*SingletonProvider) Get ¶ added in v0.0.4

func (s *SingletonProvider) Get(ctx context.Context, scheme *runtime.Scheme, optsGetter generic.RESTOptionsGetter) (registryrest.Storage, error)