feat: [google-cloud-gke-backup] add fine-grained restore (#12711)

- [ ] Regenerate this pull request now.

BEGIN_COMMIT_OVERRIDE
feat:  add fine-grained restore
feat: add volume restore flexibility
feat: add restore order
feat: add strict-permissive mode
feat: add gitops
docs: update duration comment to include new validation from smart
scheduling
END_COMMIT_OVERRIDE

PiperOrigin-RevId: 635316968

Source-Link:
googleapis/googleapis@bcaed39

Source-Link:
googleapis/googleapis-gen@611b3e4
Copy-Tag:
eyJwIjoicGFja2FnZXMvZ29vZ2xlLWNsb3VkLWdrZS1iYWNrdXAvLk93bEJvdC55YW1sIiwiaCI6IjYxMWIzZTRmNzU0ZWMyMGQyNjhhZDk3M2JhNDVjMzgzNzEwNTlkMTMifQ==

---------

Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>

Author: gcf-owl-bot[bot]

packages/google-cloud-gke-backup/google/cloud/gke_backup/__init__.py

@@ -33,6 +33,7 @@
     NamespacedName,
     NamespacedNames,
     Namespaces,
+    VolumeTypeEnum,
 )
 from google.cloud.gke_backup_v1.types.gkebackup import (
     CreateBackupPlanRequest,
@@ -69,7 +70,12 @@
     UpdateRestorePlanRequest,
     UpdateRestoreRequest,
 )
-from google.cloud.gke_backup_v1.types.restore import Restore, RestoreConfig
+from google.cloud.gke_backup_v1.types.restore import (
+    ResourceSelector,
+    Restore,
+    RestoreConfig,
+    VolumeDataRestorePolicyOverride,
+)
 from google.cloud.gke_backup_v1.types.restore_plan import RestorePlan
 from google.cloud.gke_backup_v1.types.volume import VolumeBackup, VolumeRestore
 
@@ -84,6 +90,7 @@
     "NamespacedName",
     "NamespacedNames",
     "Namespaces",
+    "VolumeTypeEnum",
     "CreateBackupPlanRequest",
     "CreateBackupRequest",
     "CreateRestorePlanRequest",
@@ -117,8 +124,10 @@
     "UpdateBackupRequest",
     "UpdateRestorePlanRequest",
     "UpdateRestoreRequest",
+    "ResourceSelector",
     "Restore",
     "RestoreConfig",
+    "VolumeDataRestorePolicyOverride",
     "RestorePlan",
     "VolumeBackup",
     "VolumeRestore",

packages/google-cloud-gke-backup/google/cloud/gke_backup_v1/__init__.py

@@ -21,7 +21,13 @@
 from .services.backup_for_gke import BackupForGKEAsyncClient, BackupForGKEClient
 from .types.backup import Backup
 from .types.backup_plan import BackupPlan, ExclusionWindow, RpoConfig
-from .types.common import EncryptionKey, NamespacedName, NamespacedNames, Namespaces
+from .types.common import (
+    EncryptionKey,
+    NamespacedName,
+    NamespacedNames,
+    Namespaces,
+    VolumeTypeEnum,
+)
 from .types.gkebackup import (
     CreateBackupPlanRequest,
     CreateBackupRequest,
@@ -57,7 +63,12 @@
     UpdateRestorePlanRequest,
     UpdateRestoreRequest,
 )
-from .types.restore import Restore, RestoreConfig
+from .types.restore import (
+    ResourceSelector,
+    Restore,
+    RestoreConfig,
+    VolumeDataRestorePolicyOverride,
+)
 from .types.restore_plan import RestorePlan
 from .types.volume import VolumeBackup, VolumeRestore
 
@@ -100,6 +111,7 @@
     "NamespacedNames",
     "Namespaces",
     "OperationMetadata",
+    "ResourceSelector",
     "Restore",
     "RestoreConfig",
     "RestorePlan",
@@ -109,5 +121,7 @@
     "UpdateRestorePlanRequest",
     "UpdateRestoreRequest",
     "VolumeBackup",
+    "VolumeDataRestorePolicyOverride",
     "VolumeRestore",
+    "VolumeTypeEnum",
 )

packages/google-cloud-gke-backup/google/cloud/gke_backup_v1/types/__init__.py

@@ -15,7 +15,13 @@
 #
 from .backup import Backup
 from .backup_plan import BackupPlan, ExclusionWindow, RpoConfig
