퍼시스턴트 볼륨 클레임

퍼시스턴트 볼륨 클레임 (PersistentVolumeClaim)

이 페이지는 사용자가 저장소를 요청하는 방법을 나타내는 PersistentVolumeClaim 객체를 설명해요. 네임스페이스 범위에서 볼륨을 요청하고 바인딩하는 구조체랍니다.

출처: Kubernetes API Reference

본문

PersistentVolumeClaim은 클러스터에서 저장소의 사용자가 요청하는 방법입니다.

apiVersion: v1

import "k8s.io/api/core/v1"

PersistentVolumeClaim

PersistentVolumeClaim은 클러스터에서 저장소의 사용자가 요청하는 방법입니다.


Field Description
apiVersion
string APIVersion은 이 객체 표현의 버전 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않은 값은 거부할 수 있습니다. 자세한 내용: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
kind
string Kind는 이 객체가 나타내는 REST 리소스를 나타내는 문자열 값입니다. 서버는 클라이언트가 요청을 제출하는 엔드포인트에서 이를 추론할 수 있습니다. 업데이트할 수 없습니다. CamelCase 형식입니다. 자세한 내용: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
metadata
ObjectMeta 객체의 표준 메타데이터입니다. 자세한 내용: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
spec
PersistentVolumeClaimSpec spec는 원하는 볼륨 특성을 정의합니다. 자세한 내용: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
status
PersistentVolumeClaimStatus status는 볼륨의 현재 상태를 나타냅니다. 자세한 내용: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status

PersistentVolumeClaimSpec

PersistentVolumeClaimSpec는 영구 볼륨 클레임의 원하는 특성을 설명합니다.


Field Description
accessModes
string array accessModes는 권한을 정의하며, 볼륨을 마운트하고 접근할 수 있는 방법을 나타냅니다. 유효한 값은 ReadWriteOnce, ReadOnlyMany, ReadWriteMany, ReadWriteOncePod입니다.
dataSource
TypedLocalObjectReference dataSource는 클레임을 채울 소스 데이터를 나타내는 객체 참조입니다.
dataSourceRef
TypedObjectReference dataSourceRef는 클레임을 채울 소스 데이터를 나타내는 객체 참조로, dataSource보다 다양한 소스를 지원할 수 있습니다.
resources
VolumeResourceRequirements resources는 클레임을 위한 리소스 요청 및 제한을 나타냅니다.
selector
LabelSelector selector는 바인딩을 위한 PersistentVolume을 선택하기 위한 라벨 셀렉터입니다.
storageClassName
string storageClassName은 클레임에 요청된 StorageClass의 이름입니다.
volumeMode
string volumeMode는 볼륨이 블록 장치로 사용될 수 있음을 정의합니다. 유효한 값은 Filesystem, Block입니다.
volumeName
string volumeName은 이 클레임이 참조하는 특정 볼륨의 바인딩 참조입니다.

VolumeResourceRequirements

VolumeResourceRequirements는 볼륨 클레임에 대한 리소스 요청 및 제한을 나타냅니다.


Field Description
limits
object limits는 최대 볼륨 크기 요구 사항을 나타냅니다.
requests
object requests는 최소 볼륨 크기 요구 사항을 나타냅니다.

PersistentVolumeClaimStatus

PersistentVolumeClaimStatus는 영구 볼륨 클레임의 현재 상태를 나타냅니다.


Field Description
accessModes
string array accessModes는 볼륨에 대한 액세스 모드의 목록입니다.
allocatedResourceStatuses
map[string]string allocatedResourceStatuses는 각 할당된 리소스의 상태를 나타냅니다.
allocatedResources
object allocatedResources는 클레임에 할당된 리소스의 맵입니다.
capacity
object capacity는 실제 클레임에 대한 현재 리소스 용량의 맵입니다.
conditions
PersistentVolumeClaimCondition array conditions는 관찰 가능한 PersistentVolumeClaim 상태의 목록입니다.
currentVolumeAttributesClassName
string currentVolumeAttributesClassName은 현재 볼륨 특성 클래스의 이름입니다.
phase
string phase는 실제 클레임에 대한 현재 상태입니다. 유효한 값은 Pending, Bound, Lost입니다.

PersistentVolumeClaimCondition

PersistentVolumeClaimCondition는 PersistentVolumeClaim의 상태 조건을 나타냅니다.


Field Description
lastProbeTime
Time lastProbeTime는 조건이 마지막으로 조사된 시간입니다.
lastTransitionTime
Time lastTransitionTime는 조건이 한 상태에서 다른 상태로 전환된 마지막 시간입니다.
message
string message는 조건에 대한 세부 정보를 포함하는 사람이 읽을 수 있는 메시지입니다.
reason
string reason는 조건의 마지막 전환에 대한 이유입니다.
status *****
string status는 조건의 상태입니다. True, False, Unknown 중 하나입니다.
type *****
string type는 조건의 유형입니다.

더 알아보기 (Learn more)