sovereign
=========
Mission statement
-----------------
This project implements a JSON control-plane based on the [envoy](https://envoyproxy.io) [data-plane-api](https://github.com/envoyproxy/data-plane-api)
The purpose of `sovereign` is to supply downstream envoy proxies with dynamic configuration.
Mechanism of Operation
----------------------
Sovereign allows you to define templates that represent each resource type
provided by Envoy. For example, clusters, routes, listeners, secrets,
extension_configs, etc.
In order to enrich the templates with data, Sovereign has ways of polling data
out-of-band which it then includes as variables that can be accessed within the
templates.
This allows Sovereign to provide configuration to Envoy that changes over time
depending on the data sources, without needing to redeploy the control-plane.
Sovereign provides some built-in ways of polling data (such as over HTTP, or
on-disk) but also exposes extension points, allowing you to write your own
plugins in Python.
Support
------------
[Submit new issues here](https://bitbucket.org/atlassian/sovereign/issues/new)
If you're unable to submit an issue on Bitbucket, send an email to [vsyrakis@atlassian.com](mailto:vsyrakis@atlassian.com)
Release
------------
See [RELEASE.md]
Roadmap
------------
* Performance improvements
* Data persistence
* Push API (versus polling)
* Client for Sovereign
* gRPC
Requirements
------------
* Python 3.8+
Installation
------------
```
pip install sovereign
```
Documentation
-------------
[Read the docs here!](https://developer.atlassian.com/platform/sovereign/)
Local development
=================
Requirements
------------
* Poetry
* Docker
* Docker-compose
Installing dependencies for dev
-------------------------------
Dependencies and creation of virtualenv is handled by poetry
```
poetry install
poetry shell
```
Running locally
---------------
Running the test env
```
make run
```
Running the test env daemonized
```
make run-daemon
```
Pylint
```
make lint
```
Unit tests
```
make unit
```
Acceptance tests
```
make run-daemon acceptance
```
Contributors
============
Pull requests, issues and comments welcome. For pull requests:
* Add tests for new features and bug fixes
* Follow the existing style
* Separate unrelated changes into multiple pull requests
See the existing issues for things to start contributing.
For bigger changes, make sure you start a discussion first by creating
an issue and explaining the intended change.
Atlassian requires contributors to sign a Contributor License Agreement,
known as a CLA. This serves as a record stating that the contributor is
entitled to contribute the code/documentation/translation to the project
and is willing to have it used in distributions and derivative works
(or is willing to transfer ownership).
Prior to accepting your contributions we ask that you please follow the appropriate
link below to digitally sign the CLA. The Corporate CLA is for those who are
contributing as a member of an organization and the individual CLA is for
those contributing as an individual.
* [CLA for corporate contributors](https://na2.docusign.net/Member/PowerFormSigning.aspx?PowerFormId=e1c17c66-ca4d-4aab-a953-2c231af4a20b)
* [CLA for individuals](https://na2.docusign.net/Member/PowerFormSigning.aspx?PowerFormId=3f94fbdc-2fbe-46ac-b14c-5d152700ae5d)
License
========
Copyright (c) 2018 Atlassian and others.
Apache 2.0 licensed, see [LICENSE.txt](LICENSE.txt) file.
Raw data
{
"_id": null,
"home_page": "https://pypi.org/project/sovereign/",
"name": "sovereign",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.11",
"maintainer_email": null,
"keywords": "envoy, envoyproxy, control-plane, management, server",
"author": "Vasili Syrakis",
"author_email": "vsyrakis@atlassian.com",
"download_url": "https://files.pythonhosted.org/packages/bb/fa/05a741d230aebd7d1a8f365054411be6689a54b78e78078fafb95e82f8ff/sovereign-0.30.0.tar.gz",
"platform": null,
"description": "sovereign\n=========\n\n\nMission statement\n-----------------\nThis project implements a JSON control-plane based on the [envoy](https://envoyproxy.io) [data-plane-api](https://github.com/envoyproxy/data-plane-api)\n\nThe purpose of `sovereign` is to supply downstream envoy proxies with dynamic configuration.\n\n\nMechanism of Operation\n----------------------\nSovereign allows you to define templates that represent each resource type\nprovided by Envoy. For example, clusters, routes, listeners, secrets,\nextension_configs, etc.\n\nIn order to enrich the templates with data, Sovereign has ways of polling data\nout-of-band which it then includes as variables that can be accessed within the\ntemplates.\n\nThis allows Sovereign to provide configuration to Envoy that changes over time\ndepending on the data sources, without needing to redeploy the control-plane.\n\nSovereign provides some built-in ways of polling data (such as over HTTP, or\non-disk) but also exposes extension points, allowing you to write your own\nplugins in Python.\n\n\nSupport\n------------\n[Submit new issues here](https://bitbucket.org/atlassian/sovereign/issues/new)\n\nIf you're unable to submit an issue on Bitbucket, send an email to [vsyrakis@atlassian.com](mailto:vsyrakis@atlassian.com)\n\n\nRelease\n------------\nSee [RELEASE.md]\n\n\nRoadmap\n------------\n* Performance improvements\n* Data persistence\n* Push API (versus polling)\n* Client for Sovereign\n* gRPC\n\n\nRequirements\n------------\n* Python 3.8+\n\n\nInstallation\n------------\n```\npip install sovereign\n```\n\nDocumentation\n-------------\n[Read the docs here!](https://developer.atlassian.com/platform/sovereign/)\n\n\n\nLocal development\n=================\n\n\nRequirements\n------------\n* Poetry\n* Docker\n* Docker-compose\n\n\nInstalling dependencies for dev\n-------------------------------\nDependencies and creation of virtualenv is handled by poetry\n```\npoetry install\npoetry shell\n```\n\nRunning locally\n---------------\nRunning the test env\n```\nmake run\n```\n \nRunning the test env daemonized\n```\nmake run-daemon\n```\n\nPylint\n```\nmake lint\n```\n\nUnit tests\n```\nmake unit\n```\n\nAcceptance tests\n```\nmake run-daemon acceptance\n```\n\n\nContributors\n============\nPull requests, issues and comments welcome. For pull requests:\n\n* Add tests for new features and bug fixes\n* Follow the existing style\n* Separate unrelated changes into multiple pull requests\n\nSee the existing issues for things to start contributing.\n\nFor bigger changes, make sure you start a discussion first by creating\nan issue and explaining the intended change.\n\nAtlassian requires contributors to sign a Contributor License Agreement,\nknown as a CLA. This serves as a record stating that the contributor is\nentitled to contribute the code/documentation/translation to the project\nand is willing to have it used in distributions and derivative works\n(or is willing to transfer ownership).\n\nPrior to accepting your contributions we ask that you please follow the appropriate\nlink below to digitally sign the CLA. The Corporate CLA is for those who are\ncontributing as a member of an organization and the individual CLA is for\nthose contributing as an individual.\n\n* [CLA for corporate contributors](https://na2.docusign.net/Member/PowerFormSigning.aspx?PowerFormId=e1c17c66-ca4d-4aab-a953-2c231af4a20b)\n* [CLA for individuals](https://na2.docusign.net/Member/PowerFormSigning.aspx?PowerFormId=3f94fbdc-2fbe-46ac-b14c-5d152700ae5d)\n\n\nLicense\n========\nCopyright (c) 2018 Atlassian and others.\nApache 2.0 licensed, see [LICENSE.txt](LICENSE.txt) file.\n\n\n",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "Envoy Proxy control-plane written in Python",
"version": "0.30.0",
"project_urls": {
"Documentation": "https://developer.atlassian.com/platform/sovereign/",
"Homepage": "https://pypi.org/project/sovereign/",
"Repository": "https://bitbucket.org/atlassian/sovereign/src/master/"
},
"split_keywords": [
"envoy",
" envoyproxy",
" control-plane",
" management",
" server"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "f06213dd781d44ad5d93d6071a41ee321aa882b60851322cfd469e3b458f4748",
"md5": "9e21846b818dce86f6fa352c66ce2c89",
"sha256": "ee59c0d38096abeaeabd346f25d491b380dbf8c3f8d2239c69fb0df32a838bd9"
},
"downloads": -1,
"filename": "sovereign-0.30.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "9e21846b818dce86f6fa352c66ce2c89",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.11",
"size": 114845,
"upload_time": "2025-01-08T22:43:29",
"upload_time_iso_8601": "2025-01-08T22:43:29.033488Z",
"url": "https://files.pythonhosted.org/packages/f0/62/13dd781d44ad5d93d6071a41ee321aa882b60851322cfd469e3b458f4748/sovereign-0.30.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "bbfa05a741d230aebd7d1a8f365054411be6689a54b78e78078fafb95e82f8ff",
"md5": "87581d7e27ea5c6bab096d2436241d18",
"sha256": "1e30135b51eda2ebdd3aab16dfe35d5337a06d51187e7a7011361283c57ce80d"
},
"downloads": -1,
"filename": "sovereign-0.30.0.tar.gz",
"has_sig": false,
"md5_digest": "87581d7e27ea5c6bab096d2436241d18",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.11",
"size": 99099,
"upload_time": "2025-01-08T22:43:30",
"upload_time_iso_8601": "2025-01-08T22:43:30.431080Z",
"url": "https://files.pythonhosted.org/packages/bb/fa/05a741d230aebd7d1a8f365054411be6689a54b78e78078fafb95e82f8ff/sovereign-0.30.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-01-08 22:43:30",
"github": false,
"gitlab": false,
"bitbucket": true,
"codeberg": false,
"bitbucket_user": "atlassian",
"bitbucket_project": "sovereign",
"lcname": "sovereign"
}
JSON