Merge pull request #66679 from jab-rh/apis-414-final

Add latest OpenShift 4.14 APIs

Author: jab-rh

rest_api/config_apis/dns-config-openshift-io-v1.adoc

@@ -72,6 +72,10 @@ Type::
  For example, given the base domain `openshift.example.com`, an API server DNS record may be created for `cluster-api.openshift.example.com`. 
  Once set, this field cannot be changed.
 
+| `platform`
+| `object`
+| platform holds configuration specific to the underlying infrastructure provider for DNS. When omitted, this means the user has no opinion and the platform is left to choose reasonable defaults. These defaults are subject to change over time.
+
 | `privateZone`
 | `object`
 | privateZone is the location where all the DNS records that are only available internally to the cluster exist. 
@@ -84,6 +88,57 @@ Type::
  If this field is nil, no public records should be created. 
  Once set, this field cannot be changed.
 
+|===
+=== .spec.platform
+Description::
++
+--
+platform holds configuration specific to the underlying infrastructure provider for DNS. When omitted, this means the user has no opinion and the platform is left to choose reasonable defaults. These defaults are subject to change over time.
+--
+
+Type::
+  `object`
+
+Required::
+  - `type`
+
+
+
+[cols="1,1,1",options="header"]
+|===
+| Property | Type | Description
+
+| `aws`
+| `object`
+| aws contains DNS configuration specific to the Amazon Web Services cloud provider.
+
+| `type`
+| `string`
+| type is the underlying infrastructure provider for the cluster. Allowed values: "", "AWS". 
+ Individual components may not support all platforms, and must handle unrecognized platforms with best-effort defaults.
+
+|===
+=== .spec.platform.aws
+Description::
++
+--
+aws contains DNS configuration specific to the Amazon Web Services cloud provider.
+--
+
+Type::
+  `object`
+
+
+
+
+[cols="1,1,1",options="header"]
+|===
+| Property | Type | Description
+
+| `privateZoneIAMRole`
+| `string`
+| privateZoneIAMRole contains the ARN of an IAM role that should be assumed when performing operations on the cluster's private hosted zone specified in the cluster DNS config. When left empty, no role should be assumed.
+
 |===
 === .spec.privateZone
 Description::

rest_api/config_apis/infrastructure-config-openshift-io-v1.adoc

@@ -889,6 +889,10 @@ Type::
 | `string`
 | controlPlaneTopology expresses the expectations for operands that normally run on control nodes. The default is 'HighlyAvailable', which represents the behavior operators have in a "normal" cluster. The 'SingleReplica' mode will be used in single-node deployments and the operators should not configure the operand for highly-available operation The 'External' mode indicates that the control plane is hosted externally to the cluster and that its components are not visible within the cluster.
 
+| `cpuPartitioning`
+| `string`
+| cpuPartitioning expresses if CPU partitioning is a currently enabled feature in the cluster. CPU Partitioning means that this cluster can support partitioning workloads to specific CPU Sets. Valid values are "None" and "AllNodes". When omitted, the default value is "None". The default value of "None" indicates that no nodes will be setup with CPU partitioning. The "AllNodes" value indicates that all nodes have been setup with CPU partitioning, and can then be further configured via the PerformanceProfile API.
+
 | `etcdDiscoveryDomain`
 | `string`
 | etcdDiscoveryDomain is the domain used to fetch the SRV records for discovering etcd servers and clients. For more info: https://github.com/etcd-io/etcd/blob/329be66e8b3f9e2e6af83c123ff89297e49ebd15/Documentation/op-guide/clustering.md#dns-discovery deprecated: as of 4.7, this field is no longer set or honored.  It will be removed in a future release.
@@ -1350,6 +1354,38 @@ Type::
 
 
 
+[cols="1,1,1",options="header"]
+|===
+| Property | Type | Description
+
+| `cloudControllerManager`
+| `object`
+| cloudControllerManager contains settings specific to the external Cloud Controller Manager (a.k.a. CCM or CPI). When omitted, new nodes will be not tainted and no extra initialization from the cloud controller manager is expected.
+
+|===
+=== .status.platformStatus.external.cloudControllerManager
+Description::
++
+--
+cloudControllerManager contains settings specific to the external Cloud Controller Manager (a.k.a. CCM or CPI). When omitted, new nodes will be not tainted and no extra initialization from the cloud controller manager is expected.
+--
+
+Type::
+  `object`
+
+
+
+
+[cols="1,1,1",options="header"]
+|===
+| Property | Type | Description
+
+| `state`
+| `string`
+| state determines whether or not an external Cloud Controller Manager is expected to be installed within the cluster. https://kubernetes.io/docs/tasks/administer-cluster/running-cloud-controller/#running-cloud-controller-manager 
+ Valid values are "External", "None" and omitted. When set to "External", new nodes will be tainted as uninitialized when created, preventing them from running workloads until they are initialized by the cloud controller manager. When omitted or set to "None", new nodes will be not tainted and no extra initialization from the cloud controller manager is expected.
+
+|===
 === .status.platformStatus.gcp
 Description::
 +

rest_api/machine_apis/controllerconfig-machineconfiguration-openshift-io-v1.adoc

@@ -108,6 +108,22 @@ Required::
 | `string`
 | etcdDiscoveryDomain is deprecated, use Infra.Status.EtcdDiscoveryDomain instead
 
