로컬 파일 시스템

로컬 파일 시스템에 저장된 문서를 크롤링합니다.

IBM Cloud Pak for Data IBM Software Hub

이 정보는 설치된 배포에만 적용됩니다.

크롤링되는 문서

  • 파일 경로에 있는 Discovery에서 지원하는 파일 형식만 크롤링되며, 그 외의 파일 형식은 모두 무시됩니다. 자세한 내용은 지원되는 파일 형식 를 참조하세요.
  • 크롤러는 /mnt 디렉토리 또는 그 하위 디렉터리 중 하나에 있는 파일만 액세스할 수 있습니다.
  • 지정한 파일 확장자 필터 규칙과 일치하는 파일 확장자를 가진 파일만 크롤링됩니다. 4.7.0 릴리스에 추가되었습니다.
  • 소스가 다시 크롤링되면, 새로운 문서가 추가되고, 업데이트된 문서는 현재 버전으로 수정되며, 삭제된 문서는 컬렉션의 색인에서 삭제됩니다.
  • 모든 Discovery 데이터 원본 커넥터는 읽기 전용입니다. 크롤링 계정에 부여된 권한에 관계없이 Discovery는 원본 데이터 원본의 콘텐츠를 쓰거나 업데이트하거나 삭제하지 않습니다.

전제조건 단계

로컬 파일 시스템 데이터 소스에 연결하기 전에 다음 단계를 완료합니다:

이 서비스는 기본적으로 Portworx 스토리지를 사용합니다. 그러나 네트워크 파일 시스템(NFS) 스토리지를 사용하는 경우에는 NFS 스토리지의 필수 단계 를 대신 참조하세요.

크롤러 팟(Pod)에서 지속적 볼륨 청구 작성 및 마운트

로컬 파일 시스템을 크롤링하려면 먼저 퍼시스턴트 볼륨 클레임을 만들어서 crawler 파드에 마운트해야 합니다. 또한 크롤링하려는 파일을 작업 중인 Discovery 클러스터에 복사해야 합니다. Discovery 클러스터가 여러 개 있는 경우 이 작업에서 만들 crawler-pvc-portworx.yaml 파일과 함께 파일을 각 클러스터에 복사해야 합니다.

다음 단계를 완료하십시오.

  1. 다음 명령을 입력하여 Portworx 제공자의 storageclass 이름을 확인하십시오.

    oc get storageclass | grep portworx-gp3-sc
    

    다음과 유사한 출력이 표시됩니다.

    NAME             PROVISIONER                    RECLAIMPOLICY  VOLUMEBINDINGMODE  ALLOWVOLUMEEXPANSION  AGE
    portworx-gp3-sc  kubernetes.io/portworx-volume  Retain         Immediate          true                  51d
    
  2. crawler-pvc-portworx.yaml 이라는 파일을 생성하여 다음 내용으로 영구 볼륨 클레임(PVC)을 정의합니다:

    kind: PersistentVolumeClaim
    apiVersion: v1
    metadata:
      name: <name-of-portworx-pvc>
    spec:
      accessModes:
        - ReadWriteMany
      resources:
        requests:
          storage: 10Gi
      storageClassName: portworx-gp3-sc
    

    <name-of-portworx-pvc> 을 동적 Portworx 퍼시스턴트 볼륨 클레임의 이름으로 바꿉니다. 예: jdoe-pvc-portworx

  3. 다음 명령을 입력하여 영구 볼륨 클레임을 생성합니다:

    oc create -f crawler-pvc-portworx.yaml
    

    메시지가 표시됩니다:

    persistentvolumeclaim/jdoe-pvc-portworx created
    
  4. crawler pod에 영구 볼륨 클레임을 마운트하려면 다음 명령을 입력하십시오

    oc patch wd wd --type=merge \
    --patch='{"spec": {"ingestion": {"crawler": {"mount": {"enabled": true, "persistentVolumeClaimName": "<name-of-portworx-pvc>" } } } } }'
    

    <name-of-portworx-pvc> 을 동적 Portworx 퍼시스턴트 볼륨 클레임의 이름으로 바꿉니다. 예를 들어, jdoe-pvc-portworx입니다.

  5. 다음 명령을 입력하여 크롤링할 파일을 동적 Portworx 지속적 볼륨 청구에 복사하십시오.

    crawler 의 기존 pod 중 하나에 대해 이 명령을 한 번만 실행하면 됩니다. 지속적인 볼륨 클레임은 모든 crawleringestion-api pod에 공유됩니다. 명령의 변수를 적절한 정보로 바꿉니다.

    oc rsync <path-to-local-file-system-folder> <crawler-pod>:/mnt
    

