{"id":20126434,"url":"https://github.com/sovereigncloudstack/kolla-builder","last_synced_at":"2026-02-12T16:01:21.883Z","repository":{"id":240898746,"uuid":"803297367","full_name":"SovereignCloudStack/kolla-builder","owner":"SovereignCloudStack","description":"Developement Environment for Kolla","archived":false,"fork":false,"pushed_at":"2025-03-13T11:28:01.000Z","size":137,"stargazers_count":0,"open_issues_count":3,"forks_count":1,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-08-26T00:36:19.187Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Jinja","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"MatusJenca2/kolla-builder","license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/SovereignCloudStack.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2024-05-20T13:04:46.000Z","updated_at":"2024-09-19T08:45:53.000Z","dependencies_parsed_at":null,"dependency_job_id":"602daecf-7fc7-46ac-9baf-ac9bc67e4abf","html_url":"https://github.com/SovereignCloudStack/kolla-builder","commit_stats":null,"previous_names":["sovereigncloudstack/kolla-builder"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/SovereignCloudStack/kolla-builder","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SovereignCloudStack%2Fkolla-builder","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SovereignCloudStack%2Fkolla-builder/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SovereignCloudStack%2Fkolla-builder/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SovereignCloudStack%2Fkolla-builder/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SovereignCloudStack","download_url":"https://codeload.github.com/SovereignCloudStack/kolla-builder/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SovereignCloudStack%2Fkolla-builder/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29371395,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-12T08:51:36.827Z","status":"ssl_error","status_checked_at":"2026-02-12T08:51:26.849Z","response_time":55,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":"2024-11-13T20:16:07.640Z","updated_at":"2026-02-12T16:01:21.866Z","avatar_url":"https://github.com/SovereignCloudStack.png","language":"Jinja","readme":"# Kolla Builder\n\nThis repository contains a set of Ansible playbooks that will spawn and configure VMs (currently supporting libvirt only) to deploy Kolla.\n\n## Prerequisites\n### Host Machine\nMachine where you run Libvirt instances that will run Kolla Can be the same as [Local Machine](#local-machine) or a remote machine.\n- Libvirt\n```bash\n  sudo apt install qemu qemu-kvm libvirt-dev\n```\n- LibXML for python **Important:** install as root\n```bash\nsudo pip install lxml\n```\n### Local Machine\nYour machine where you run Kolla-Builder ansible playbooks from.\n- Virt-manager (optional)\n  ```bash\n  sudo apt install virt-manager\n  ```\n- [Kolla image](https://api.gx-scs.sovereignit.cloud:8080/swift/v1/AUTH_0b3c75f80b6743778daccec0da423465/Kolla%20Builder%20Image%2020240903/kolla-image.qcow2)\n\n- Ansible\n  ```bash\n  pip install ansible\n  ```\n- [Kolla Ansible source code](https://github.com/openstack/kolla-ansible)\n  ```bash\n  git clone https://opendev.org/openstack/kolla-ansible.git\n  ```\n- Copy SSH key from `ssh/id_kolla` to your `~/.ssh` directory\n  ```bash\n  cp ssh/id_kolla ~/.ssh\n  ```\n- Python libraries:\n```bash\npip install libvirt-python\npip install lxml\n```\n- Docker for ARA (optional) - for ARA recording Ansible docker needs to be installed and runnig\n## Configuration\n\n- Edit the [example user config](example_config.yml) and options are documented in config examples.\n\n## Usage\n\n### Building Environment\nThe `builder` script is used to manage nodes with `ansible-playbook` .\n#### Deploying ARA records ansible server (optional)\n\nTo deploy ARA server and start recording host ansible plays with ARA,\nensure flag `ara_enable` in `user_config.yml` is set to true and run:\n\n```bash\n./builder ara user/local-aio.yml\n```\n\nNodes plays will be recorded to this server too. ARA UI will then be accessible\non localhost/remote host on specified `ara_server_port`, 8000 by default.\n\n\n#### Spawning Nodes\n\nTo spawn a node or nodes, run:\n\n```bash\n./builder spawn user/local-aio.yml\n```\n\nIf you want to spawn the nodes on a remote server, use the `-r` option:\n\n```bash\n./builder -r spawn user/remote-multinode.yml\n```\n\n\u003e **Note**: Only run the `spawn` action once to create the nodes. You need to delete them before\nrunning again.\n\n#### Preparing Nodes\n\nOnce the nodes are booted, prepare them by running:\n\n```bash\n./builder prepare user/local-aio.yml\n```\n\nIf you need to update something on the nodes, run the prepare action again:\n\n```bash\n./builder prepare user/local-aio.yml\n```\n\n#### Accessing Nodes\n\n- For aio deployment\n```bash\nssh -F ssh_config openstack-aio\n# or whatever you named your node\n```\n\n- For multinode deployment\n```bash\nssh -F ssh_config openstack-deployment\n# or whatever you named your deploy node\n```\n#### Configuring Reverse Proxy on Remote Nodes\n\nIf you are using the remote option and need to configure a reverse proxy, run:\n\n```bash\n./builder -r nginx user/remote-aio.yml\n```\n\n### Deploy script\n\n- You can try the deploy script which is already on the node\n\n```bash\n./deploy\n```\n\n- If that fails, investigate the issue. Sometimes you just have to run the script again. If it doesn't help, see the next section.\n\n- Otherwise reffer to [Quick start for development](https://docs.openstack.org/kolla-ansible/latest/user/quickstart-development.html)\n\n### Remote Setup\n- You can use kolla-builder to spawn Kolla on a remote server/cloud instance\n- Edit [remote](remote) inventory and add your server\n```\nPUBLIC.IP.OF.REMOTE ansible_ssh_user=ubuntu ansible_become=True ansible_private_key_file=/path/to/your/ssh_key\n```\n- If you use a remote Openstack instance, you need:\n  - Network setup that allows outside connection\n  - SSH keypair\n  - Floating IP\n  - Security group rules allow:\n    - Egress for all connections\n    - Ingress for SSH(22)\n    - Ingress for HTTP(80)/HTTPS(443) to access Horizon from local browser\n    - Ingress for any additional port you reverse proxy to\n  - All the [prerequisites](#prerequisites) must be installed on the instance\n\n### Deletion\n\n\nTo delete all nodes, use the delete action:\n\n```bash\n./builder delete user/local-multinode.yml\n```\nor for remote libvirt host\n\n```bash\n./builder -r delete user/local-multinode.yml\n```\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsovereigncloudstack%2Fkolla-builder","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsovereigncloudstack%2Fkolla-builder","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsovereigncloudstack%2Fkolla-builder/lists"}