퍼시스턴트 볼륨

퍼시스턴트 볼륨 (PersistentVolume)

이 페이지는 클러스터 안에 프로비저닝된 저장소를 나타내는 PersistentVolume 객체를 설명해요. 네임스페이스와 무관한 저장 리소스를 나타내는 구조체랍니다.

출처: Kubernetes API Reference

PersistentVolume (PV)은 클러스터 안에 프로비저닝된 저장소입니다.

apiVersion: v1

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

PersistentVolume (PV)은 클러스터 안에 프로비저닝된 저장소입니다.

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`
PersistentVolumeSpec	spec는 영구 볼륨의 원하는 상태를 정의합니다. 자세한 내용: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
`status`
PersistentVolumeStatus	status는 영구 볼륨의 현재 상태를 나타냅니다. 자세한 내용: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status

PersistentVolumeSpec는 영구 볼륨의 원하는 상태를 정의합니다.

Field	Description
`accessModes`
string array	accessModes는 볼륨을 마운트하고 액세스할 수 있는 방법을 정의합니다. 유효한 값은 ReadWriteOnce, ReadOnlyMany, ReadWriteMany, ReadWriteOncePod입니다. 자세한 내용: https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes
`capacity`
object	capacity는 영구 볼륨에 포함된 저장 공간의 설명입니다.
`claimRef`
ObjectReference	claimRef는 이 영구 볼륨에 바인딩된 PersistentVolumeClaim의 참조입니다. 일반적으로 영구 볼륨 컨트롤러에 의해 자동으로 설정됩니다.
`mountOptions`
string array	mountOptions는 탑재되는 동안 마운트에 전달되는 옵션입니다. 권장 형식은 파일 시스템별 옵션입니다.
`nodeAffinity`
VolumeNodeAffinity	nodeAffinity는 이 볼륨이 마운트될 수 있는 노드에 대한 제약 조건을 정의합니다.
`persistentVolumeReclaimPolicy`
string	persistentVolumeReclaimPolicy는 PV에서 PVC가 해제된 후의 동작을 정의합니다. 유효한 값은 Retain, Delete, Recycle입니다.
`storageClassName`
string	storageClassName은 이 영구 볼륨이 속한 StorageClass의 이름입니다.
`volumeMode`
string	volumeMode는 영구 볼륨이 블록 장치이거나 파일 시스템일 수 있음을 정의합니다. 유효한 값은 Filesystem, Block입니다.
`volumeAttributes`
map[string]string	volumeAttributes는 각 PersistentVolume에 대한 추가 속성의 맵입니다.

VolumeNodeAffinity는 볼륨이 마운트될 수 있는 노드를 제한하는 노드 선호도를 정의합니다.

Field	Description
`required`
NodeSelector	required는 볼륨이 탑재될 수 있는 노드를 지정합니다.

PersistentVolumeStatus는 영구 볼륨의 현재 상태를 나타냅니다.

Field	Description
`lastPhaseTransitionTime`
Time	lastPhaseTransitionTime는 볼륨의 단계(phase)가 마지막으로 전환된 시간입니다.
`message`
string	message는 휴먼이 읽을 수 있는 상태에 대한 메시지입니다.
`phase`
string	phase는 바인딩된 볼륨이 현재 상태를 나타냅니다. 유효한 값은 Pending, Available, Bound, Released, Failed입니다.
`reason`
string	reason는 상태가 현재 상태가 된 이유를 나타내는 사람이 읽을 수 있는 정보입니다.