영구 볼륨 클레임(PVC)을 마운트하고 크롤링하려는 파일을 PVC에 복사했습니다.

로컬 파일 시스템 데이터 소스에 연결

Discovery 프로젝트에서 다음 단계를 완료하십시오

  1. 탐색 창에서 컬렉션 관리를 선택합니다.

  2. 새 컬렉션을 클릭합니다.

  3. 로컬 파일 시스템를 클릭한 다음 다음를 클릭합니다.

  4. 컬렉션의 이름을 지정합니다.

  5. 크롤링하려는 문서의 언어가 영어가 아닌 경우 적절한 언어를 선택합니다.

    지원되는 언어 목록은 언어 지원을 참조하십시오.

  6. 선택: 동기화 일정을 변경합니다.

    자세한 내용은 크롤링 일정 옵션 를 참조하세요.

  7. 크롤링할 대상 지정하기 섹션의 경로 필드에 크롤링할 파일 경로를 입력한 다음 추가를 클릭합니다.

    파일 경로는 대소문자를 구분합니다. 크롤러는 /mnt 디렉토리 또는 그 하위 디렉터리 중 하나에 있는 파일에만 액세스할 수 있습니다.

  8. 원하는 경우 파일 경로를 더 추가합니다.

  9. 컬렉션에 추가할 파일 유형을 제한하려는 경우 포함하거나 제외할 파일 유형의 파일 확장자를 나열할 수 있습니다.

    지원되는 파일 형식 목록은 지원되는 파일 형식 를 참조하세요.

    이 옵션에 대한 지원은 4.7.0 릴리스에서 추가되었습니다.

  10. 크롤러가 문서의 이미지에서 텍스트를 추출하도록 하려면 추가 처리 설정를 확장하고 광학 문자 인식(OCR)On 으로 설정하세요.

    OCR이 활성화되어 있고 문서에 이미지가 포함되어 있으면 처리 시간이 더 오래 걸립니다. 자세한 내용은 광학 문자 인식 를 참조하세요.

  11. ** 완료**를 누르십시오.

컬렉션이 빠르게 생성됩니다. 데이터가 컬렉션에 추가되면 처리하는 데 시간이 더 걸립니다.

진행 상황을 확인하려면 활동 페이지로 이동하세요. 탐색 창에서 컬렉션 관리를 클릭한 다음 클릭하여 컬렉션을 엽니다.

NFS 스토리지의 필수 단계

다음 방법 중 하나를 선택하여 crawler 파드가 파일 시스템에 액세스할 수 있도록 설정합니다:

외부 NFS 서버 구성하기

크롤링할 로컬 파일 시스템 파일 또는 폴더가 외부 네트워크 파일 시스템(NFS)에 저장된 경우 외부 NFS 서버를 사용하여 지속적 볼륨 청구를 작성할 수 있습니다.

  1. crawler-pv-nfs.yaml 라는 이름의 파일을 만들고 다음 내용을 입력합니다:

    apiVersion: v1
    kind: PersistentVolume
    metadata:
      name: <persistent-volume-name>
      labels:
        pv-name: <persistent-volume-name>
    spec:
      capacity:
        storage: 10Gi
      accessModes:
        - ReadWriteMany
      persistentVolumeReclaimPolicy: Retain
      nfs:
        server: <NFS server hostname or IP address>
        path: <Path of NFS exported folder>
    

    <persistent-volume-name> 에 대한 참조를 퍼시스턴트 볼륨의 이름으로 바꿉니다. 예를 들어, jdoe-nfs-pv 를 입력하고 누락된 외부 NFS 세부 정보를 추가합니다.

  2. 다음 명령을 입력하여 영구 볼륨 클레임을 생성합니다:

    oc create -f crawler-pv-nfs.yaml
    

    다음 메시지가 표시됩니다.

    persistentvolume/jdoe-nfs-pv created
    
  3. crawler-pvc-nfs.yaml 라는 파일을 만들고 다음 내용을 입력합니다:

    kind: PersistentVolumeClaim
    apiVersion: v1
    metadata:
      name: <persistent-volume-claim-name>
    spec:
      accessModes:
        - ReadWriteMany
      resources:
        requests:
          storage: 10Gi
      selector:
        matchLabels:
          pv-name: <persistent-volume-name>
    

    다음 변수를 대체하십시오.

    • <persistent-volume-claim-name>: 지속적 볼륨 클레임의 이름을 지정합니다. 예를 들어, jdoe-nfs-pvc입니다.
    • <persistent-volume-name>: 영구 볼륨의 이름을 지정합니다. 예를 들어, jdoe-nfs-pv입니다.
  4. 다음 명령을 입력하여 영구 볼륨 클레임을 생성합니다:

    oc create -f crawler-pvc-nfs.yaml
    

    다음 메시지가 표시됩니다.

    persistentvolumeclaim/jdoe-nfs-pvc created
    
  5. crawler 의 pod에 영구 볼륨 클레임을 마운트하려면 다음 명령을 입력하십시오.

    이 명령은 또한 모든 ingestion-api 포드에 퍼시스턴트 볼륨 클레임을 마운트합니다. <persistent-volume-claim-name> 를 영구 볼륨 클레임의 이름으로 바꿉니다. 예: jdoe-nfs-pvc.

    oc patch wd wd --type=merge \
    --patch='{"spec": {"ingestion": {"crawler": {"mount": {"enabled": true, "persistentVolumeClaimName": "<persistent-volume-claim-name>" } } } } }'
    

