KRM API gkebackup.gke.io/v1 API

gkebackup.gke.io/v1

gkebackup.gke.io v1 API 그룹의 API 스키마 정의가 포함되어 있습니다.

BackupAllRestoreAll

이 구성요소에서 선택된 모든 항목을 백업하고 복원 중에 모든 항목을 복원하는 전략을 정의합니다.

표시 위치: - 전략

필드	설명
backupPreHooks HookSpec 배열	이 구성요소의 선택된 모든 볼륨을 백업하기 전에 실행되는 후크 목록입니다. 일반적으로 정지 단계입니다. 실행 타겟 포드는 이 구성요소 내의 모든 포드입니다.
backupPostHooks HookSpec 배열	이 구성요소의 모든 볼륨이 백업된 후 실행되는 후크 목록입니다. 일반적으로 정지 해제 단계입니다. 실행 타겟 포드는 이 구성요소 내의 모든 포드입니다.
volumeSelector LabelSelector	이 구성요소 내에서 백업 및 복원되는 영구 볼륨을 선택하는 데 사용되는 라벨 선택기입니다. 이 값이 제공되지 않으면 모든 영구 볼륨이 선택됩니다.

BackupJobList

백업 작업 목록을 포함합니다.

필드	설명
apiVersion 문자열	gkebackup.gke.io/v1
kind 문자열	BackupJobList
metadata ListMeta	metadata 필드는 Kubernetes API 문서를 참고하세요.
items BackupJob 배열

BackupJobSpec

백업 작업에 대해 원하는 상태를 정의합니다.

표시 위치: - BackupJob

필드	설명
backupName 문자열	백업 작업이 실행되는 컨트롤 플레인 백업 이름입니다. 이름은 변경할 수 없습니다.

BackupJobStatus

백업 작업의 관찰된 상태를 정의합니다.

표시 위치: - BackupJob

필드	설명
phase BackupJobPhase	백업의 현재 단계입니다.
message 문자열	백업이 이 상태인 이유에 대한 세부정보를 나타내는 사람이 읽을 수 있는 메시지입니다.
reason 문자열	업데이트를 설명하고 머신 파싱 및 깔끔한 표시를 위해 사용되는 간단한 카멜 케이스 문자열입니다.

BackupOneRestoreAll

이 구성요소 내의 한 포드에서만 볼륨을 백업하는 전략을 정의하며, 이러한 볼륨은 복원 중에 다른 모든 포드로 복원됩니다. 이 전략은 하나의 기본 및 하나 이상의 보조로 구성된 고가용성 구성에 배포된 애플리케이션에 사용됩니다. 이 전략은 정의된 volumeClaimTemplate 리소스를 사용하여 볼륨을 프로비저닝하는 StatefulSet 구성요소에만 적용됩니다.

구성요소가 여러 Deployment 리소스로 구성된 경우 모든 배포에는 정확히 하나의 복제본이 있어야 하고, 모든 복제본에는 동일한 수의 영구 볼륨이 있어야 하며, 모든 영구 볼륨은 동일한 순서로 정의되어야 합니다. 이러한 볼륨은 .spec.template.spec.volumes 필드에 정의되어 있으며 비영구 볼륨은 건너뜁니다.

구성요소가 여러 StatefulSet 리소스로 구성된 경우 모든 StatefulSet 리소스의 볼륨 클레임 템플릿 수가 동일해야 하며 모든 볼륨 클레임 템플릿이 동일한 순서를 따라야 합니다. .spec.volumeClaimTemplates 필드에 정의됩니다.

표시 위치: - 전략

