# Salt Extension for Kubernetes
Salt Extension for interacting with Kubernetes
## Security
If you think you've found a security vulnerability, see
[Salt's security guide][security].
## User Documentation
This README is for people aiming to contribute to the project.
If you just want to get started with the extension, check out the
module docstrings (for now, documentation is coming!).
## Contributing
The saltext-kubernetes project team welcomes contributions from the community.
The [Salt Contributing guide][salt-contributing] has a lot of relevant
information, but if you'd like to jump right in here's how to get started:
```bash
# Clone the repo
git clone --origin salt git@github.com:salt-extensions/saltext-kubernetes.git
# Change to the repo dir
cd saltext-kubernetes
# Create a new venv
python3 -m venv env --prompt saltext-kubernetes
source env/bin/activate
# On mac, you may need to upgrade pip
python -m pip install --upgrade pip
# On WSL or some flavors of linux you may need to install the `enchant`
# library in order to build the docs
sudo apt-get install -y enchant
# Install extension + test/dev/doc dependencies into your environment
python -m pip install -e '.[tests,dev,docs]'
# Run tests!
python -m nox -e tests-3
# skip requirements install for next time
export SKIP_REQUIREMENTS_INSTALL=1
# Build the docs, serve, and view in your web browser:
python -m nox -e docs && (cd docs/_build/html; python -m webbrowser localhost:8000; python -m http.server; cd -)
```
Writing code isn't the only way to contribute! We value contributions in any of
these areas:
* Documentation - especially examples of how to use this module to solve
specific problems.
* Triaging [issues][issues] and participating in [discussions][discussions]
* Reviewing [Pull Requests][PRs] (we really like
[Conventional Comments][comments]!)
You could also contribute in other ways:
* Writing blog posts
* Posting on social media about how you used Salt+Kubernetes to solve your
problems, including videos
* Giving talks at conferences
* Publishing videos
* Asking/answering questions in IRC, Slack, or email groups
Any of these things are super valuable to our community, and we sincerely
appreciate every contribution!
For more information, build the docs and head over to http://localhost:8000/ —
that's where you'll find the rest of the documentation.
[security]: https://github.com/saltstack/salt/blob/master/SECURITY.md
[salt-contributing]: https://docs.saltproject.io/en/master/topics/development/contributing.html
[issues]: https://github.com/salt-extensions/saltext-kubernetes/issues
[PRs]: https://github.com/salt-extensions/saltext-kubernetes/pulls
[discussions]: https://github.com/salt-extensions/saltext-kubernetes/discussions
[comments]: https://conventionalcomments.org/
Raw data
{
"_id": null,
"home_page": "",
"name": "saltext.kubernetes",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "",
"keywords": "salt-extension",
"author": "",
"author_email": "\"EITR Technologies, LLC\" <devops@eitr.tech>",
"download_url": "https://files.pythonhosted.org/packages/24/13/37c3f954d05fdd64ca497fc974e5c6ac9b19e9956ada9c47f95b7cc1f204/saltext.kubernetes-1.0.1.tar.gz",
"platform": "any",
"description": "# Salt Extension for Kubernetes\n\nSalt Extension for interacting with Kubernetes\n\n## Security\n\nIf you think you've found a security vulnerability, see\n[Salt's security guide][security].\n\n## User Documentation\n\nThis README is for people aiming to contribute to the project.\nIf you just want to get started with the extension, check out the\nmodule docstrings (for now, documentation is coming!).\n\n## Contributing\n\nThe saltext-kubernetes project team welcomes contributions from the community.\n\nThe [Salt Contributing guide][salt-contributing] has a lot of relevant\ninformation, but if you'd like to jump right in here's how to get started:\n\n\n```bash\n# Clone the repo\ngit clone --origin salt git@github.com:salt-extensions/saltext-kubernetes.git\n\n# Change to the repo dir\ncd saltext-kubernetes\n\n# Create a new venv\npython3 -m venv env --prompt saltext-kubernetes\nsource env/bin/activate\n\n# On mac, you may need to upgrade pip\npython -m pip install --upgrade pip\n\n# On WSL or some flavors of linux you may need to install the `enchant`\n# library in order to build the docs\nsudo apt-get install -y enchant\n\n# Install extension + test/dev/doc dependencies into your environment\npython -m pip install -e '.[tests,dev,docs]'\n\n# Run tests!\npython -m nox -e tests-3\n\n# skip requirements install for next time\nexport SKIP_REQUIREMENTS_INSTALL=1\n\n# Build the docs, serve, and view in your web browser:\npython -m nox -e docs && (cd docs/_build/html; python -m webbrowser localhost:8000; python -m http.server; cd -)\n```\n\nWriting code isn't the only way to contribute! We value contributions in any of\nthese areas:\n\n* Documentation - especially examples of how to use this module to solve\n specific problems.\n* Triaging [issues][issues] and participating in [discussions][discussions]\n* Reviewing [Pull Requests][PRs] (we really like\n [Conventional Comments][comments]!)\n\nYou could also contribute in other ways:\n\n* Writing blog posts\n* Posting on social media about how you used Salt+Kubernetes to solve your\n problems, including videos\n* Giving talks at conferences\n* Publishing videos\n* Asking/answering questions in IRC, Slack, or email groups\n\nAny of these things are super valuable to our community, and we sincerely\nappreciate every contribution!\n\n\nFor more information, build the docs and head over to http://localhost:8000/ \u2014\nthat's where you'll find the rest of the documentation.\n\n\n[security]: https://github.com/saltstack/salt/blob/master/SECURITY.md\n[salt-contributing]: https://docs.saltproject.io/en/master/topics/development/contributing.html\n[issues]: https://github.com/salt-extensions/saltext-kubernetes/issues\n[PRs]: https://github.com/salt-extensions/saltext-kubernetes/pulls\n[discussions]: https://github.com/salt-extensions/saltext-kubernetes/discussions\n[comments]: https://conventionalcomments.org/\n",
"bugtrack_url": null,
"license": "Apache Software License",
"summary": "Salt Extension for interacting with Kubernetes",
"version": "1.0.1",
"project_urls": {
"Homepage": "https://github.com/salt-extensions/saltext-kubernetes",
"Source": "https://github.com/salt-extensions/saltext-kubernetes",
"Tracker": "https://github.com/salt-extensions/saltext-kubernetes/issues"
},
"split_keywords": [
"salt-extension"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "b6d11ab71e84ae252760b2621485ae063be9bca4fd6ffef4796cd3e8af7e5aca",
"md5": "0d448f3cb4d69813c3d0199da305f410",
"sha256": "568f408fdea315f41f5a6f70b2ef3dcd7ce64a6a08124ca67d4c996e329c4056"
},
"downloads": -1,
"filename": "saltext.kubernetes-1.0.1-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "0d448f3cb4d69813c3d0199da305f410",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": ">=3.8",
"size": 30495,
"upload_time": "2023-12-29T10:43:30",
"upload_time_iso_8601": "2023-12-29T10:43:30.964321Z",
"url": "https://files.pythonhosted.org/packages/b6/d1/1ab71e84ae252760b2621485ae063be9bca4fd6ffef4796cd3e8af7e5aca/saltext.kubernetes-1.0.1-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "241337c3f954d05fdd64ca497fc974e5c6ac9b19e9956ada9c47f95b7cc1f204",
"md5": "a5eae2d7aebc25d1cbc9c33b0d18a0e5",
"sha256": "583bdb315d7ec6ddbca282280c243d24d31d88771cc7120bae7848cc51d4b07c"
},
"downloads": -1,
"filename": "saltext.kubernetes-1.0.1.tar.gz",
"has_sig": false,
"md5_digest": "a5eae2d7aebc25d1cbc9c33b0d18a0e5",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 67673,
"upload_time": "2023-12-29T10:43:32",
"upload_time_iso_8601": "2023-12-29T10:43:32.307817Z",
"url": "https://files.pythonhosted.org/packages/24/13/37c3f954d05fdd64ca497fc974e5c6ac9b19e9956ada9c47f95b7cc1f204/saltext.kubernetes-1.0.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-12-29 10:43:32",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "salt-extensions",
"github_project": "saltext-kubernetes",
"travis_ci": false,
"coveralls": true,
"github_actions": true,
"lcname": "saltext.kubernetes"
}
JSON
