Skip to main content

Topology Docker its a plugin (called a Platform Engine) for the Topology Framework that allows to build a topology using Docker containers.

Documentation

https://topology-docker.readthedocs.io/

Changelog

1.8.0

Changes

  • Allow platform to receive options, so it is compatible with the new Topology 1.10.0 “options” feature. [David Diaz]

1.7.0

  • Release changelog lost in time.

1.6.0

New

  • A dockerfile for a test host container has been added. The purpose of this container is to serve as a general purpose test host, which includes by default several tools (iperf, tcpdump, for example) that are useful for test case execution.

  • Fixing default host image in ubuntu:14.04. The default image for hosts used to be ubuntu:latest but since the actual image to which this points to can change, it could introduce issues for test cases that were developed under the assumption that the pointed-to image included the necessary tools for the test case.

  • Logging the image and container data. Image name, id, creation date, etc. are now logged automatically for every container.

  • Docker nodes now mount their /tmp directory under the host /tmp. The mount path of this directory under the host /tmp is defined using the container id.

  • A new test that checks the proper functionality of host routes has been added. This is a functional test in which 2 hosts ping each other.

Changes

  • Documentation for image attribute has been improved. This attribute was a source of confusion since it was not explicitly documented that the TAG column needed to be included in the image value.

Fixes

  • Nodes which fail to start are now not considered for rollback. Also, this rollback process is now a best effort since it just tries to stop nodes. If one of these nodes fails to stop, this will be logged and the process will continue.

1.5.0

Changes

The only change in this version is the transference of all specialized support nodes previously included with this platform engine into their own repositories. This change seeks to improve maintainability of the platform engine, separation of the support nodes issues, requirements and enhancements from those of the platform and, finally, endorse shared ownership of the nodes.

The new home for those support nodes are:

OpenSwitch support node:

https://github.com/HPENetworking/topology_docker_openswitch

Open vSwitch support node:

https://github.com/HPENetworking/topology_docker_openvswitch

P4Switch support node:

https://github.com/HPENetworking/topology_docker_p4switch

Ryu Controller support node:

https://github.com/HPENetworking/topology_docker_ryu

1.4.0

New

  • The binds attribute can now be injected and extended by users. If you require to add a new bind directory to a node you may now specify the attribute binds (and thus, also use attribute injection) separating the pair of binded directories with a ;. For example:

    /host/a:/container/a;/host/b:/container/b
  • OpenSwitch support node will now notify the container when the setup of the interfaces is done. This fixes many potential race conditions on container initialization. To be able to use this new feature an OpenSwitch image of a date greater than March 4 2016 is required.

Changes

  • Set topology minimal version to 1.5.0.

  • Internal docker exec shell layer migrated to Topology’s new shell API, available since 1.4.0 and improved in 1.5.0.

Fixes

  • OpenSwitch support node will now ignore the bonding_masters interface when creating setting up the ports.

  • Fixed a race condition in OpenSwitch support node caused by a slower than normal db schema setup in ovsdb. This race conditions caused an IndexError when setting up the image, causing the topology build to rollback.

1.3.0

Changes

  • Node’s/Container’s hostname can now be set using the hostname attribute in the SZN description. OpenSwitch will always enforce the switch hostname for all nodes of this type.

  • Docker-py’s will now use the server’s API version, instead of the latest. With this it will no longer required to update the Docker daemon to run topology tests.

  • Set topology minimal version to 1.2.0.

1.2.0

Changes

  • Refactored node loading logic to use topology.platforms.utils.NodeLoader instead.

1.1.0

New

  • Added Dockerfiles for Ryu and P4.

Changes

  • The Open vSwitch node will now check that the openvswitch kernel module is loaded. It is supposed to work in user space, but we discovered many race conditions without the kernel module. Check the documentation of the openvswitch node for more information.

Fixes

  • Improved openswitch’s vtysh prompt regular expression to avoid false positives matches.

  • Fixed a bug on shell management that caused the echo of the command to be included in the output, and thus interpreted as failed.

1.0.0

  • Initial public release.

License

Copyright (C) 2015-2016 Hewlett Packard Enterprise Development LP

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing,
software distributed under the License is distributed on an
"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
KIND, either express or implied.  See the License for the
specific language governing permissions and limitations
under the License.

Metadata

Release files for topology-docker 1.8.2

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

Source distribution (sdist)

Source distribution for topology-docker 1.8.2
File Size Uploaded
topology_docker-1.8.2.tar.gz 21.7 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for topology-docker 1.8.2
File Interpreter ABI Platform
topology_docker-1.8.2-py3-none-any.whl Python 3 none any Details

Total release size: 47.9 kB

Release files / topology_docker-1.8.2.tar.gz

Download URL topology_docker-1.8.2.tar.gz
Size 21.7 kB
Tags Source
SHA-256 checksum
How to use checksums
4ff3b66fca2cb8c451a68716f083e9aa7e64877fa7fec2a9b39d96911711a443
BLAKE2b-256 checksum
How to use checksums
f6a55789098ab48286e01cdd364fac63e602fa3367d0a65503d86f301ad5b68b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.12.3

Release files / topology_docker-1.8.2-py3-none-any.whl

Download URL topology_docker-1.8.2-py3-none-any.whl
Size 26.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
00315d90576ce0022722612e2c8990522e2db77b6d5e4e322ad1262d9dfd93af
BLAKE2b-256 checksum
How to use checksums
c53d0bf0ccc6775b5984d2d185d34ffc2f7fd5afb047ea1698503bf01628ff78
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.12.3

Release history Release notifications | RSS feed

This release

1.8.2 This release

2 release files

1.8.1

1 release file

1.8.0

2 release files

1.7.0

2 release files

1.6.0

1 release file

1.5.0

1 release file

1.4.0

1 release file

1.3.0

1 release file

1.2.0

1 release file

1.1.0

1 release file

1.0.0

1 release file

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