NFS 스토리지 클래스를 이용한 동적 프로비저닝 구성

로컬 파일 시스템 파일이나 폴더를 크롤링하고 싶지만, 그 파일이나 폴더를 저장하기 위해 별도의 NFS 서버를 준비하고 싶지 않다면, NFS 스토리지 클래스를 사용하여 동적 스토리지를 구성할 수 있습니다.

Discovery 가 지원하는 스토리지 제공업체에 대한 자세한 정보와 스토리지 비교는 스토리지 고려 사항을 참조하십시오.

이 작업을 완료하기 전에 크롤링하려는 파일을 작업 중인 Discovery 클러스터로 복사하십시오. 여러 Discovery 클러스터가 있는 경우 이 작업에서 만드는 crawler-pvc-dynamic.yaml 파일과 함께 파일을 각 클러스터에 복사해야 합니다.

다음 단계를 완료하십시오.

  1. 다음 명령을 입력하여 NFS 제공자의 storageclass 이름을 확인하십시오.

    oc get storageclass
    

    메시지가 표시됩니다.

    NAME        PROVISIONER                                     RECLAIMPOLICY  VOLUMEBINDINGMODE  ALLOWVOLUMEEXPANSION  AGE
    nfs-client  cluster.local/innocence-nfs-client-provisioner  Delete         Immediate          true                  177m
    
  2. crawler-pvc-dynamic.yaml 이라는 이름의 파일을 만들고 다음 콘텐츠를 추가합니다:

    kind: PersistentVolumeClaim
    apiVersion: v1
    metadata:
      name: <name-of-dynamic-pvc>
    spec:
      accessModes:
        - ReadWriteMany
      resources:
        requests:
          storage: 10Gi
      storageClassName: nfs-client
    

    <name-of-dynamic-pvc> 을 동적 NFS 영구 볼륨 클레임의 이름으로 바꿉니다. 예를 들어, jdoe-dynamic-pvc입니다.

  3. 다음 명령을 입력하여 영구 볼륨 클레임을 생성합니다:

    oc create -f crawler-pvc-dynamic.yaml
    

    메시지가 표시됩니다.

    persistentvolumeclaim/jdoe-dynamic-pvc created
    
  4. crawler 의 pod에 영구 볼륨 클레임을 마운트하려면 다음 명령을 입력하십시오.

    이 명령은 또한 모든 ingestion-api 포드에 퍼시스턴트 볼륨 클레임을 마운트합니다.

    oc patch wd wd --type=merge \
    --patch='{"spec": {"ingestion": {"crawler": {"mount": {"enabled": true, "persistentVolumeClaimName": "<name-of-dynamic-pvc>" } } } } }'
    

    <name-of-dynamic-pvc> 을 이전 단계의 동적 NFS 영구 볼륨 클레임의 이름으로 바꿉니다. 예를 들어, jdoe-dynamic-pvc입니다.

  5. 다음 명령을 입력하여 크롤링할 파일을 동적 NFS 지속적 볼륨 청구에 복사하십시오.

    이 명령은 기존 crawler 파드 중 하나에 대해 한 번만 실행해야 합니다. 지속적인 볼륨 클레임은 모든 crawleringestion-api pod에 공유됩니다. 명령의 변수를 적절한 정보로 바꿉니다.

    oc rsync <path-to-local-file-system-folder> <crawler-pod>:/mnt
    

영구 볼륨 클레임(PVC)을 마운트하고 크롤링하려는 모든 파일을 PVC에 복사했습니다.