Pipelines: No method to upload pipeline version using python sdk

[jonasdebeukelaer]

What steps did you take:

tried to write a python script to upload a new pipeline version.

What happened:

could not find the client method to do so. It seems to have been removed since the below docs were written. https://www.kubeflow.org/docs/pipelines/tutorials/sdk-examples/#example-1-creating-a-pipeline-and-a-pipeline-version-using-the-sdk

What did you expect to happen:

have an method called upload_pipeline_version or similar.

Environment:

How did you deploy Kubeflow Pipelines (KFP)?
via KF

KFP version: 1.0.1
KFP SDK version: 1.0.1

Anything else you would like to add:

/kind bug
/area sdk

[Ark-kun]

The method exists:
https://github.com/kubeflow/pipelines/blame/master/sdk/python/kfp/_client.py#L846
https://kubeflow-pipelines.readthedocs.io/en/latest/source/kfp.client.html#kfp.Client.upload_pipeline_version

I think the problem is that the released version of the SDK uses a really old version. https://github.com/kubeflow/pipelines/issues/4409

[Bobgy]

That's right, https://kubeflow-pipelines.readthedocs.io/en/latest/source/kfp.client.html#kfp.Client.upload_pipeline_version shows master branch, but we released from release-1.0 branch. The method did not get into 1.0 release

[ConverJens]

@Bobgy I think the issue is that if you create a kfp.Client() object, that object has no upload_pipeline_version method. It is only accessible through kfp.Client()._upload_api.upload_pipeline_version which is slightly obscure.

[Bobgy]

Yes, that's right. The feature will be released with 1.1.0-alpha.1.

[paveldournov]

@Bobgy I think the issue is that if you create a kfp.Client() object, that object has no upload_pipeline_version method. It is only accessible through kfp.Client()._upload_api.upload_pipeline_version which is slightly obscure.

Can we add this to the documentation? The doc doesn't say it is requires the additional indirection.

[Bobgy]

@paveldournov, @Ark-kun has updated the doc website: https://kubeflow-pipelines.readthedocs.io to show stable version by default now (instead of latest previously). So it should not show the method to users before its released.

Regarding to using _upload_api, I'll need to double check when releasing 1.1.0, if the method is not available through upload_pipeline_version, then it's a bug we need to fix. Rather than a documentation issue.