Red Hat Summit Red Hat Summit지원콘솔개발자평가판 시작연락처

5.2. 로컬 블록을 사용하는 영구 스토리지

OpenShift Container Platform은 로컬 볼륨을 사용하여 영구 스토리지를 통해 프로비저닝될 수 있습니다. 로컬 영구 볼륨을 사용하면 표준 영구 볼륨 클레임 인터페이스를 사용하여 디스크 또는 파티션과 같은 로컬 스토리지 장치에 액세스할 수 있습니다.

시스템에서 볼륨 노드 제약 조건을 인식하고 있기 때문에 로컬 볼륨은 노드에 수동으로 Pod를 예약하지 않고 사용할 수 있습니다. 그러나 로컬 볼륨은 여전히 기본 노드의 가용성에 따라 달라지며 일부 애플리케이션에는 적합하지 않습니다.

참고

로컬 볼륨은 정적으로 생성된 영구 볼륨으로 사용할 수 있습니다.

5.2.1. Local Storage Operator 설치
링크 복사

Local Storage Operator는 기본적으로 OpenShift Container Platform에 설치되지 않습니다. 다음 절차에 따라 이 Operator를 설치하고 구성하여 클러스터에서 로컬 볼륨을 활성화합니다.

사전 요구 사항

  • OpenShift Container Platform 웹 콘솔 또는 CLI(명령줄 인터페이스)에 액세스할 수 있습니다.

절차

  1. openshift-local-storage 프로젝트를 생성합니다. 

    $ oc adm new-project openshift-local-storage
    Copy to Clipboard Toggle word wrap

  2. 선택 사항: 인프라 노드에서 로컬 스토리지 생성을 허용합니다.

    Local Storage Operator를 사용하여 로깅 및 모니터링과 같은 구성 요소를 지원하는 인프라 노드에 볼륨을 생성할 수 있습니다.

    Local Storage Operator에 작업자 노드가 아닌 인프라 노드가 포함되도록 기본 노드 선택기를 조정해야 합니다.

    Local Storage Operator가 클러스터 전체 기본 선택기를 상속하지 못하도록 하려면 다음 명령을 입력합니다. 

    $ oc annotate namespace openshift-local-storage openshift.io/node-selector=''
    Copy to Clipboard Toggle word wrap

  3. 선택 사항: 단일 노드 배포의 CPU 관리 풀에서 로컬 스토리지를 실행할 수 있습니다.

    단일 노드 배포에서 Local Storage Operator를 사용하고 management 풀에 속하는 CPU를 사용할 수 있습니다. 관리 워크로드 파티셔닝을 사용하는 단일 노드 설치에서 이 단계를 수행합니다.

    Local Storage Operator가 관리 CPU 풀에서 실행되도록 하려면 다음 명령을 실행합니다. 

    $ oc annotate namespace openshift-local-storage workload.openshift.io/allowed='management'
    Copy to Clipboard Toggle word wrap

UI에서

웹 콘솔에서 Local Storage Operator를 설치하려면 다음 단계를 따르십시오.

  1. OpenShift Container Platform 웹 콘솔에 로그인합니다.
  2. Operators OperatorHub로 이동합니다.
  3. Local Storage를 필터 상자에 입력하여 Local Storage Operator를 찾습니다.
  4. 설치를 클릭합니다.
  5. Operator 설치 페이지에서 클러스터의 특정 네임스페이스를 선택합니다. 드롭다운 메뉴에서 openshift-local-storage를 선택합니다.
  6. 업데이트 채널 및 승인 전략 값을 원하는 값으로 조정합니다.
  7. 설치를 클릭합니다.

완료되면 Local Storage Operator가 웹 콘솔의 설치된 Operator 섹션에 나열됩니다.

CLI에서

  1. CLI에서 Local Storage Operator를 설치합니다.

    1. openshift-local-storage.yaml과 같은 Local Storage Operator의 Operator 그룹 및 서브스크립션을 정의하는 오브젝트 YAML 파일을 생성합니다.

      예: openshift-local-storage.yaml

      apiVersion: operators.coreos.com/v1
kind: OperatorGroup
metadata:
  name: local-operator-group
  namespace: openshift-local-storage
spec:
  targetNamespaces:
    - openshift-local-storage
---
apiVersion: operators.coreos.com/v1alpha1
kind: Subscription
metadata:
  name: local-storage-operator
  namespace: openshift-local-storage
spec:
  channel: stable
  installPlanApproval: Automatic
      1 
      
  name: local-storage-operator
  source: redhat-operators
  sourceNamespace: openshift-marketplace
      Copy to Clipboard Toggle word wrap

      1
      설치 계획에 대한 사용자 승인 정책입니다.

  2. 다음 명령을 입력하여 Local Storage Operator 오브젝트를 생성합니다. 

    $ oc apply -f openshift-local-storage.yaml
    Copy to Clipboard Toggle word wrap

    이 시점에서 OLM(Operator Lifecycle Manager)은 Local Storage Operator를 인식합니다. Operator의 ClusterServiceVersion (CSV)이 대상 네임스페이스에 표시되고 Operator가 제공한 API를 작성할 수 있어야 합니다.

  3. 모든 Pod 및 Local Storage Operator가 생성되었는지 확인하여 로컬 스토리지 설치를 확인합니다.

    1. 필요한 모든 Pod가 생성되었는지 확인합니다. 

      $ oc -n openshift-local-storage get pods
      Copy to Clipboard Toggle word wrap

      출력 예

      NAME                                      READY   STATUS    RESTARTS   AGE
