pypz-k8s-deployer


Namepypz-k8s-deployer JSON
Version 0.9.1 PyPI version JSON
download
home_pageNone
SummaryThis package provides the Kubernetes implementation of the deployer interface for pypz.
upload_time2024-04-18 05:49:13
maintainerNone
docs_urlNone
authorNone
requires_python>=3.11
licenseApache-2.0
keywords pypz k8s kubernetes deployer
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # Description

This package contains the Kubernetes implementation of the deployer interface
of *pypz*. It enables the deployment of the pipelines to a Kubernetes cluster.

Check the [documentation](https://lazlowa.github.io/pypz-python/deployers/kubernetes.html) for
more details.

# Install

The python artifact is hosted on https://pypi.org/, so you can install
it via pip:

```shell
pip install pypz-k8s-deployer
```

If you want to work on it locally, then you should install in editable mode:

```shell
pip install -e ./deployers/k8s
```

# Test

You can run tests against an existing Kubernetes cluster, however, it is
more convenient and safe to use [Kind](https://kind.sigs.k8s.io/) for this
purpose. 

1. Follow the instructions to install Kind. Note that Kind prepares the
required config file **~/.kube/config**. If you work with your own cluster,
make sure, you have this file already in place.
2. Install the subproject in editable more.
```shell
pip install -e ./deployers/k8s
```
3. Start the cluster
```shell
kind create cluster
```
4. Build the test images (test/resources)
```shell
docker build -t pypz-test-image .
```
5. Load the test image onto the Kind node
```shell
kind load docker-image pypz-test-image
```
6. To run the tests locally, you need to execute the following command:
```shell
python -m unittest discover .\deployers\k8s\test\ -p "*.py"
```
7. Delete cluster
```shell
kind delete cluster
```

# Build

Before you build, you will need to install the "build" package:

```shell
pip install build
```

Then from the subproject's root, you will need to execute the following command:

```shell
python -m build
```

It will create the source distribution and the wheel file in the "dist" folder.

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "pypz-k8s-deployer",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.11",
    "maintainer_email": null,
    "keywords": "pypz, k8s, kubernetes, deployer",
    "author": null,
    "author_email": "Laszlo Anka <laszlo.anka@gmail.com>",
    "download_url": "https://files.pythonhosted.org/packages/45/2d/1984238d0fd13951d7871986f4c3a5307a3fdc23c8703acbb55aa089942e/pypz_k8s_deployer-0.9.1.tar.gz",
    "platform": null,
    "description": "# Description\n\nThis package contains the Kubernetes implementation of the deployer interface\nof *pypz*. It enables the deployment of the pipelines to a Kubernetes cluster.\n\nCheck the [documentation](https://lazlowa.github.io/pypz-python/deployers/kubernetes.html) for\nmore details.\n\n# Install\n\nThe python artifact is hosted on https://pypi.org/, so you can install\nit via pip:\n\n```shell\npip install pypz-k8s-deployer\n```\n\nIf you want to work on it locally, then you should install in editable mode:\n\n```shell\npip install -e ./deployers/k8s\n```\n\n# Test\n\nYou can run tests against an existing Kubernetes cluster, however, it is\nmore convenient and safe to use [Kind](https://kind.sigs.k8s.io/) for this\npurpose. \n\n1. Follow the instructions to install Kind. Note that Kind prepares the\nrequired config file **~/.kube/config**. If you work with your own cluster,\nmake sure, you have this file already in place.\n2. Install the subproject in editable more.\n```shell\npip install -e ./deployers/k8s\n```\n3. Start the cluster\n```shell\nkind create cluster\n```\n4. Build the test images (test/resources)\n```shell\ndocker build -t pypz-test-image .\n```\n5. Load the test image onto the Kind node\n```shell\nkind load docker-image pypz-test-image\n```\n6. To run the tests locally, you need to execute the following command:\n```shell\npython -m unittest discover .\\deployers\\k8s\\test\\ -p \"*.py\"\n```\n7. Delete cluster\n```shell\nkind delete cluster\n```\n\n# Build\n\nBefore you build, you will need to install the \"build\" package:\n\n```shell\npip install build\n```\n\nThen from the subproject's root, you will need to execute the following command:\n\n```shell\npython -m build\n```\n\nIt will create the source distribution and the wheel file in the \"dist\" folder.\n",
    "bugtrack_url": null,
    "license": "Apache-2.0",
    "summary": "This package provides the Kubernetes implementation of the deployer interface for pypz.",
    "version": "0.9.1",
    "project_urls": null,
    "split_keywords": [
        "pypz",
        " k8s",
        " kubernetes",
        " deployer"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "d37b081f4e5e52eacc7aac02efbcdb8829d95b75ee3deafeb2f965c0395040be",
                "md5": "01fae8de82ea5928d27c5e23a5aa498f",
                "sha256": "0ce789048186e04b9134d607e9da8d6efa208a94610779c955313b856c0efd7c"
            },
            "downloads": -1,
            "filename": "pypz_k8s_deployer-0.9.1-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "01fae8de82ea5928d27c5e23a5aa498f",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.11",
            "size": 10919,
            "upload_time": "2024-04-18T05:49:11",
            "upload_time_iso_8601": "2024-04-18T05:49:11.421091Z",
            "url": "https://files.pythonhosted.org/packages/d3/7b/081f4e5e52eacc7aac02efbcdb8829d95b75ee3deafeb2f965c0395040be/pypz_k8s_deployer-0.9.1-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "452d1984238d0fd13951d7871986f4c3a5307a3fdc23c8703acbb55aa089942e",
                "md5": "be752649fdd67b91cc9bf4e272f9f2b2",
                "sha256": "03685828eb7b764248ae31b0d86edb7309f7be165df75c52cfc63198334e3b6b"
            },
            "downloads": -1,
            "filename": "pypz_k8s_deployer-0.9.1.tar.gz",
            "has_sig": false,
            "md5_digest": "be752649fdd67b91cc9bf4e272f9f2b2",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.11",
            "size": 11446,
            "upload_time": "2024-04-18T05:49:13",
            "upload_time_iso_8601": "2024-04-18T05:49:13.043541Z",
            "url": "https://files.pythonhosted.org/packages/45/2d/1984238d0fd13951d7871986f4c3a5307a3fdc23c8703acbb55aa089942e/pypz_k8s_deployer-0.9.1.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-04-18 05:49:13",
    "github": false,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "lcname": "pypz-k8s-deployer"
}
        
Elapsed time: 0.24717s