{"id":22558386,"url":"https://github.com/redbrick/netsoc","last_synced_at":"2025-03-28T11:41:49.336Z","repository":{"id":10968379,"uuid":"13283715","full_name":"redbrick/netsoc","owner":"redbrick","description":"Virtualised networking society","archived":false,"fork":false,"pushed_at":"2016-07-18T22:05:55.000Z","size":337,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-02-02T12:16:23.217Z","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/redbrick.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}},"created_at":"2013-10-02T21:43:08.000Z","updated_at":"2016-03-21T17:34:07.000Z","dependencies_parsed_at":"2022-08-29T15:41:04.390Z","dependency_job_id":null,"html_url":"https://github.com/redbrick/netsoc","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/redbrick%2Fnetsoc","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/redbrick%2Fnetsoc/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/redbrick%2Fnetsoc/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/redbrick%2Fnetsoc/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/redbrick","download_url":"https://codeload.github.com/redbrick/netsoc/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246025918,"owners_count":20711575,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":"2024-12-07T20:14:33.925Z","updated_at":"2025-03-28T11:41:49.274Z","avatar_url":"https://github.com/redbrick.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"Netsoc [![Build Status](https://travis-ci.org/redbrick/netsoc.svg?branch=master)](https://travis-ci.org/redbrick/netsoc)\n================================\n\nAbout\n-------------------------\n\n\u003e While you're waiting, read the free novel we sent you. It's a Spanish story about a \n\u003e guy named 'Manual'. - Dilbert\n\nThis document details the process for running an entire networking society's infrastructure in a virtualised fashion.\n\nThe assumed distribution for running the virtual machines is Ubuntu LTS. The setup has been shown to run on both Windows and Linux distributions.\n\n\nPrerequisites\n-------------------------\n\nDownload and install the latest version of:\n\n * [VirtualBox](https://www.virtualbox.org/wiki/Downloads)\n * [Vagrant](http://www.vagrantup.com/downloads.html)\n\n\nInstallation\n-------------------------\n\nDownload the repository by running `git clone https://github.com/redbrick/netsoc`.\n\n\nRunning\n-------------------------\n\nFrom the VM host, navigate to the repository and issue the command `vagrant up`. This will launch a number of VMs and begin to configure them.\n\nLog into the management server using `vagrant ssh mgmt`.\n\n\n## Networking\n\nNetworking is divided into two seperate networks, a private and a public network.\n\nThe private network is a host-only network with an addressing of `10.10.1.0/24`. This allows machines to communicate which each other privately.\n\nThe public network is a host-only network with an addressing of `10.20.1.0/24`. This is assumed to be the Internet facing side of the infrastructure even though it is not publicly addressable.\n\n## Configuration Management\n\nCurrently netsoc is using Ansible. However depending on the use-cases and its effectiveness this may be subject to change.\n\nAnsible is installed onto the `mgmt` server from where the VMs can be configured. To log into the management server run `vagrant ssh mgmt`.\n\n### Installation\n\nAnsible is installed in `/opt/ansible` using virtualenv and pip. The Ubuntu version is not used as it is out of date and is lacking several security related patches. netsoc installs Ansible scripts in `/usr/local/sbin/` so that they are accessible to the system without needing to use virtualenv manually.\n\n### Configuration\n\n`/etc/ansible/hosts` contains the hosts that Ansible will manage.\n\n### Running\n\n`ansible --list-hosts all` will display all the hosts.\n\nTo Test if the host is reachable with Ansible use `ansible all -m ping --ask-pass`.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fredbrick%2Fnetsoc","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fredbrick%2Fnetsoc","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fredbrick%2Fnetsoc/lists"}