local-storage-operator-746bf599c9-vlt5t   1/1     Running   0          19m
      Copy to Clipboard Toggle word wrap

    2. CSV(ClusterServiceVersion) YAML 매니페스트를 확인하여 openshift-local-storage 프로젝트에서 Local Storage Operator를 사용할 수 있는지 확인합니다. 

      $ oc get csvs -n openshift-local-storage
      Copy to Clipboard Toggle word wrap

      출력 예

      NAME                                         DISPLAY         VERSION               REPLACES   PHASE
local-storage-operator.4.2.26-202003230335   Local Storage   4.2.26-202003230335              Succeeded
      Copy to Clipboard Toggle word wrap

모든 확인이 통과되면 Local Storage Operator가 성공적으로 설치됩니다.

5.2.2. Local Storage Operator를 사용하여 로컬 볼륨을 프로비저닝
링크 복사

동적 프로비저닝을 통해 로컬 볼륨을 생성할 수 없습니다. 대신 Local Storage Operator에서 영구 볼륨을 생성할 수 있습니다. 로컬 볼륨 프로비저너는 정의된 리소스에 지정된 경로에서 모든 파일 시스템 또는 블록 볼륨 장치를 찾습니다.

사전 요구 사항

  • Local Storage Operator가 설치되어 있습니다.

  • 다음 조건을 충족하는 로컬 디스크가 있습니다.

    • 노드에 연결되어 있습니다.
    • 마운트되지 않았습니다.
    • 파티션이 포함되어 있지 않습니다.

프로세스

  1. 로컬 볼륨 리소스를 생성합니다. 이 리소스는 로컬 볼륨에 대한 노드 및 경로를 정의해야 합니다.

    참고

    동일한 장치에 다른 스토리지 클래스 이름을 사용하지 마십시오. 이렇게 하면 여러 영구 볼륨(PV)이 생성됩니다.

    예: Filesystem

    apiVersion: "local.storage.openshift.io/v1"
kind: "LocalVolume"
metadata:
  name: "local-disks"
  namespace: "openshift-local-storage"
    1 
    
spec:
  nodeSelector:
    2 
    
    nodeSelectorTerms:
    - matchExpressions:
        - key: kubernetes.io/hostname
          operator: In
          values:
          - ip-10-0-140-183
          - ip-10-0-158-139
          - ip-10-0-164-33
  storageClassDevices:
    - storageClassName: "local-sc"
    3 
    
      forceWipeDevicesAndDestroyAllData: false
    4 
    
      volumeMode: Filesystem
    5 
    
      fsType: xfs
    6 
    
      devicePaths:
    7 
    
        - /path/to/device
    8
    Copy to Clipboard Toggle word wrap

    1
    Local Storage Operator가 설치된 네임스페이스입니다.
    2
    선택 사항: 로컬 스토리지 볼륨이 연결된 노드 목록이 포함된 노드 선택기입니다. 이 예에서는 oc get node에서 가져온 노드 호스트 이름을 사용합니다. 값을 정의하지 않으면 Local Storage Operator에서 사용 가능한 모든 노드에서 일치하는 디스크를 찾습니다.
    3
    영구 볼륨 오브젝트를 생성할 때 사용할 스토리지 클래스의 이름입니다. Local Storage Operator가 존재하지 않는 경우 스토리지 클래스를 자동으로 생성합니다. 이 로컬 볼륨 세트를 고유하게 식별하는 스토리지 클래스를 사용해야 합니다.
    4
    이 설정은 로컬 스토리지 운영자(LSO) 프로비저닝에 사용할 디스크를 준비하기 위해 파티션 테이블 서명(매직 문자열)을 제거하는 wipefs를 호출할지 여부를 정의합니다. 서명 이외의 다른 데이터는 삭제되지 않습니다. 기본값은 "false"입니다( wipefs가 호출되지 않음). 이전 데이터가 재사용되어야 하는 디스크에 남아 있는 경우, forceWipeDevicesAndDestroyAllData를 "true"로 설정하면 유용할 수 있습니다. 이러한 시나리오에서 이 필드를 true로 설정하면 관리자가 디스크를 수동으로 지울 필요가 없습니다. 이러한 사례로는 노드를 여러 번 재배포할 수 있는 단일 노드 OpenShift(SNO) 클러스터 환경이나 이전 데이터를 개체 스토리지 장치(OSD)로 사용할 계획인 디스크에 그대로 둘 수 있는 OpenShift Data Foundation(ODF)을 사용하는 경우가 있습니다.
    5
    로컬 볼륨의 유형을 정의하는 Filesystem 또는 Block 중 하나에 해당 볼륨 모드입니다.
    참고

    원시 블록 볼륨( volumeMode: Block )은 파일 시스템으로 포맷되지 않았습니다. Pod에서 실행되는 모든 애플리케이션이 원시 블록 장치를 사용할 수 있는 경우에만 이 모드를 사용합니다.

    6
    로컬 볼륨이 처음 마운트될 때 생성되는 파일 시스템입니다.
    7
    선택할 로컬 스토리지 장치 목록이 포함된 경로입니다.
    8
    이 값을 LocalVolume 리소스의 실제 로컬 디스크 파일 경로(예: /dev/disk/ by-id /wwn )로 바꿉니다. 프로비저너가 배포되면 이러한 로컬 디스크에 PV가 생성됩니다.
    참고

    RHEL KVM과 함께 OpenShift Container Platform을 실행하는 경우 VM 디스크에 일련 번호를 할당해야 합니다. 그렇지 않으면 재부팅 후 VM 디스크를 식별할 수 없습니다. virsh edit <VM> 명령을 사용하여 <serial>mydisk</serial> 정의를 추가할 수 있습니다.

    예: 블록

    apiVersion: "local.storage.openshift.io/v1"
