ownCloud oCIS에서 사용자 역할별 기본 스토리지 할당량 설정
역할별로 새로운 ownCloud Infinite Scale 사용자에게 바이트 기반 스토리지 제한을 할당하는 방법을 안내합니다. proxy.yaml 예제와 안전성 검증 체크리스트가 포함되어 있습니다.
ownCloud Infinite Scale(oCIS)에서 사용자 파일 콘텐츠를 S3에 저장하려면 Storage-Users 서비스가 s3ng드라이버를 사용하도록 구성하고, 미리 생성된 버킷을 가리키도록 설정하고, 서비스의 메타데이터 디렉터리를 영구 POSIX 스토리지에 유지해야 합니다. S3는 파일 블롭을 저장하며, 모든 로컬 oCIS 데이터 경로를 대체하지는 않습니다.
아래 구성은 ownCloud Infinite Scale 8.2 설명서를 따릅니다. 프로덕션 시스템을 변경하기 전에 변수 이름과 배포 예제를 설치된 릴리스의 설명서와 비교하십시오.
이 맥락에서 블롭(blob)은 저장된 파일 콘텐츠를 의미하고, 메타데이터는 oCIS가 파일을 구성하고 찾는 데 사용하는 정보를 의미합니다. S3NG를 사용하면 블롭은 S3 호환 객체 저장소에 저장되고 메타데이터는 POSIX 파일 시스템에 유지됩니다. 해당 파일 시스템은 항상 마운트된 상태로 유지하고 백업에 포함시켜야 합니다. 시스템 스토리지 드라이버는 그대로 유지해야 합니다 ocis.
다음의 간단한 비행 전 점검 목록을 활용하세요:
ownCloud 스토리지 레이아웃 노트에는 S3 버킷 외부에 어떤 정보가 남아 있는지 설명되어 있습니다. 따라서 버킷만 복원하는 것은 완전한 복구 계획이 아닙니다.

공급자 콘솔 또는 인프라 도구에서 버킷을 구성한 다음 oCIS 서비스 ID에 해당 버킷에 필요한 액세스 권한만 부여하십시오. ownCloud S3 페이지에는 AWS 스타일 S3 API에 대한 기본 정책이 설명되어 있습니다. 버킷 이름을 실제 bucket-name버킷 이름으로 바꾸고, 공급자가 Amazon S3가 아닌 S3 호환 방식인 경우 정책 구문을 해당 방식에 맞게 수정하십시오.
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": ["s3:ListBucket"],
"Resource": ["arn:aws:s3:::bucket-name"]
},
{
"Effect": "Allow",
"Action": [
"s3:*Object",
"s3:*MultipartUpload",
"s3:ListMultipartUploadParts"
],
"Resource": ["arn:aws:s3:::bucket-name/*"]
}
]
}
버킷 수준 ARN과 객체 수준 ARN은 서로 다릅니다. 버킷 수준 ARN은 버킷 목록을 조회하는 데 사용되고, 객체 수준 ARN은 버킷 내 객체에 대한 작업을 적용하는 데 사용됩니다. ownCloud S3 버킷 정책 요구 사항 및 공급업체의 최신 정책 문서를 준수하십시오. 정책 파일, 소스 저장소 또는 스크린샷에 자격 증명을 붙여넣지 마십시오.