필드	설명
backupTargetName 문자열	백업에 사용되는 기본 Deployment 또는 StatefulSet 리소스의 이름입니다. 이 구성요소가 구성된 방식에 따라 타겟 포드가 선택됩니다. 다중 Deployment의 경우 이 Deployment 리소스에 의해 생성된 포드를 선택합니다. 다중 StatefulSet의 경우 타겟 StatefulSet 리소스에 의해 생성된 첫 번째 포드를 선택합니다. 단일 StatefulSet의 경우 타겟 StatefulSet 리소스에 의해 생성된 두 번째 포드를 선택합니다.
backupPreHooks HookSpec 배열	이 구성요소의 선택된 모든 볼륨을 백업하기 전에 실행되는 후크 목록입니다. 일반적으로 정지 단계입니다. 후크는 선택된 백업 포드에서만 실행됩니다.
backupPostHooks HookSpec 배열	이 구성요소의 모든 볼륨이 백업된 후 실행되는 후크 목록입니다. 일반적으로 정지 해제 단계입니다. 후크는 선택된 백업 포드에서만 실행됩니다.
volumeSelector LabelSelector	타겟 포드 내에서 백업된 모든 영구 볼륨을 선택하는 데 사용되는 라벨 선택기입니다. 선택기가 타겟 포드 외부의 볼륨을 선택할 수 있지만 타겟 포드에 속하는 볼륨만 백업됩니다. 이러한 볼륨 백업은 복원 중에 선택기로 선택된 다른 모든 볼륨에 복원됩니다. 이 값이 제공되지 않으면 모든 영구 볼륨이 선택됩니다.

구성요소

애플리케이션 리소스와 백업 및 복원 전략의 하위 집합을 정의합니다. 개별 구성요소는 StatefulSet 또는 Deployment 리소스 목록으로 표시됩니다.

표시 위치: - ProtectedApplicationSpec

필드	설명
name 문자열	이 구성요소의 고유한 이름입니다.
resourceKind ResourceKind	이 구성요소에 포함된 리소스의 종류입니다. 리소스 종류는 Deployment, StatefulSet 또는 Pod일 수 있습니다. Pod 리소스 종류는 현재 BackupAllRestoreAll 전략만 지원합니다.
resourceNames 문자열 배열	이 구성요소에 속하는 리소스의 이름입니다. resourceKind 필드에 정의된 내용을 기반으로 하는 Deployment, StatefulSet 또는 Pod 리소스의 이름 목록이어야 합니다.
strategy 전략	이 구성요소를 백업하고 복원하는 방법에 관한 세부정보입니다.

DumpAndLoad

구성요소의 백업 및 복원이 MySQL의 경우 mysqldump, PostgreSQL의 경우 pg_dump과 같은 데이터를 덤프하고 로드하는 애플리케이션별 도구를 사용하여 달성되는 전략을 정의합니다. 덤프 파일은 전용 볼륨에 저장됩니다. 이 전략에서는 전용 볼륨만 백업하도록 선택됩니다. 덤프 대상과 로드 대상은 다를 수 있습니다. 이 전략은 정의된 volumeClaimTemplate 리소스를 사용하여 볼륨을 프로비저닝하는 StatefulSet 구성요소에만 적용됩니다.

표시 위치: - 전략

필드	설명
dumpTarget 문자열	구성요소 데이터를 덤프하는 데 사용되는 기본 Deployment 또는 StatefulSet 리소스의 이름입니다. 이 구성요소가 구성된 방식에 따라 타겟 포드가 선택됩니다. Deployment의 경우 타겟 Deployment 리소스에 의해 생성된 포드만 선택합니다. 단일 StatefulSet의 경우 복제본 수가 2보다 크면 타겟 StatefulSet 리소스에 의해 생성된 두 번째 포드를 선택합니다. 그렇지 않은 경우 유일한 Pod을 선택합니다. 다중 StatefulSet의 경우 타겟 StatefulSet 리소스에 의해 생성된 첫 번째 포드를 선택합니다.
loadTarget 문자열	구성요소 데이터를 로드하는 데 사용되는 기본 Deployment 또는 StatefulSet 리소스의 이름입니다. 이 구성요소가 구성된 방식에 따라 타겟 포드가 선택됩니다. Deployment의 경우 타겟 Deployment 리소스에 의해 생성된 유일한 포드를 선택합니다. StatefulSet의 경우 항상 타겟 StatefulSet 리소스에 의해 생성된 첫 번째 포드를 선택합니다.
dumpHooks HookSpec 배열	이 구성요소의 데이터를 전용 볼륨에 덤프하는 데 사용되는 후크 목록입니다. 실행 타겟 포드는 DumpTarget 필드에서 선택한 포드 중 하나입니다.
backupPostHooks HookSpec 배열	전용 덤프 볼륨이 백업된 후 실행되는 후크 목록입니다. 일반적으로 정리 단계입니다.
loadHooks HookSpec 배열	전용 볼륨에서 이 구성요소의 데이터를 로드하는 데 사용되는 후크 목록입니다. 로드 완료 후 정리 단계가 포함될 수 있습니다. 실행 타겟 포드는 LoadTarget 필드에서 선택한 포드 중 하나입니다.
volumeSelector LabelSelector	애플리케이션 데이터를 덤프하고 로드하는 데 사용되는 전용 볼륨을 선택해야 하는 라벨 선택기입니다. DumpTarget 및 LoadTarget 필드 모두에서 볼륨을 하나만 선택해야 합니다.