kind: "LocalVolume"
metadata:
  name: "local-disks"
  namespace: "openshift-local-storage"
    1 
    
spec:
  nodeSelector:
    2 
    
    nodeSelectorTerms:
    - matchExpressions:
        - key: kubernetes.io/hostname
          operator: In
          values:
          - ip-10-0-136-143
          - ip-10-0-140-255
          - ip-10-0-144-180
  storageClassDevices:
    - storageClassName: "local-sc"
    3 
    
      forceWipeDevicesAndDestroyAllData: false
    4 
    
      volumeMode: Block
    5 
    
      devicePaths:
    6 
    
        - /path/to/device
    7
    Copy to Clipboard Toggle word wrap

    1
    Local Storage Operator가 설치된 네임스페이스입니다.
    2
    선택 사항: 로컬 스토리지 볼륨이 연결된 노드 목록이 포함된 노드 선택기입니다. 이 예에서는 oc get node에서 가져온 노드 호스트 이름을 사용합니다. 값을 정의하지 않으면 Local Storage Operator에서 사용 가능한 모든 노드에서 일치하는 디스크를 찾습니다.
    3
    영구 볼륨 오브젝트를 생성할 때 사용할 스토리지 클래스의 이름입니다.
    4
    이 설정은 로컬 스토리지 운영자(LSO) 프로비저닝에 사용할 디스크를 준비하기 위해 파티션 테이블 서명(매직 문자열)을 제거하는 wipefs를 호출할지 여부를 정의합니다. 서명 이외의 다른 데이터는 삭제되지 않습니다. 기본값은 "false"입니다( wipefs가 호출되지 않음). 이전 데이터가 재사용되어야 하는 디스크에 남아 있는 경우, forceWipeDevicesAndDestroyAllData를 "true"로 설정하면 유용할 수 있습니다. 이러한 시나리오에서 이 필드를 true로 설정하면 관리자가 디스크를 수동으로 지울 필요가 없습니다. 이러한 사례로는 노드를 여러 번 재배포할 수 있는 단일 노드 OpenShift(SNO) 클러스터 환경이나 이전 데이터를 개체 스토리지 장치(OSD)로 사용할 계획인 디스크에 그대로 둘 수 있는 OpenShift Data Foundation(ODF)을 사용하는 경우가 있습니다.
    5
    로컬 볼륨의 유형을 정의하는 Filesystem 또는 Block 중 하나에 해당 볼륨 모드입니다.
    6
    선택할 로컬 스토리지 장치 목록이 포함된 경로입니다.
    7
    이 값을 LocalVolume 리소스의 실제 로컬 디스크 파일 경로(예: dev/disk/ by-id /wwn )로 바꿉니다. 프로비저너가 배포되면 이러한 로컬 디스크에 PV가 생성됩니다.
    참고

    RHEL KVM과 함께 OpenShift Container Platform을 실행하는 경우 VM 디스크에 일련 번호를 할당해야 합니다. 그렇지 않으면 재부팅 후 VM 디스크를 식별할 수 없습니다. virsh edit <VM> 명령을 사용하여 <serial>mydisk</serial> 정의를 추가할 수 있습니다.

  2. OpenShift Container Platform 클러스터에 로컬 볼륨 리소스를 생성합니다. 방금 생성한 파일을 지정합니다. 

    $ oc create -f <local-volume>.yaml
    Copy to Clipboard Toggle word wrap

  3. 프로비저너가 생성되었고 해당 데몬 세트가 생성되었는지 확인합니다. 

    $ oc get all -n openshift-local-storage
    Copy to Clipboard Toggle word wrap

    출력 예

    NAME                                          READY   STATUS    RESTARTS   AGE
pod/diskmaker-manager-9wzms                   1/1     Running   0          5m43s
pod/diskmaker-manager-jgvjp                   1/1     Running   0          5m43s
pod/diskmaker-manager-tbdsj                   1/1     Running   0          5m43s
pod/local-storage-operator-7db4bd9f79-t6k87   1/1     Running   0          14m

NAME                                     TYPE        CLUSTER-IP      EXTERNAL-IP   PORT(S)             AGE
service/local-storage-operator-metrics   ClusterIP   172.30.135.36   <none>        8383/TCP,8686/TCP   14m

NAME                               DESIRED   CURRENT   READY   UP-TO-DATE   AVAILABLE   NODE SELECTOR   AGE
daemonset.apps/diskmaker-manager   3         3         3       3            3           <none>          5m43s

NAME                                     READY   UP-TO-DATE   AVAILABLE   AGE
deployment.apps/local-storage-operator   1/1     1            1           14m

NAME                                                DESIRED   CURRENT   READY   AGE
replicaset.apps/local-storage-operator-7db4bd9f79   1         1         1       14m
    Copy to Clipboard Toggle word wrap

    필요한 데몬 세트 프로세스 및 현재 개수를 기록해 둡니다. 0의 개수는 레이블 선택기가 유효하지 않음을 나타냅니다.

  4. 영구 볼륨이 생성되었는지 확인합니다. 

    $ oc get pv
    Copy to Clipboard Toggle word wrap

    출력 예

    NAME                CAPACITY   ACCESS MODES   RECLAIM POLICY   STATUS      CLAIM   STORAGECLASS   REASON   AGE
