Planning에서 OCI Object Storage 설정

Task Manager 첨부파일에 대해 Planning에서 OCI Object Storage를 설정하려면 다음을 수행합니다.

  1. 네비게이터로 이동하여 에서 연결을 누릅니다.

    연결 관리 페이지가 표시됩니다.

  2. 생성을 눌러 연결을 생성합니다.

    연결을 생성할 제공자 선택 대화상자가 표시됩니다.

  3. 기타 웹 서비스 제공자를 누릅니다.

    연결 세부정보 입력 대화상자가 표시됩니다.

  4. 다음 세부정보를 지정합니다.
    • 연결 이름: Object Storage 연결 이름
    • 설명: 연결에 대한 간단한 설명
    • URL: Object Storage 버킷 URL. Oracle Object Storage Cloud 버킷 URL입니다.
    • 사용자비밀번호: Oracle Cloud Infrastructure에서 Planning에 대해 생성한 사용자 이름 및 비밀번호

      Note:

      통합 ID 제공자에서 사용자가 생성된 경우 사용자 이름에 통합 ID 제공자 이름이 접두어로 지정되어야 합니다. oracleidentitycloudservice/username을 예로 들 수 있습니다. 비밀번호의 경우, 로그인 비밀번호가 아닌 인증 토큰을 비밀번호로 사용해야 합니다.
  5. 저장 후 닫기를 눌러 Object Storage 연결 세부정보를 저장합니다.
  6. > 애플리케이션 > Task Manager로 이동합니다.
  7. 시스템 설정 탭을 누릅니다.

    시스템 설정 관리 페이지가 표시됩니다.

  8. Object Storage를 누르고 연결 드롭다운 목록에서 Object Storage 연결을 선택합니다.

    버킷 URL이 자동으로 채워집니다.

    URL 형식은 https://swiftobjectstorage.region_identifier.oraclecloud.com/v1/namespace/bucket_name이며, 설명은 다음과 같습니다.
    • region_identifier는 호스팅 OCI(Oracle Cloud Infrastructure)입니다.
    • region.namespace는 모든 버킷 및 객체에 대한 최상위 레벨 컨테이너입니다. 각 Oracle Cloud Infrastructure 테넌트는 계정 생성 시에 변경이 불가능하며 고유한 시스템 생성 Object Storage 네임스페이스 이름이 지정됩니다. 테넌시 네임스페이스 이름(예: axaxnpcrorw5)은 모든 영역에서 유효합니다
    • bucket_name은 데이터 및 파일을 저장하는 논리 컨테이너의 이름입니다. 버킷은 구획에서 구성되고 유지관리됩니다.

    URL 예는 https://swiftobjectstorage.us-ashburn-1.oraclecloud.com/v1/epmcloud/fccsAttachments입니다.

    버킷 내에 폴더를 생성한 경우 URL 형식은 https://swiftobjectstorage.us-ashburn-1.oraclecloud.com/v1/epmcloud/bucket_name/folder_name입니다. 여기서, folder_name은 데이터가 포함된 폴더의 이름입니다.

  9. 검증 및 저장을 누릅니다. 시스템에서는 연결이 제대로 작동 중인지 확인하기 위해 검증하며 테스트 파일을 생성하고 읽습니다.

    Object Storage 확인 대화상자가 표시됩니다.

  10. 계속을 누릅니다. 현재 데이터베이스에 있는 첨부파일을 지정된 Object Storage 위치로 이동하는 뱃치 작업이 바로 시작됩니다. 이후로는 모든 첨부파일이 데이터베이스가 아닌 Object Storage 위치에 저장됩니다. 첨부파일이 Object Storage 위치에 저장되면 데이터베이스로 되돌릴 수 없습니다.
  11. 기존 고객인지 OCI Object StoragePlanning을 처음으로 설정한 새 고객인지 여부에 따라 통계가 표시됩니다.
    • 마이그레이션된 첨부파일 수: 마이그레이션된 첨부파일의 수입니다.

    • 마이그레이션된 첨부파일 크기(MB): 마이그레이션된 첨부파일의 크기입니다.

    • 대기 중인 첨부파일 수: 마이그레이션을 위해 대기 중인 첨부파일의 수입니다.

    • 대기 중인 첨부파일 크기(MB): 마이그레이션을 위해 대기 중인 첨부파일의 크기입니다.

    • 모든 첨부파일 수: 시스템에 있는 총 첨부파일 수입니다(마이그레이션된 첨부파일, 마이그레이션 대기 중인 첨부파일 및 새로 추가된 첨부파일 포함).

    • 모든 첨부파일 크기(MB): 시스템에 있는 모든 첨부파일의 크기입니다.

    Note:

    테스트 환경에서 프로덕션 환경으로 마이그레이션한 후 연결 세부정보의 수동 단계를 업데이트하지 않는 경우 애플리케이션에서 첨부파일을 업로드 및 다운로드하면 오류가 발생합니다. 다운로드는 0바이트가 수행되고 업로드는 검증 오류가 발생합니다.
    • 기존 고객인 경우 Planning 데이터베이스에서 OCI Object Storage로의 첨부파일 마이그레이션과 관련된 통계가 표시됩니다. 첨부파일이 이동됨에 따라 통계 증분이 표시됩니다.

      Planning은 데이터베이스에서 첨부파일을 가져와 설정한 버킷에 있는 OCI Object Storage로 파일을 이동합니다. 이는 Oracle Cloud Infrastructure에서 Planning에 대해 생성한 사용자 이름 및 비밀번호와 함께 버킷 URL을 기반으로 수행됩니다. 첨부파일은 데이터베이스에서 OCI Object Storage로 이동된 다음 데이터베이스에서 제거됩니다.

      첫번째 마이그레이션 이후 첨부파일의 업로드 및 다운로드는 OCI Object Storage에서 저장 및 검색됩니다.

    • Planning을 처음 사용하는 경우 기존 첨부파일을 OCI Object Storage로 이동하지 않으므로 표시된 많은 통계가 0으로 표시됩니다.

    다음은 통계의 샘플 스크린샷입니다.

    통계

재설정을 누르면 작동한 최근 연결로 재설정됩니다.

구성 문제해결

OCI Object Storage를 설정하는 동안 다음 오류가 표시되면 버킷 URL 또는 인증서에 문제가 있을 수 있습니다.

Error: Unable to connect to the Object Storage service using the specified URL and credentials.

cURL 또는 Postman과 같은 REST 클라이언트를 사용하여 버킷 URL 및 인증서를 테스트합니다.

cURL 명령의 형식은 다음과 같습니다. curl <bucket URL> -u "<username>:<password>"

다음은 URL 및 인증서를 테스트하기 위한 cURL 명령 예제입니다.

curl https://swiftobjectstorage.us-ashburn-1.oraclecloud.com/v1/epmcloud/taskAttachments -u "username:password"