Documentation
¶
Overview ¶
Package network implements the explicitly prepared shared network runtime. Selection never creates or starts a runtime. References fence every request against replacement of the selected service.
Index ¶
- Constants
- func Check(ctx context.Context, ref Reference) error
- func CheckRetained(ctx context.Context, ref Reference) error
- func Completed(ctx context.Context, ref Reference, id string) error
- func Endpoint(name, identity string) string
- func Environment(env []string, ref Reference) []string
- func Prepare(name string, uid uint32) error
- func PrepareProtected(name string, uid uint32, enable bool, authentication []string) error
- func Release(ctx context.Context, ref Reference, id string) error
- func Reserve(ctx context.Context, ref Reference, id string) error
- func Start(name string) error
- func ValidateName(name string) error
- func Wrap(cmd *exec.Cmd, ref Reference, id string) (func(), error)
- type Forward
- type Membership
- type Reference
- type Request
- type Response
- type Status
Constants ¶
const ReferenceEnvironment = "AGENT_WORKFLOW_NETWORK_REFERENCE"
ReferenceEnvironment carries the nonsecret reference admitted before provider launch.
const Registry = "/var/lib/agent-workflow/runtimes"
const RunRoot = "/run/agent-workflow-runtimes"
const SocketEnforcement = "bpf-lsm-unix-v1"
Variables ¶
This section is empty.
Functions ¶
func CheckRetained ¶
CheckRetained fences owned recovery against replacement without admitting new work.
func Environment ¶
Environment replaces inherited container selectors with the admitted endpoint.
func Prepare ¶
Prepare enrolls only an existing rootful Podman authority. Starting a rootful API is equivalent to unrestricted service-user execution; narrow Podman read permissions are insufficient. No login or privilege refresh is performed.
func PrepareProtected ¶
PrepareProtected requires explicit operator consent to the host kernel policy and to each authentication exception. Re-preparation replaces the exception list.
func Reserve ¶
Reserve fences container creation against busy stop. Recovery releases this durable reservation only after exact container ownership/absence is proved.
func ValidateName ¶
Types ¶
type Membership ¶
type Reference ¶
type Request ¶
type Request struct {
Operation string `json:"operation"`
Reference Reference `json:"reference"`
ID string `json:"id,omitempty"`
Path string `json:"path,omitempty"`
Args []string `json:"args,omitempty"`
Env []string `json:"env,omitempty"`
Dir string `json:"dir,omitempty"`
Forward Forward `json:"forward,omitempty"`
Umask int `json:"umask,omitempty"`
Terminal bool `json:"terminal,omitempty"`
}
func (Request) MarshalJSON ¶
MarshalJSON preserves native strings as bytes, including invalid UTF-8. A value receiver covers Request values nested inside launch metadata as well.
func (*Request) UnmarshalJSON ¶
type Response ¶
type Response struct {
Status Status `json:"status"`
Member Membership `json:"member"`
Error string `json:"error,omitempty"`
}
type Status ¶
type Status struct {
Reference Reference `json:"reference"`
Healthy bool `json:"healthy"`
SocketEnforcement string `json:"socket_enforcement"`
NetworkNamespace string `json:"network_namespace"`
Members map[string]Membership `json:"members"`
Forwards []Forward `json:"forwards"`
MemberCount int `json:"member_count"`
ForwardCount int `json:"forward_count"`
MembersTruncated bool `json:"members_truncated"`
ForwardsTruncated bool `json:"forwards_truncated"`
}