openshift / api

Canonical location of the OpenShift API definition.
http://www.openshift.org
Apache License 2.0
94 stars 517 forks source link

OPRUN-3402: :warning: Bump OLM API to v1 #2061

Closed perdasilva closed 2 weeks ago

perdasilva commented 1 month ago

Next PR: #2066

openshift-ci[bot] commented 1 month ago

Hello @perdasilva! Some important instructions when contributing to openshift/api: API design plays an important part in the user experience of OpenShift and as such API PRs are subject to a high level of scrutiny to ensure they follow our best practices. If you haven't already done so, please review the OpenShift API Conventions and ensure that your proposed changes are compliant. Following these conventions will help expedite the api review process for your PR.

perdasilva commented 1 month ago

verify-crd-schema is failing because observedGeneration is not in OperatorCondition. We've reached out on the #forum-api-review to see if this is something we should override. slack thread

JoelSpeed commented 1 month ago

@perdasilva You need to ensure your project is checked out under an appropriate $GOPATH or, not run the protobuf generator

Looking at the PR, I think protobuf generation is not required, so perhaps revert all the proto related changes and run the updates with PROTO_OPTIONAL=1

perdasilva commented 1 month ago

Thanks @JoelSpeed ^^ I just saw the message on the api forum XD - should be fixed up now (I hope)

perdasilva commented 1 month ago

/retest

perdasilva commented 1 month ago

/retest

perdasilva commented 1 month ago

/retest

openshift-ci-robot commented 1 month ago

@perdasilva: This pull request references OPRUN-3402 which is a valid jira issue.

Warning: The referenced jira issue has an invalid target version for the target branch this PR targets: expected the spike to target the "4.18.0" version, but no target version was set.

