5.6. CSI 자동 마이그레이션
일반적으로 OpenShift Container Platform과 함께 제공되는 In-tree 스토리지 드라이버는 더 이상 사용되지 않으며 동등한 CSI(Container Storage Interface) 드라이버로 교체됩니다. OpenShift Container Platform은 지원되는 특정 in-tree 볼륨 플러그인에 해당하는 CSI 드라이버로 자동 마이그레이션을 제공합니다.
5.6.1. 개요
인트리 스토리지 플러그인을 사용하여 프로비저닝하고 이 기능에서 지원하는 볼륨은 CSI(Container Storage Interface) 드라이버로 마이그레이션됩니다. 이 프로세스는 데이터 마이그레이션을 수행하지 않습니다. OpenShift Container Platform은 메모리에서 영구 볼륨 오브젝트만 변환합니다. 그 결과 번역된 영구 볼륨 오브젝트가 디스크에 저장되지 않으며 내용이 변경되지 않았습니다.
CSI 드라이버의 다음 인트리가 지원됩니다.
| in-tree/CSI 드라이버 | 지원 수준 | CSI 자동 마이그레이션이 자동으로 활성화됩니까? |
|---|---|---|
|
Generally available (GA) |
Yes. For more information, see Automatic migration of in-tree volumes to CSI. |
|
Technology Preview (TP) | 아니요. 활성화하려면 CSI 자동 마이그레이션 수동 활성화를 참조하십시오. 또한 vSphere의 경우 다음의 정보를 참조하십시오.
|
CSI 자동 마이그레이션이 원활해야 합니다. 이 기능은 기존의 모든 API 오브젝트(예: PersistentVolumes,PersistentVolumeClaims 및 StorageClasses )를 사용하는 방법은 변경되지 않습니다.
원래의 인트리 스토리지 플러그인이 지원하지 않는 경우 in-tree (PV) 또는 PVC(영구 볼륨 클레임)에 대한 CSI 자동 마이그레이션을 활성화하면 스냅샷 또는 확장과 같은 새 CSI 드라이버 기능이 활성화되지 않습니다.
5.6.2. in-tree 볼륨을 CSI로 자동 마이그레이션
OpenShift Container Platform은 다음과 같은 in-tree 볼륨 유형에서 CSI(Container Storage Interface) 드라이버로의 자동적이고 원활한 마이그레이션을 지원합니다.
- Azure Disk
- OpenStack Cinder
- AWS(Amazon Web Services) EBS(Elastic Block Storage)
- GCP PD(Google Compute Engine Persistent Disk)
이러한 볼륨 유형에 대한 CSI 마이그레이션은 일반적으로 사용 가능한 (GA)로 간주되며 수동 개입이 필요하지 않습니다.
새로운 OpenShift Container Platform 4.11 이상의 경우 설치 시 기본 스토리지 클래스는 CSI 스토리지 클래스입니다. 이 스토리지 클래스를 사용하여 프로비저닝된 모든 볼륨은 CSI PV(영구 볼륨)입니다.
4.10 및 이전 버전에서 4.11 이상으로 업그레이드된 클러스터의 경우 CSI 스토리지 클래스가 생성되고 업그레이드 전에 기본 스토리지 클래스가 설정되지 않은 경우 기본값으로 설정됩니다. 이름이 같은 스토리지 클래스가 없는 경우 기존 스토리지 클래스는 변경되지 않습니다. 기존 in-tree 스토리지 클래스가 남아 있으며 기존 in-tree PV에 대해 볼륨 확장과 같은 특정 기능에 필요할 수 있습니다. in-tree 스토리지 플러그인에 대한 스토리지 클래스가 계속 작동하지만 기본 스토리지 클래스를 CSI 스토리지 클래스로 전환하는 것이 좋습니다.
5.6.3. CSI 자동 마이그레이션 수동 활성화
개발 또는 OpenShift Container Platform 클러스터 스테이징에서 CSI(Container Storage Interface) 마이그레이션을 테스트하려면 다음 in-tree 볼륨 유형에 대해 CSI로의 in-tree를 수동으로 활성화해야 합니다.
- VMware vSphere Disk
- Azure File
이전의 in-tree 볼륨 플러그인 및 CSI 드라이버 쌍에 대한 CSI 자동 마이그레이션은 기술 프리뷰 기능 전용입니다. 기술 프리뷰 기능은 Red Hat 프로덕션 서비스 수준 계약(SLA)에서 지원되지 않으며 기능적으로 완전하지 않을 수 있습니다. 따라서 프로덕션 환경에서 사용하는 것은 권장하지 않습니다. 이러한 기능을 사용하면 향후 제품 기능을 조기에 이용할 수 있어 개발 과정에서 고객이 기능을 테스트하고 피드백을 제공할 수 있습니다.
Red Hat 기술 프리뷰 기능의 지원 범위에 대한 자세한 내용은 기술 프리뷰 기능 지원 범위를 참조하십시오.
마이그레이션 후 기본 스토리지 클래스는 in-tree 스토리지 클래스로 유지됩니다.
CSI 자동 마이그레이션은 향후 OpenShift Container Platform 릴리스의 모든 스토리지 in-tree 플러그인에 기본적으로 활성화되므로 지금 테스트하고 문제를 보고하는 것이 좋습니다.
CSI 자동 마이그레이션 드레이닝을 활성화한 다음 클러스터에 있는 모든 노드를 순서대로 다시 시작합니다. 다소 시간이 걸릴 수 있습니다.
절차
기능 게이트를 활성화합니다( 노드
클러스터 작업 기능 게이트 사용 기능활성화). 중요기능 게이트를 사용하여 기술 프리뷰 기능을 켜면 해제할 수 없습니다. 이로 인해 클러스터 업그레이드가 불가능합니다.
다음 구성 예제에서는 현재 TP(기술 프리뷰) 상태에 있는 이 기능에서 지원하는 모든 CSI 드라이버에 대해 CSI 자동 마이그레이션을 활성화합니다.
apiVersion: config.openshift.io/v1 kind: FeatureGate metadata: name: cluster spec: featureSet: TechPreviewNoUpgrade 1 ...- 1
- Azure File 및 VMware vSphere 자동 마이그레이션을 활성화합니다.
CustomNoUpgradefeatureSet을 설정하고featuregates의 경우 다음 중 하나로 설정하여 선택한 CSI 드라이버에 대해 CSI 자동 마이그레이션을 지정할 수 있습니다.- CSIMigrationAzureFile
- CSIMigrationvSphere
다음 구성 예제에서는 vSphere CSI 드라이버로만 자동 마이그레이션할 수 있습니다.
apiVersion: config.openshift.io/v1 kind: FeatureGate metadata: name: cluster spec: featureSet: CustomNoUpgrade customNoUpgrade: enabled: - CSIMigrationvSphere 1 ...- 1
- vSphere 자동 마이그레이션만 활성화합니다.
추가 리소스
5.6.4. vSphere in-tree PV를 사용하여 OpenShift Container Platform 4.12에서 4.13으로 업데이트
vSphere in-tree PV(영구 볼륨)를 사용하고 OpenShift Container Platform 4.12에서 4.13으로 업데이트하려면 vSphere vCenter 및 ESXI 호스트를 7.0 업데이트 3L 또는 8.0 업데이트 2로 업데이트하려는 경우 OpenShift Container Platform 업그레이드가 차단됩니다. vSphere를 업데이트하면 OpenShift Container Platform 업데이트가 발생할 수 있으며 vSphere에 대한 CSI(Automatic Container Storage Interface) 마이그레이션이 옵트인된 경우에만 수행됩니다.
또는 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=mergeCSI 마이그레이션이 4.12에서 4.13으로 업그레이드된 클러스터에 아직 활성화되지 않았기 때문에 일반적으로 OpenShift Container Platform 4.12에서 4.13으로의 업데이트에 대해 요청된 관리자 승인을 제공하는 것이 안전합니다. 그러나 Red Hat은 향후 4.14에 대한 업데이트를 계획하여 CSI 드라이버에서 모든 인트리 볼륨을 원활하게 관리할 수 있도록 vSphere 환경 업데이트를 계획하는 것이 좋습니다.
OpenShift Container Platform 4.13.10 이상으로 업데이트하지 않고 vSphere를 업데이트하지 않고 마이그레이션( 추가 리소스에서 CSI 자동 마이그레이션 활성화 참조)을 선택하면 알려진 문제가 발생할 수 있습니다. 마이그레이션에 적용하기 전에 이 기술 자료 문서를 주의 깊게 읽으십시오.
추가 리소스
5.6.5. vSphere in-tree PV를 사용하여 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의 CSI(Automatic Container Storage Interface) 마이그레이션이 기본적으로 자동으로 수행됩니다.
또는 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=mergeoc -n openshift-config patch cm admin-acks --patch '{"data":{"ack-4.13-kube-127-vsphere-migration-in-4.14":"true"}}' --type=mergevSphere를 업데이트하지 않고 OpenShift Container Platform 4.14로 업데이트하는 경우 OpenShift Container Platform 4.14에서 기본적으로 CSI 마이그레이션이 활성화되어 있기 때문에 알려진 문제가 발생할 수 있습니다. 업데이트하기 전에 이 지식 베이스 문서를 주의 깊게 읽으십시오.
OpenShift Container Platform 4.12에서 4.14로 업데이트하는 것은 EUS (Extended Update Support)-EUS 업데이트입니다. 이 업데이트 유형 및 수행 방법을 이해하려면 아래 추가 리소스 의 EUS-to-EUS 업데이트 링크를 참조하십시오.
추가 리소스
