{"id":20154725,"url":"https://github.com/sodafoundation/installer","last_synced_at":"2025-04-09T21:52:53.314Z","repository":{"id":39637163,"uuid":"129361076","full_name":"sodafoundation/installer","owner":"sodafoundation","description":"provides easy installation and basic deployment based on specific configurations for  SODA Projects","archived":false,"fork":false,"pushed_at":"2024-02-17T06:26:46.000Z","size":1569,"stargazers_count":35,"open_issues_count":122,"forks_count":68,"subscribers_count":15,"default_branch":"master","last_synced_at":"2025-04-09T21:52:48.828Z","etag":null,"topics":["ansible","helm-charts","salt-formula"],"latest_commit_sha":null,"homepage":"","language":"Shell","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/sodafoundation.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG/CHANGELOG-v1.1.0.md","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}},"created_at":"2018-04-13T06:50:38.000Z","updated_at":"2023-06-30T10:09:16.000Z","dependencies_parsed_at":"2024-02-17T07:28:34.524Z","dependency_job_id":"6604315a-413f-405a-ae59-f08ecaa6adc3","html_url":"https://github.com/sodafoundation/installer","commit_stats":null,"previous_names":[],"tags_count":49,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sodafoundation%2Finstaller","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sodafoundation%2Finstaller/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sodafoundation%2Finstaller/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sodafoundation%2Finstaller/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sodafoundation","download_url":"https://codeload.github.com/sodafoundation/installer/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248119401,"owners_count":21050754,"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":["ansible","helm-charts","salt-formula"],"created_at":"2024-11-13T23:28:12.248Z","updated_at":"2025-04-09T21:52:53.297Z","avatar_url":"https://github.com/sodafoundation.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# installer\n\n[![Releases](https://img.shields.io/github/release/sodafoundation/installer/all.svg?style=flat-square)](https://github.com/sodafoundation/installer/releases)\n[![LICENSE](https://img.shields.io/github/license/sodafoundation/installer.svg?style=flat-square)](https://github.com/sodafoundation/installer/blob/master/LICENSE)\n\n\u003cimg src=\"https://sodafoundation.io/wp-content/uploads/2020/01/SODA_logo_outline_color_800x800.png\" width=\"200\" height=\"200\"\u003e\n\n## Introduction\n\nSODA installer project provides easy installation and basic deployment based on specific configurations for SODA Projects. The installer is created so as to support the integrated installation of specific projects for each SODA Release.\n\nIt is modular and specific project installation information is built based on the installation hooks and related configurations. Basically SODA installer plays a wrapper role to put all together and provide a simple installation for the users and experience overall solution.\n\nInstaller project is maintained by SODA Foundation directly.\n\nSODA Installer supports installation of following SODA projects. If you want to install Orchestration, Sushi or Terra with Ceph backend, please use Installer version 1.7.0 or older.\n* Delfin\n* Terra/Hotpot (Api, Controller \u0026 Dock)\n* Strato/Gelato (Multi-cloud)\n* Orchestration\n* Sushi (NBP)\n* Dashboard\n\n## Installation using Ansible\n\n* Supported OS: **Ubuntu 20.04, Ubuntu 18.04**\n* Prerequisite: **Python 3.6 or above** should be installed\n\n\n### Install steps\n\nEnsure no ansible \u0026 docker installed, OR **Latest** ansible and docker tools are installed with versions listed below or later. If ansible \u0026 docker is not installed in the OS, script `install_dependencies.sh` will install it.\n\nUpdate configurations for individual projects in **`installer/ansible/group_var/*.yml`** and follow commands listed below.\n\n* auth.yml\n* common.yml\n* dashboard.yml\n* delfin.yml\n* gelato-ha.yml\n* gelato.yml\n* hotpot.yml\n* orchestration.yml\n* osdsdb.yml\n* osdsdock.yml\n* srm-toolchain.yml\n* sushi.yml\n* telemetry.yml\n\n\nPlease refer [SODA documentation](https://docs.sodafoundation.io/soda-gettingstarted/installation-using-ansible/) for the detailed installation steps and configuration options available.\n\n**Installation steps for Strato :** To install Strato(Multi-cloud) and Dashboard using ansible installer, please follow below steps.\n\n\n```bash\nsudo apt-get update \u0026\u0026 sudo apt-get install -y git\ngit clone https://github.com/sodafoundation/installer.git\ncd installer/ansible\ngit checkout v1.8.0 # you may choose specific release version also\nchmod +x install_dependencies.sh \u0026\u0026 source install_dependencies.sh\nexport PATH=$PATH:/home/$USER/.local/bin\n```\n\nEnable following configurations\n * In file installer/ansible/group_vars/gelato.yml\n`enable_gelato.yml: true`\n* In file installer/ansible/group_vars/dashboard.yml\n`enable_dashboard: true`\n* In file installer/ansible/group_vars/common.yml\n`host_ip: \u003cUser's IP address, eg. 192.168.0.2\u003e`\n\nNote : \n* Change HOST_IP value in below export command also.\n* To enable Storage Service Plan in Multi-cloud edit the configuration file installer/ansible/group_vars/common.yml as below \n`enable_storage_service_plans: true`\n\n```bash\nexport HOST_IP=192.168.0.2 # Change HOST_IP value to real host ip\nsudo -E env \"PATH=$PATH\" ansible-playbook site.yml -i local.hosts -v\n```\n\n**Installation steps for Delfin :** To install Delfin, SRM tool chain and Dashboard using ansible installer, please follow below steps.\n\n```bash\nsudo apt-get update \u0026\u0026 sudo apt-get install -y git\ngit clone https://github.com/sodafoundation/installer.git\ncd installer/ansible\ngit checkout v1.8.0 # you may choose specific release version also\nchmod +x install_dependencies.sh \u0026\u0026 source install_dependencies.sh\nexport PATH=$PATH:/home/$USER/.local/bin\n```\n\nEnable following configurations\n * In file installer/ansible/group_vars/delfin.yml\n`enable_delfin: true`\n* In file installer/ansible/group_vars/srm-toolchain.yml\n`install_srm_toolchain: true`\n* In file installer/ansible/group_vars/dashboard.yml\n`enable_dashboard: true`\n* In file installer/ansible/group_vars/common.yml\n`host_ip: \u003cUser's IP address, eg. 192.168.0.2\u003e`\n\n```bash\nexport HOST_IP=192.168.0.2 # Change HOST_IP value to real host ip\nsudo -E env \"PATH=$PATH\" ansible-playbook site.yml -i local.hosts -v\n```\n### Uninstall\n```bash\nsudo -E env \"PATH=$PATH\" ansible-playbook clean.yml -i local.hosts -v\n```\n\n### Tools used\n#### Ubuntu 20.04\n```bash\nroot@ubuntu2004:~/installer/ansible# ansible --version\nansible [core 2.13.5]\n  config file = /etc/ansible/ansible.cfg\n  configured module search path = ['/root/.ansible/plugins/modules', '/usr/share/ansible/plugins/modules']\n  ansible python module location = /root/.local/lib/python3.8/site-packages/ansible\n  ansible collection location = /root/.ansible/collections:/usr/share/ansible/collections\n  executable location = /root/.local/bin/ansible\n  python version = 3.8.10 (default, Jun 22 2022, 20:18:18) [GCC 9.4.0]\n  jinja version = 3.1.2\n  libyaml = True\nroot@ubuntu20:~/installer/ansible# python3 -m pip show ansible\nName: ansible\nVersion: 5.10.0\nSummary: Radically simple IT automation\nHome-page: https://ansible.com/\nAuthor: Ansible, Inc.\nAuthor-email: info@ansible.com\nLicense: GPLv3+\nLocation: /usr/lib/python3/dist-packages\nRequires: ansible-core\nRequired-by:\n\nroot@ubuntu20:~/installer/ansible# docker version\nClient: Docker Engine - Community\n Version:           20.10.21\n API version:       1.41\n Go version:        go1.18.7\n Git commit:        baeda1f\n Built:             Tue Oct 25 18:02:21 2022\n OS/Arch:           linux/amd64\n Context:           default\n Experimental:      true\n\nServer: Docker Engine - Community\n Engine:\n  Version:          20.10.21\n  API version:      1.41 (minimum version 1.12)\n  Go version:       go1.18.7\n  Git commit:       3056208\n  Built:            Tue Oct 25 18:00:04 2022\n  OS/Arch:          linux/amd64\n  Experimental:     false\n containerd:\n  Version:          1.6.9\n  GitCommit:        1c90a442489720eec95342e1789ee8a5e1b9536f\n runc:\n  Version:          1.1.4\n  GitCommit:        v1.1.4-0-g5fd4c4d\n docker-init:\n  Version:          0.19.0\n  GitCommit:        de40ad0\nroot@ubuntu20:~/installer/ansible# docker compose version\nDocker Compose version v2.12.2\n```\n\n#### Ubuntu 18.04\n```bash\ntest@T:~/installer$ ansible --version\n[DEPRECATION WARNING]: Ansible will require Python 3.8 or newer on the controller starting with Ansible 2.12. Current version: 3.6.9 \n(default, Jun 29 2022, 11:45:57) [GCC 8.4.0]. This feature will be removed from ansible-core in version 2.12. Deprecation warnings can be \ndisabled by setting deprecation_warnings=False in ansible.cfg.\nansible [core 2.11.12]\n  config file = None\n  configured module search path = ['/home/test/.ansible/plugins/modules', '/usr/share/ansible/plugins/modules']\n  ansible python module location = /home/test/.local/lib/python3.6/site-packages/ansible\n  ansible collection location = /home/test/.ansible/collections:/usr/share/ansible/collections\n  executable location = /home/test/.local/bin/ansible\n  python version = 3.6.9 (default, Jun 29 2022, 11:45:57) [GCC 8.4.0]\n  jinja version = 3.0.3\n  libyaml = True\ntest@T:~/installer$ python3 -m pip show ansible\nName: ansible\nVersion: 4.10.0\nSummary: Radically simple IT automation\nHome-page: https://ansible.com/\nAuthor: Ansible, Inc.\nAuthor-email: info@ansible.com\nLicense: GPLv3+\nLocation: /home/test/.local/lib/python3.6/site-packages\nRequires: ansible-core\nRequired-by:\n\ntest@T:~/installer/ansible$ docker version\nClient: Docker Engine - Community\n Version:           20.10.21\n API version:       1.41\n Go version:        go1.18.7\n Git commit:        baeda1f\n Built:             Tue Oct 25 18:02:00 2022\n OS/Arch:           linux/amd64\n Context:           default\n Experimental:      true\nGot permission denied while trying to connect to the Docker daemon socket at unix:///var/run/docker.sock: Get \"http://%2Fvar%2Frun%2Fdocker.sock/v1.24/version\": dial unix /var/run/docker.sock: connect: permission denied\ntest@T:~/installer/ansible$ docker compose version\nDocker Compose version v2.12.2\n\n```\n## Documentation\n\n[https://docs.sodafoundation.io](https://docs.sodafoundation.io/)\n\n## Quick Start - To Use/Experience\n\n[https://docs.sodafoundation.io](https://docs.sodafoundation.io/)\n\n## Quick Start - To Develop\n\n[https://docs.sodafoundation.io](https://docs.sodafoundation.io/)\n\n## Latest Releases\n\n[https://github.com/sodafoundation/installer/releases](https://github.com/sodafoundation/installer/releases)\n\n## Support and Issues\n\n[https://github.com/sodafoundation/installer/issues](https://github.com/sodafoundation/installer/issues)\n\n## Project Community\n\n[https://sodafoundation.io/slack/](https://sodafoundation.io/slack/)\n\n## How to contribute to this project?\n\nJoin [https://sodafoundation.io/slack/](https://sodafoundation.io/slack/) and share your interest in the ‘general’ channel\n\nCheckout [https://github.com/sodafoundation/installer/issues](https://github.com/sodafoundation/installer/issues) labelled with ‘good first issue’ or ‘help needed’ or ‘help wanted’ or ‘StartMyContribution’ or ‘SMC’\n\n## Project Roadmap\n\nWe envision to provide fully automated, single click installation or deployment for SODA Solutions using all the projects integrated.\n\n[https://docs.sodafoundation.io](https://docs.sodafoundation.io/)\n\n## Join SODA Foundation\n\nWebsite : [https://sodafoundation.io](https://sodafoundation.io/)\n\nSlack  : [https://sodafoundation.io/slack/](https://sodafoundation.io/slack/)\n\nTwitter  : [@sodafoundation](https://twitter.com/sodafoundation)\n\nMailinglist  : [https://lists.sodafoundation.io](https://lists.sodafoundation.io/)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsodafoundation%2Finstaller","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsodafoundation%2Finstaller","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsodafoundation%2Finstaller/lists"}