+| `imageRegistryBundleData`
+| `array`
+| imageRegistryBundleData is Image Registry Data provided by the openshift-config-managed/image-registry-ca configmap.
+
+| `imageRegistryBundleData[]`
+| `object`
+| ImageRegistryBundle contains the file and data for each CA
+
+| `imageRegistryBundleUserData`
+| `array`
+| imageRegistryBundleUserData is Image Registry Data provided by the user. This is pulled from image.config.openshift.io/cluster which contains an additionalCA field.
+
+| `imageRegistryBundleUserData[]`
+| `object`
+| ImageRegistryBundle contains the file and data for each CA
+
 | `images`
 | `object (string)`
 | images is map of images that are used by the controller to render templates under ./templates/
@@ -116,6 +132,10 @@ Required::
 | `object`
 | infra holds the infrastructure details
 
+| `internalRegistryPullSecret`
+| ``
+| internalRegistryPullSecret is the pull secret for the internal registry.
+
 | `ipFamilies`
 | `string`
 | ipFamilies indicates the IP families in use by the cluster network
@@ -190,6 +210,84 @@ Required::
 | xref:../objects/index.adoc#io.k8s.apimachinery.pkg.apis.meta.v1.ObjectMeta[`ObjectMeta`]
 | Standard object's metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
 
+|===
+=== .spec.imageRegistryBundleData
+Description::
++
+--
+imageRegistryBundleData is Image Registry Data provided by the openshift-config-managed/image-registry-ca configmap.
+--
+
+Type::
+  `array`
+
+
+
+
+=== .spec.imageRegistryBundleData[]
+Description::
++
+--
+ImageRegistryBundle contains the file and data for each CA
+--
+
+Type::
+  `object`
+
+
+
+
+[cols="1,1,1",options="header"]
+|===
+| Property | Type | Description
+
+| `data`
+| `string`
+| data of the CA
+
+| `file`
+| `string`
+| file of the CA
+
+|===
+=== .spec.imageRegistryBundleUserData
+Description::
++
+--
+imageRegistryBundleUserData is Image Registry Data provided by the user. This is pulled from image.config.openshift.io/cluster which contains an additionalCA field.
+--
+
+Type::
+  `array`
+
+
+
+
+=== .spec.imageRegistryBundleUserData[]
+Description::
++
+--
+ImageRegistryBundle contains the file and data for each CA
+--
+
+Type::
+  `object`
+
+
+
+
+[cols="1,1,1",options="header"]
+|===
+| Property | Type | Description
+
+| `data`
+| `string`
+| data of the CA
+
+| `file`
+| `string`
+| file of the CA
+
 |===
 === .spec.infra
 Description::
@@ -296,6 +394,14 @@ Type::
 | `object`
 | ControllerConfigStatusCondition contains condition information for ControllerConfigStatus
 
+| `controllerCertificates`
+| `array`
+| controllerCertificates holds the information about the MCCs certificates.
+
+| `controllerCertificates[]`
+| `object`
+| ControllerCertificate contains certificate information for ControllerConfigStatus
+
 | `observedGeneration`
 | `integer`
 | observedGeneration represents the generation observed by the controller.
@@ -354,6 +460,49 @@ Required::
 | `string`
 | type specifies the state of the operator's reconciliation functionality.
 
+|===
+=== .status.controllerCertificates
+Description::
++
+--
+controllerCertificates holds the information about the MCCs certificates.
+--
+
+Type::
+  `array`
+
+
+
+
+=== .status.controllerCertificates[]
+Description::
++
+--
+ControllerCertificate contains certificate information for ControllerConfigStatus
+--
+
+Type::
+  `object`
+
+
+
+
+[cols="1,1,1",options="header"]
+|===
+| Property | Type | Description
+
+| `bundleFile`
+| `string`
+| the name of the bundle serving this cert.
+
+| `signer`
+| `string`
+| signer contains the issuer of the cert
+
+| `subject`
+| ``
+| the subject of the cert.
+
 |===
 
 == API endpoints

rest_api/machine_apis/controlplanemachineset-machine-openshift-io-v1.adoc

@@ -570,6 +570,8 @@ rootVolume contains settings that will be used by the OpenStack machine provider
 Type::
   `object`
 
+Required::
+  - `volumeType`
 
 
 
@@ -583,7 +585,7 @@ Type::
 
 | `volumeType`
 | `string`
-| volumeType specifies the type of the root volume that will be provisioned. If not specifified, the root volume will be created as the type in the machine template. The maximum length of a volume type name is 255 characters, as per the OpenStack limit.
+| volumeType specifies the type of the root volume that will be provisioned. The maximum length of a volume type name is 255 characters, as per the OpenStack limit.
 
 |===
 === .spec.template.machines_v1beta1_machine_openshift_io.metadata

rest_api/machine_apis/machineconfigpool-machineconfiguration-openshift-io-v1.adoc

@@ -366,6 +366,14 @@ Type::
 |===
 | Property | Type | Description
 
+| `certExpirys`
+| `array`
+| The certificate expiry dates from the controller config
+
+| `certExpirys[]`
+| `object`
+| the certExpiry contains specific information about a certificate stored in the controllerConfig.
+
 | `conditions`
 | `array`
 | conditions represents the latest available observations of current state.
@@ -402,6 +410,45 @@ Type::
 | `integer`
 | updatedMachineCount represents the total number of machines targeted by the pool that have the CurrentMachineConfig as their config.
 
+|===
+=== .status.certExpirys
+Description::
++
+--
+The certificate expiry dates from the controller config
+--
+
+Type::
+  `array`
+
+
+
+
+=== .status.certExpirys[]
+Description::
++
+--
+the certExpiry contains specific information about a certificate stored in the controllerConfig.
+--
+
+Type::
+  `object`
+
+
+
+
+[cols="1,1,1",options="header"]
+|===
+| Property | Type | Description
+
+| `bundle`
+| `string`
+| the bundle for which the expiry applies
+
+| `subject`
+| `string`
+| the subject of the cert
+
 |===
 === .status.conditions
 Description::