local-pv-1cec77cf   100Gi      RWO            Delete           Available           local-sc                88m
local-pv-2ef7cd2a   100Gi      RWO            Delete           Available           local-sc                82m
local-pv-3fa1c73    100Gi      RWO            Delete           Available           local-sc                48m
    Copy to Clipboard Toggle word wrap

중요

LocalVolume 오브젝트 편집은 안전하지 않은 작업이므로 이를 수행하면 기존 영구 볼륨의 fsType 또는 volumeMode가 변경되지 않습니다.

5.2.3. Local Storage Operator없이 로컬 볼륨 프로비저닝
링크 복사

동적 프로비저닝을 통해 로컬 볼륨을 생성할 수 없습니다. 대신 개체 정의에서 영구 볼륨(PV)을 정의하여 영구 볼륨을 생성할 수 있습니다. 로컬 볼륨 프로비저너는 정의된 리소스에 지정된 경로에서 모든 파일 시스템 또는 블록 볼륨 장치를 찾습니다.

중요

PVC가 삭제될 때 PV를 수동으로 프로비저닝하면 PV를 재사용할 때 데이터 누출의 위험이 발생할 수 있습니다. Local Storage Operator는 로컬 PV를 프로비저닝할 때 장치의 라이프 사이클을 자동화하는 것이 좋습니다.

사전 요구 사항

  • 로컬 디스크가 OpenShift Container Platform 노드에 연결되어 있습니다.

프로세스

  1. PV를 정의합니다. PersistentVolume 오브젝트 정의로 example-pv-filesystem.yaml 또는 example-pv-block.yaml과 같은 파일을 생성합니다. 이 리소스는 로컬 볼륨에 대한 노드 및 경로를 정의해야 합니다.

    참고

    동일한 장치에 다른 스토리지 클래스 이름을 사용하지 마십시오. 이렇게 하면 여러 PV가 생성됩니다.

    example-pv-filesystem.yaml

    apiVersion: v1
kind: PersistentVolume
metadata:
  name: example-pv-filesystem
spec:
  capacity:
    storage: 100Gi
  volumeMode: Filesystem
    1 
    
  accessModes:
  - ReadWriteOnce
  persistentVolumeReclaimPolicy: Delete
  storageClassName: local-sc
    2 
    
  local:
    path: /dev/xvdf
    3 
    
  nodeAffinity:
    required:
      nodeSelectorTerms:
      - matchExpressions:
        - key: kubernetes.io/hostname
          operator: In
          values:
          - example-node
    Copy to Clipboard Toggle word wrap

    1
    PV의 유형을 정의하는 Filesystem 또는 Block 중 하나에 해당 볼륨 모드입니다.
    2
    PV 리소스를 생성할 때 사용할 스토리지 클래스의 이름입니다. 이 PV 세트를 고유하게 식별하는 스토리지 클래스를 사용합니다.
    3
    선택할 로컬 저장 장치 목록이 포함된 경로 또는 디렉토리입니다. Filesystem volumeMode 를 사용해서만 디렉토리를 지정할 수 있습니다.
    참고

    원시 블록 볼륨(volumeMode: block)은 파일 시스템과 함께 포맷되지 않습니다. Pod에서 실행되는 모든 애플리케이션이 원시 블록 장치를 사용할 수 있는 경우에만 이 모드를 사용합니다.

    example-pv-block.yaml

    apiVersion: v1
kind: PersistentVolume
metadata:
  name: example-pv-block
spec:
  capacity:
    storage: 100Gi
  volumeMode: Block
    1 
    
  accessModes:
  - ReadWriteOnce
  persistentVolumeReclaimPolicy: Delete
  storageClassName: local-sc
    2 
    
  local:
    path: /dev/xvdf
    3 
    
  nodeAffinity:
    required:
      nodeSelectorTerms:
      - matchExpressions:
        - key: kubernetes.io/hostname
          operator: In
          values:
          - example-node
    Copy to Clipboard Toggle word wrap

    1
    PV의 유형을 정의하는 Filesystem 또는 Block 중 하나에 해당 볼륨 모드입니다.
    2
    PV 리소스를 생성할 때 사용할 스토리지 클래스의 이름입니다. 이 PV 세트를 고유하게 식별하는 스토리지 클래스를 사용해야 합니다.
    3
    선택할 로컬 스토리지 장치 목록이 포함된 경로입니다.

  2. OpenShift Container Platform 클러스터에 PV 리소스를 생성합니다. 방금 생성한 파일을 지정합니다. 

    $ oc create -f <example-pv>.yaml
    Copy to Clipboard Toggle word wrap

  3. 로컬 PV가 생성되었는지 확인합니다. 

    $ oc get pv
    Copy to Clipboard Toggle word wrap

    출력 예

    NAME                    CAPACITY   ACCESS MODES   RECLAIM POLICY   STATUS      CLAIM                STORAGECLASS    REASON   AGE
example-pv-filesystem   100Gi      RWO            Delete           Available                        local-sc            3m47s
example-pv1             1Gi        RWO            Delete           Bound       local-storage/pvc1   local-sc            12h
example-pv2             1Gi        RWO            Delete           Bound       local-storage/pvc2   local-sc            12h
example-pv3             1Gi        RWO            Delete           Bound       local-storage/pvc3   local-sc            12h
    Copy to Clipboard Toggle word wrap

5.2.4. 로컬 볼륨 영구 볼륨 클레임 생성
링크 복사

로컬 볼륨은 Pod가 액세스할 수 있는 영구 볼륨 클레임(PVC)으로서 정적으로 생성되어야 합니다.

