minicloud 1.0.0

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

dm = CloudManager()

# Create a container
container = dm.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

dm = CloudManager()

container = dm.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 = dm.list_containers()

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

Get Container Info

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

Get Container Stats

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

Start/Stop/Restart

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

Delete Container

dm.delete_container("my-app")

Server Info

server = dm.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

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

Custom Allowed Images

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

Error Handling

from minicloud import CloudManager, ContainerAlreadyExistsError, ImageNotAllowedError

try:
    dm.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

Resource Limits

Resource	Min	Max
RAM	128 MB	16384 MB
CPU	10%	400% (4 cores)
Disk	1 GB	100 GB
Port	1024	65535

License

MIT