Commands

Description and operation

General

A command is the main process of a sandbox. You give it at creation as cmd: the program, then its arguments. The sandbox ends when the command exits.

The command can start other processes. The sandbox waits only for the command. When the command exits, the other processes end with the sandbox.

For one command, sandboxes.run creates the sandbox, waits for the command, reads the output and ends the sandbox. It returns the exit code, the output and the id.

A command can use the name of a service when the sandbox is created in a session with an environment. See Sandboxes.

Tasks

Run a command

Reason for the task: Run a command in a new sandbox and read the output and the exit code.

Job set-up

• Access: you.
• References: POST /v1/sandboxes, POST /v1/sandboxes/{id}/wait, GET /v1/sandboxes/{id}/logs.

Procedure

1. Create the sandbox with the command. The call returns at once.

   PythonCopy

   sb = kl.sandboxes.create(cmd=["python3", "-c", "print(6 * 7)"], packages=["python3"])

   TypeScriptCopy

   const sb = await kl.sandboxes.create({ cmd: ["python3", "-c", "print(6 * 7)"], packages: ["python3"] });

   GoCopy

   sb, err := kl.Sandboxes.Create(kloudlite.CreateSandbox{Cmd: []string{"python3", "-c", "print(6 * 7)"}, Packages: []string{"python3"}})if err != nil {    log.Fatal(err)}

   RubyCopy

   sb = kl.sandboxes.create(cmd: ["python3", "-c", "print(6 * 7)"], packages: ["python3"])

   JavaCopy

   var sb = kl.sandboxes().create(new Kloudlite.CreateSandbox().cmd(List.of("python3", "-c", "print(6 * 7)")).packages("python3"));

   CLICopy

   kloudlite sandboxes create --package python3 -- python3 -c 'print(6 * 7)'

2. Wait for the command to exit. The call returns the exit code.

   PythonCopy

   code = sb.wait()

   TypeScriptCopy

   const code = await sb.wait();

   GoCopy

   code, err := sb.Wait(0)if err != nil {    log.Fatal(err)}

   RubyCopy

   code = sb.wait

   JavaCopy

   int code = sb.waitFor(null);

   CLICopy

   kloudlite sandboxes wait sbx-3c4d5e6f7a8b9c0d

3. Read the output.

   PythonCopy

   print(sb.logs())

   TypeScriptCopy

   console.log(await sb.logs());

   GoCopy

   out, err := sb.Logs(false)if err != nil {    log.Fatal(err)}fmt.Print(out)

   RubyCopy

   puts sb.logs

   JavaCopy

   System.out.print(sb.logs(false));

   CLICopy

   kloudlite sandboxes logs sbx-3c4d5e6f7a8b9c0d

Close-out

1. Make sure that the output shows 42 and the exit code is 0.
2. Delete the record if you do not need it, as in End a sandbox.

To run one command in one call, use run. The call ends the sandbox for you.

res = kl.sandboxes.run(cmd=["python3", "-c", "print(6 * 7)"], packages=["python3"])print(res["exit_code"], res["output"])

const res = await kl.sandboxes.run({ cmd: ["python3", "-c", "print(6 * 7)"], packages: ["python3"] });console.log(res.exitCode, res.output);

res, err := kl.Sandboxes.Run(kloudlite.RunSandbox{Sandbox: kloudlite.CreateSandbox{Cmd: []string{"python3", "-c", "print(6 * 7)"}, Packages: []string{"python3"}}})if err != nil {	log.Fatal(err)}fmt.Println(res.ExitCode, res.Output)

res = kl.sandboxes.run(cmd: ["python3", "-c", "print(6 * 7)"], packages: ["python3"])puts res["exit_code"], res["output"]

var res = kl.sandboxes().run(new Kloudlite.RunSandbox().cmd(List.of("python3", "-c", "print(6 * 7)")).packages("python3"));System.out.println(res.exitCode + " " + res.output);

kloudlite sandboxes run --package python3 -- python3 -c 'print(6 * 7)'

Troubleshooting