HookFailurePolicy

기본 유형: string 후크 실행에 오류가 발생할 경우 원하는 동작입니다.

표시 위치: - HookSpec

HookSpec

타겟 포드가 선택되었다고 가정할 때 선택된 컨테이너에서 후크가 실행되는 방식을 정의합니다.

표시 위치: - BackupAllRestoreAll - BackupOneRestoreAll - DumpAndLoad

필드	설명
name 문자열	이 후크의 이름입니다. 이 필드는 후크 실행 상태와 발생한 오류를 식별하는 데 사용됩니다.
container 문자열	이 후크가 실행되는 컨테이너입니다. 지정하지 않으면 Pod의 첫 번째 컨테이너에서 실행됩니다.
command 문자열 배열	실행할 명령어입니다. 실행할 후크 명령어입니다. 예를 들면 ["/sbin/fsfreeze", "--freeze"]입니다.
timeoutSeconds 정수	후크의 제한 시간(초)입니다. 지정하지 않으면 기본값은 30입니다.
onError HookFailurePolicy	후크 실행 시 오류가 발생할 때 따라야 하는 원하는 동작입니다. 유효한 값은 Ignore 또는 Fail입니다. 지정하지 않으면 값은 Fail입니다.

ProtectedApplication

Protectedapplication API의 스키마를 정의합니다.

표시 위치: - ProtectedApplicationList

필드	설명
apiVersion 문자열	gkebackup.gke.io/v1
kind 문자열	ProtectedApplication
metadata ObjectMeta	metadata 필드는 Kubernetes API 문서를 참고하세요.
spec ProtectedApplicationSpec
status ProtectedApplicationStatus

ProtectedApplicationError

이 ProtectedApplication 리소스에 대한 자세한 오류 정보를 포함합니다.

표시 위치: - ProtectedApplicationStatus

필드	설명
reason 문자열	오류를 설명하고 머신 파싱 및 깔끔한 표시를 위해 사용되는 카멜 표기법 문자열입니다.
message 문자열	오류에 대한 세부정보를 나타내는 인간이 읽을 수 있는 메시지입니다.

ProtectedApplicationList

ProtectedApplication 리소스 목록이 포함됩니다.

필드	설명
apiVersion 문자열	gkebackup.gke.io/v1
kind 문자열	ProtectedApplicationList
metadata ListMeta	metadata 필드는 Kubernetes API 문서를 참고하세요.
items ProtectedApplication 배열

ProtectedApplicationSpec

ProtectedApplication에 속하는 관련 리소스와 지정된 애플리케이션을 백업하거나 복원하는 방법을 정의합니다.

표시 위치: - ProtectedApplication

필드	설명
resourceSelection ResourceSelection	이 ProtectedApplication에 속하는 리소스입니다.
components 구성요소 배열	이 보호된 애플리케이션의 구성요소입니다.

ProtectedApplicationStatus

이 ProtectedApplication 리소스의 상태를 정의합니다.

표시 위치: - ProtectedApplication

필드	설명
readyToBackup 불리언	이 ProtectedApplication 리소스가 백업할 준비가 되었는지 여부를 지정합니다. ProtectedApplication 리소스에 오류가 포함되어 있으면 준비되지 않은 것입니다.
error ProtectedApplicationError 배열	이 보호된 애플리케이션과 관련된 오류입니다. 예를 들어 한 구성요소 구성이 잘못되었습니다.

ResourceKind

기본 유형: string 리소스의 종류를 정의합니다.

표시 위치: - 구성요소

ResourceSelection

이 애플리케이션에 속한 리소스를 식별하는 방법을 정의합니다.

