Expand description
Runner containers through the Docker Engine API: the connection, container, volume and image requests, and the
DockerApi trait the engine and the caches call. It decides nothing about scheduling, and a JIT config only
ever reaches a container as a root-only file, never the create request or a log line.
Structs§
- Container
- A container
listfound. - Docker
- The local Docker Engine.
- File
- A file
filesread from a container. - Files
- What
filesread of a directory. - Image
- An image
imagesfound. - JitConfig
- A runner’s just-in-time config from GitHub: credentials, never printed.
- Runner
Spec - One runner container: a profile’s image stage with the profile’s limits.
- Runner
State - What
inspectreports about a runner container. - Start
Error - A runner start that failed, with the container it may have left: Docker may have made, or even started, it before the request failed, as when its answer is lost.
- Tagged
Image - An image
tagged_imagesfound. - Tty
- A container’s terminal, attached once it was created and before it started, so none of its output is missed.
- TtySize
- A terminal’s size.
Enums§
- Error
- Generic Docker errors
Constants§
- JIT_
CONFIG_ PATH - Where
startputs the just-in-time config in the container: a root-only file, never the create request, which Docker stores and clients may log.
Traits§
- Docker
Api - The Docker Engine calls the scheduler and the caches make.
Dockeris the real one; the engine’s tests use a fake.
Functions§
- cpu_
shares - The CPU shares of a runner’s container or a record’s shell with
cpusCPUs: 1024 a CPU, within the 2 to 262144 Docker takes, which it writes as the container’scpu.weight. They sit in the slice beside each other, so when the slice’s CPUs are all in use they share them in proportion to theircpus, not evenly; a container with work still gets at most itscpus(nano_cpus). The mirror keeps Docker’s default weight, which every job’s pulls go through, and programs outside the slice share the host’s CPUs with the slice by its own weight (ADR 0079). - create_
body - The create-container request for a runner container under an isolation backend.
- is_
declined - Whether Docker answered that it cannot or will not do what was asked: a 4xx, or 501 for what it lacks, such as the log of a container whose log driver keeps none. Asking again gets the same answer; any other error may not.
- is_
not_ found - Whether a Docker error says the container, volume or image does not exist.
- is_
unreachable - Whether a Docker error says the Engine did not answer at all: its socket is gone, refuses connections or closed the connection, as while the machine shuts down. Not an answer the Engine gave, nor a timeout, which a busy Engine also gives.
Type Aliases§
- Output
- What a command run in a container prints on stdout, as it prints it.