{ "info": { "author": "CloudGenix Developer Support", "author_email": "developers@cloudgenix.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "Intended Audience :: Developers", "License :: OSI Approved :: MIT License", "Programming Language :: Python :: 2.7", "Programming Language :: Python :: 3" ], "description": "# CloudGenix Config (Preview)\nConfiguration exporting and Continuous Integration (CI) capable configuration importing for the CloudGenix Cloud Controller.\n\n#### Synopsis\nEnables export and import of configurations and templates from the CloudGenix Cloud Controller. Also, the Import of \nconfiguration is designed to be run on file change, to maintain configuration state on the Cloud Controller.\n\n#### Features\n - Replace ION at site by extracting configuration, replacing 'serial_number' with new ION (Must be online and at least allocated to the account).\n - Check configurations into a repository (private GIT), and have a CI process system automatically configure site(s)\n - Use configs as a rollback tool after changes.\n - Delete most configurations by simply removing them from the file and/or setting to null.\n - Use configs as a template to deploy 10s-100s-1000s of sites.\n\n#### Requirements\n* Active CloudGenix Account\n* Python >= 2.7 or >=3.6\n* Python modules:\n * CloudGenix Python SDK >= 5.1.1b1 - \n\n#### License\nMIT\n\n#### Installation:\n - **PIP:** `pip install cloudgenix_config`. After install, `pull_site`/`do_site` scripts should be placed in the Python\n Scripts directory. \n - **Github:** Download files to a local directory, manually run `pull_site.py` and `do_site.py` scripts. \n\n### Examples of usage:\n 1. Configure a Site, Element, and related objects using the UI. Record the Site name (example, MySite)\n 2. Extract the configuration using the `pull_site` script: `pull_site -S \"MySite\" --output MySite.yaml`\n ```bash\n edwards-mbp-pro:cloudgenix_config aaron$ ./pull_site.py -S \"MySite\" --output MySite.yml \n edwards-mbp-pro:cloudgenix_config aaron$ \n ```\n 3. View, edit, make changes to the configuration file as needed. Example file at \n 4. Use `do_site.py` to apply the configuration, script will get site to that state.\n ```bash\n edwards-mbp-pro:cloudgenix_config aaron$ ./do_site.py ./MySite.yml\n No Change for Site MySite.\n No Change for Waninterface Circuit to Comcast.\n No Change for Waninterface Circuit to AT&T.\n No Change for Waninterface Circuit to Megapath.\n No Change for Lannetwork NATIVE_VLAN.\n Element: Code is at correct version 5.0.1-b9.\n No Change for Element MySite Element.\n No Change for Interface 23.\n No Change for Interface 1.\n No Change for Interface controller 1.\n No Change for Interface 4.\n No Change for AS-PATH Access List test3.\n No Change for IP Community List 20.\n No Change for Routing Prefixlist test-script-list2.\n No Change for Route Map toady.\n No Change for Route Map test8.\n No Change for Route Map toady2.\n No Change for BGP Global Config 15311892501660245.\n No Change for BGP Peer teaerz.\n No Change for Staticroute 15312386843200245.\n No Change for Ntp default.\n No Change for Toolkit 15311890594020131.\n No Change for Site MySite state (active).\n DONE\n ```\n \n### Caveats and known issues:\n - This is a PREVIEW release, hiccups to be expected. Please file issues on Github for any problems.\n - Requires 5.1.1b1 SDK\n - While this script can EXTRACT a single file with ALL sites, running do_sites.py on that file is NOT RECOMMENDED.\n - Best practice to do one site per config file.\n - These can be automatically pulled via `pull_site.py` with `--multi-output ` switch, will create a config per site.\n - Site safety factor is set to 1 by default (prevents unintentional multi-site configurations)\n - Re-naming Sites is not currently supported (changing site name in config causes a new site to be created)\n - Deletion of sites using `do_site.py` DESTROYS all objects under the Site. This operation is done by running `do_site.py` with the `--destroy` option.\n - Delete WILL happily auto-destroy EVERY SITE in the referenced YAML config file (Even FULLY-CONFIGURED SITES). Use with caution.\n - Site safety factor also applies to `--destroy` operations.\n - Element Extensions with specific PATH IDs are not currently templatable across multiple sites using this script.\n\n#### Version\n| Version | Build | Changes |\n| ------- | ----- | ------- |\n| **1.1.0** | **b1** | CloudGenix SDK 5.1.1b1 support|\n| **1.0.0** | **b6** | PIP setup will now limit CloudGenix SDK to 5.0.3b2 for v1.0.0|\n| **1.0.0** | **b5** | Hotfix for #16 |\n| **1.0.0** | **b4** | Fix issues #8 #11 #12 and #13 |\n| **1.0.0** | **b3** | More Bug fixes. |\n| **1.0.0** | **b2** | Bug fixes. |\n| **1.0.0** | **b1** | Initial Release. |\n\n\n#### For more info\n * Get help and additional CloudGenix Documentation at ", "description_content_type": "text/markdown", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/CloudGenix/cloudgenix_config", "keywords": "", "license": "MIT", "maintainer": "", "maintainer_email": "", "name": "cloudgenix-config", "package_url": "https://pypi.org/project/cloudgenix-config/", "platform": "", "project_url": "https://pypi.org/project/cloudgenix-config/", "project_urls": { "Homepage": "https://github.com/CloudGenix/cloudgenix_config" }, "release_url": "https://pypi.org/project/cloudgenix-config/1.1.0b1/", "requires_dist": null, "requires_python": "", "summary": "Configuration exporting and Continuous Integration (CI) capable configuration importing for the CloudGenix Cloud Controller.", "version": "1.1.0b1" }, "last_serial": 4886331, "releases": { "1.0.0b1": [ { "comment_text": "", "digests": { "md5": "1c47ba837985b4b01a4e93a7a2ad0688", "sha256": "07439d49951b8f5b9254f6098afa2bcb390109d0b30cd2fd2cfab4505b41091b" }, "downloads": -1, "filename": "cloudgenix_config-1.0.0b1.tar.gz", "has_sig": false, "md5_digest": "1c47ba837985b4b01a4e93a7a2ad0688", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 57210, "upload_time": "2018-07-18T16:13:17", "url": "https://files.pythonhosted.org/packages/e2/63/bfcf3223c5b7159779d9515dfe60381199b91cb630705b05d80be4f2d4a5/cloudgenix_config-1.0.0b1.tar.gz" } ], "1.0.0b2": [ { "comment_text": "", "digests": { "md5": "e3187f9f5886ae0bc31f6f8f1a7af780", "sha256": "5fe3101ab46cd7ca3128f914b9bee4afd0da4954f6db7b7da9de2b01380e4967" }, "downloads": -1, "filename": "cloudgenix_config-1.0.0b2.tar.gz", "has_sig": false, "md5_digest": "e3187f9f5886ae0bc31f6f8f1a7af780", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 57883, "upload_time": "2018-07-18T23:09:27", "url": "https://files.pythonhosted.org/packages/49/b2/7c7a103c72c049ba6816f8bb29274b3ba5c0e4952c3e779f363940cad499/cloudgenix_config-1.0.0b2.tar.gz" } ], "1.0.0b3": [ { "comment_text": "", "digests": { "md5": "2c85798a18cdc6288fe1cb15209766a6", "sha256": "60190d181df2355eeefc58f1288606525746cc57f6ead43f7df325e5ce1cb0b5" }, "downloads": -1, "filename": "cloudgenix_config-1.0.0b3.tar.gz", "has_sig": false, "md5_digest": "2c85798a18cdc6288fe1cb15209766a6", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 58012, "upload_time": "2018-07-26T15:15:34", "url": "https://files.pythonhosted.org/packages/1c/df/240caac3397a44a494ab7173319307da81e43a3d49fc8bbfef53720e7efe/cloudgenix_config-1.0.0b3.tar.gz" } ], "1.0.0b4": [ { "comment_text": "", "digests": { "md5": "703c3d63ab6708a6ba2ed5b277bc2489", "sha256": "f41dea92a2da4233c2aa9f374e069f9ede2a6d88f047691afadf66e44feb20e8" }, "downloads": -1, "filename": "cloudgenix_config-1.0.0b4.tar.gz", "has_sig": false, "md5_digest": "703c3d63ab6708a6ba2ed5b277bc2489", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 59129, "upload_time": "2018-09-06T17:27:33", "url": "https://files.pythonhosted.org/packages/77/da/4a289c8f483a964d8681f54bf3e27166376bc2650a3bf177454a97a01701/cloudgenix_config-1.0.0b4.tar.gz" } ], "1.0.0b5": [ { "comment_text": "", "digests": { "md5": "caf387f6fe56ab3e523a8d8f22c66bd7", "sha256": "157280667a82e0ea4424d769b8f0d1cebd28cbb84fb4aded53fbfe30da425c37" }, "downloads": -1, "filename": "cloudgenix_config-1.0.0b5.tar.gz", "has_sig": false, "md5_digest": "caf387f6fe56ab3e523a8d8f22c66bd7", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 59668, "upload_time": "2018-09-06T21:57:48", "url": "https://files.pythonhosted.org/packages/bb/f8/24327eacfd9da7225e398f1f3360c20fbe5717d82701d7624e096b266c6d/cloudgenix_config-1.0.0b5.tar.gz" } ], "1.0.0b6": [ { "comment_text": "", "digests": { "md5": "ed149c9ab8440275bf9b41a83444d87d", "sha256": "277d281b9acfa773e6dc41d1a1ec07963f014c1b249215b9f3b650ddfffa4a30" }, "downloads": -1, "filename": "cloudgenix_config-1.0.0b6.tar.gz", "has_sig": false, "md5_digest": "ed149c9ab8440275bf9b41a83444d87d", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 59740, "upload_time": "2018-11-20T19:54:51", "url": "https://files.pythonhosted.org/packages/80/3c/91f50f23e8034bddb388adaa19ec02972e2c8fa464a6830f37db2c397766/cloudgenix_config-1.0.0b6.tar.gz" } ], "1.1.0b1": [ { "comment_text": "", "digests": { "md5": "5a5303b352094c170be82cd1dd17b492", "sha256": "47ecfb2497ca153c21ff11524a875366521b5ad6631f08c4a5da5b469da6a936" }, "downloads": -1, "filename": "cloudgenix_config-1.1.0b1.tar.gz", "has_sig": false, "md5_digest": "5a5303b352094c170be82cd1dd17b492", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 70275, "upload_time": "2019-03-01T19:46:47", "url": "https://files.pythonhosted.org/packages/e6/65/18f6c8a0459f9730580f8438edea6928ff2682f71569b4dd646248f67212/cloudgenix_config-1.1.0b1.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "5a5303b352094c170be82cd1dd17b492", "sha256": "47ecfb2497ca153c21ff11524a875366521b5ad6631f08c4a5da5b469da6a936" }, "downloads": -1, "filename": "cloudgenix_config-1.1.0b1.tar.gz", "has_sig": false, "md5_digest": "5a5303b352094c170be82cd1dd17b492", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 70275, "upload_time": "2019-03-01T19:46:47", "url": "https://files.pythonhosted.org/packages/e6/65/18f6c8a0459f9730580f8438edea6928ff2682f71569b4dd646248f67212/cloudgenix_config-1.1.0b1.tar.gz" } ] }