표시 위치: - ProtectedApplicationSpec

필드	설명
type ResourceSelectionType	애플리케이션 소스 유형입니다. Type 필드는 ApplicationName 또는 Selector이어야 합니다. 유니온 식별자입니다.
applicationName 문자열	동일한 네임스페이스 내 sig-apps 애플리케이션의 이름입니다. 데이터 보호 사양이 적용되는 애플리케이션입니다.
selector LabelSelector	선택된 ProtectedApplication 리소스와 동일한 네임스페이스에 있는 리소스 데이터 보호 사양이 이러한 리소스에 적용됩니다.

ResourceSelectionType

기본 유형: string 선택 유형입니다.

표시 위치: - ResourceSelection

RestoreJob

RestoreJob API의 스키마를 정의합니다.

표시 위치: - RestoreJobList

필드	설명
apiVersion 문자열	gkebackup.gke.io/v1
kind 문자열	RestoreJob
metadata ObjectMeta	metadata 필드는 Kubernetes API 문서를 참고하세요.
spec RestoreJobSpec
status RestoreJobStatus

RestoreJobList

RestoreJob 리소스 목록이 포함됩니다.

필드	설명
apiVersion 문자열	gkebackup.gke.io/v1
kind 문자열	RestoreJobList
metadata ListMeta	metadata 필드는 Kubernetes API 문서를 참고하세요.
items RestoreJob 배열

RestoreJobSpec

복원에 대해 원하는 상태를 정의합니다.

표시 위치: - RestoreJob

필드	설명
restoreName 문자열	RestoreName은 RestoreJob이 실행되는 컨트롤 플레인 복원 이름입니다. 이름은 변경할 수 없습니다.

RestoreJobStatus

복원 작업의 관찰된 상태를 정의합니다.

표시 위치: - RestoreJob

필드	설명
phase RestoreJobPhase	복원의 현재 상태입니다.
message 문자열	백업 복원이 이 상태인 이유에 대한 세부정보를 나타내는 사람이 읽을 수 있는 메시지입니다.
reason 문자열	업데이트를 설명하고 머신 파싱 및 깔끔한 표시를 위해 사용되는 카멜 표기법 문자열입니다.

전략

특정 구성요소의 백업 및 복원 방법을 정의합니다. BackupAllRestoreAll, BackupOneRestoreAll, DumpAndLoad 중 하나여야 합니다.

표시 위치: - 구성요소

필드	설명
type StrategyType	백업 및 복원 전략의 유형입니다. 값은 BackupAllRestoreAll, BackupOneRestoreAll 또는 DumpAndLoad일 수 있습니다. Pod 리소스 종류는 BackupAllRestoreAll 전략만 지원합니다. 유니온 식별자입니다.
backupAllRestoreAll BackupAllRestoreAll	이 구성요소에서 선택된 모든 항목을 백업하고 복원 중에 모든 항목을 복원하는 전략입니다.
backupOneRestoreAll BackupOneRestoreAll	이 구성요소 내의 한 포드에서만 볼륨을 백업하고 복원 중에 다른 모든 포드로 복원하는 전략입니다. 이 전략은 하나의 기본 및 하나 이상의 보조로 구성된 고가용성 구성에 배포된 애플리케이션에 사용됩니다. 이 전략은 정의된 volumeClaimTemplate 리소스를 사용하여 볼륨을 프로비저닝하는 StatefulSet 구성요소에만 적용됩니다.
dumpAndLoad DumpAndLoad	구성요소의 백업 및 복원이 MySQL의 경우 mysqldump, PostgreSQL의 경우 pg_dump와 같은 데이터를 덤프하고 로드하는 애플리케이션별 도구를 사용하여 이루어지는 전략입니다. 덤프 파일은 전용 볼륨에 저장됩니다. 이 전략에서는 전용 볼륨만 백업하도록 선택해야 합니다. 덤프 타겟과 로드 타겟은 다를 수 있습니다. 이 전략은 정의된 volumeClaimTemplate 리소스를 사용하여 볼륨을 프로비저닝하는 StatefulSet 구성요소에만 적용됩니다.

StrategyType

기본 유형: string 구성요소의 백업 및 복원 전략을 정의합니다.

표시 위치: - 전략