#파일 스토리지: S3 (Pro)

#소개

기존 파일 관리 플러그인에 S3 프로토콜과 호환되는 파일 스토리지 유형 지원이 추가되었습니다. Amazon S3, Alibaba Cloud OSS, Tencent Cloud COS, MinIO, Cloudflare R2 등 S3 프로토콜을 지원하는 모든 객체 스토리지 서비스를 쉽게 연동할 수 있어 스토리지 서비스의 호환성과 유연성을 더욱 높여줍니다.

#주요 기능

1. 클라이언트 업로드: 파일 업로드 과정에서 NocoBase 서버를 거치지 않고 파일 스토리지 서비스에 직접 연결하여 더욱 효율적이고 빠른 업로드 경험을 제공합니다.
2. 프라이빗 액세스: 파일에 접근할 때 모든 URL은 서명된 임시 인증 주소로 제공되어 파일 접근의 보안성과 유효성을 보장합니다.

#활용 사례

1. 파일 테이블 관리: 업로드된 모든 파일을 중앙에서 관리하고 저장하며, 다양한 파일 유형과 스토리지 방식을 지원하여 파일 분류 및 검색을 편리하게 합니다.
2. 첨부 파일 필드 스토리지: 폼이나 레코드에 첨부 파일을 업로드할 때 데이터를 저장하고, 특정 데이터 레코드와 연결할 수 있도록 지원합니다.

#플러그인 설정

1. plugin-file-storage-s3-pro 플러그인을 활성화합니다.
2. "Setting -> FileManager"로 이동하여 파일 관리 설정에 접근합니다.
3. "Add new" 버튼을 클릭하고 "S3 Pro"를 선택합니다.

4. 팝업 창이 나타나면 작성해야 할 양식 내용이 많을 것입니다. 해당 파일 서비스에 대한 관련 파라미터 정보를 얻으려면 다음 문서를 참조하여 양식에 올바르게 입력해 주세요.

#서비스 제공업체 설정

#Amazon S3

#버킷 생성

1. Amazon S3 콘솔에 접속합니다.
2. 오른쪽의 "Create bucket" 버튼을 클릭합니다.

3. Bucket Name(버킷 이름)을 입력하고, 다른 필드는 기본 설정으로 유지합니다. 페이지 하단으로 스크롤하여 "Create" 버튼을 클릭하면 생성이 완료됩니다.

#CORS 설정

1. 버킷 목록에서 방금 생성한 버킷을 찾아 클릭하여 상세 페이지로 이동합니다.

2. "Permission" 탭으로 이동한 다음, 아래로 스크롤하여 CORS 설정 섹션을 찾습니다.

3. 다음 설정을 입력하고 (필요에 따라 세부적으로 구성할 수 있습니다) 저장합니다.

[
    {
        "AllowedHeaders": [
            "*"
        ],
        "AllowedMethods": [
            "POST",
            "PUT"
        ],
        "AllowedOrigins": [
            "*"
        ],
        "ExposeHeaders": [
            "ETag"
        ],
        "MaxAgeSeconds": 3000
    }
]

#AccessKey 및 SecretAccessKey 가져오기

1. 페이지 오른쪽 상단에 있는 "Security credentials" 버튼을 클릭합니다.

2. 아래로 스크롤하여 "Access Keys" 섹션을 찾은 다음, "Create Access Key" 버튼을 클릭합니다.

3. 약관에 동의합니다 (여기서는 메인 계정 데모이며, 프로덕션 환경에서는 IAM을 사용하는 것을 권장합니다).

4. 페이지에 표시된 Access key와 Secret access key를 저장합니다.

#파라미터 가져오기 및 설정

1. AccessKey ID와 AccessKey Secret은 이전 단계에서 얻은 값입니다. 정확하게 입력해 주세요.
2. 버킷 상세 페이지의 속성(properties) 패널로 이동하면 Bucket Name(버킷 이름)과 Region(리전) 정보를 확인할 수 있습니다.

#공개 액세스 (선택 사항)

이 설정은 필수는 아니며, 업로드된 파일을 완전히 공개해야 할 때 구성합니다.

1. 권한(Permissions) 패널로 이동하여 "Object Ownership"까지 아래로 스크롤한 다음, "편집"을 클릭하고 ACL을 활성화합니다.

2. "Block public access"까지 스크롤한 다음, "편집"을 클릭하고 ACL 제어를 허용하도록 설정합니다.

3. NocoBase에서 "Public access"를 선택합니다.

#썸네일 설정 (선택 사항)

이 설정은 선택 사항이며, 이미지 미리 보기 크기나 효과를 최적화해야 할 때 사용합니다. 이 배포 방식은 추가 비용이 발생할 수 있으므로, 자세한 내용은 AWS 관련 약관을 참조해 주세요.

1. Dynamic Image Transformation for Amazon CloudFront에 접속합니다.

2. 페이지 하단의 Launch in the AWS Console 버튼을 클릭하여 배포를 시작합니다.

3. 안내에 따라 설정을 완료합니다. 특히 다음 몇 가지 옵션에 주의해야 합니다.

   1. 스택을 생성할 때 원본 이미지가 포함된 Amazon S3 버킷 이름을 지정해야 합니다. 이전에 생성한 버킷 이름을 입력해 주세요.
   2. 데모 UI 배포를 선택한 경우, 배포 완료 후 해당 인터페이스를 통해 이미지 처리 기능을 테스트할 수 있습니다. AWS CloudFormation 콘솔에서 스택을 선택하고 "출력(Outputs)" 탭으로 이동하여 DemoUrl 키에 해당하는 값을 찾아 해당 링크를 클릭하여 데모 인터페이스를 엽니다.
   3. 이 솔루션은 sharp Node.js 라이브러리를 사용하여 이미지를 효율적으로 처리합니다. GitHub 저장소에서 소스 코드를 다운로드하여 필요에 따라 사용자 정의할 수 있습니다.

   