사전 요구 사항

  • 영구 볼륨은 로컬 볼륨 프로비저너를 사용하여 생성됩니다.

절차

  1. 해당 스토리지 클래스를 사용하여 PVC를 생성합니다. 

    kind: PersistentVolumeClaim
apiVersion: v1
metadata:
  name: local-pvc-name
    1 
    
spec:
  accessModes:
  - ReadWriteOnce
  volumeMode: Filesystem
    2 
    
  resources:
    requests:
      storage: 100Gi
    3 
    
  storageClassName: local-sc
    4
    Copy to Clipboard Toggle word wrap
    1
    PVC의 이름입니다.
    2
    PVC의 유형입니다. 기본값은 Filesystem입니다.
    3
    PVC에서 사용할 수 있는 스토리지 용량입니다.
    4
    클레임에 필요한 스토리지 클래스의 이름입니다.

  2. 방금 작성한 파일을 지정하여 OpenShift Container Platform 클러스터에서 PVC를 생성합니다. 

    $ oc create -f <local-pvc>.yaml
    Copy to Clipboard Toggle word wrap

5.2.5. 로컬 클레임 연결
링크 복사

로컬 볼륨이 영구 볼륨 클레임에 매핑된 후 리소스 내부에서 지정할 수 있습니다.

사전 요구 사항

  • 동일한 네임스페이스에 영구 볼륨 클레임이 있어야 합니다.

절차

  1. 리소스 사양에 정의된 클레임을 포함합니다. 다음 예시는 Pod 내에서 영구 볼륨 클레임을 선언합니다. 

    apiVersion: v1
kind: Pod
spec:
# ...
  containers:
    volumeMounts:
    - name: local-disks
    1 
    
      mountPath: /data
    2 
    
  volumes:
  - name: local-disks
    persistentVolumeClaim:
      claimName: local-pvc-name
    3 
    
# ...
    Copy to Clipboard Toggle word wrap
    1
    마운트할 볼륨의 이름입니다.
    2
    볼륨이 마운트된 Pod 내부의 경로입니다. 컨테이너 루트, / 또는 호스트와 컨테이너에서 동일한 경로에 마운트하지 마십시오. 컨테이너가 호스트 /dev/pts 파일과 같이 충분한 권한이 있는 경우 호스트 시스템이 손상될 수 있습니다. /host를 사용하여 호스트를 마운트하는 것이 안전합니다.
    3
    사용할 기존 영구 볼륨 클레임의 이름입니다.

  2. 방금 생성한 파일을 지정하여 OpenShift Container Platform 클러스터에 리소스를 생성합니다. 

    $ oc create -f <local-pod>.yaml
    Copy to Clipboard Toggle word wrap

5.2.6. 로컬 스토리지 장치에 대한 검색 및 프로비저닝 자동화
링크 복사

로컬 스토리지 Operator는 로컬 스토리지 검색 및 프로비저닝을 자동화합니다. 이 기능을 사용하면 배포 중에 연결된 장치가 있는 베어 메탈, VMware 또는 AWS 스토어 인스턴스와 같이 동적 프로비저닝을 사용할 수 없는 경우 설치를 단순화할 수 있습니다.

중요

자동 검색 및 프로비저닝은 기술 프리뷰 기능 전용입니다. Technology Preview 기능은 Red Hat 프로덕션 서비스 수준 계약(SLA)에서 지원되지 않으며 기능적으로 완전하지 않을 수 있습니다. 따라서 프로덕션 환경에서 사용하는 것은 권장하지 않습니다. 이러한 기능을 사용하면 향후 제품 기능을 조기에 이용할 수 있어 개발 과정에서 고객이 기능을 테스트하고 피드백을 제공할 수 있습니다.

Red Hat 기술 프리뷰 기능의 지원 범위에 대한 자세한 내용은 기술 프리뷰 기능 지원 범위를 참조하십시오.

중요

Red Hat OpenShift Data Foundation을 온프레미스에 배포하거나 플랫폼에 독립적인 배포에 사용하는 경우 자동 검색 및 프로비저닝이 완벽하게 지원됩니다.

다음 절차에 따라 로컬 장치를 자동으로 검색하고 선택한 장치에 대한 로컬 볼륨을 자동으로 프로비저닝하십시오.

주의

LocalVolumeSet 객체를 사용할 때는 주의하세요. 로컬 디스크에서 영구 볼륨(PV)을 자동으로 프로비저닝하는 경우 로컬 PV가 일치하는 모든 장치를 클레임할 수 있습니다. LocalVolumeSet 객체를 사용하는 경우 로컬 스토리지 운영자가 노드의 로컬 장치를 관리하는 유일한 엔터티인지 확인하세요. 노드를 두 번 이상 대상으로 하는 LocalVolumeSet 의 여러 인스턴스를 생성할 수 없습니다.

사전 요구 사항

  • 클러스터 관리자 권한이 있어야 합니다.
  • Local Storage Operator가 설치되어 있습니다.
  • OpenShift Container Platform 노드에 로컬 디스크가 연결되어 있습니다.
  • OpenShift Container Platform 웹 콘솔과 oc 명령줄 인터페이스(CLI)에 액세스할 수 있습니다.

