From ff9142b263ed65cb3d85955f5100ea5bfe273b93 Mon Sep 17 00:00:00 2001 From: Tiger Kaovilai Date: Mon, 25 Jul 2022 22:15:15 -0400 Subject: [PATCH 1/7] Correct API References property casing. Using psuedo version to include datamover features property. https://pkg.go.dev/github.com/openshift/oadp-operator@v0.0.0-20220722142130-a02487302a02/api/v1alpha1#Features Do this to get psuedo version of latest master commit ``` go get -d github.com/openshift/oadp-operator/api@master go: github.com/openshift/oadp-operator/api@master: github.com/openshift/oadp-operator/api@v0.0.0-20220722142130-a02487302a02: invalid version: missing github.com/openshift/oadp-operator/api/go.mod at revision a02487302a02 ``` Closes #770 #768 --- docs/API_ref.md | 83 +++++++++++++++++++++++++------------------------ 1 file changed, 42 insertions(+), 41 deletions(-) diff --git a/docs/API_ref.md b/docs/API_ref.md index add0a87e90..9e54c9ffc1 100644 --- a/docs/API_ref.md +++ b/docs/API_ref.md @@ -1,78 +1,79 @@

API References

-### DataProtectionApplicationSpec +### [DataProtectionApplicationSpec](https://pkg.go.dev/github.com/openshift/oadp-operator@v0.0.0-20220722142130-a02487302a02/api/v1alpha1#DataProtectionApplicationSpec) | Property | Type | Description | |----------------------|-----------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------| -| BackupLocations | [] BackupLocation | BackupLocations defines the list of desired configuration to use for BackupStorageLocations | -| SnapshotLocations | [] SnapshotLocation | SnapshotLocations defines the list of desired configuration to use for VolumeSnapshotLocations | -| UnsupportedOverrides | map [ UnsupportedImageKey ] string | UnsupportedOverrides can be used to override the deployed dependent images for development | -| PodAnnotations | map [ string ] string | Used to add annotations to pods deployed by operator | -| PodDnsPolicy | [corev1.DNSPolicy] ( https://pkg.go.dev/k8s.io/api/core/v1#DNSPolicy) | DNSPolicy defines how a pod's DNS will be configured. | -| PodDnsConfig | [corev1.PodDNSConfig] ( https://pkg.go.dev/k8s.io/api/core/v1#PodDNSConfig) | PodDNSConfig defines the DNS parameters of a pod in addition to those generated from DNSPolicy. | -| BackupImages | *bool | BackupImages is used to specify whether you want to deploy a registry for enabling backup and restore of images | -| Configuration | *ApplicationConfig | Configuration is used to configure the data protection application's server config. | -| Features | *Features | Features defines the configuration for the DPA to enable the tech preview features | - -### BackupLocation +| backupLocations | [] [BackupLocation](https://pkg.go.dev/github.com/openshift/oadp-operator@v0.0.0-20220722142130-a02487302a02/api/v1alpha1#BackupLocation) | BackupLocations defines the list of desired configuration to use for BackupStorageLocations | +| snapshotLocations | [] [SnapshotLocation](https://pkg.go.dev/github.com/openshift/oadp-operator@v0.0.0-20220722142130-a02487302a02/api/v1alpha1#SnapshotLocation) | SnapshotLocations defines the list of desired configuration to use for VolumeSnapshotLocations | +| unsupportedOverrides | map [ [UnsupportedImageKey](https://pkg.go.dev/github.com/openshift/oadp-operator@v0.0.0-20220722142130-a02487302a02/api/v1alpha1#UnsupportedImageKey) ] [string](https://pkg.go.dev/builtin#string) | UnsupportedOverrides can be used to override the deployed dependent images for development. Options are `veleroImageFqin`, `awsPluginImageFqin`, `openshiftPluginImageFqin`, `azurePluginImageFqin`, `gcpPluginImageFqin`, `csiPluginImageFqin`, `dataMoverImageFqin`, `resticRestoreImageFqin`, `kubevirtPluginImageFqin`, and `operator-type` | +| podAnnotations | map [ [string](https://pkg.go.dev/builtin#string) ] [string](https://pkg.go.dev/builtin#string) | Used to add annotations to pods deployed by operator | +| podDnsPolicy | [corev1.DNSPolicy] ( https://pkg.go.dev/k8s.io/api/core/v1#DNSPolicy) | DNSPolicy defines how a pod's DNS will be configured. | +| podDnsConfig | [corev1.PodDNSConfig] ( https://pkg.go.dev/k8s.io/api/core/v1#PodDNSConfig) | PodDNSConfig defines the DNS parameters of a pod in addition to those generated from DNSPolicy. | +| backupImages | *[bool](https://pkg.go.dev/builtin#bool) | BackupImages is used to specify whether you want to deploy a registry for enabling backup and restore of images | +| configuration | *[ApplicationConfig](https://pkg.go.dev/github.com/openshift/oadp-operator@v0.0.0-20220722142130-a02487302a02/api/v1alpha1#ApplicationConfig) | Configuration is used to configure the data protection application's server config. | +| features | *[Features](https://pkg.go.dev/github.com/openshift/oadp-operator@v0.0.0-20220722142130-a02487302a02/api/v1alpha1#Features) | Features defines the configuration for the DPA to enable the tech preview features | + +### [BackupLocation](https://pkg.go.dev/github.com/openshift/oadp-operator@v0.0.0-20220722142130-a02487302a02/api/v1alpha1#BackupLocation) | Property | Type | Description | |----------|---------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------| -| name | metav1. ObjectMeta | | +| name | [metav1.ObjectMeta](https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#ObjectMeta) | | | velero | [*velero.BackupStorageLocationSpec](https://velero.io/docs/v1.6/api-types/backupstoragelocation/) | Location to store volume snapshots. For further details, see [here] ( config/bsl_and_vsl.md). | -### VolumeSnapshot +### [SnapshotLocation](https://pkg.go.dev/github.com/openshift/oadp-operator@v0.0.0-20220722142130-a02487302a02/api/v1alpha1#SnapshotLocation) | Property | Type | Description | |----------|-----------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------| -| name | metav1. ObjectMeta | | +| name | [metav1.ObjectMeta](https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#ObjectMeta) | | | velero | [*velero.VolumeSnapshotLocationSpec](https://velero.io/docs/v1.6/api-types/volumesnapshotlocation/) | Location to store volume snapshots. For further details, see [here] ( config/bsl_and_vsl.md). | -### ApplicationConfig (DataProtectionApplicationSpec.Configuration) +### [ApplicationConfig](https://pkg.go.dev/github.com/openshift/oadp-operator@v0.0.0-20220722142130-a02487302a02/api/v1alpha1#ApplicationConfig) | Property | Type | Description | |----------|---------------|------------------------------------------------------| -| velero | *VeleroConfig | This defines the configuration for the Velero server | -| restic | *resticConfig | This defines the configuration for the Restic server | +| velero | *[VeleroConfig](https://pkg.go.dev/github.com/openshift/oadp-operator@v0.0.0-20220722142130-a02487302a02/api/v1alpha1#VeleroConfig) | This defines the configuration for the Velero server | +| restic | *[ResticConfig](https://pkg.go.dev/github.com/openshift/oadp-operator@v0.0.0-20220722142130-a02487302a02/api/v1alpha1#ResticConfig) | This defines the configuration for the Restic server | -### VeleroConfig +### [VeleroConfig](https://pkg.go.dev/github.com/openshift/oadp-operator@v0.0.0-20220722142130-a02487302a02/api/v1alpha1#VeleroConfig) | Property | Type | Description | |---------------------------------|-------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| featureFlags | [] string | FeatureFlags defines the list of features to enable for Velero instance | -| defaultPlugins | [] string | Five types of default Velero plugins can be installed: `AWS` , `GCP` , `Azure` and `OpenShift` , and `CSI` . See [here] ( config/plugins.md) for further information. | -| customPlugins | map [string]interface{} | Used for installation of custom Velero plugins. See [here] ( config/plugins.md) for further information. | -| restoreResourcesVersionPriority | string | RestoreResourceVersionPriority represents a configmap that will be created if defined for use in conjunction with `EnableAPIGroupVersions` feature flag. Defining this field automatically add EnableAPIGroupVersions to the velero server feature flag | -| noDefaultBackupLocation | bool | If you need to install Velero without a default backup storage location NoDefaultBackupLocation flag is required for confirmation | -| podConfig | *PodConfig | Velero Pod specific configuration | -| logLevel | string | Velero server’s log level (default info, use debug for the most logging). Valid options are error, warn, warning, info, debug, trace | +| featureFlags | [] [string](https://pkg.go.dev/builtin#string) | FeatureFlags defines the list of features to enable for Velero instance | +| defaultPlugins | [] [string](https://pkg.go.dev/builtin#string) | Five types of default Velero plugins can be installed: `AWS` , `GCP` , `Azure` and `OpenShift` , and `CSI` . See [here] ( config/plugins.md) for further information. | +| customPlugins | [][CustomPlugin](https://pkg.go.dev/github.com/openshift/oadp-operator@v0.0.0-20220722142130-a02487302a02/api/v1alpha1#CustomPlugin) | Used for installation of custom Velero plugins. See [here] ( config/plugins.md) for further information. | +| restoreResourcesVersionPriority | [string](https://pkg.go.dev/builtin#string) | RestoreResourceVersionPriority represents a configmap that will be created if defined for use in conjunction with `EnableAPIGroupVersions` feature flag. Defining this field automatically add EnableAPIGroupVersions to the velero server feature flag | +| noDefaultBackupLocation | [bool](https://pkg.go.dev/builtin#bool) | If you need to install Velero without a default backup storage location NoDefaultBackupLocation flag is required for confirmation | +| podConfig | *[PodConfig](https://pkg.go.dev/github.com/openshift/oadp-operator@v0.0.0-20220722142130-a02487302a02/api/v1alpha1#PodConfig) | Velero Pod specific configuration | +| logLevel | [string](https://pkg.go.dev/builtin#string) | Velero server’s log level (default info, use debug for the most logging). Valid options are error, warn, warning, info, debug, trace | -### ResticConfig +### [CustomPlugin](https://pkg.go.dev/github.com/openshift/oadp-operator@v0.0.0-20220722142130-a02487302a02/api/v1alpha1#CustomPlugin) | Property | Type | Description | |--------------------|------------|-----------------------------------------------------------------------------| -| enable | *bool | Enables backup/restore using Restic. If set to false, snapshots are needed. | -| supplementalGroups | []int64 | SupplementalGroups defines the linux groups to be applied to the Restic Pod | -| timeout | string | Timeout defines the Restic timeout, default value is 1h | -| PodConfig | *PodConfig | Restic Pod specific configuration | +| name | [string](https://pkg.go.dev/builtin#string) | Name of custom plugin | +| image | [string](https://pkg.go.dev/builtin#string) | Image of custom plugin | -### PodConfig +### [ResticConfig](https://pkg.go.dev/github.com/openshift/oadp-operator@v0.0.0-20220722142130-a02487302a02/api/v1alpha1#ResticConfig) + +| Property | Type | Description | +|--------------------|------------|-----------------------------------------------------------------------------| +| enable | *[bool](https://pkg.go.dev/builtin#bool) | Enables backup/restore using Restic. If set to false, snapshots are needed. | +| supplementalGroups | [][int64](https://pkg.go.dev/builtin#int64) | SupplementalGroups defines the linux groups to be applied to the Restic Pod | +| timeout | [string](https://pkg.go.dev/builtin#string) | Timeout defines the Restic timeout, default value is 1h | +| PodConfig | *[PodConfig](https://pkg.go.dev/github.com/openshift/oadp-operator@v0.0.0-20220722142130-a02487302a02/api/v1alpha1#PodConfig) | Restic Pod specific configuration | + +### [PodConfig](https://pkg.go.dev/github.com/openshift/oadp-operator@v0.0.0-20220722142130-a02487302a02/api/v1alpha1#PodConfig) | Property | Type | Description | |---------------------|-------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------| -| nodeSelector | map [ string ] string | NodeSelector defines the nodeSelector to be supplied to Velero/Restic podSpec | +| nodeSelector | map [ [string](https://pkg.go.dev/builtin#string) ] [string](https://pkg.go.dev/builtin#string) | NodeSelector defines the nodeSelector to be supplied to Velero/Restic podSpec | | tolerations | [[]corev1. Toleration](https://pkg.go.dev/k8s.io/api/core/v1#Toleration) | Tolerations defines the list of tolerations to be applied to Velero Deployment/Restic daemonset | | resourceAllocations | [corev1.ResourceRequirements](https://pkg.go.dev/k8s.io/api/core/v1#ResourceRequirements) | Set specific resource `limits` and `requests` for the Velero/Restic pods. For more information, go [here] ( config/resource_req_limits.md). | -### Features +### [Features](https://pkg.go.dev/github.com/openshift/oadp-operator@v0.0.0-20220722142130-a02487302a02/api/v1alpha1#Features) | Property | Type | Description | |-----------|-----------|-------------------------------------------------------------------------------------------------------------------------------------------| -| DataMover | DataMover | DataMover defines the various config for DPA data mover | - -### DataMover -| Property | Type | Description | -|------------|------|-------------------------------------------------------------------------------------------------------------------------------| -| Enable | bool | Enable is used to specify whether you want to deploy the volume snapshot mover controller and a modified csi datamover plugin | -| Credential | *corev1.SecretKeySelector | User supplied Restic Secret name for DataMover | | +| enableDataMover | bool | EnableDataMover is used to specify whether you want to deploy the volume snapshot mover controller and a modified csi datamover plugin | | See also [![Go Reference](https://pkg.go.dev/badge/github.com/openshift/oadp-operator.svg)](https://pkg.go.dev/github.com/openshift/oadp-operator) for a deeper dive. From 99c37de655ef42e3557457d027e7edc61fbd33dc Mon Sep 17 00:00:00 2001 From: Tiger Kaovilai Date: Tue, 26 Jul 2022 10:31:05 -0400 Subject: [PATCH 2/7] Revert incorrect datamover changes. --- docs/API_ref.md | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/docs/API_ref.md b/docs/API_ref.md index 9e54c9ffc1..8a74f5a004 100644 --- a/docs/API_ref.md +++ b/docs/API_ref.md @@ -74,6 +74,12 @@ ### [Features](https://pkg.go.dev/github.com/openshift/oadp-operator@v0.0.0-20220722142130-a02487302a02/api/v1alpha1#Features) | Property | Type | Description | |-----------|-----------|-------------------------------------------------------------------------------------------------------------------------------------------| -| enableDataMover | bool | EnableDataMover is used to specify whether you want to deploy the volume snapshot mover controller and a modified csi datamover plugin | | +| DataMover | DataMover | DataMover defines the various config for DPA data mover | + +### DataMover +| Property | Type | Description | +|------------|------|-------------------------------------------------------------------------------------------------------------------------------| +| Enable | bool | Enable is used to specify whether you want to deploy the volume snapshot mover controller and a modified csi datamover plugin | +| Credential | *corev1.SecretKeySelector | User supplied Restic Secret name for DataMover | | See also [![Go Reference](https://pkg.go.dev/badge/github.com/openshift/oadp-operator.svg)](https://pkg.go.dev/github.com/openshift/oadp-operator) for a deeper dive. From 7603429755a39918dbfbddc9ec7128058a645a63 Mon Sep 17 00:00:00 2001 From: Tiger Kaovilai Date: Tue, 26 Jul 2022 10:41:05 -0400 Subject: [PATCH 3/7] link correction --- docs/API_ref.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/API_ref.md b/docs/API_ref.md index 8a74f5a004..f779fb0a87 100644 --- a/docs/API_ref.md +++ b/docs/API_ref.md @@ -68,7 +68,7 @@ | Property | Type | Description | |---------------------|-------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------| | nodeSelector | map [ [string](https://pkg.go.dev/builtin#string) ] [string](https://pkg.go.dev/builtin#string) | NodeSelector defines the nodeSelector to be supplied to Velero/Restic podSpec | -| tolerations | [[]corev1. Toleration](https://pkg.go.dev/k8s.io/api/core/v1#Toleration) | Tolerations defines the list of tolerations to be applied to Velero Deployment/Restic daemonset | +| tolerations | [][corev1.Toleration](https://pkg.go.dev/k8s.io/api/core/v1#Toleration) | Tolerations defines the list of tolerations to be applied to Velero Deployment/Restic daemonset | | resourceAllocations | [corev1.ResourceRequirements](https://pkg.go.dev/k8s.io/api/core/v1#ResourceRequirements) | Set specific resource `limits` and `requests` for the Velero/Restic pods. For more information, go [here] ( config/resource_req_limits.md). | ### [Features](https://pkg.go.dev/github.com/openshift/oadp-operator@v0.0.0-20220722142130-a02487302a02/api/v1alpha1#Features) From 88cd391db98a8949c30741b470ff55c7c728aa14 Mon Sep 17 00:00:00 2001 From: Tiger Kaovilai Date: Tue, 26 Jul 2022 12:30:12 -0400 Subject: [PATCH 4/7] correct logLevel options, bump velero docs version to 1.9 --- docs/API_ref.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/API_ref.md b/docs/API_ref.md index f779fb0a87..5f533aaaa9 100644 --- a/docs/API_ref.md +++ b/docs/API_ref.md @@ -19,14 +19,14 @@ | Property | Type | Description | |----------|---------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------| | name | [metav1.ObjectMeta](https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#ObjectMeta) | | -| velero | [*velero.BackupStorageLocationSpec](https://velero.io/docs/v1.6/api-types/backupstoragelocation/) | Location to store volume snapshots. For further details, see [here] ( config/bsl_and_vsl.md). | +| velero | [*velero.BackupStorageLocationSpec](https://velero.io/docs/v1.9/api-types/backupstoragelocation/) | Location to store volume snapshots. For further details, see [here] ( config/bsl_and_vsl.md). | ### [SnapshotLocation](https://pkg.go.dev/github.com/openshift/oadp-operator@v0.0.0-20220722142130-a02487302a02/api/v1alpha1#SnapshotLocation) | Property | Type | Description | |----------|-----------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------| | name | [metav1.ObjectMeta](https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#ObjectMeta) | | -| velero | [*velero.VolumeSnapshotLocationSpec](https://velero.io/docs/v1.6/api-types/volumesnapshotlocation/) | Location to store volume snapshots. For further details, see [here] ( config/bsl_and_vsl.md). | +| velero | [*velero.VolumeSnapshotLocationSpec](https://velero.io/docs/v1.9/api-types/volumesnapshotlocation/) | Location to store volume snapshots. For further details, see [here] ( config/bsl_and_vsl.md). | ### [ApplicationConfig](https://pkg.go.dev/github.com/openshift/oadp-operator@v0.0.0-20220722142130-a02487302a02/api/v1alpha1#ApplicationConfig) @@ -45,7 +45,7 @@ | restoreResourcesVersionPriority | [string](https://pkg.go.dev/builtin#string) | RestoreResourceVersionPriority represents a configmap that will be created if defined for use in conjunction with `EnableAPIGroupVersions` feature flag. Defining this field automatically add EnableAPIGroupVersions to the velero server feature flag | | noDefaultBackupLocation | [bool](https://pkg.go.dev/builtin#bool) | If you need to install Velero without a default backup storage location NoDefaultBackupLocation flag is required for confirmation | | podConfig | *[PodConfig](https://pkg.go.dev/github.com/openshift/oadp-operator@v0.0.0-20220722142130-a02487302a02/api/v1alpha1#PodConfig) | Velero Pod specific configuration | -| logLevel | [string](https://pkg.go.dev/builtin#string) | Velero server’s log level (default info, use debug for the most logging). Valid options are error, warn, warning, info, debug, trace | +| logLevel | [string](https://pkg.go.dev/builtin#string) | Velero server’s log level (default info, use debug for the most logging). Valid options are trace, debug, info, warning, error, fatal, or panic | ### [CustomPlugin](https://pkg.go.dev/github.com/openshift/oadp-operator@v0.0.0-20220722142130-a02487302a02/api/v1alpha1#CustomPlugin) From 7de2232151e719c53430c6d0f663e0527814cced Mon Sep 17 00:00:00 2001 From: Tiger Kaovilai Date: Wed, 27 Jul 2022 07:52:04 -0400 Subject: [PATCH 5/7] Add labels to PodConfig section --- docs/API_ref.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/API_ref.md b/docs/API_ref.md index 5f533aaaa9..c6a6ee18e3 100644 --- a/docs/API_ref.md +++ b/docs/API_ref.md @@ -67,6 +67,7 @@ | Property | Type | Description | |---------------------|-------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------| +| labels | map [ [string](https://pkg.go.dev/builtin#string) ] [string](https://pkg.go.dev/builtin#string) | Labels to add to pods | | nodeSelector | map [ [string](https://pkg.go.dev/builtin#string) ] [string](https://pkg.go.dev/builtin#string) | NodeSelector defines the nodeSelector to be supplied to Velero/Restic podSpec | | tolerations | [][corev1.Toleration](https://pkg.go.dev/k8s.io/api/core/v1#Toleration) | Tolerations defines the list of tolerations to be applied to Velero Deployment/Restic daemonset | | resourceAllocations | [corev1.ResourceRequirements](https://pkg.go.dev/k8s.io/api/core/v1#ResourceRequirements) | Set specific resource `limits` and `requests` for the Velero/Restic pods. For more information, go [here] ( config/resource_req_limits.md). | From e207cd90996f5d29845c7fa2dff8ef7c499822f1 Mon Sep 17 00:00:00 2001 From: Tiger Kaovilai Date: Wed, 27 Jul 2022 18:41:11 -0400 Subject: [PATCH 6/7] bump to v0.0.0-20220727202820-c5f87df8fafd --- docs/API_ref.md | 38 +++++++++++++++++++------------------- 1 file changed, 19 insertions(+), 19 deletions(-) diff --git a/docs/API_ref.md b/docs/API_ref.md index c6a6ee18e3..80b9b101d3 100644 --- a/docs/API_ref.md +++ b/docs/API_ref.md @@ -1,69 +1,69 @@

