search

miguelammatos / Kollaps

Kollaps: a decentralized container based network emulator
Apache License 2.0
31 stars 5 forks source link

Swarm error "kollaps_network" is declared as external, but could not be found #24

Closed vschiavoni closed 3 years ago

vschiavoni commented 3 years ago

Following the currently published instructions to run the examples, running this:

docker stack deploy -c iperf_docker.yaml iperf3_deployment

the following error appears:

When trying to use Docker swarm, I get the error "network "kollaps_network" is declared as external, but could not be found. You need to create a swarm-scoped network before the stack is deployed”.

(reported by INRIA team, thank you Pedro)

vschiavoni commented 3 years ago

This is because the topology descriptors by default assume the kollaps_network overlay network to be valid. For instance here https://github.com/miguelammatos/Kollaps/blob/master/examples/iperf3/topology.xml#L26

Potential solution (pending validation) is to create the kollaps_network before deploying the stack: 

docker network create --driver=overlay --subnet=10.1.0.0/24 kollaps_network
docker stack deploy -c iperf_docker.yaml iperf3_deployment
csegarragonz commented 3 years ago

Sorry for lurking, but for some reason this popped up in my home menu and thought I would help :)

This is a bit of the instructions that gets easily missed, has happened in the past, but network creation is part of the overlay setup instruction file here. Which is linked from the main README.md right before the Installation Using Docker section.

vschiavoni commented 3 years ago

I think we should have a TL;DR version of the installation instructions that one cannot misunderstood. Probably deployers would appreciate a simple sequence of commands that upon completion lead to a ready-to-use system. It could be embedded in the main README.md

csegarragonz commented 3 years ago

Ok, #27 should fix this.