File: README.rst

package info (click to toggle)
python-k8sclient 0.3.0-4
  • links: PTS, VCS
  • area: main
  • in suites: bookworm, bullseye
  • size: 4,744 kB
  • sloc: python: 29,618; sh: 88; makefile: 13
file content (60 lines) | stat: -rw-r--r-- 1,981 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
=============================================
python-k8sclient - Kubernetes API client code
=============================================

Overview
--------

This is Kubernetes API python client code. This code is generated by
swagger-codegen. Kubernetes provide swagger-spec to generate client code for
different versions. The specs live in Kubernetes repo.

* Free software: Apache license
* Documentation: http://docs.openstack.org/developer/python-k8sclient
* Source: http://git.openstack.org/cgit/openstack/python-k8sclient
* Bugs: http://bugs.launchpad.net/python-k8sclient

See also
--------

* swagger-codegen: https://github.com/swagger-api/swagger-codegen
* Kubernetes swagger-spec: https://github.com/GoogleCloudPlatform/kubernetes/tree/master/api/swagger-spec

Prerequisites
-------------

You need to install required packages for swagger codegen. Please refer to
`<https://github.com/swagger-api/swagger-codegen#prerequisites>`_

Steps to generate API client code
---------------------------------

Steps to generate Kubernetes client code for v1:

* Clone the python-k8sclient repo::

    git clone https://github.com/openstack/python-k8sclient.git

* Clone the swagger-codegen repo. It is recommended to checkout a release
 (e.g. v2.1.3) instead of using the master branch::

    git clone https://github.com/swagger-api/swagger-codegen.git
    cd swagger-codegen/
    git checkout tags/v2.1.3

* Build swagger-codegen::

    mvn package

* Update the v1.json from latest Kubernetes release::
  curl -o ./k8sclient/templates/v1.json https://raw.githubusercontent.com/kubernetes/kubernetes/v1.2.2/api/swagger-spec/v1.json

* Run below command to generate the API client code for Kubernetes::

    cd ..
    java -jar ./swagger-codegen/modules/swagger-codegen-cli/target/swagger-codegen-cli.jar \
        generate \
        -i ./k8sclient/templates/v1.json \
        -l python -o ./KubernetesClientCode

Now you can check the code at location ./KubernetesClientCode.