API References

-### [DataProtectionApplicationSpec](https://pkg.go.dev/github.com/openshift/oadp-operator@v0.0.0-20220722142130-a02487302a02/api/v1alpha1#DataProtectionApplicationSpec) +### [DataProtectionApplicationSpec](https://pkg.go.dev/github.com/openshift/oadp-operator@v0.0.0-20220727202820-c5f87df8fafd/api/v1alpha1#DataProtectionApplicationSpec) | Property | Type | Description | |----------------------|-----------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------| -| backupLocations | [] [BackupLocation](https://pkg.go.dev/github.com/openshift/oadp-operator@v0.0.0-20220722142130-a02487302a02/api/v1alpha1#BackupLocation) | BackupLocations defines the list of desired configuration to use for BackupStorageLocations | -| snapshotLocations | [] [SnapshotLocation](https://pkg.go.dev/github.com/openshift/oadp-operator@v0.0.0-20220722142130-a02487302a02/api/v1alpha1#SnapshotLocation) | SnapshotLocations defines the list of desired configuration to use for VolumeSnapshotLocations | -| unsupportedOverrides | map [ [UnsupportedImageKey](https://pkg.go.dev/github.com/openshift/oadp-operator@v0.0.0-20220722142130-a02487302a02/api/v1alpha1#UnsupportedImageKey) ] [string](https://pkg.go.dev/builtin#string) | UnsupportedOverrides can be used to override the deployed dependent images for development. Options are `veleroImageFqin`, `awsPluginImageFqin`, `openshiftPluginImageFqin`, `azurePluginImageFqin`, `gcpPluginImageFqin`, `csiPluginImageFqin`, `dataMoverImageFqin`, `resticRestoreImageFqin`, `kubevirtPluginImageFqin`, and `operator-type` | +| backupLocations | [] [BackupLocation](https://pkg.go.dev/github.com/openshift/oadp-operator@v0.0.0-20220727202820-c5f87df8fafd/api/v1alpha1#BackupLocation) | BackupLocations defines the list of desired configuration to use for BackupStorageLocations | +| snapshotLocations | [] [SnapshotLocation](https://pkg.go.dev/github.com/openshift/oadp-operator@v0.0.0-20220727202820-c5f87df8fafd/api/v1alpha1#SnapshotLocation) | SnapshotLocations defines the list of desired configuration to use for VolumeSnapshotLocations | +| unsupportedOverrides | map [ [UnsupportedImageKey](https://pkg.go.dev/github.com/openshift/oadp-operator@v0.0.0-20220727202820-c5f87df8fafd/api/v1alpha1#UnsupportedImageKey) ] [string](https://pkg.go.dev/builtin#string) | UnsupportedOverrides can be used to override the deployed dependent images for development. Options are `veleroImageFqin`, `awsPluginImageFqin`, `openshiftPluginImageFqin`, `azurePluginImageFqin`, `gcpPluginImageFqin`, `csiPluginImageFqin`, `dataMoverImageFqin`, `resticRestoreImageFqin`, `kubevirtPluginImageFqin`, and `operator-type` | | podAnnotations | map [ [string](https://pkg.go.dev/builtin#string) ] [string](https://pkg.go.dev/builtin#string) | Used to add annotations to pods deployed by operator | | podDnsPolicy | [corev1.DNSPolicy] ( https://pkg.go.dev/k8s.io/api/core/v1#DNSPolicy) | DNSPolicy defines how a pod's DNS will be configured. | | podDnsConfig | [corev1.PodDNSConfig] ( https://pkg.go.dev/k8s.io/api/core/v1#PodDNSConfig) | PodDNSConfig defines the DNS parameters of a pod in addition to those generated from DNSPolicy. | | backupImages | *[bool](https://pkg.go.dev/builtin#bool) | BackupImages is used to specify whether you want to deploy a registry for enabling backup and restore of images | -| configuration | *[ApplicationConfig](https://pkg.go.dev/github.com/openshift/oadp-operator@v0.0.0-20220722142130-a02487302a02/api/v1alpha1#ApplicationConfig) | Configuration is used to configure the data protection application's server config. | -| features | *[Features](https://pkg.go.dev/github.com/openshift/oadp-operator@v0.0.0-20220722142130-a02487302a02/api/v1alpha1#Features) | Features defines the configuration for the DPA to enable the tech preview features | +| configuration | *[ApplicationConfig](https://pkg.go.dev/github.com/openshift/oadp-operator@v0.0.0-20220727202820-c5f87df8fafd/api/v1alpha1#ApplicationConfig) | Configuration is used to configure the data protection application's server config. | +| features | *[Features](https://pkg.go.dev/github.com/openshift/oadp-operator@v0.0.0-20220727202820-c5f87df8fafd/api/v1alpha1#Features) | Features defines the configuration for the DPA to enable the tech preview features | -### [BackupLocation](https://pkg.go.dev/github.com/openshift/oadp-operator@v0.0.0-20220722142130-a02487302a02/api/v1alpha1#BackupLocation) +### [BackupLocation](https://pkg.go.dev/github.com/openshift/oadp-operator@v0.0.0-20220727202820-c5f87df8fafd/api/v1alpha1#BackupLocation) | Property | Type | Description | |----------|---------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------| | name | [metav1.ObjectMeta](https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#ObjectMeta) | | | velero | [*velero.BackupStorageLocationSpec](https://velero.io/docs/v1.9/api-types/backupstoragelocation/) | Location to store volume snapshots. For further details, see [here] ( config/bsl_and_vsl.md). | -### [SnapshotLocation](https://pkg.go.dev/github.com/openshift/oadp-operator@v0.0.0-20220722142130-a02487302a02/api/v1alpha1#SnapshotLocation) +### [SnapshotLocation](https://pkg.go.dev/github.com/openshift/oadp-operator@v0.0.0-20220727202820-c5f87df8fafd/api/v1alpha1#SnapshotLocation) | Property | Type | Description | |----------|-----------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------| | name | [metav1.ObjectMeta](https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#ObjectMeta) | | | velero | [*velero.VolumeSnapshotLocationSpec](https://velero.io/docs/v1.9/api-types/volumesnapshotlocation/) | Location to store volume snapshots. For further details, see [here] ( config/bsl_and_vsl.md). | -### [ApplicationConfig](https://pkg.go.dev/github.com/openshift/oadp-operator@v0.0.0-20220722142130-a02487302a02/api/v1alpha1#ApplicationConfig) +### [ApplicationConfig](https://pkg.go.dev/github.com/openshift/oadp-operator@v0.0.0-20220727202820-c5f87df8fafd/api/v1alpha1#ApplicationConfig) | Property | Type | Description | |----------|---------------|------------------------------------------------------| -| velero | *[VeleroConfig](https://pkg.go.dev/github.com/openshift/oadp-operator@v0.0.0-20220722142130-a02487302a02/api/v1alpha1#VeleroConfig) | This defines the configuration for the Velero server | -| restic | *[ResticConfig](https://pkg.go.dev/github.com/openshift/oadp-operator@v0.0.0-20220722142130-a02487302a02/api/v1alpha1#ResticConfig) | This defines the configuration for the Restic server | +| velero | *[VeleroConfig](https://pkg.go.dev/github.com/openshift/oadp-operator@v0.0.0-20220727202820-c5f87df8fafd/api/v1alpha1#VeleroConfig) | This defines the configuration for the Velero server | +| restic | *[ResticConfig](https://pkg.go.dev/github.com/openshift/oadp-operator@v0.0.0-20220727202820-c5f87df8fafd/api/v1alpha1#ResticConfig) | This defines the configuration for the Restic server | -### [VeleroConfig](https://pkg.go.dev/github.com/openshift/oadp-operator@v0.0.0-20220722142130-a02487302a02/api/v1alpha1#VeleroConfig) +### [VeleroConfig](https://pkg.go.dev/github.com/openshift/oadp-operator@v0.0.0-20220727202820-c5f87df8fafd/api/v1alpha1#VeleroConfig) | Property | Type | Description | |---------------------------------|-------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | featureFlags | [] [string](https://pkg.go.dev/builtin#string) | FeatureFlags defines the list of features to enable for Velero instance | | defaultPlugins | [] [string](https://pkg.go.dev/builtin#string) | Five types of default Velero plugins can be installed: `AWS` , `GCP` , `Azure` and `OpenShift` , and `CSI` . See [here] ( config/plugins.md) for further information. | -| customPlugins | [][CustomPlugin](https://pkg.go.dev/github.com/openshift/oadp-operator@v0.0.0-20220722142130-a02487302a02/api/v1alpha1#CustomPlugin) | Used for installation of custom Velero plugins. See [here] ( config/plugins.md) for further information. | +| customPlugins | [][CustomPlugin](https://pkg.go.dev/github.com/openshift/oadp-operator@v0.0.0-20220727202820-c5f87df8fafd/api/v1alpha1#CustomPlugin) | Used for installation of custom Velero plugins. See [here] ( config/plugins.md) for further information. | | restoreResourcesVersionPriority | [string](https://pkg.go.dev/builtin#string) | RestoreResourceVersionPriority represents a configmap that will be created if defined for use in conjunction with `EnableAPIGroupVersions` feature flag. Defining this field automatically add EnableAPIGroupVersions to the velero server feature flag | | noDefaultBackupLocation | [bool](https://pkg.go.dev/builtin#bool) | If you need to install Velero without a default backup storage location NoDefaultBackupLocation flag is required for confirmation | -| podConfig | *[PodConfig](https://pkg.go.dev/github.com/openshift/oadp-operator@v0.0.0-20220722142130-a02487302a02/api/v1alpha1#PodConfig) | Velero Pod specific configuration | +| podConfig | *[PodConfig](https://pkg.go.dev/github.com/openshift/oadp-operator@v0.0.0-20220727202820-c5f87df8fafd/api/v1alpha1#PodConfig) | Velero Pod specific configuration | | logLevel | [string](https://pkg.go.dev/builtin#string) | Velero server’s log level (default info, use debug for the most logging). Valid options are trace, debug, info, warning, error, fatal, or panic | -### [CustomPlugin](https://pkg.go.dev/github.com/openshift/oadp-operator@v0.0.0-20220722142130-a02487302a02/api/v1alpha1#CustomPlugin) +### [CustomPlugin](https://pkg.go.dev/github.com/openshift/oadp-operator@v0.0.0-20220727202820-c5f87df8fafd/api/v1alpha1#CustomPlugin) | Property | Type | Description | |--------------------|------------|-----------------------------------------------------------------------------| | name | [string](https://pkg.go.dev/builtin#string) | Name of custom plugin | | image | [string](https://pkg.go.dev/builtin#string) | Image of custom plugin | -### [ResticConfig](https://pkg.go.dev/github.com/openshift/oadp-operator@v0.0.0-20220722142130-a02487302a02/api/v1alpha1#ResticConfig) +### [ResticConfig](https://pkg.go.dev/github.com/openshift/oadp-operator@v0.0.0-20220727202820-c5f87df8fafd/api/v1alpha1#ResticConfig) | Property | Type | Description | |--------------------|------------|-----------------------------------------------------------------------------| | enable | *[bool](https://pkg.go.dev/builtin#bool) | Enables backup/restore using Restic. If set to false, snapshots are needed. | | supplementalGroups | [][int64](https://pkg.go.dev/builtin#int64) | SupplementalGroups defines the linux groups to be applied to the Restic Pod | | timeout | [string](https://pkg.go.dev/builtin#string) | Timeout defines the Restic timeout, default value is 1h | -| PodConfig | *[PodConfig](https://pkg.go.dev/github.com/openshift/oadp-operator@v0.0.0-20220722142130-a02487302a02/api/v1alpha1#PodConfig) | Restic Pod specific configuration | +| PodConfig | *[PodConfig](https://pkg.go.dev/github.com/openshift/oadp-operator@v0.0.0-20220727202820-c5f87df8fafd/api/v1alpha1#PodConfig) | Restic Pod specific configuration | -### [PodConfig](https://pkg.go.dev/github.com/openshift/oadp-operator@v0.0.0-20220722142130-a02487302a02/api/v1alpha1#PodConfig) +### [PodConfig](https://pkg.go.dev/github.com/openshift/oadp-operator@v0.0.0-20220727202820-c5f87df8fafd/api/v1alpha1#PodConfig) | Property | Type | Description | |---------------------|-------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------| @@ -72,7 +72,7 @@ | tolerations | [][corev1.Toleration](https://pkg.go.dev/k8s.io/api/core/v1#Toleration) | Tolerations defines the list of tolerations to be applied to Velero Deployment/Restic daemonset | | resourceAllocations | [corev1.ResourceRequirements](https://pkg.go.dev/k8s.io/api/core/v1#ResourceRequirements) | Set specific resource `limits` and `requests` for the Velero/Restic pods. For more information, go [here] ( config/resource_req_limits.md). | -### [Features](https://pkg.go.dev/github.com/openshift/oadp-operator@v0.0.0-20220722142130-a02487302a02/api/v1alpha1#Features) +### [Features](https://pkg.go.dev/github.com/openshift/oadp-operator@v0.0.0-20220727202820-c5f87df8fafd/api/v1alpha1#Features) | Property | Type | Description | |-----------|-----------|-------------------------------------------------------------------------------------------------------------------------------------------| | DataMover | DataMover | DataMover defines the various config for DPA data mover | From 6458b0355a48f87dac18bad3eff87b332588e6ba Mon Sep 17 00:00:00 2001 From: Tiger Kaovilai Date: Fri, 29 Jul 2022 08:49:40 -0400 Subject: [PATCH 7/7] Adding links to datamover, correct property names --- docs/API_ref.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/API_ref.md b/docs/API_ref.md index 80b9b101d3..bc12817b54 100644 --- a/docs/API_ref.md +++ b/docs/API_ref.md @@ -75,12 +75,12 @@ ### [Features](https://pkg.go.dev/github.com/openshift/oadp-operator@v0.0.0-20220727202820-c5f87df8fafd/api/v1alpha1#Features) | Property | Type | Description | |-----------|-----------|-------------------------------------------------------------------------------------------------------------------------------------------| -| DataMover | DataMover | DataMover defines the various config for DPA data mover | +| dataMover | [DataMover](https://pkg.go.dev/github.com/openshift/oadp-operator@v0.0.0-20220727202820-c5f87df8fafd/api/v1alpha1#DataMover) | DataMover defines the various config for DPA data mover | ### DataMover | Property | Type | Description | |------------|------|-------------------------------------------------------------------------------------------------------------------------------| -| Enable | bool | Enable is used to specify whether you want to deploy the volume snapshot mover controller and a modified csi datamover plugin | -| Credential | *corev1.SecretKeySelector | User supplied Restic Secret name for DataMover | | +| enable | [bool](https://pkg.go.dev/builtin#bool) | Enable is used to specify whether you want to deploy the volume snapshot mover controller and a modified csi datamover plugin | +| credentialName | [string](https://pkg.go.dev/builtin#string) | User supplied Restic Secret name for DataMover | | See also [![Go Reference](https://pkg.go.dev/badge/github.com/openshift/oadp-operator.svg)](https://pkg.go.dev/github.com/openshift/oadp-operator) for a deeper dive.