-
Bug
-
Resolution: Unresolved
-
Minor
-
None
-
4.16, 4.17, 4.18, 4.19, 4.20
-
None
-
False
-
-
None
-
Moderate
-
None
-
None
-
None
-
None
-
None
-
None
-
None
-
None
-
None
-
None
-
None
-
None
Description of problem:
I recently discovered than since 4.14 some of the descriptions provided in previous versions of RHOCP have been removed from the oc explain command.
Such as the oc explain mc.spec.config.storage.files that does not provide anymore the details of the fields.
Version-Release number of selected component (if applicable):
4.16 and newer.
How reproducible:
This is missing in all 4.16 and newer versions.
Steps to Reproduce:
1. Running the oc explain mc.spec.config.storage.files on the cluster does not provide the details of the sub-components.
Actual results:
$ oc explain mc.spec.config.storage.files
GROUP: machineconfiguration.openshift.io
KIND: MachineConfig
VERSION: v1
error: field "files" does not exist
$ oc explain mc.spec.config
GROUP: machineconfiguration.openshift.io
KIND: MachineConfig
VERSION: v1
FIELD: config <Object>
DESCRIPTION:
Config is a Ignition Config object.
Expected results:
Something similar to 4.14 and before
$ oc explain mc.spec.config.storage.files GROUP: machineconfiguration.openshift.io KIND: MachineConfig VERSION: v1 FIELD: files <[]Object> DESCRIPTION: Files is the list of files to be created/modified Items is list of files to be written FIELDS: contents <Object> Contents specifies options related to the contents of the file filesystem <string> Filesystem is the internal identifier of the filesystem in which to write the file. This matches the last filesystem with the given identifier [...]
$ oc explain mc.spec.config GROUP: machineconfiguration.openshift.io KIND: MachineConfig VERSION: v1 FIELD: config <Object> DESCRIPTION: Config is a Ignition Config object. FIELDS: ignition <Object> -required- Ignition section contains metadata about the configuration itself. We only permit a subsection of ignition fields for MachineConfigs. passwd <Object> <no description> storage <Object> Storage describes the desired state of the system's storage devices. systemd <Object> systemd describes the desired state of the systemd units
Additional info:
The oc explain feature is usually a great tool for support to provide additional details to customers and help them to understand the fields available in the APIs.
This has been discussed in this Slack Thread