표준 oCIS 환경 변수를 허용하는 서비스 환경 또는 Compose 파일의 경우 다음 값을 설정하십시오. 이러한 예시 값은 자리 표시자이며, 공급자가 할당한 엔드포인트 및 지역을 사용해야 합니다.
STORAGE_USERS_DRIVER: s3ng
STORAGE_USERS_S3NG_ROOT: /var/lib/ocis/storage/users
STORAGE_SYSTEM_DRIVER: ocis
STORAGE_USERS_S3NG_ENDPOINT: https://s3.example.com
STORAGE_USERS_S3NG_REGION: us-east-1
STORAGE_USERS_S3NG_ACCESS_KEY: ${OCIS_S3_ACCESS_KEY}
STORAGE_USERS_S3NG_SECRET_KEY: ${OCIS_S3_SECRET_KEY}
STORAGE_USERS_S3NG_BUCKET: ocis-user-blobs
(선택한 루트) 영구 POSIX 스토리지에 마운트하십시오 /var/lib/ocis/storage/users. 이 메타데이터 경로를 S3 버킷으로 지정하지 마십시오. 액세스 키와 비밀 키를 안전하게 주입하십시오. 위의 변수 참조는 배포 환경에서 해당 비밀 키 값을 제공한다고 가정합니다. 엔드포인트는 oCIS 서비스에서 접근 가능해야 하며, 버킷 이름, 지역 및 자격 증명은 동일한 공급자 계정과 버킷을 참조해야 합니다.
ownCloud의 모듈형 Compose 예제를 사용하는 경우 ocis_full, 선택 사항인 S3 오버레이는 예제별 S3NG설정과 별도의 구성 파일을 사용합니다. 다른 Compose 파일과 무턱대고 혼합하지 말고, 해당 예제를 완전한 배포 패턴으로 따르십시오. 공식 oCIS Compose 배포 예제 와 Storage-Users 환경 참조를s3ng.yml 확인하세요 .

대용량 파일은 여러 파트로 나누어 업로드됩니다. Amazon S3는 최대 객체 크기를 5TiB, 파트 수를 10,000개로 제한하고 있으며, 각 파트의 크기는 5MiB에서 5GiB 사이여야 합니다. S3NG의 기본 파트 크기는 16MiB로 설정되어 있습니다. 이 기본값을 사용하면 파트 수 제한이 공급자의 최대 객체 크기에 도달하기 전에 실질적인 한계가 될 수 있습니다. ownCloud 8.2 페이지에서는 기본 한계를 160GiB로 추정하고 있으므로, 구성된 파트 크기와 공급자의 규칙을 사용하여 안전한 최대값을 계산하고 여유 공간을 확보하십시오.
ownCloud 문서에서 구성 가능한 유일한 멀티파트 매개변수는 파트 크기입니다 STORAGE_USERS_S3NG_PUT_OBJECT_PART_SIZE. 지원하는 파일 크기가 10,000개 이상의 파트를 필요로 하는 경우 파트 크기를 늘리세요. 값은 uint64부호 없는 정수이므로 "MiB"가 추가된 문자열이 아닌 바이트 수로 설정해야 합니다. 문서에 명시된 5 MiB~5 GiB 범위 내에서 값을 유지하고 S3 공급자가 선택한 값을 지원하는지 확인하세요. 5 TiB 크기의 객체를 10,000개의 파트로 분할하는 경우 평균 파트 크기는 500 MiB가 되어야 합니다.
또한 oCIS 호스트 또는 컨테이너에 임시 저장 공간을 확보하십시오. ownCloud는 수신 데이터를 버퍼링하기 위해 예상되는 가장 큰 파일 크기 이상의 임시 용량이 필요하다고 명시하고 있습니다. 유효한 버킷과 자격 증명이 있더라도 파트 제한 부족 또는 임시 디스크 용량 부족으로 인한 오류를 방지할 수는 없습니다. ownCloud의 S3 업로드 제한 및 환경 변수 유형 참조를 확인하십시오 .
구성을 저장한 후 설치 절차에 따라 oCIS를 다시 시작하거나 재배포하십시오. 서비스 로그에서 구성, 엔드포인트, 권한 또는 연결 오류를 확인하십시오. 그런 다음 oCIS와 동일하게 구성된 런타임에서 블롭스토어 검사를 실행하십시오.
ocis storage-users blobstore check
이 유지 관리 명령은 구성된 블롭스토어를 사용하여 임의의 테스트 페이로드로 업로드, 다운로드 및 삭제 왕복 작업을 수행합니다. 이는 스토리지 점검에 초점을 맞춘 명령이며, 모든 사용자 대상 워크플로 또는 대용량 업로드가 성공한다는 것을 보장하는 것은 아닙니다. 블롭스토어 명령 참조 문서에는 구성 가능한 테스트 페이로드 크기를 포함한 다양한 옵션이 설명되어 있습니다.

