Skip to main content

Clusternet

This project extends the Containernet emulation environment to span the emulation across several physical machines.

Dependencies

Install

sudo pip install -U git+https://github.com/EsauM10/clusternet.git

Usage

Run a Worker in a machine with:

sudo RunWorker -p=5000

Choose a machine to run an Openflow Controller with:

controller -v ptcp=6633

And then, create a topoly and save to a file.

from clusternet.client import RemoteWorker

worker = RemoteWorker(ip='192.168.0.152', port=5000)

try:
    worker.add_controller('c0', ip='192.168.0.152', port=6633)
    worker.add_switch('s1')
    d1 = worker.add_docker(name='d1', ip='10.0.0.1', dimage='ubuntu:trusty')
    d2 = worker.add_docker(name='d2', ip='10.0.0.2', dimage='ubuntu:trusty')

    worker.add_link('d1', 's1')
    worker.add_link('d2', 's1')

    worker.start()
    worker.run_pingall()
    
    print(d1.cmd('ifconfig'))
    print(d2.cmd(f'ping -c 4 {d1.get_ip()}'))

except Exception as ex:
    print(ex)
finally:
    worker.stop()

This example runs one worker and the Openflow Controller in the same machine, make sure the IP addresses and ports are configured correctly and run it with:

sudo python3 topology.py

Metadata

Release files for clusternet 0.9.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for clusternet 0.9.3
File Size Uploaded Provenance Actions
clusternet-0.9.3.tar.gz 14.8 kB With provenance Details for clusternet-0.9.3.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for clusternet 0.9.3
File Interpreter ABI Platform Actions
clusternet-0.9.3-py3-none-any.whl Python 3 none any Details for clusternet-0.9.3-py3-none-any.whl

Total release size: 42.3 kB

Release files / clusternet-0.9.3.tar.gz

Download URL clusternet-0.9.3.tar.gz
Size 14.8 kB
Tags Source
SHA-256 checksum
How to use checksums
70bd3279af6f50fd77f7ed152059787280283fea254e814aece551e19ec35f3d
BLAKE2b-256 checksum
How to use checksums
ec88a7d4adfdcdc746edfb2ea31833959649c6336a688e0a8cfbc88c5b69cac5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.7

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 18, 2025.

Transparency log

Release files / clusternet-0.9.3-py3-none-any.whl

Download URL clusternet-0.9.3-py3-none-any.whl
Size 27.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
598f38d8e4b9c8a11ae2bb26e401a680f3c28ea6e19e5100674673bbc3ed57e6
BLAKE2b-256 checksum
How to use checksums
a5f34201855db77bb1a62e6cd4fe870b73a74a887581ce00f4258f1f6a0f9491
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.7

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 18, 2025.

Transparency log

Security for clusternet 0.9.3

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 2 files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for clusternet-0.9.3.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 18, 2025.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.9.3 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page