절차

  1. 웹 콘솔에서 로컬 장치를 자동으로 검색할 수 있도록 하려면 다음을 수행합니다.

    1. Operators 설치된 Operators를 클릭합니다.
    2. openshift-local-storage 네임스페이스에서 로컬 스토리지를 클릭합니다.
    3. 로컬 볼륨 검색 탭을 클릭합니다.
    4. 로컬 볼륨 검색 만들기를 클릭한 다음 양식 보기 또는 YAML 보기를 선택합니다.
    5. LocalVolumeDiscovery 오브젝트 매개변수를 구성합니다.

    6. 생성을 클릭합니다.

      로컬 스토리지 운영자는 auto-discover-devices 라는 이름의 로컬 볼륨 검색 인스턴스를 생성합니다.

  2. 노드에 사용 가능한 장치 목록을 표시하려면 다음을 수행합니다.

    1. OpenShift Container Platform 웹 콘솔에 로그인합니다.
    2. 컴퓨팅 노드로 이동합니다.
    3. 열기를 원하는 노드 이름을 클릭합니다. "노드 세부 정보" 페이지가 표시됩니다.

    4. 선택한 장치 목록을 표시하려면 디스크 탭을 선택합니다.

      로컬 디스크가 추가되거나 제거되면 장치 목록이 지속적으로 업데이트됩니다. 장치를 이름, 상태, 유형, 모델, 용량 및 모드로 필터링할 수 있습니다.

  3. 웹 콘솔에서 발견된 장치에 대한 로컬 볼륨을 자동으로 프로비저닝하려면 다음을 수행합니다.

    1. Operator 설치된 Operator로 이동하고 Operator 목록에서 로컬 스토리지를 선택합니다.
    2. 로컬 볼륨 세트 로컬 볼륨 세트 만들기를 선택합니다.
    3. 볼륨 세트 이름과 스토리지 클래스 이름을 입력합니다.

    4. 그에 따라 필터를 적용하려면 모든 노드 또는 노드 선택을 선택합니다.

      참고

      모든 노드 또는 노드 선택을 사용하여 필터링하는지의 여부와 관계없이 작업자 노드만 사용할 수 있습니다.

    5. 로컬 볼륨 세트에 적용할 디스크 유형, 모드, 크기 및 제한을 선택하고 만들기를 클릭합니다.

      몇 분 후에 “Operator 조정됨”을 나타내는 메시지가 표시됩니다.

  4. 대신 CLI에서 검색된 장치에 대한 로컬 볼륨을 프로비저닝하려면 다음을 수행합니다.

    1. 다음 예와 같이 local-volume-set.yaml과 같은 로컬 볼륨 세트를 정의하는 오브젝트 YAML 파일을 생성합니다. 

      apiVersion: local.storage.openshift.io/v1alpha1
kind: LocalVolumeSet
metadata:
  name: example-autodetect
spec:
  nodeSelector:
    nodeSelectorTerms:
      - matchExpressions:
          - key: kubernetes.io/hostname
            operator: In
            values:
              - worker-0
              - worker-1
  storageClassName: local-sc
      1 
      
  volumeMode: Filesystem
  fsType: ext4
  maxDeviceCount: 10
  deviceInclusionSpec:
    deviceTypes:
      2 
      
      - disk
      - part
    deviceMechanicalProperties:
      - NonRotational
    minSize: 10G
    maxSize: 100G
    models:
      - SAMSUNG
      - Crucial_CT525MX3
    vendors:
      - ATA
      - ST2000LM
      Copy to Clipboard Toggle word wrap
      1
      검색된 장치에서 프로비저닝된 영구 볼륨에 대해 생성된 스토리지 클래스를 결정합니다. Local Storage Operator가 존재하지 않는 경우 스토리지 클래스를 자동으로 생성합니다. 이 로컬 볼륨 세트를 고유하게 식별하는 스토리지 클래스를 사용해야 합니다.
      2
      로컬 볼륨 세트 기능을 사용할 때 Local Storage Operator는 논리 볼륨 관리(LVM) 장치 사용을 지원하지 않습니다.

    2. 로컬 볼륨 세트 오브젝트를 생성합니다. 

      $ oc apply -f local-volume-set.yaml
      Copy to Clipboard Toggle word wrap

    3. 로컬 영구 볼륨이 스토리지 클래스를 기반으로 동적으로 프로비저닝되었는지 확인합니다. 

      $ oc get pv
      Copy to Clipboard Toggle word wrap

      출력 예

      NAME                CAPACITY   ACCESS MODES   RECLAIM POLICY   STATUS      CLAIM   STORAGECLASS   REASON   AGE
local-pv-1cec77cf   100Gi      RWO            Delete           Available           local-sc                88m
local-pv-2ef7cd2a   100Gi      RWO            Delete           Available           local-sc                82m
local-pv-3fa1c73    100Gi      RWO            Delete           Available           local-sc                48m
      Copy to Clipboard Toggle word wrap

참고

결과는 노드에서 제거된 후 삭제됩니다. 심볼릭 링크는 수동으로 제거해야 합니다.

5.2.7. Local Storage Operator Pod에서 허용 오차 사용
링크 복사

테인트를 노드에 적용하여 일반 워크로드를 실행하지 못하도록 할 수 있습니다. Local Storage Operator가 테인트된 노드를 사용하도록 허용하려면 Pod 또는 DaemonSet 정의에 허용 오차를 추가해야 합니다. 그러면 생성된 리소스가 이러한 테인트된 노드에서 실행될 수 있습니다.

LocalVolume 리소스를 통해 Local Storage Operator Pod에 허용 오차를 적용하고 노드 사양을 통해 노드에 테인트를 적용합니다. 노드의 테인트는 해당 테인트를 허용하지 않는 모든 Pod를 거절하도록 노드에 지시합니다. 다른 Pod에 없는 특정 테인트를 사용하면 Local Storage Operator Pod가 해당 노드에서도 실행될 수 있습니다.

