91e75e620b
CI: cua-driver distro-compat matrix / debian:12 (glibc 2.36) (push) Has been cancelled
CI: SPDX Headers / Check SPDX headers (warn-only) (push) Has been cancelled
CD: Docs MCP Server / build (linux/amd64) (push) Has been cancelled
CD: Docs MCP Server / build (linux/arm64) (push) Has been cancelled
CD: Docs MCP Server / merge (push) Has been cancelled
CI: cua-driver distro-compat matrix / Resolve release version (push) Has been cancelled
CI: cua-driver distro-compat matrix / fedora:41 (glibc 2.40) (push) Has been cancelled
CI: cua-driver distro-compat matrix / rockylinux:9 (glibc 2.34) (push) Has been cancelled
CI: cua-driver distro-compat matrix / ubuntu:22.04 (glibc 2.35) (push) Has been cancelled
CI: cua-driver distro-compat matrix / ubuntu:24.04 (glibc 2.39) (push) Has been cancelled
CI: cua-driver distro-compat matrix / Distro compat summary (push) Has been cancelled
CI: Rust Linux unit / Rust Linux unit and compile (push) Has been cancelled
CI: Rust Windows unit / Rust Windows unit and compile (push) Has been cancelled
CI: Nix Linux Rust source / Nix / compositor build (push) Has been cancelled
CI: Nix Linux Rust source / Nix / driver package (push) Has been cancelled
CI: Nix Linux Rust source / Nix / Rust unit tests (push) Has been cancelled
68 lines
2.0 KiB
Python
68 lines
2.0 KiB
Python
"""Run a local Linux VM in Python with the Cua Sandbox SDK.
|
|
|
|
async with Sandbox.ephemeral(Image.linux(kind="vm"), local=True) as sb:
|
|
await sb.shell.run("uname -a")
|
|
screenshot = await sb.screenshot()
|
|
|
|
Sandbox.ephemeral() auto-selects QEMURuntime (docker mode) for Linux VMs,
|
|
provisions the environment, and tears it down on exit. Use local=True to run on
|
|
your machine; drop it to run on the Cua cloud instead.
|
|
|
|
Contrast:
|
|
Image.linux() + local=True -> Docker container (fast, no VM overhead)
|
|
Image.linux(kind="vm") + local=True -> QEMU VM (full kernel isolation)
|
|
Image.linux(kind="vm") + local=False -> Cua cloud VM
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
import asyncio
|
|
import subprocess
|
|
|
|
import pytest
|
|
from cua_sandbox import Image, Sandbox
|
|
|
|
pytestmark = pytest.mark.asyncio
|
|
|
|
|
|
def _has_docker() -> bool:
|
|
try:
|
|
subprocess.run(["docker", "info"], capture_output=True, check=True, timeout=10)
|
|
return True
|
|
except (subprocess.SubprocessError, FileNotFoundError):
|
|
return False
|
|
|
|
|
|
@pytest.mark.skipif(not _has_docker(), reason="Docker not available")
|
|
async def test_linux_local_vm():
|
|
async with Sandbox.ephemeral(
|
|
Image.linux("ubuntu", "24.04", kind="vm"),
|
|
local=True,
|
|
name="example-linux-local-vm",
|
|
) as sb:
|
|
result = await sb.shell.run("uname -s")
|
|
assert result.success
|
|
assert "Linux" in result.stdout
|
|
|
|
screenshot = await sb.screenshot()
|
|
assert screenshot[:4] == b"\x89PNG"
|
|
|
|
|
|
async def main():
|
|
async with Sandbox.ephemeral(
|
|
Image.linux("ubuntu", "24.04", kind="vm"),
|
|
local=True,
|
|
name="example-linux-local-vm",
|
|
) as sb:
|
|
result = await sb.shell.run("uname -s")
|
|
print(f"uname: {result.stdout.strip()}")
|
|
|
|
screenshot = await sb.screenshot()
|
|
print(f"Screenshot: {len(screenshot)} bytes")
|
|
with open("/tmp/linux_local_vm.png", "wb") as f:
|
|
f.write(screenshot)
|
|
|
|
|
|
if __name__ == "__main__":
|
|
asyncio.run(main())
|