Фоновые команды

Параметр background в JavaScript/Python или метод Commands.Start в Go запускает команду без ожидания результата. Возвращённый объект содержит ID процесса и позволяет дождаться команды, отключиться от неё или остановить её.

mjs

import { Sandbox } from "@abox-dev/sdk";

const sandbox = await Sandbox.create();

try {
  const command = await sandbox.commands.run(
    "sleep 1; printf 'job finished' > /tmp/job.txt",
    { background: true, timeoutMs: 0 },
  );

  const pid = command.pid;
  await command.disconnect();

  const reconnected = await sandbox.commands.connect(pid);
  await reconnected.wait();
  console.log(await sandbox.files.read("/tmp/job.txt"));
} finally {
  await sandbox.kill();
}

from agentbox import Sandbox


sandbox = Sandbox.create()

try:
    command = sandbox.commands.run(
        "sleep 1; printf 'job finished' > /tmp/job.txt",
        background=True,
        timeout=0,
    )

    pid = command.pid
    command.disconnect()

    reconnected = sandbox.commands.connect(pid)
    reconnected.wait()
    print(sandbox.files.read("/tmp/job.txt"))
finally:
    sandbox.kill()

package main

import (
	"context"
	"fmt"
	"log"

	"github.com/abox-dev/sdk/packages/go-sdk"
)

func kill(sandbox *agentbox.Sandbox) {
	if _, err := sandbox.Kill(context.Background()); err != nil {
		log.Printf("cleanup sandbox: %v", err)
	}
}

func run() (err error) {
	ctx := context.Background()
	client, err := agentbox.NewClient()
	if err != nil {
		return err
	}
	sandbox, err := client.Sandboxes.Create(ctx, nil)
	if err != nil {
		return err
	}
	defer kill(sandbox)
	command, err := sandbox.Commands.Start(ctx, "sh", &agentbox.CommandOptions{
		Args: []string{"-lc", "sleep 1; printf 'job finished' > /tmp/job.txt"},
	})
	if err != nil {
		return err
	}
	pid, err := command.PID(ctx)
	if err != nil {
		return err
	}
	if err := command.Close(); err != nil {
		return err
	}
	reconnected, err := sandbox.Commands.Connect(ctx, pid, "")
	if err != nil {
		return err
	}
	if _, err := reconnected.Wait(ctx); err != nil {
		return err
	}
	value1, err := sandbox.Files.ReadText(ctx, "/tmp/job.txt", nil)
	if err != nil {
		return err
	}
	fmt.Println(value1)
	return nil
}

func main() {
	if err := run(); err != nil {
		log.Fatal(err)
	}
}

Сохраните ID песочницы и процесса, если результат будет получать другой процесс приложения. Сначала подключитесь к песочнице, затем вызовите sandbox.commands.connect(pid).

Обработчики вывода относятся к текущему соединению. В Go метод ConnectWithOptions позволяет задать обработчики и потоковый режим при повторном подключении. Метод Close отсоединяет дескриптор и оставляет процесс работающим. Если вывод должен сохраниться после отключения, записывайте его в файл.

Для команды без собственного таймаута укажите timeoutMs: 0 в JavaScript или timeout=0 в Python. В Go контекст подключения управляет локальным потоком. Его отмена отсоединяет клиент без остановки удалённого процесса. Во всех языках задайте песочнице достаточное время жизни.

Фоновые команды ​

Фоновые команды