중요

테인트 및 허용 오차는 key, value 및 effect로 구성되어 있습니다. 인수로는 key=value:effect로 표시됩니다. Operator는 이러한 매개 변수 중 하나를 비워두는 것을 허용합니다.

사전 요구 사항

  • Local Storage Operator가 설치되어 있습니다.
  • 로컬 디스크는 테인트와 함께 OpenShift Container Platform 노드에 연결되어 있습니다.
  • 테인트된 노드는 로컬 스토리지를 프로비저닝해야 합니다.

절차

테인트된 노드에서 스케줄링을 위해 로컬 볼륨을 구성하려면 다음을 수행하십시오.

  1. 다음 예와 같이 Pod를 정의하는 YAML 파일을 수정하고 LocalVolume 사양을 추가합니다. 

      apiVersion: "local.storage.openshift.io/v1"
  kind: "LocalVolume"
  metadata:
    name: "local-disks"
    namespace: "openshift-local-storage"
  spec:
    tolerations:
      - key: localstorage
    1 
    
        operator: Equal
    2 
    
        value: "localstorage"
    3 
    
    storageClassDevices:
        - storageClassName: "local-sc"
          volumeMode: Block
    4 
    
          devicePaths:
    5 
    
            - /dev/xvdg
    Copy to Clipboard Toggle word wrap
    1
    노드에 추가한 키를 지정합니다.
    2
    키/값 매개변수가 일치할 것을 요구하도록 Equal Operator를 지정합니다. Operator가 Exists인 경우 시스템은 키가 존재하는지 확인하고 값을 무시합니다. Operator가 Equal 이면 키와 값이 일치해야 합니다.
    3
    테인트된 노드의 로컬 값을 지정합니다.
    4
    볼륨 모드(파일 시스템 또는 블록)는 로컬 볼륨의 유형을 정의합니다.
    5
    선택할 로컬 스토리지 장치 목록이 포함된 경로입니다.

  2. 선택 사항: 테인트된 노드에만 로컬 영구 볼륨을 생성하려면 다음 예와 같이 YAML 파일을 수정하고 LocalVolume 사양을 추가합니다. 

    spec:
  tolerations:
    - key: node-role.kubernetes.io/master
      operator: Exists
    Copy to Clipboard Toggle word wrap

정의된 허용 오차가 결과 데몬 세트로 전달되어, 지정된 테인트를 포함하는 노드에 대해 디스크 제조 업체 및 프로비저너 Pod를 생성할 수 있습니다.

5.2.8. Local Storage Operator 지표
링크 복사

OpenShift Container Platform은 Local Storage Operator에 대한 다음 지표를 제공합니다.

  • lso_discovery_disk_count: 각 노드에서 발견된 총 장치 수
  • lso_lvset_provisioned_PV_count: LocalVolumeSet 개체에서 생성한 총 PV 수
  • lso_lvset_unmatched_disk_count: 기준 불일치로 인해 Local Storage Operator가 프로비저닝을 위해 선택하지 않은 총 디스크 수
  • lso_lvset_orphaned_symlink_count: LocalVolumeSet 개체 기준과 더 이상 일치하지 않는 PV가 있는 장치 수
  • lso_lv_orphaned_symlink_count: LocalVolume 오브젝트 기준과 더 이상 일치하지 않는 PV가 있는 장치 수
  • lso_lv_provisioned_PV_count: LocalVolume의 프로비저닝된 총 PV 수

이러한 측정 항목을 사용하려면 다음 중 하나를 수행하여 측정 항목을 활성화하세요.

  • 웹 콘솔에서 OperatorHub 의 Local Storage Operator를 설치할 때, 이 네임스페이스에서 Operator가 권장하는 클러스터 모니터링 사용 확인란을 선택합니다.

  • 다음 명령을 실행하여 Operator 네임스페이스에 openshift.io/cluster-monitoring=true 레이블을 수동으로 추가합니다. 

    $ oc label ns/openshift-local-storage openshift.io/cluster-monitoring=true
    Copy to Clipboard Toggle word wrap

메트릭에 대한 자세한 내용은 관리자로서 메트릭에 액세스를 참조하세요.

5.2.9. Local Storage Operator 리소스 삭제
링크 복사

5.2.9.1. 로컬 볼륨 또는 로컬 볼륨 세트 제거
링크 복사

가끔 로컬 볼륨(LV)과 로컬 볼륨 세트(LVS)를 삭제해야 할 때가 있습니다.

사전 요구 사항

  • 영구 볼륨(PV)은 해제됨 또는 사용 가능 상태여야 합니다.

    주의

    아직 사용 중인 영구 볼륨을 삭제하면 데이터 손실 또는 손상이 발생할 수 있습니다.

프로세스

LV 또는 LVS를 삭제하려면 다음 단계를 완료하세요.

  1. 삭제되는 LV 또는 LVS가 소유한 바인딩된 PV가 있는 경우 해당 영구 볼륨 클레임(PVC)을 삭제하여 PV를 해제합니다.

    1. 특정 LV 또는 LVS가 소유한 바인딩된 PV를 찾으려면 다음 명령을 실행하세요. 

      $ oc get pv --selector storage.openshift.com/owner-name=<LV_LVS_name>
      1
      Copy to Clipboard Toggle word wrap
      1
      <LV_LVS_name> 은 LV 또는 LVS의 이름입니다.

      출력 예

      NAME                CAPACITY   ACCESS MODES   RECLAIM POLICY   STATUS      CLAIM                 STORAGECLASS   VOLUMEATTRIBUTESCLASS   REASON   AGE
