Zalando Kubectl
Description
Kubernetes CLI (kubectl) wrapper in Python with OAuth token authentication.
This wrapper script zkubectl serves as a drop-in replacement for the
kubectl binary:
- it downloads the current
kubectlbinary from Google - it generates a new
~/.kube/configwith an OAuth Bearer token acquired via zign. - it passes through commands to the
kubectlbinary
User Facing documentation
- https://cloud.docs.zalando.net/reference/zkubectl/
- https://cloud.docs.zalando.net/howtos/install-tools/
Contribute
Setup project
- It's recommended to use uv for the project.
Go to the project dir and install dependencies with uv
$ cd <project-path>
$ uv sync
- [Optional] install pre-commit hooks
$ pre-commit install
- [Optional] The project uses ruff for code formatting, configure your editor to use it.
Unit Tests
Run unit tests with Docker:
docker build --build-arg PYTHON_VERSION=3.10 --build-arg PACKAGE_NAME=zalando_kubectl -f Dockerfile.test .
docker build --build-arg PYTHON_VERSION=3.11 --build-arg PACKAGE_NAME=zalando_kubectl -f Dockerfile.test .
docker build --build-arg PYTHON_VERSION=3.12 --build-arg PACKAGE_NAME=zalando_kubectl --build-arg DEBIAN_DISTRO=bullseye -f Dockerfile.test .
docker build --build-arg PYTHON_VERSION=3.13 --build-arg PACKAGE_NAME=zalando_kubectl --build-arg DEBIAN_DISTRO=bullseye -f Dockerfile.test .
Run Locally
via uv
$ uv run zkubectl
Or first activate the virtualenv
$ source .venv/bin/activate
$ zkubectl login playground
Use as kubectl plugin
The project exposes scripts that use the kubectl plugin format
You can see which ones are available in the scripts section of pyproject.toml
In order for kubectl to detect the subcommands provided by the script, they must be in the PATH, so you need first to activate the virtualenv
$ source .venv/bin/activate
$ kubectl login playground
2 maintainers
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file zalando_kubectl-1.36.3.422.tar.gz.
File metadata
- Download URL: zalando_kubectl-1.36.3.422.tar.gz
- Upload date:
- Size: 50.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.11.33 {"installer":{"name":"uv","version":"0.11.33","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
0cfd0e2001609efa42fc01262099fa47ed138d3958bf4b907832a14b3f8f87eb
|
|
| MD5 |
7c33f2ac3ef06dbd2fa5a9b306054f4d
|
|
| BLAKE2b-256 |
a4158b365374f1d7c0b95a7c5a7bb030d232ca331d284ddede75fdd3d7f2596e
|
File details
Details for the file zalando_kubectl-1.36.3.422-py3-none-any.whl.
File metadata
- Download URL: zalando_kubectl-1.36.3.422-py3-none-any.whl
- Upload date:
- Size: 51.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.11.33 {"installer":{"name":"uv","version":"0.11.33","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
6d10f4fcdb463c1dc2c49a1b9cd9ada700ec7c4f464a5bd39d19ebe6c298fddc
|
|
| MD5 |
8f5893173aa97c24a4d5ae7d0bd75954
|
|
| BLAKE2b-256 |
2c51b7d2e5eee2737aa2e8f8e9e78c9bb0fa38c6eb8364ea6338a09864510b3d
|
