Generate Tekton Pipeline Python SDK

[jinchihe]

Changes

Note the PR is separate from the PR: tektoncd/pipeline#3081 you can get more from there

The PR is going to generate Tekton Pipeline Python SDK. Python SDK is very import for end user.

Design and implements:

1. Use openapi-gen to generate OpenAPI specification from Go struct definition. (The part is kept in tektoncd/pipeline repo Generate OpenAPI specification and Swagger file pipeline#3081)
2. And then generate the swagger file from the OpenAPI specification. (The part is kept in tektoncd/pipeline repo Generate OpenAPI specification and Swagger file pipeline#3081)
3. Use swagger-codegen to generate the python SDK for the python object models (basic on some Kubernetes Python models).
4. Then we need to develop some Client API such as create, update, delete to maintain Tekton objects, for this, we can use the Kubernetes CRD Python APIs.
5. Update Readme file (generated) and the docs that linked to Kubernetes Python APIs, and some manually works.
6. After finished, we can publish the SDK to Pypi so that user can easy to install and use the SDK.

See details in the generate script: https://github.com/tektoncd/experimental/blob/b0ac9b0e37a3ba850395831582c7a0f32e50b009/sdk/hack/README.md

Examples:

from tekton import TektonClient
from tekton import V1beta1TaskRun
from tekton import V1beta1TaskRunSpec
from tekton import V1beta1TaskSpec
from tekton import V1beta1Step
from kubernetes import client

taskrun = V1beta1TaskRun(
    api_version='tekton.dev/v1beta1',
    kind='TaskRun',
    metadata=client.V1ObjectMeta(name='sdk-sample-taskrun'),
    spec=V1beta1TaskRunSpec(
        task_spec=V1beta1TaskSpec(
            steps=[V1beta1Step(name='default',
                            image='ubuntu',
                            script='sleep 30;echo "This is a sdk demo.')]
        )))

tekton_client = TektonClient()
tekton_client.create(taskrun, namespace='default')

See detailed examples of taskrun here: https://github.com/tektoncd/experimental/blob/7f25f4c46dc6f30548cde7089e1c7c180e482311/sdk/python/examples/taskrun.ipynb

See detailed Readme and related docs in the PR: https://github.com/tektoncd/experimental/blob/7f25f4c46dc6f30548cde7089e1c7c180e482311/sdk/python/README.md

What's the next:

This is a init SDK generation, lots of things need to do, such as make more Client APIs manually, in this PR, I just finish basic apis... Thanks.

Submitter Checklist

These are the criteria that every PR should meet, please check them off as you
review them:

• Includes docs (if user facing)
• Commit messages follow commit message best practices

See the contribution guide
for more details.

[tekton-robot]

Hi @jinchihe. Thanks for your PR.

I'm waiting for a tektoncd member to verify that this patch is reasonable to test. If it is, they should reply with /ok-to-test on its own line. Until that is done, I will not automatically test new commits in this PR, but the usual testing commands by org members will still work. Regular contributors should join the org to skip this step.

Once the patch is verified, the new status will be reflected by the ok-to-test label.

I understand the commands that are listed here.

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes/test-infra repository.

[jinchihe]

Hey Reviewers, the PR is ready for review now. Thanks.

/cc @vdemeester

[jinchihe]

@vdemeester Any more comments? I think that's ready. Thanks.

[vincent-pli]

/ok-to-test

[afrittoli]

Thank you for this!
I think the first should be to merge it in, and we can then take it from there.
If you are part of the tekton org, you may want to add yourself and OWNER to this folder.
/approve

[vdemeester]

/lgtm

[afrittoli]

/approve

[tekton-robot]

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: afrittoli

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Needs approval from an approver in each of these files:

• OWNERS [afrittoli]

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

[vdemeester]

/test pull-tekton-experimental-build-tests

[afrittoli]

/restest

[jinchihe]

I will take a look the CI issue and fix that ASAP . Thanks.

[jinchihe]

Seems the CI test is passed now. Thanks!

[vincent-pli]

/lgtm