In response to [this](https://github.com/openshift/api/pull/2061): > Instructions for interacting with me using PR comments are available [here](https://prow.ci.openshift.org/command-help?repo=openshift%2Fapi). If you have questions or suggestions related to my behavior, please file an issue against the [openshift-eng/jira-lifecycle-plugin](https://github.com/openshift-eng/jira-lifecycle-plugin/issues/new) repository.
openshift-ci-robot commented 1 month ago

@perdasilva: This pull request references OPRUN-3402 which is a valid jira issue.

Warning: The referenced jira issue has an invalid target version for the target branch this PR targets: expected the spike to target the "4.18.0" version, but no target version was set.

In response to [this](https://github.com/openshift/api/pull/2061): >* Promotes operator/v1alpha1 OLM to operator/v1 OLM >* Removes operator/v1alpha1 OLM Instructions for interacting with me using PR comments are available [here](https://prow.ci.openshift.org/command-help?repo=openshift%2Fapi). If you have questions or suggestions related to my behavior, please file an issue against the [openshift-eng/jira-lifecycle-plugin](https://github.com/openshift-eng/jira-lifecycle-plugin/issues/new) repository.
openshift-ci-robot commented 1 month ago

@perdasilva: This pull request references OPRUN-3402 which is a valid jira issue.

Warning: The referenced jira issue has an invalid target version for the target branch this PR targets: expected the spike to target the "4.18.0" version, but no target version was set.

In response to [this](https://github.com/openshift/api/pull/2061): >* Promotes operator/v1alpha1 OLM to operator/v1 OLM >* Removes operator/v1alpha1 OLM > >Next PR: #2066 Instructions for interacting with me using PR comments are available [here](https://prow.ci.openshift.org/command-help?repo=openshift%2Fapi). If you have questions or suggestions related to my behavior, please file an issue against the [openshift-eng/jira-lifecycle-plugin](https://github.com/openshift-eng/jira-lifecycle-plugin/issues/new) repository.
perdasilva commented 1 month ago

/jira refresh

openshift-ci-robot commented 1 month ago

@perdasilva: This pull request references OPRUN-3402 which is a valid jira issue.

Warning: The referenced jira issue has an invalid target version for the target branch this PR targets: expected the task to target the "4.18.0" version, but no target version was set.

In response to [this](https://github.com/openshift/api/pull/2061#issuecomment-2425938589): >/jira refresh > Instructions for interacting with me using PR comments are available [here](https://prow.ci.openshift.org/command-help?repo=openshift%2Fapi). If you have questions or suggestions related to my behavior, please file an issue against the [openshift-eng/jira-lifecycle-plugin](https://github.com/openshift-eng/jira-lifecycle-plugin/issues/new) repository.
perdasilva commented 1 month ago

@JoelSpeed This should be ready for review ^^

The failure in verify-crd-schema is:

    could not run schemacheck generator for group/version operator.openshift.io/v1: 
        error in operator/v1/zz_generated.crd-manifests/0000_10_operator-lifecycle-manager_01_olms.crd.yaml: ConditionsMustHaveProperSSATags: crd/olms.operator.openshift.io version/v1 field/^.status.condition must define valid condition properties: observedGeneration attribute is missing
        error in operator/v1/zz_generated.featuregated-crd-manifests/olms.operator.openshift.io/AAA_ungated.yaml: ConditionsMustHaveProperSSATags: crd/olms.operator.openshift.io version/v1 field/^.status.condition must define valid condition properties: observedGeneration attribute is missing
+ echo This verifier checks all files that have changed. In some cases you may have changed or renamed a file that already contained api violations, but you are not introducing a new violation. In such cases it is appropriate to /override the failing CI job.
This verifier checks all files that have changed. In some cases you may have changed or renamed a file that already contained api violations, but you are not introducing a new violation. In such cases it is appropriate to /override the failing CI job. 

as discussed here, it should be ok to override.

(cc @joelanford)

JoelSpeed commented 3 weeks ago

When bumping an API from v1alpha1 to v1, we must keep the old types around for some time. We need to be able to generate clients for both v1alpha1 and v1 simultaneously to allow users to build tooling versions that might span both GA and pre-GA

Please restore the v1alpha1 versions, and then I'll review the v1 API again to see if there's anything we might need to update prior to GA

openshift-ci-robot commented 3 weeks ago

@perdasilva: This pull request references OPRUN-3402 which is a valid jira issue.

Warning: The referenced jira issue has an invalid target version for the target branch this PR targets: expected the task to target the "4.18.0" version, but no target version was set.

In response to [this](https://github.com/openshift/api/pull/2061): >* Promotes operator/v1alpha1 OLM to operator/v1 OLM > >Next PR: #2066 Instructions for interacting with me using PR comments are available [here](https://prow.ci.openshift.org/command-help?repo=openshift%2Fapi). If you have questions or suggestions related to my behavior, please file an issue against the [openshift-eng/jira-lifecycle-plugin](https://github.com/openshift-eng/jira-lifecycle-plugin/issues/new) repository.
perdasilva commented 3 weeks ago

When bumping an API from v1alpha1 to v1, we must keep the old types around for some time. We need to be able to generate clients for both v1alpha1 and v1 simultaneously to allow users to build tooling versions that might span both GA and pre-GA

Please restore the v1alpha1 versions, and then I'll review the v1 API again to see if there's anything we might need to update prior to GA

@JoelSpeed Thanks for clarifying that. We really weren't sure if it would be ok given the support requirements, but didn't factor in other technical considerations. I've gone ahead and restored v1alpha1.

perdasilva commented 3 weeks ago

/jira refresh

openshift-ci-robot commented 3 weeks ago

@perdasilva: This pull request references OPRUN-3402 which is a valid jira issue.

In response to [this](https://github.com/openshift/api/pull/2061#issuecomment-2446188653): >/jira refresh Instructions for interacting with me using PR comments are available [here](https://prow.ci.openshift.org/command-help?repo=openshift%2Fapi). If you have questions or suggestions related to my behavior, please file an issue against the [openshift-eng/jira-lifecycle-plugin](https://github.com/openshift-eng/jira-lifecycle-plugin/issues/new) repository.
JoelSpeed commented 3 weeks ago

Is there a related feature gate that also needs to be promoted?

What is the path to GA for this feature?

Do we have enough time to complete the path to GA prior to branch cutting?

JoelSpeed commented 2 weeks ago

/lgtm

/override ci/prow/verify-crd-schema

Existing failures about observed generation cannot be resolved now

openshift-ci[bot] commented 2 weeks ago

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: JoelSpeed, perdasilva

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](https://github.com/openshift/api/blob/master/OWNERS)~~ [JoelSpeed] Approvers can indicate their approval by writing `/approve` in a comment Approvers can cancel approval by writing `/approve cancel` in a comment
openshift-ci[bot] commented 2 weeks ago

@JoelSpeed: Overrode contexts on behalf of JoelSpeed: ci/prow/verify-crd-schema

In response to [this](https://github.com/openshift/api/pull/2061#issuecomment-2462577996): >/lgtm > >/override ci/prow/verify-crd-schema > >Existing failures about observed generation cannot be resolved now Instructions for interacting with me using PR comments are available [here](https://git.k8s.io/community/contributors/guide/pull-requests.md). If you have questions or suggestions related to my behavior, please file an issue against the [kubernetes-sigs/prow](https://github.com/kubernetes-sigs/prow/issues/new?title=Prow%20issue:) repository.
openshift-ci[bot] commented 2 weeks ago

@perdasilva: all tests passed!

Full PR test history. Your PR dashboard.

Instructions for interacting with me using PR comments are available [here](https://git.k8s.io/community/contributors/guide/pull-requests.md). If you have questions or suggestions related to my behavior, please file an issue against the [kubernetes-sigs/prow](https://github.com/kubernetes-sigs/prow/issues/new?title=Prow%20issue:) repository. I understand the commands that are listed [here](https://go.k8s.io/bot-commands).
openshift-bot commented 2 weeks ago

[ART PR BUILD NOTIFIER]

Distgit: ose-cluster-config-api This PR has been included in build ose-cluster-config-api-container-v4.18.0-202411071810.p0.gd37bb9f.assembly.stream.el9. All builds following this will include this PR.