{"id":19000145,"url":"https://github.com/midonet/orizuru","last_synced_at":"2025-06-20T14:33:46.545Z","repository":{"id":25359080,"uuid":"28786865","full_name":"midonet/orizuru","owner":"midonet","description":"test drive Midonet with Openstack, all services are in containers","archived":false,"fork":false,"pushed_at":"2017-07-31T12:52:39.000Z","size":377,"stargazers_count":6,"open_issues_count":0,"forks_count":2,"subscribers_count":11,"default_branch":"master","last_synced_at":"2025-04-22T17:11:17.458Z","etag":null,"topics":["installer","midonet","openstack","paramiko","python","python-fabric","ssh","yaml"],"latest_commit_sha":null,"homepage":"http://blog.midokura.com/2015/08/building-midonet-demo-environment/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/midonet.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-01-04T21:40:02.000Z","updated_at":"2021-06-27T15:08:54.000Z","dependencies_parsed_at":"2022-08-06T04:00:17.987Z","dependency_job_id":null,"html_url":"https://github.com/midonet/orizuru","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/midonet/orizuru","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/midonet%2Forizuru","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/midonet%2Forizuru/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/midonet%2Forizuru/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/midonet%2Forizuru/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/midonet","download_url":"https://codeload.github.com/midonet/orizuru/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/midonet%2Forizuru/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260961819,"owners_count":23089299,"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":["installer","midonet","openstack","paramiko","python","python-fabric","ssh","yaml"],"created_at":"2024-11-08T18:06:22.160Z","updated_at":"2025-06-20T14:33:41.530Z","avatar_url":"https://github.com/midonet.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"THIS PROJECT IS DEPRECATED.\n\nPlease use github.com/agabert/zeus for MEM5 demo installations.\n\n折鶴\n====\n\nThis program can be used to test drive MEM OpenStack and midonet.org OpenStack inside containers on Ubuntu Linux.\n\nFor MEM credentials you can always get your MEM trial key here today: http://www.midokura.com/midonet-enterprise/\n\nA demo video of the installer running (30 minutes) is available here: http://midonet.github.io/orizuru .\n\nTo get started with this all you need to provide is a list of (virtual or physical) servers.\n\nAt the end of the installation you can do the following to log into midonet-cli and use keystone:\n```\nssh -F tmp/.ssh/config midonet_cli\n```\nThe file /etc/keystone/KEYSTONERC is available in every container (so when you log into openstack_controller you will be able to source it also).\n\nFor kilo you should source /etc/keystone/admin-openrc.sh (the KEYSTONERC will not exist there).\n\nLocalhost Quickstart\n====================\nThis is useful if you do not want to install to other servers and install everything on your localhost right away.\n\nPlease make sure that you have at least 4 cores (8 HT cores) and 32 GB memory on the machine where the installer runs and the demo is installed.\n\nAlso ssh root@localhost must work and the ssh fingerprint of the server should be saved in .ssh/known_hosts.\n\nThe file that is used for this installation is called conf/localhost.yaml\n\nYou need to replace the ip 127.0.0.1 in this file with the ip for your host before starting the installation:\n```\nservers:\n  os001:\n    ip: 146.185.187.4\n```\n\nNow you can set the root password, set the configfile and start\n```\ngit clone https://github.com/midonet/orizuru.git\ncd orizuru\nmake\n```\n\nIf you experience a lot of spurious ssh errors that could be a bug in paramiko ssh session handling (we see it alot during testing).\nWhat helps is running the installer from a second machine, not on the same host you are installing to.\n\nAlso make sure your ~/.ssh/known_hosts is clean and does not contain fingerprints from logging into containers created during earlier runs (may also lead to ssh connect errors in paramiko).\n\nWriting your own config file\n============================\nTo set up the installation on several servers you should cd into the project directory and create a yaml file in the ./conf directory.\n\nAlso you should export two environment variables, one for the config, one for the root password of the containers and the hosts you are installing to:\n```\ngit clone https://github.com/midonet/orizuru.git\ncd orizuru\nexport CONFIGFILE=\"$(pwd)/conf/alex.yaml\"\nmake\n```\n\nYou can take a look at conf/alex.yaml for an example.\n\nIf you are installing to one server and are running the installer on a different machine the server you are installing the demo on should have at least 8GB memory and 2 cores (4 HT cores).\n\nPlease make sure you also use an ssh-agent for your ssh key passphrase so that fabric can login as root to the ips of the servers you defined without asking you for the passphrase each time.\n\nAlso you should make sure that all the host fingerprints for the ips are in your .ssh/known_hosts file before you start the installer with multiple hosts (this is because of a bug in paramiko handling ProxyCommand).\n\nMidoNet Manager\n===============\nIf you want to look at MidoNet Manager we encourage you to get a MEM repo account (you can get a free 30 day trial key from Midokura at no cost!) and enable the following environment vars:\n```\ngit clone https://github.com/midonet/orizuru.git\ncd orizuru\nexport OS_MIDOKURA_REPOSITORY_USER=\"your MEM username\"\nexport OS_MIDOKURA_REPOSITORY_PASS=\"your MEM password\"\nexport CONFIGFILE=\"$(pwd)/conf/alex.yaml\"\nmake\n```\n\nAfter enabling these env vars the MidoNet Manager will automatically be installed (even when you pick OSS as the midonet repo) and you can use it for managing your NVO solution.\n\nRestrictions on server names\n============================\nAll names in the servers section (and therefore also in the role section) must end with XXX where XXX is a number between 001 and 999.\nPlease do not use names like 'server' or 'test' as server names.\n\nWhat works best is naming the servers like this:\n```\nservers:\n    zk001:\n        ip: 192.168.4.203\n        dockernet: 192.168.21.0/24\n\n    zk002:\n        ip: 192.168.4.207\n        dockernet: 192.168.22.0/24\n\n    zk003:\n        ip: 192.168.4.208\n        dockernet: 192.168.23.0/24\n\n    os001:\n        ip: 192.168.4.206\n        dockernet: 192.168.31.0/24\n\n    os002:\n        ip: 192.168.4.202\n        dockernet: 192.168.32.0/24\n\n    os003:\n        ip: 192.168.4.209\n        dockernet: 192.168.33.0/24\n\n```\n\nWhen you only have one server things become easy: just name it server001 or os001.\n\nThe reason for this is that we construct some id fields from the digits of the server names.\n\nNot for production\n==================\n\nPlease do not use this demo installer to run production clouds. After you reboot a server all containers will be gone!\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmidonet%2Forizuru","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmidonet%2Forizuru","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmidonet%2Forizuru/lists"}