10장. VolumeAttachment [storage.k8s.io/v1]
- 설명
VolumeAttachment는 지정된 볼륨을 지정된 노드에서/에서 연결하거나 분리하려는 의도를 캡처합니다.
VolumeAttachment 오브젝트는 네임스페이스가 아닙니다.
- 유형
-
object - 필수 항목
-
spec
-
10.1. 사양
| 속성 | 유형 | 설명 |
|---|---|---|
|
|
| APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
|
| kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
|
| 표준 오브젝트 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata | |
|
|
| VolumeAttachmentSpec은 VolumeAttachment 요청 사양입니다. |
|
|
| VolumeAttachmentStatus는 VolumeAttachment 요청의 상태입니다. |
10.1.1. .spec
- 설명
- VolumeAttachmentSpec은 VolumeAttachment 요청 사양입니다.
- 유형
-
object - 필수 항목
-
attacher -
소스 -
nodeName
-
| 속성 | 유형 | 설명 |
|---|---|---|
|
|
| attacher는 이 요청을 처리해야 하는 볼륨 드라이버의 이름을 나타냅니다. GetPluginName()에서 반환한 이름입니다. |
|
|
| nodename은 볼륨을 연결해야 하는 노드를 나타냅니다. |
|
|
| VolumeAttachmentSource는 연결해야 하는 볼륨을 나타냅니다. 이제 PersistenVolume만 외부 연결기를 통해 연결할 수 있습니다. 나중에 Pod에서 인라인 볼륨도 허용할 수 있습니다. 정확히 하나의 멤버를 설정할 수 있습니다. |
10.1.2. .spec.source
- 설명
- VolumeAttachmentSource는 연결해야 하는 볼륨을 나타냅니다. 이제 PersistenVolume만 외부 연결기를 통해 연결할 수 있습니다. 나중에 Pod에서 인라인 볼륨도 허용할 수 있습니다. 정확히 하나의 멤버를 설정할 수 있습니다.
- 유형
-
object
| 속성 | 유형 | 설명 |
|---|---|---|
|
| inlineVolumeSpec에는 Pod의 인라인 VolumeSource에서 정의한 영구 볼륨을 연결하는 데 필요한 모든 정보가 포함되어 있습니다. 이 필드는 CSIMigration 기능에 대해서만 채워집니다. Pod의 인라인 VolumeSource에서 PersistentVolumeSpec으로 변환된 필드가 포함되어 있습니다. 이 필드는 베타 수준이며 CSIMigration 기능을 활성화한 서버에서만 적용됩니다. | |
|
|
| persistentVolumeName은 연결할 영구 볼륨의 이름을 나타냅니다. |
10.1.3. .status
- 설명
- VolumeAttachmentStatus는 VolumeAttachment 요청의 상태입니다.
- 유형
-
object - 필수 항목
-
연결됨
-
| 속성 | 유형 | 설명 |
|---|---|---|
|
|
| VolumeError는 볼륨 작업 중에 발생한 오류를 캡처합니다. |
|
|
| attached는 볼륨이 성공적으로 연결되었음을 나타냅니다. 이 필드는 연결 작업을 완료하는 엔티티(예: external-attacher)만 설정해야 합니다. |
|
|
| attachmentMetadata는 연결 작업에서 반환한 모든 정보로 채워집니다. 이 연결은 후속 WaitForAttach 또는 Mount 호출로 전달되어야 합니다. 이 필드는 연결 작업을 완료하는 엔티티(예: external-attacher)만 설정해야 합니다. |
|
|
| VolumeError는 볼륨 작업 중에 발생한 오류를 캡처합니다. |
10.1.4. .status.attachError
- 설명
- VolumeError는 볼륨 작업 중에 발생한 오류를 캡처합니다.
- 유형
-
object
| 속성 | 유형 | 설명 |
|---|---|---|
|
|
| message는 Attach 또는 Detach 작업 중에 발생한 오류를 나타냅니다. 이 문자열은 기록될 수 있으므로 민감한 정보를 포함해서는 안 됩니다. |
|
| Time은 오류가 발생한 시간을 나타냅니다. |
10.1.5. .status.detachError
- 설명
- VolumeError는 볼륨 작업 중에 발생한 오류를 캡처합니다.
- 유형
-
object
| 속성 | 유형 | 설명 |
|---|---|---|
|
|
| message는 Attach 또는 Detach 작업 중에 발생한 오류를 나타냅니다. 이 문자열은 기록될 수 있으므로 민감한 정보를 포함해서는 안 됩니다. |
|
| Time은 오류가 발생한 시간을 나타냅니다. |
