Note: This bug is displayed in read-only format because the product is no longer active in Red Hat Bugzilla.

Bug 1705748

Summary: Missing openapi CRD definitions for oc explain to work
Product: OpenShift Container Platform Reporter: Maciej Szulik <maszulik>
Component: Cloud ComputeAssignee: Jan Chaloupka <jchaloup>
Status: CLOSED ERRATA QA Contact: Jianwei Hou <jhou>
Severity: unspecified Docs Contact:
Priority: unspecified    
Version: 4.1.0CC: agarcial, rvokal, sponnaga, zhsun
Target Milestone: ---   
Target Release: 4.2.0   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2019-10-16 06:28:30 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:

Description Maciej Szulik 2019-05-02 21:03:05 UTC
The following PR https://github.com/openshift/origin/pull/22696 introduced an e2e which is verifying that all the operators provide descriptive information as part of their schema which is then available through oc explain command. 

Your component has a few missing bits, see the commented out lines from the PR.

This should be fixed similarly to https://github.com/openshift/cluster-version-operator/pull/168 and then update origin's e2e test and uncomment the lines from your components.

Comment 1 Jan Chaloupka 2019-05-03 08:14:50 UTC
Two CRDs in question:

- schema.GroupVersionResource{Group: "healthchecking.openshift.io", Version: "v1", Resource: "machinehealthchecks"},
- schema.GroupVersionResource{Group: "autoscaling.openshift.io", Version: "v1", Resource: "machineautoscalers"},

Comment 2 Maciej Szulik 2019-05-03 20:14:14 UTC
This is not 4.1 blocker, but it needs to be fixed as part of 4.1.x since this is important element of documentation.

Comment 3 Jan Chaloupka 2019-05-06 11:14:44 UTC
autoscaling resources PR: https://github.com/openshift/cluster-autoscaler-operator/pull/99

Comment 4 Jan Chaloupka 2019-05-06 11:28:19 UTC
machine HC PR: https://github.com/openshift/machine-api-operator/pull/313

Comment 5 Sudha Ponnaganti 2019-06-19 03:37:56 UTC
This is done only in Master. Need to create a bug for 4.1.z and merge in to 4.1 codeline. Setting target to 4.2

Comment 7 sunzhaohua 2019-08-05 03:07:40 UTC
Verified
clusterversion: 4.2.0-0.nightly-2019-08-01-113533

$ oc explain machineautoscaler
KIND:     MachineAutoscaler
VERSION:  autoscaling.openshift.io/v1beta1

DESCRIPTION:

FIELDS:
   apiVersion	<string>
     APIVersion defines the versioned schema of this representation of an
     object. Servers should convert recognized schemas to the latest internal
     value, and may reject unrecognized values. More info:
     https://git.k8s.io/community/contributors/devel/api-conventions.md#resources

   kind	<string>
     Kind is a string value representing the REST resource this object
     represents. Servers may infer this from the endpoint the client submits
     requests to. Cannot be updated. In CamelCase. More info:
     https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds

   metadata	<Object>
     Standard object's metadata. More info:
     https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata

   spec	<Object>
     Specification of constraints of a scalable resource

   status	<Object>
     Most recently observed status of a scalable resource


$ oc explain machinehealthcheck
KIND:     MachineHealthCheck
VERSION:  healthchecking.openshift.io/v1alpha1

DESCRIPTION:

FIELDS:
   apiVersion	<string>
     APIVersion defines the versioned schema of this representation of an
     object. Servers should convert recognized schemas to the latest internal
     value, and may reject unrecognized values. More info:
     https://git.k8s.io/community/contributors/devel/api-conventions.md#resources

   kind	<string>
     Kind is a string value representing the REST resource this object
     represents. Servers may infer this from the endpoint the client submits
     requests to. Cannot be updated. In CamelCase. More info:
     https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds

   metadata	<Object>
     Standard object's metadata. More info:
     https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata

   spec	<Object>
     Specification of machine health check policy

   status	<map[string]>
     Most recently observed status of MachineHealthCheck resource

Comment 8 errata-xmlrpc 2019-10-16 06:28:30 UTC
Since the problem described in this bug report should be
resolved in a recent advisory, it has been closed with a
resolution of ERRATA.

For information on the advisory, and where to find the updated
files, follow the link below.

If the solution does not work for you, open a new bug report.

https://access.redhat.com/errata/RHBA-2019:2922