4. 설정이 완료되면 배포 상태가 CREATE_COMPLETE로 변경될 때까지 기다립니다.

5. NocoBase 설정 시 다음 사항에 유의해 주세요.

   1. Thumbnail rule: ?width=100과 같은 이미지 처리 관련 파라미터를 입력합니다. 자세한 내용은 AWS 문서를 참조해 주세요.
   2. Access endpoint: 배포 후 출력(Outputs) -> ApiEndpoint의 값을 입력합니다.
   3. Full access URL style: Ignore를 선택해야 합니다 (설정 시 이미 버킷 이름을 입력했으므로, 접근 시 다시 필요하지 않습니다).

   

#설정 예시

#Alibaba Cloud OSS

#버킷 생성

1. OSS 콘솔을 엽니다.

2. 왼쪽 메뉴에서 "Buckets"를 선택한 다음, "Create Bucket" 버튼을 클릭하여 스토리지 버킷 생성을 시작합니다.

3. 버킷 관련 정보를 입력하고 마지막으로 "Create" 버튼을 클릭합니다.
   1. Bucket Name: 비즈니스 요구사항에 맞춰 자유롭게 이름을 지정합니다.
   2. Region: 사용자에게 가장 가까운 리전을 선택합니다.
   3. 기타 설정은 기본값으로 유지하거나 필요에 따라 직접 구성할 수 있습니다.

#CORS 설정

1. 이전 단계에서 생성한 버킷의 상세 페이지로 이동합니다.

2. 중간 메뉴에서 "Content Security -> CORS"를 클릭합니다.

3. "Create Rule" 버튼을 클릭하고 관련 내용을 작성한 다음, 아래로 스크롤하여 "OK"를 클릭합니다. 아래 스크린샷을 참조하거나 더 자세한 설정을 진행할 수 있습니다.

#AccessKey 및 SecretAccessKey 가져오기

1. 오른쪽 상단 아바타 아래의 "AccessKey"를 클릭합니다.

2. 여기서는 데모를 위해 메인 계정을 사용하여 AccessKey를 생성하지만, 실제 운영 환경에서는 RAM을 사용하여 생성하는 것을 권장합니다. 자세한 내용은 https://help.aliyun.com/zh/ram/user-guide/create-an-accesskey-pair-1?spm=5176.28366559.0.0.1b5c3c2fUI9Ql8#section-rjh-18m-7kp을 참조해 주세요.

3. "Create AccessKey" 버튼을 클릭합니다.

4. 계정 인증을 진행합니다.

5. 페이지에 표시된 Access key와 Secret access key를 저장합니다.

#파라미터 가져오기 및 설정

1. AccessKey ID와 AccessKey Secret은 이전 단계에서 얻은 값입니다.
2. 버킷 상세 페이지로 이동하여 Bucket 이름을 확인합니다.

3. 아래로 스크롤하여 Region을 확인합니다 (뒤에 ".aliyuncs.com"은 필요 없습니다).

4. 엔드포인트(endpoint) 주소를 확인하고, NocoBase에 입력할 때는 https:// 접두사를 추가해야 합니다.

#썸네일 설정 (선택 사항)

이 설정은 선택 사항이며, 이미지 미리 보기 크기나 효과를 최적화해야 할 때만 사용합니다.

1. Thumbnail rule 관련 파라미터를 입력합니다. 자세한 파라미터 설정은 이미지 처리 파라미터 문서를 참조해 주세요.

2. Full upload URL style과 Full access URL style은 동일하게 유지하면 됩니다.

#설정 예시

#MinIO

#버킷 생성

1. 왼쪽의 Buckets 메뉴를 클릭한 다음 -> Create Bucket을 클릭하여 생성 페이지로 이동합니다.
2. 버킷 이름을 입력한 후, 저장 버튼을 클릭합니다.

#AccessKey 및 SecretAccessKey 가져오기

1. Access Keys로 이동한 다음 -> Create access key 버튼을 클릭하여 생성 페이지로 이동합니다.

2. 저장 버튼을 클릭합니다.

3. 팝업 창에 표시된 Access Key와 Secret Key를 저장하여 나중에 설정할 때 사용합니다.

#파라미터 설정

1. NocoBase의 File manager 페이지로 이동합니다.
2. Add new 버튼을 클릭하고 S3 Pro를 선택합니다.
3. 양식을 작성합니다.
   • AccessKey ID와 AccessKey Secret: 이전 단계에서 저장한 값을 사용합니다.
   • Region: 프라이빗으로 배포된 MinIO는 리전 개념이 없으므로, "auto"로 설정할 수 있습니다.
   • Endpoint: 배포된 서비스의 도메인 이름 또는 IP 주소를 입력합니다.
   • Full access URL style을 Path-Style로 설정해야 합니다.

#설정 예시

#Tencent COS

위에서 설명한 파일 서비스 설정을 참조하시면 됩니다. 설정 방식은 유사합니다.

#설정 예시

#Cloudflare R2

위에서 설명한 파일 서비스 설정을 참조하시면 됩니다. 설정 방식은 유사합니다.

#설정 예시

#사용자 가이드

파일 관리자 플러그인 문서를 참조해 주세요.