README
¶
Execution allocation inputs
This is the shared input parser for the pending execution-requirements integration. It is tested independently but not yet registered on run or list commands. Wiring depends on runtime support; no command currently promises enforcement of these new inputs.
Bind Options.AddFlags to a command's local flag set. At execution time, pass
os.LookupEnv to Options.Parse, then inject the resulting versioned allocation
into the worker. Argument values override the corresponding environment field
independently, allowing mixed sources. Explicit empty arguments or environment
values are invalid; omitted values remain unknown. Parsing does not inspect
host capacity or use recipe requests as evidence of allocation.
| Argument | Environment | Meaning |
|---|---|---|
--execution-cpu |
C2J_EXECUTION_CPU |
Usable cores/millicores |
--execution-memory |
C2J_EXECUTION_MEMORY |
Usable memory |
--execution-ephemeral-storage |
C2J_EXECUTION_EPHEMERAL_STORAGE |
Usable scratch |
--execution-platform |
C2J_EXECUTION_PLATFORM |
OS/architecture/optional variant |
--execution-image |
C2J_EXECUTION_IMAGE |
Launch reference/tag |
--execution-image-digest |
C2J_EXECUTION_IMAGE_DIGEST |
Actual manifest digest |
--execution-image-id |
C2J_EXECUTION_IMAGE_ID |
Runtime/config identity, diagnostic only |
List commands should call ParseFilter with their explicit
--compatible-with-execution and --include-unresolved choices. Without
compatibility opt-in, environment variables are not read and allocation flags
are rejected. With opt-in, at least one compatibility-relevant allocation fact
is required; an image ID alone is insufficient. IncludeUnresolved admits
unknown jobs for default-environment bootstrap, not as proven compatible jobs.
This package parses the candidate; it does not perform listing or pagination.
Run go test ./cmd/c2j/internal/executionflags for precedence, unknown-input,
validation, image-identity, and list opt-in tests.
Documentation
¶
Overview ¶
Package executionflags is the shared argument/environment boundary for run allocation injection and opt-in list compatibility filters.
Index ¶
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type Filter ¶
type Filter struct {
Allocation execution.Allocation
IncludeUnresolved bool
}
Filter is a candidate descriptor, not a lease request. An unresolved job can be included as a bootstrap candidate, but must never be labeled compatible.
type Options ¶
type Options struct {
CPU *string
Memory *string
EphemeralStorage *string
Platform *string
Image *string
ImageDigest *string
ImageID *string
}
Options preserves presence so an explicit empty argument cannot fall back to an environment value. Environment lookup happens at execution, not binding.
func (Options) Parse ¶
Parse resolves each argument independently ahead of its corresponding environment variable. No host detection, deployment defaults, or requested requirements are used as evidence of actual capacity. Pass os.LookupEnv in production, or nil to ignore the environment.
func (Options) ParseFilter ¶
func (o Options) ParseFilter(enabled, includeUnresolved bool, lookupEnv func(string) (string, bool)) (*Filter, error)
ParseFilter does not inspect inherited allocation variables without explicit opt-in. In particular, listing children inside a worker must not silently hide children that require a different environment.
Source Files