minicloud 1.0.1

Docker container management library for Python

minicloud

Docker container management library for Python. Create and manage VPS containers with SSH access.

Installation

pip install minicloud

Quick Start

from minicloud import CloudManager

cm = CloudManager()

# Create a container
container = cm.create_container(
    name="my-app",
    ram=512,
    cpu=100,
    disk=10,
    port=3000,
    ssh_password="mypassword"
)

print(f"Container ID: {container['container_id']}")

Usage

Create Container

from minicloud import CloudManager

cm = CloudManager()

container = cm.create_container(
    name="my-app",
    ram=512,      # 512 MB RAM
    cpu=100,       # 1 CPU core (100 = 1 core)
    disk=10,       # 10 GB disk
    port=3000,     # SSH port
    image="ubuntu:22.04",
    ssh_password="secure-password"
)

List Containers

containers = cm.list_containers()

for c in containers:
    print(f"{c['name']}: {c['status']}")

Get Container Info

info = cm.get_container_info("my-app")
print(f"Status: {info['status']}")
print(f"Port: {info['port']}")

Get Container Stats

stats = cm.get_container_stats("my-app")
print(f"CPU: {stats['cpu_percent']}%")
print(f"Memory: {stats['memory_used']}/{stats['memory_limit']} MB")

Start/Stop/Restart

cm.start_container("my-app")
cm.stop_container("my-app")
cm.restart_container("my-app")

Delete Container

cm.delete_container("my-app")

Server Info

server = cm.get_server_info()
print(f"Hostname: {server['hostname']}")
print(f"Available RAM: {server['available_ram']} MB")
print(f"Containers: {server['containers_count']}")

Custom Configuration

Custom Prefix

cm = CloudManager(prefix="vps")
# Containers will be named: vps_my-app

Custom Allowed Images

cm = CloudManager(allowed_images=[
    "ubuntu:22.04",
    "debian:12",
    "nginx:latest",
])

Error Handling

from minicloud import CloudManager, ContainerAlreadyExistsError, ImageNotAllowedError

try:
    cm.create_container(
        name="my-app",
        ram=512,
        cpu=100,
        disk=10,
        port=3000
    )
except ContainerAlreadyExistsError:
    print("Container already exists")
except ImageNotAllowedError as e:
    print(f"Image not allowed: {e}")

Available Images

Default allowed images:

• ubuntu:22.04
• ubuntu:20.04
• debian:12
• debian:11
• alpine:latest
• centos:7

License

MIT