local-pv-3fa1c73    5Gi        RWO            Delete           Available                         slow           <unset>                          28s
local-pv-1cec77cf   30Gi       RWX            Retain           Bound       openshift/storage     my-sc          <unset>                          168d
      Copy to Clipboard Toggle word wrap

      바운드 PV는 바운드 상태를 가지며, 해당 PVC는 CLAIM 열에 나타납니다. 이전 예에서 PV local-pv-1cec77cf 는 바인딩되고 해당 PVC는 openshift/storage 입니다.

    2. 다음 명령을 실행하여 삭제되는 LV 또는 LVS가 소유한 바인딩된 PV의 해당 PVC를 삭제합니다. 

      $ oc delete pvc <name>
      Copy to Clipboard Toggle word wrap

      이 예에서는 PVC openshift/storage를 삭제합니다.

  2. 다음 명령을 실행하여 LV 또는 LVS를 삭제합니다.

    LV 삭제 명령

    $ oc delete lv <name>
    Copy to Clipboard Toggle word wrap

    또는

    LVS 삭제 명령

    $ oc delete lvs <name>
    Copy to Clipboard Toggle word wrap

  3. LV 또는 LVS가 소유한 PV에 보존 회수 정책이 있는 경우 중요한 데이터를 백업한 후 PV를 삭제하세요.

    참고

    삭제 정책이 적용된 PV는 LV 또는 LVS를 삭제하면 자동으로 삭제됩니다.

    1. Retain Reclaim 정책이 있는 PV를 찾으려면 다음 명령을 실행하세요. 

      $ oc get pv
      Copy to Clipboard Toggle word wrap

      출력 예

      NAME                CAPACITY   ACCESS MODES   RECLAIM POLICY   STATUS      CLAIM                STORAGECLASS   REASON   AGE
local-pv-1cec77cf   30Gi       RWX            Retain           Available                        my-sc                   168d
      Copy to Clipboard Toggle word wrap

      이 예에서 PV local-pv-1cec77cf 에는 Retain reclaim 정책이 있으므로 수동으로 삭제해야 합니다.

    2. 이 볼륨의 중요한 데이터는 백업해 두세요.

    3. 다음 명령을 실행하여 PV를 삭제합니다. 

      $ oc delete pv <name>
      Copy to Clipboard Toggle word wrap

      이 예에서는 PV local-pv-1cec77cf를 삭제합니다.

5.2.9.2. Local Storage Operator 설치 제거
링크 복사

Local Storage Operator의 설치를 제거하려면 openshift-local-storage 프로젝트에서 Operator 및 모든 생성된 리소스를 제거해야 합니다.

주의

로컬 스토리지 PV를 아직 사용 중 일 때 Local Storage Operator의 설치를 제거하는 것은 권장되지 않습니다. Operator 제거 후 PV는 유지되지만, PV 및 로컬 스토리지 리소스를 제거하지 않고 Operator를 제거한 후 다시 설치하면 알 수 없는 동작이 발생할 수 있습니다.

사전 요구 사항

  • OpenShift Container Platform 웹 콘솔에 액세스합니다.

프로세스

  1. 다음 명령을 실행하여 프로젝트에 설치된 localvolume , localvolumeset , localvolumediscovery 와 같은 로컬 볼륨 리소스를 삭제합니다. 

    $ oc delete localvolume --all --all-namespaces
    Copy to Clipboard Toggle word wrap 
    $ oc delete localvolumeset --all --all-namespaces
    Copy to Clipboard Toggle word wrap 
    $ oc delete localvolumediscovery --all --all-namespaces
    Copy to Clipboard Toggle word wrap

  2. 웹 콘솔에서 Local Storage Operator의 설치를 제거합니다.

    1. OpenShift Container Platform 웹 콘솔에 로그인합니다.
    2. Operators 설치된 Operator로 이동합니다.
    3. Local Storage를 필터 상자에 입력하여 Local Storage Operator를 찾습니다.
    4. Local Storage Operator 끝에 있는 옵션 메뉴 kebab 를 클릭합니다.
    5. Operator 제거를 클릭합니다.
    6. 표시되는 창에서 제거를 클릭합니다.

  3. Local Storage Operator에서 생성한 PV는 삭제될 때까지 클러스터에 남아 있습니다. 이러한 볼륨이 더 이상 사용되지 않으면 다음 명령을 실행하여 해당 볼륨을 삭제합니다. 

    $ oc delete pv <pv-name>
    Copy to Clipboard Toggle word wrap

  4. 다음 명령을 실행하여 openshift-local-storage 프로젝트를 삭제합니다. 

    $ oc delete project openshift-local-storage
    Copy to Clipboard Toggle word wrap
맨 위로 이동
Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

Red Hat을 사용하는 고객은 신뢰할 수 있는 콘텐츠가 포함된 제품과 서비스를 통해 혁신하고 목표를 달성할 수 있습니다. 최신 업데이트를 확인하세요.

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 언어를 교체하기 위해 최선을 다하고 있습니다. 자세한 내용은 다음을 참조하세요.Red Hat 블로그.

Red Hat 소개

Red Hat은 기업이 핵심 데이터 센터에서 네트워크 에지에 이르기까지 플랫폼과 환경 전반에서 더 쉽게 작업할 수 있도록 강화된 솔루션을 제공합니다.

Theme

© 2025 Red Hat