5.7. CSI 자동 마이그레이션
일반적으로 OpenShift Container Platform과 함께 제공되는 in-tree 스토리지 드라이버는 더 이상 사용되지 않으며 동등한 CSI(Container Storage Interface) 드라이버로 교체됩니다. OpenShift Container Platform은 동등한 CSI 드라이버에 인트리 볼륨 플러그인에 대한 자동 마이그레이션을 제공합니다.
5.7.1. 개요
이 기능은 in-tree 스토리지 플러그인을 사용하여 프로비저닝된 볼륨을 CSI(Container Storage Interface) 드라이버에 자동으로 마이그레이션합니다.
이 프로세스는 데이터 마이그레이션을 수행하지 않습니다. OpenShift Container Platform은 메모리의 영구 볼륨 오브젝트만 변환합니다. 결과적으로 변환된 영구 볼륨 오브젝트는 디스크에 저장되지 않으며 내용이 변경되지도 않습니다. CSI 자동 마이그레이션이 원활해야 합니다. 이 기능은 기존 API 오브젝트(예: PersistentVolumes
,PersistentVolumeClaims
, StorageClasses
)를 사용하는 방법을 변경하지 않습니다.
CSI 드라이버로 다음 인트리가 자동으로 마이그레이션됩니다.
- Azure Disk
- OpenStack Cinder
- AWS(Amazon Web Services) EBS(Elastic Block Storage)
- GCP PD(Google Compute Engine Persistent Disk)
- Azure File
- VMware vSphere( vSphere의 특정 마이그레이션 동작은 아래 참조)
이러한 볼륨 유형의 CSI 마이그레이션은 일반적으로 사용 가능한 것으로 간주되며 수동 개입이 필요하지 않습니다.
CSI(In-tree 영구 볼륨) 또는 PVC(영구 볼륨 클레임)의 자동 마이그레이션은 원래의 in-tree 스토리지 플러그인에서 지원하지 않는 경우 스냅샷 또는 확장과 같은 새로운 CSI 드라이버 기능을 활성화하지 않습니다.
5.7.2. 스토리지 클래스의 영향
새로운 OpenShift Container Platform 4.13 이상의 경우 기본 스토리지 클래스는 CSI 스토리지 클래스입니다. 이 스토리지 클래스를 사용하여 프로비저닝된 모든 볼륨은 CSI PV(영구 볼륨)입니다.
4.12 및 이전 버전에서 4.13 이상으로 업그레이드된 클러스터의 경우 CSI 스토리지 클래스가 생성되며 업그레이드 전에 기본 스토리지 클래스가 설정되지 않은 경우 기본값으로 설정됩니다. 이름이 동일한 스토리지 클래스가 있는 경우 기존 스토리지 클래스는 변경되지 않은 상태로 유지됩니다. 기존 in-tree 스토리지 클래스는 그대로 유지되며 기존 in-tree PV의 볼륨 확장과 같은 특정 기능에 필요할 수 있습니다. in-tree 스토리지 플러그인을 참조하는 스토리지 클래스는 계속 작동하지만 기본 스토리지 클래스를 CSI 스토리지 클래스로 전환하는 것이 좋습니다.
기본 스토리지 클래스 를 변경하려면 기본 스토리지 클래스 변경을 참조하십시오.
5.7.3. vSphere 자동 마이그레이션
5.7.3.1. 새로운 OpenShift Container Platform 설치
OpenShift Container Platform 4.13 이상을 새로 설치하는 경우 자동 마이그레이션이 기본적으로 활성화됩니다.
5.7.3.2. OpenShift Container Platform 4.13에서 4.14로 업데이트
vSphere in-tree PV(영구 볼륨)를 사용하고 OpenShift Container Platform 4.13에서 4.14로 업데이트하려면 vSphere vCenter 및 ESXI 호스트를 7.0 업데이트 3L 또는 8.0 업데이트 2로 업데이트하려는 경우 OpenShift Container Platform 업데이트가 차단됩니다. vSphere를 업데이트하면 OpenShift Container Platform 업데이트가 발생할 수 있으며 자동 마이그레이션이 기본적으로 활성화됩니다.
또는 vSphere를 업데이트하지 않으려면 관리자 승인을 수행하여 OpenShift Container Platform 업데이트를 진행할 수 있습니다.
oc -n openshift-config patch cm admin-acks --patch '{"data":{"ack-4.13-kube-127-vsphere-migration-in-4.14":"true"}}' --type=merge
vSphere 7.0 업데이트 3L 또는 8.0 업데이트 2로 업데이트하지 않고 관리자 승인을 사용하여 OpenShift Container Platform 4.14로 업데이트하는 경우 OpenShift Container Platform 4.14에서 기본적으로 CSI 마이그레이션이 활성화되어 있기 때문에 알려진 문제가 발생할 수 있습니다. 관리자 승인을 진행하기 전에 이 지식 베이스 문서를 주의 깊게 읽으십시오.
5.7.3.3. OpenShift Container Platform 4.12에서 4.14로 업데이트
vSphere in-tree PV(영구 볼륨)를 사용하고 OpenShift Container Platform 4.12에서 4.14로 업데이트하려면 vSphere vCenter 및 ESXI 호스트를 7.0 업데이트 3L 또는 8.0 업데이트 2로 업데이트하려는 경우 OpenShift Container Platform 업데이트가 차단됩니다. vSphere를 업데이트하면 OpenShift Container Platform 업데이트가 발생할 수 있으며 자동 마이그레이션이 기본적으로 활성화됩니다.
또는 vSphere를 업데이트하지 않으려면 다음 두 명령을 모두 실행하여 관리자 승인을 수행하여 OpenShift Container Platform 업데이트를 진행할 수 있습니다.
oc -n openshift-config patch cm admin-acks --patch '{"data":{"ack-4.12-kube-126-vsphere-migration-in-4.14":"true"}}' --type=merge
oc -n openshift-config patch cm admin-acks --patch '{"data":{"ack-4.13-kube-127-vsphere-migration-in-4.14":"true"}}' --type=merge
vSphere 7.0 업데이트 3L 또는 8.0 업데이트 2로 업데이트하지 않고 관리자 승인을 사용하여 OpenShift Container Platform 4.14로 업데이트하는 경우 OpenShift Container Platform 4.14에서 기본적으로 CSI 마이그레이션이 활성화되어 있기 때문에 알려진 문제가 발생할 수 있습니다. 관리자 승인을 진행하기 전에 이 지식 베이스 문서를 주의 깊게 읽으십시오.
OpenShift Container Platform 4.12에서 4.14로 업데이트하는 것은 EUS (Extended Update Support)-EUS 업데이트입니다. 이 업데이트 유형 및 수행 방법을 이해하려면 아래 추가 리소스 섹션에 있는 컨트롤 플레인만 업데이트 링크를 참조하십시오.
추가 리소스