-from .common import EncryptionKey, NamespacedName, NamespacedNames, Namespaces
+from .common import (
+    EncryptionKey,
+    NamespacedName,
+    NamespacedNames,
+    Namespaces,
+    VolumeTypeEnum,
+)
 from .gkebackup import (
     CreateBackupPlanRequest,
     CreateBackupRequest,
@@ -51,7 +57,12 @@
     UpdateRestorePlanRequest,
     UpdateRestoreRequest,
 )
-from .restore import Restore, RestoreConfig
+from .restore import (
+    ResourceSelector,
+    Restore,
+    RestoreConfig,
+    VolumeDataRestorePolicyOverride,
+)
 from .restore_plan import RestorePlan
 from .volume import VolumeBackup, VolumeRestore
 
@@ -64,6 +75,7 @@
     "NamespacedName",
     "NamespacedNames",
     "Namespaces",
+    "VolumeTypeEnum",
     "CreateBackupPlanRequest",
     "CreateBackupRequest",
     "CreateRestorePlanRequest",
@@ -97,8 +109,10 @@
     "UpdateBackupRequest",
     "UpdateRestorePlanRequest",
     "UpdateRestoreRequest",
+    "ResourceSelector",
     "Restore",
     "RestoreConfig",
+    "VolumeDataRestorePolicyOverride",
     "RestorePlan",
     "VolumeBackup",
     "VolumeRestore",

packages/google-cloud-gke-backup/google/cloud/gke_backup_v1/types/backup.py

@@ -171,6 +171,14 @@ class Backup(proto.Message):
         config_backup_size_bytes (int):
             Output only. The size of the config backup in
             bytes.
+        permissive_mode (bool):
+            Output only. If false, Backup will fail when Backup for GKE
+            detects Kubernetes configuration that is non-standard or
+            requires additional setup to restore.
+
+            Inherited from the parent BackupPlan's
+            [permissive_mode][google.cloud.gkebackup.v1.BackupPlan.BackupConfig.permissive_mode]
+            value.
     """
 
     class State(proto.Enum):
@@ -387,6 +395,10 @@ class ClusterMetadata(proto.Message):
         proto.INT64,
         number=27,
     )
+    permissive_mode: bool = proto.Field(
+        proto.BOOL,
+        number=28,
+    )
 
 
 __all__ = tuple(sorted(__protobuf__.manifest))

packages/google-cloud-gke-backup/google/cloud/gke_backup_v1/types/backup_plan.py

@@ -313,6 +313,13 @@ class BackupConfig(proto.Message):
 
                 Default (empty): Config backup artifacts will
                 not be encrypted.
+            permissive_mode (bool):
+                Optional. If false, Backups will fail when
+                Backup for GKE detects Kubernetes configuration
+                that is non-standard or requires additional
+                setup to restore.
+
+                Default: False
         """
 
         all_namespaces: bool = proto.Field(
@@ -345,6 +352,10 @@ class BackupConfig(proto.Message):
             number=6,
             message=common.EncryptionKey,
         )
+        permissive_mode: bool = proto.Field(
+            proto.BOOL,
+            number=7,
+        )
 
     name: str = proto.Field(
         proto.STRING,
@@ -474,9 +485,10 @@ class ExclusionWindow(proto.Message):
             Required. Specifies the start time of the
             window using time of the day in UTC.
         duration (google.protobuf.duration_pb2.Duration):
-            Required. Specifies duration of the window. Restrictions for
-            duration based on the recurrence type to allow some time for
-            backup to happen:
+            Required. Specifies duration of the window. Duration must be
+            >= 5 minutes and < (target RPO - 20 minutes). Additional
+            restrictions based on the recurrence type to allow some time
+            for backup to happen:
 
             -  single_occurrence_date: no restriction, but UI may warn
                about this when duration >= target RPO

packages/google-cloud-gke-backup/google/cloud/gke_backup_v1/types/common.py

@@ -26,6 +26,7 @@
         "NamespacedName",
         "NamespacedNames",
         "EncryptionKey",
+        "VolumeTypeEnum",
     },
 )
 
@@ -98,4 +99,20 @@ class EncryptionKey(proto.Message):
     )
 
 
+class VolumeTypeEnum(proto.Message):
+    r"""Message to encapsulate VolumeType enum."""
+
+    class VolumeType(proto.Enum):
+        r"""Supported volume types.
+
+        Values:
+            VOLUME_TYPE_UNSPECIFIED (0):
+                Default
+            GCE_PERSISTENT_DISK (1):
+                Compute Engine Persistent Disk volume
+        """
+        VOLUME_TYPE_UNSPECIFIED = 0
+        GCE_PERSISTENT_DISK = 1
+
+
 __all__ = tuple(sorted(__protobuf__.manifest))