Conch 快速开始

本文介绍如何从源码编译并启动 Conch，以及如何创建 Template 和 Sandbox。使用软件包部署请参阅 RPM 安装。

1. 准备环境

按照环境准备安装依赖并完成主机配置。创建 Template 还需要准备一个支持 EROFS 的 guest kernel。

2. 编译

在仓库根目录执行：

make build
make build-conch-init-initramfs

Conch 二进制位于 bin/，initrd 位于 build-artifacts/conch-init-initramfs.cpio.gz。

3. 运行 conchd

复制默认配置并启动 conchd：

cp config/config.yaml config/config.local.yaml
chmod 0600 config/config.local.yaml
sudo ./bin/conchd --config config/config.local.yaml

conchd 会在前台运行并输出日志。保持该终端运行，在另一个终端执行后续命令。

4. 基本操作

从 OCI 镜像、guest kernel 和 initrd 创建 Template：

sudo ./bin/conch template create \
  --config config/config.local.yaml \
  --name localhost/conch/nginx:latest \
  --source docker.io/library/nginx:latest \
  --kernel /path/to/guest/kernel \
  --initrd build-artifacts/conch-init-initramfs.cpio.gz

命令会返回 Template Name 和当前 Template ID。使用 Name 创建并控制 Sandbox：

sudo ./bin/conch template ls --config config/config.local.yaml

sudo ./bin/conch sandbox create \
  --config config/config.local.yaml \
  --template-name localhost/conch/nginx:latest \
  --sandbox-id sandbox_demo

# 也可用 --template-id <sha256:digest> 代替 --template-name；二者互斥

sudo ./bin/conch sandbox suspend --config config/config.local.yaml sandbox_demo

sudo ./bin/conch sandbox resume --config config/config.local.yaml sandbox_demo

sudo curl --unix-socket /var/run/conchd/conchd.sock \
  -X DELETE http://localhost/api/v1/sandboxes/sandbox_demo

Template 分发和镜像管理见 Template 与镜像，Sandbox 内命令执行和文件操作见 Python SDK。