Control Plane Support
A Linux sandbox supports every operation of the common control plane, through the API or thetelnyx-edge CLI.
Virtual Machine
ENOSPC to the writing process. The sandbox keeps running.
Image Requirements
- Platform. The image must offer
linux/amd64. From a multi-platform index, thelinux/amd64manifest is used. - Layers. Layers are gzip-compressed or plain tar. zstd and foreign layers are refused.
- Size. The unpacked image must fit the 8 GiB root disk.
- Registry. The reference names its registry host. See Templates.
Processes and Users
ENTRYPOINT and CMD are never run. Root in a sandbox is root in its virtual machine only.
Environment Variables
Each process receives its environment in layers. A later layer replaces an earlier variable of the same name.- The platform defaults:
PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin,HOME=/root,LANG=C.UTF-8, and the certificate variables listed under Secrets, which point common clients at/etc/ssl/certs/ca-certificates.crt. - The image’s
ENV. - The create’s
env. - Secrets delivered by
secrets_env. - An exec’s own
env, for that exec.
Reserved
Identity
The sandbox’s/etc/machine-id is written at its first boot. A sandbox created from a template, a snapshot, or a fork receives a new machine ID, new SSH host keys, and a reseeded random number generator before its code resumes.