{"id":50487946,"url":"https://github.com/netgroup/softnet-container-lab","last_synced_at":"2026-06-02T00:03:32.920Z","repository":{"id":359537198,"uuid":"1224655803","full_name":"netgroup/softnet-container-lab","owner":"netgroup","description":"Containerlab experiments for software networks","archived":false,"fork":false,"pushed_at":"2026-05-30T12:05:32.000Z","size":26,"stargazers_count":0,"open_issues_count":0,"forks_count":19,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-05-30T14:05:28.910Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/netgroup.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-29T13:49:44.000Z","updated_at":"2026-04-29T14:38:09.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/netgroup/softnet-container-lab","commit_stats":null,"previous_names":["netgroup/softnet-container-lab"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/netgroup/softnet-container-lab","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netgroup%2Fsoftnet-container-lab","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netgroup%2Fsoftnet-container-lab/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netgroup%2Fsoftnet-container-lab/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netgroup%2Fsoftnet-container-lab/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/netgroup","download_url":"https://codeload.github.com/netgroup/softnet-container-lab/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netgroup%2Fsoftnet-container-lab/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33798943,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-01T02:00:06.963Z","response_time":115,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-06-02T00:03:32.152Z","updated_at":"2026-06-02T00:03:32.900Z","avatar_url":"https://github.com/netgroup.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# clab-softnet — Simple 2-Node ContainerLab Topology\n\n**Purpose:** Minimal containerlab topology with dual-stack IPv4/IPv6 support\n\n---\n\n## Goal\n\nA simple 2-node containerlab topology:\n- Two Ubuntu nodes (node1, node2) connected by a single p2p link on eth1\n- IPv4: `10.0.0.0/24`\n- IPv6: `fc00::/64`\n\n---\n\n## Repository Structure\n\n```\nclab-softnet/\n├── containerlab/\n│   ├── basic-lab.clab.yml      # 2-node topology (node1 \u003c-\u003e node2)\n│   ├── Dockerfile              # Ubuntu 24.04 image (sleep infinity as PID 1)\n│   ├── bin/\n│   │   └── entrypoint.sh       # Network configuration script (called via exec)\n│   ├── configs/                # Per-node configuration\n│   │   ├── node1.cfg\n│   │   └── node2.cfg\n│   ├── deploy.sh               # Deploy helper\n│   └── destroy.sh              # Destroy helper\n├── scripts/\n│   └── build-image.sh          # Build custom Docker image\n├── PLAN.md                     # Architecture and design notes\n├── README.md                   # This file\n└── TROUBLESHOOTING.md          # Debug guide\n```\n\n---\n\n## Prerequisites\n\n- [containerlab](https://containerlab.dev)\n- docker\n- Linux\n\n---\n\n## Quick Start\n\n### 1. Build Docker Image\n\n```bash\ncd containerlab\ndocker build -t clab-ubuntu-softnet:latest .\n```\n\nOr use the helper script:\n\n```bash\n./scripts/build-image.sh\n```\n\n### 2. Deploy Topology\n\n```bash\ncd containerlab\ncontainerlab deploy -t basic-lab.clab.yml\n```\n\nContainerlab will:\n1. Start both containers (`sleep infinity` as PID 1)\n2. Create the `node1:eth1 \u003c-\u003e node2:eth1` veth link\n3. Run `bash /entrypoint.sh` inside each container via `exec`\n\nThe entrypoint output is shown directly in the deploy log.\n\n### 3. Verify Connectivity\n\n```bash\n# Check node status\ncontainerlab inspect -t basic-lab.clab.yml\n\n# IPv4 ping\ndocker exec clab-basic-lab-node1 ping -c 3 10.0.0.2\n\n# IPv6 ping\ndocker exec clab-basic-lab-node1 ping -6 -c 3 fc00::2\n```\n\n### 4. Destroy Topology\n\n```bash\ncd containerlab\ncontainerlab destroy -t basic-lab.clab.yml --cleanup\n```\n\n---\n\n## Configuration\n\n### IP Addressing\n\n| Node  | eth1 IPv4    | eth1 IPv6   | Peer IPv4 | Peer IPv6 |\n|-------|-------------|-------------|-----------|-----------|\n| node1 | 10.0.0.1/24 | fc00::1/64  | 10.0.0.2  | fc00::2   |\n| node2 | 10.0.0.2/24 | fc00::2/64  | 10.0.0.1  | fc00::1   |\n\nEach config file (`configs/node1.cfg`, `configs/node2.cfg`) defines all six values:\n`NODE_IP`, `NODE_PREFIX`, `NODE_IP6`, `NODE_PREFIX6`, `PEER_IP`, `PEER_IP6`\n\n### Network Topology\n\n```\n    +----------+       +----------+\n    |  node1   | eth1  |  node2   |\n    |10.0.0.1  |-------|10.0.0.2  |\n    |fc00::1   |       |fc00::2   |\n    +----------+       +----------+\n```\n\n---\n\n## How exec Works\n\nThe topology uses containerlab's `exec` to run the entrypoint after links are created:\n\n```yaml\nnodes:\n  node1:\n    binds:\n      - configs/node1.cfg:/etc/nodes/node1.cfg:ro\n    exec:\n      - bash /entrypoint.sh\n```\n\nThis guarantees `eth1` already exists when the script runs — no polling loop needed.\nThe container stays alive via `CMD [\"sleep\", \"infinity\"]` in the Dockerfile.\n\n---\n\n## Commands Reference\n\n```bash\n# Deploy\ncontainerlab deploy -t basic-lab.clab.yml\n\n# Inspect\ncontainerlab inspect -t basic-lab.clab.yml\n\n# Shell access\ndocker exec -it clab-basic-lab-node1 bash\ndocker exec -it clab-basic-lab-node2 bash\n\n# Destroy\ncontainerlab destroy -t basic-lab.clab.yml --cleanup\n```\n\n---\n\n## Troubleshooting\n\nSee [TROUBLESHOOTING.md](TROUBLESHOOTING.md).\n\n---\n\n## License\n\nGNU General Public License v3.0\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnetgroup%2Fsoftnet-container-lab","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnetgroup%2Fsoftnet-container-lab","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnetgroup%2Fsoftnet-container-lab/lists"}