Python client for the kubernetes API.
From source:
git clone --recursive https://github.com/kubernetes-client/python.git
cd python
python setup.py install
From PyPi directly:
pip install kubernetes
list all pods:
from kubernetes import client, config
# Configs can be set in Configuration class directly or using helper utility
config.load_kube_config()
v1 = client.CoreV1Api()
print("Listing pods with their IPs:")
ret = v1.list_pod_for_all_namespaces(watch=False)
for i in ret.items:
print("%s\t%s\t%s" % (i.status.pod_ip, i.metadata.namespace, i.metadata.name))watch on namespace object:
from kubernetes import client, config, watch
# Configs can be set in Configuration class directly or using helper utility
config.load_kube_config()
v1 = client.CoreV1Api()
count = 10
w = watch.Watch()
for event in w.stream(v1.list_namespace, _request_timeout=60):
print("Event: %s %s" % (event['type'], event['object'].metadata.name))
count -= 1
if not count:
w.stop()
print("Ended.")More examples can be found in examples folder. To run examples, run this command:
python -m examples.example1(replace example1 with the example base filename)
All APIs and Models' documentation can be found at the Generated client's README file
client-python follows semver, so until the major version of
client-python gets increased, your code will continue to work with explicitly
supported versions of Kubernetes clusters.
| Kubernetes 1.4 | Kubernetes 1.5 | Kubernetes 1.6 | Kubernetes 1.7 | Kubernetes 1.8 | Kubernetes 1.9 | |
|---|---|---|---|---|---|---|
| client-python 1.0 | + | ✓ | - | - | - | - |
| client-python 2.0 | + | + | ✓ | - | - | - |
| client-python 3.0 | + | + | + | ✓ | - | - |
| client-python 4.0 | + | + | + | + | ✓ | - |
| client-python 5.0 | + | + | + | + | + | ✓ |
| client-python HEAD | + | + | + | + | + | ✓ |
Key:
✓Exactly the same features / API objects in both client-python and the Kubernetes version.+client-python has features or api objects that may not be present in the Kubernetes cluster, but everything they have in common will work.-The Kubernetes cluster has features the client-python library can't use (additional API objects, etc).
See the CHANGELOG for a detailed description of changes between client-python versions.
| Client version | Canonical source for OpenAPI spec | Maintenance status |
|---|---|---|
| 1.0 Alpha/Beta | Kubernetes main repo, 1.5 branch | ✗ |
| 1.0.x | Kubernetes main repo, 1.5 branch | ✓ |
| 2.0 Alpha/Beta | Kubernetes main repo, 1.6 branch | ✗ |
| 2.0.x | Kubernetes main repo, 1.6 branch | ✓ |
| 3.0 Alpha/Beta | Kubernetes main repo, 1.7 branch | ✗ |
| 3.0 | Kubernetes main repo, 1.7 branch | ✓ |
| 4.0 Alpha/Beta | Kubernetes main repo, 1.8 branch | ✗ |
| 4.0 | Kubernetes main repo, 1.8 branch | ✓ |
| 5.0 Alpha/Beta | Kubernetes main repo, 1.9 branch | ✗ |
| 5.0 | Kubernetes main repo, 1.9 branch | ✓ |
Key:
✓Changes in main Kubernetes repo are manually (should be automated) published to client-python when they are available.✗No longer maintained; please upgrade.
Note: There would be no maintenance for alpha/beta releases except the latest one.
You can reach the maintainers of this project at SIG API Machinery. If you have any problem with the package or any suggestions, please file an issue.
Participation in the Kubernetes community is governed by the CNCF Code of Conduct.
This is a Kubernetes Incubator project.
If you get an SSLError, you likely need to update your version of python. The version that ships with macOS may not be supported.
Install the latest version of python with brew:
brew install python
Once installed, you can query the version of OpenSSL like so:
python -c "import ssl; print ssl.OPENSSL_VERSION"
You'll need a version with OpenSSL version 1.0.0 or later.
If you get an ssl.CertificateError complaining about hostname match, your installed packages does not meet version requirements.
Specifically check ipaddress and urllib3 package versions to make sure they met requirements in requirements.txt file.
Starting from 4.0 release, we do not support directly calling exec or attach calls. you should use stream module to call them. so instead
of resp = api.connect_get_namespaced_pod_exec(name, ... you should call resp = stream(api.connect_get_namespaced_pod_exec, name, ....
See more at exec example.