{"id":15103548,"url":"https://github.com/indigo-dc/puppet-synergy","last_synced_at":"2026-02-14T04:02:15.349Z","repository":{"id":57664389,"uuid":"59582595","full_name":"indigo-dc/puppet-synergy","owner":"indigo-dc","description":null,"archived":false,"fork":false,"pushed_at":"2017-02-06T12:22:49.000Z","size":21,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-09-21T19:24:18.641Z","etag":null,"topics":["indigo-dc","openstack","puppet","synergy"],"latest_commit_sha":null,"homepage":null,"language":"HTML","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/indigo-dc.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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":"2016-05-24T14:56:05.000Z","updated_at":"2017-01-30T15:49:57.000Z","dependencies_parsed_at":"2022-09-10T14:51:56.136Z","dependency_job_id":null,"html_url":"https://github.com/indigo-dc/puppet-synergy","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/indigo-dc/puppet-synergy","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/indigo-dc%2Fpuppet-synergy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/indigo-dc%2Fpuppet-synergy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/indigo-dc%2Fpuppet-synergy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/indigo-dc%2Fpuppet-synergy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/indigo-dc","download_url":"https://codeload.github.com/indigo-dc/puppet-synergy/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/indigo-dc%2Fpuppet-synergy/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29435388,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-14T03:34:37.767Z","status":"ssl_error","status_checked_at":"2026-02-14T03:34:09.092Z","response_time":53,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: 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":["indigo-dc","openstack","puppet","synergy"],"created_at":"2024-09-25T19:40:24.260Z","updated_at":"2026-02-14T04:02:15.275Z","avatar_url":"https://github.com/indigo-dc.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Synergy\n\n#### Table of Contents\n\n1. [Overview](#overview)\n2. [Module Description - What the module does and why it is useful](#module-description)\n3. [Setup - The basics of getting started with synergy](#setup)\n    * [What synergy affects](#what-synergy-affects)\n    * [Setup requirements](#setup-requirements)\n    * [Beginning with synergy](#beginning-with-synergy)\n4. [Usage - Configuration options and additional functionality](#usage)\n5. [Reference - An under-the-hood peek at what the module is doing and how](#reference)\n5. [Limitations - OS compatibility, etc.](#limitations)\n6. [Development - Guide for contributing to the module](#development)\n\n## Overview\n\nSet up and manage [Synergy](https://launchpad.net/synergy-service) on an existing\nOpenStack instance.\n\n\n## Module Description\n\nUsers that already have an OpenStack instance can use this module to install\nand configure the two main Synergy components:\n\n- [synergy-service](https://launchpad.net/synergy-service)\n- [synergy-scheduler-manager](https://launchpad.net/synergy-scheduler-manager)\n\nThis module will download the latest version of Synergy and install it.\nOne can manage Synergy configuration directly through this module.\n\n\n## Setup\n\n### What synergy affects\n\n* Synergy configuration file at `/etc/synergy/synergy.conf`\n* packages `synergy-service` (rpm or deb depending on the platform) and\n  `synergy-scheduler-manager` (via pip)\n\n### Setup Requirements\n\nAn OpenStack instance (with the version specified in [Limitations](#limitations)).\n\nThe Puppet module [puppetlabs/apt](https://forge.puppet.com/puppetlabs/apt/)\nif you plan to install on Ubuntu.\n\nAn OpenStack package repository for fetching `python-oslo*` libraries:\n\n- on Ubuntu, use the [*OpenStack/CloudArchive*](https://wiki.ubuntu.com/OpenStack/CloudArchive) repository.\n- on CentOS, the *CentOS Cloud SIG* repository will be installed during the Puppet run through the `centos-openstack-release-{openstackversion}` package.\n\n### Beginning with synergy\n\nMake sure this module is discoverable by your Puppet instance.\n\nDeclare the `synergy` class (see [Usage](#usage)).\n\n## Usage\n\n```puppet\nclass { 'synergy':\n  synergy_db_url          =\u003e 'mysql://test:test@localhost',\n  dynamic_quotas          =\u003e {'project_A' =\u003e 1,  'project_B' =\u003e 2},\n  project_shares          =\u003e {'project_A' =\u003e 70, 'project_B' =\u003e 30 },\n  user_shares             =\u003e {'project_A' =\u003e {'user1' =\u003e 60, 'user2' =\u003e 40 },\n                              'project_B' =\u003e {'user3' =\u003e 80, 'user4' =\u003e 20}},\n  keystone_url            =\u003e 'https://example.com',\n  keystone_admin_user     =\u003e 'admin',\n  keystone_admin_password =\u003e 'the admin password',\n}\n```\n\n## Reference\n\n### Class: `synergy`\n\n#### Parameters\n\n- `synergy_db_url` (*required*): the Synergy database, must be compliant to the [SQLAlchemy database URL schema](http://docs.sqlalchemy.org/en/latest/core/engines.html#database-urls). \n- `synergy_log_file` (default: `/var/log/synergy/synergy.log`): a file to log to.\n- `synergy_log_level` (default: `INFO`): log all information including and above this level, choices: `INFO`, `WARNING`, `ERROR`.\n- `synergy_service_host` (default: `localhost`): synergy host.\n- `synergy_service_port` (default: `8051`): synergy port.\n- `synergy_project_shares` (*required*): a puppet hash describing the project shares (see [Usage](#usage) for an example).\n- `keystone_url` (*required*): Keystone URL.\n- `keystone_admin_user` (*required*): Keystone admin user.\n- `keystone_admin_password` (*required*): Keystone admin password.\n- `nova_url` (*required*): Nova URL\n- `nova_db_url` (*required*): Nova database URL, in SQLAlchemy format.\n- `amqp_backend` (default: `rabbit`): AMQP backend.\n- `amqp_hosts` (default: ''): AMQP HA cluster host:port pairs, string.\n- `amqp_host` (*required*): AMQP host.\n- `amqp_port` (default: `5672`): AMQP port.\n- `amqp_user` (default: `openstack`): AMQP user.\n- `amqp_password` (*required*): AMQP password.\n- `amqp_virtual_host` (default: `/`): AMQP virtual host.\n- `metadata_secret` (*required*): a random secret.\n- `enable_external_repository` (default: `true`): whether or not to setup external package repositories.\n\n## Limitations\n\n**Operating System**\n- CentOS 7\n- Ubuntu 14.04\n\n**OpenStack version**\n- Liberty\n\n\n## Development\n\nFeel free to submit pull requests on the [project github page](https://github.com/indigo-dc/synergy-service).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Findigo-dc%2Fpuppet-synergy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Findigo-dc%2Fpuppet-synergy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Findigo-dc%2Fpuppet-synergy/lists"}