==========================
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.

See also
--------

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

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

Steps to generate Kubernetes client code for v1beta3:

* Clone the Kubernetes repo.

  git clone https://github.com/GoogleCloudPlatform/kubernetes.git

* Clone the swagger-codegen repo.

  git clone https://github.com/swagger-api/swagger-codegen.git

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

  java -jar ./swagger-codegen/modules/swagger-codegen-cli/target/swagger-codegen-cli.jar generate -i ./kubernetes/api/swagger-spec/v1beta3.json -l python -o ./KubernetesClientCode

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

==========================
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.

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 Magnum repo::

    git clone https://github.com/openstack/magnum.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

* 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 ./magnum/magnum/common/pythonk8sclient/templates/v1.json \
        -l python -o ./KubernetesClientCode

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

Update documentation for generating k8s v1 client
Update documentation for generating k8s v1 client

Partially-Implements: blueprint kubernetes-v1
Change-Id: I30e7d17ce00619c7519a7271837bb8721c65ed5f