마지막으로 클라이언트 또는 웹 인터페이스를 통해 작은 테스트 파일을 업로드하고 파일이 제대로 표시되고 열리는지 확인하십시오. 대용량 파일 배포의 경우, 설정이 완료되기 전에 대표 파일 크기로 테스트를 진행하는 것이 좋습니다. 작은 왕복 전송이 성공했다고 해서 멀티파트 용량이나 사용 가능한 임시 디스크 공간이 검증되는 것은 아닙니다.
S3 객체와 POSIX 메타데이터, 구성 및 기타 필요한 oCIS 데이터를 하나의 통합된 세트로 백업하십시오. ownCloud의 백업 지침에 따르면 백업을 위해 인스턴스를 중지하고 외부에 저장된 S3 블롭은 별도로 처리해야 합니다. 두 스토리지 계층 모두의 복구 가능한 복사본을 보관하고 배포를 보호된 것으로 간주하기 전에 복원 절차를 테스트하십시오 . 자세한 내용은 ownCloud 백업 고려 사항을 참조하십시오 .
STORAGE_USERS_DRIVER입니다 s3ng. 시스템 저장 공간이 남아 있습니다 ocis.역할별로 새로운 ownCloud Infinite Scale 사용자에게 바이트 기반 스토리지 제한을 할당하는 방법을 안내합니다. proxy.yaml 예제와 안전성 검증 체크리스트가 포함되어 있습니다.
TLS 인증을 비활성화하지 않고 서버 호스트 이름, 인증서 체인, 개인 CA 신뢰 및 캡티브 포털 문제를 확인하여 ownCloud 데스크톱 동기화를 복원하세요.
잘못된 파일 보고서를 사용하여 코어 파일이나 앱 서명이 일치하지 않는 부분을 식별하고, 올바른 릴리스 파일을 복원하고, 무결성 검사를 안전하게 확인할 수 있습니다.
ownCloud Infinite Scale을 공식 Compose 예제를 사용하여 배포하고, 도메인 및 영구 스토리지를 구성한 다음, TLS, 컨테이너 및 첫 로그인을 확인합니다.
ownCloud Infinite Scale이 파일 콘텐츠를 안정적으로 저장할 수 있도록 S3NG 드라이버, 버킷 권한, 영구 메타데이터 저장소 및 업로드 크기를 설정합니다.
ownCloud 서버 업로드가 거의 완료될 무렵 중단되는 이유를 파일 상태, 할당량, 임시 디스크 공간, PHP 제한 및 프록시 시간 초과를 확인하여 알아보세요.
ownCloud의 웹 루트에만 AllowOverride All을 설정하고, 활성 Apache vhost를 확인한 다음, 안전하게 페이지를 새로 고침하여 .htaccess 규칙을 복원하십시오.
ownCloud의 엔터프라이즈 감사 앱을 활성화하고, admin_audit 이벤트를 보호된 로그 파일로 라우팅하고, 실제 사용자 작업이 기록되는지 확인하십시오.
Keycloak의 영역 발급자, 웹 클라이언트 및 사용자 클레임을 정렬하여 ownCloud Infinite Scale이 웹 및 모바일 클라이언트 전반에서 사용자를 안정적으로 로그인할 수 있도록 합니다.
ownCloud의 occ 명령어를 사용하여 소유 파일과 공유 폴더를 이전하고, 어떤 파일이 남는지 확인하고, 이전 계정을 삭제하기 전에 액세스 권한을 확인하세요.