Базовые образы

Каждый шаблон начинается с одного базового образа. Выберите его первым шагом, затем добавляйте пакеты, файлы и команды.

Образ AgentBox

fromBaseImage() использует базовый OCI-образ AgentBox. Он подходит для обычных задач разработки и автоматизации.

В образ входят:

• Python 3.11 с pip, uv и uvx;
• Node.js 24 с npm, npx и yarn;
• Git, Git LFS, OpenSSH, GitHub CLI (gh) и GitLab CLI (glab);
• инструменты поиска и обработки текста rg, fd, find, grep, sed, gawk, diff, patch, jq и yq;
• средства загрузки и синхронизации curl, wget и rsync;
• архиваторы tar, gzip, bzip2, xz, zip, unzip и zstd;
• сетевые и системные утилиты ss, dig, nc, bash, coreutils, util-linux, procps, file и less;
• компилятор C/C++, pkg-config и заголовочные файлы для сборки распространённых зависимостей.

Пользователь user имеет домашний каталог /home/user и может выполнять команды через sudo без пароля.

Готовые OCI-образы

SDK предоставляет короткие методы для распространённых образов: fromUbuntuImage, fromDebianImage, fromFedoraImage, fromAlpineImage, fromArchImage, fromPythonImage, fromNodeImage и fromBunImage.

Например:

• fromUbuntuImage("24.04") выбирает ubuntu:24.04;
• fromNodeImage("24-bookworm-slim") выбирает node:24-bookworm-slim;
• fromBunImage("1.3") выбирает oven/bun:1.3.

Это OCI-образы из Docker Registry. AgentBox использует их файловую систему как основу шаблона, но запускает песочницу в виртуальной машине, а не в Docker-контейнере.

Произвольный образ

fromImage("registry.example.com/team/app:1.4.0") принимает OCI-образ по полному имени. Для закрытого реестра передайте учётные данные.

В одном описании можно выбрать только одну основу. Чтобы продолжить собственный шаблон, используйте fromTemplate("name:tag").