App 스토리지

App 스토리지를 사용하기 전에 프로젝트를 Atoms 클라우드에 연결하세요. 연결되어 있지 않다면 에이전트에게 Atoms 클라우드를 연결해 달라고 요청하거나 Atoms 클라우드를 따르세요.

Atoms 클라우드에서 App 스토리지 이해하기

App 스토리지는 프로젝트가 보관하고 접근해야 하는 파일을 저장합니다. 이는 데이터베이스에 저장된 구조화된 데이터, Chat에 업로드된 파일, 그리고 프로젝트의 코드를 구성하는 파일과는 별개입니다.

주요 용어

• Bucket: 관련 파일을 저장하고 그룹화하는 데 사용되는 기본 컨테이너입니다. 버킷은 하나의 파일 범주를 위한 저장 공간처럼 생각할 수 있습니다. 각 버킷은 Public 또는 Private 중 하나로 설정되며, 이 설정은 내부 파일에 누가 접근할 수 있는지를 제어합니다.
• Folder: 버킷 내에서 파일을 정리하는 선택적 방법입니다. 폴더는 컴퓨터의 폴더처럼 작동하며, 더 큰 파일 모음을 더 쉽게 관리할 수 있도록 도와줍니다.
• Object: 이미지, 문서, 동영상 또는 기타 업로드된 파일처럼 버킷이나 폴더에 저장된 개별 파일입니다.
• Object key: 버킷 내부에서 파일이 저장된 위치를 식별하는 데 사용되는 고유 경로입니다. 예를 들어 images/profile/avatar.png 는 images/profile 폴더 안에 저장된 이미지의 object key일 수 있습니다.

Public 또는 Private 선택하기

버킷을 만들기 전에 버킷 유형을 선택하세요:

Bucket type	용도
Private	민감한 파일, 계정별 파일 또는 사용자 업로드 파일
Public	의도적으로 공개해도 안전한 비민감 파일

민감하거나 사용자별 파일에는 Private를 사용하세요. 접근 오류가 발생하더라도 파일에 접근할 수 있게 하려고 버킷을 Public 으로 변경하지 마세요. 대신 앱이 파일을 요청하는 사람에게 해당 파일에 접근할 권한이 있는지 확인하도록 하세요.

Atoms 클라우드에서 App 스토리지 열기

1. 데스크톱 기기에서 프로젝트를 엽니다.
2. App 뷰어가 있는 동일한 워크스페이스 도구 모음에서 Atoms 클라우드를 선택합니다.
3. Atoms 클라우드 사이드바에서 App 스토리지를 선택합니다.

App 스토리지의 권한

App 스토리지는 워크스페이스 역할을 사용합니다. Editors 와 workspace owners 모두 열 수 있는 프로젝트의 스토리지를 관리할 수 있습니다. 워크스페이스 멤버가 아닌 사람은 프로젝트의 App 스토리지를 열거나 관리할 수 없습니다.

버킷의 Public 또는 Private 설정은 Atoms 클라우드에서 누가 이를 관리할 수 있는지를 바꾸지 않습니다. 이 설정은 실행 중인 앱이 파일에 대한 접근을 어떻게 제공할 수 있는지를 제어하며, 워크스페이스 권한은 Atoms 클라우드 워크스페이스에서 누가 스토리지를 관리할 수 있는지를 제어합니다.

버킷 만들기

앱은 최대 10 buckets 까지 가질 수 있습니다. 서로 다른 파일 그룹에 서로 다른 접근 설정이 필요하거나 더 쉬운 정리를 위해 분리해 두어야 한다면 별도의 버킷을 만드세요.

1. App 스토리지 페이지에서 Create Bucket 을 선택합니다.
2. Bucket Name 아래에서 버킷의 고유한 이름을 입력합니다. 이름은 다음 조건을 충족해야 합니다:
   • 3~63자여야 합니다.
   • 소문자, 숫자, 하이픈만 사용해야 합니다.
   • 문자 또는 숫자로 시작하고 끝나야 합니다.
3. Bucket Type 아래에서 Private 또는 Public 을 선택합니다. 기본값으로 Public 이 선택되어 있으므로 계속하기 전에 원하는 접근 수준을 선택했는지 확인하세요.
4. Create 를 선택합니다.

새 버킷은 이름, 유형, 생성 날짜와 함께 App 스토리지 페이지에 표시됩니다. 버킷을 선택해 열고 내용을 확인하세요.

App 스토리지에서 Create Bucket을 선택합니다.

버킷 이름은 생성 후 변경할 수 없으므로, 나중에 바꿀 필요가 없을 명확한 이름을 선택하세요. 앱에 이미 버킷이 10개 있다면 Create Bucket 은 더 이상 사용할 수 없습니다.

파일 업로드 및 정리

버킷 안에서는 파일을 직접 업로드하거나 먼저 파일을 업로드하지 않고 빈 폴더를 만들 수 있습니다.

새 폴더 만들기

1. 새 폴더를 만들려는 bucket 또는 folder 를 엽니다.
2. Add Folder 를 선택합니다.
3. 폴더 이름을 입력한 다음 Create 를 선택합니다. 폴더 이름에는 문자, 숫자, 점 (.), 하이픈 (-), 밑줄 (_)을 사용할 수 있으며, 최대 100 characters 까지 가능합니다. 폴더 이름은 생성 후 변경할 수 없습니다.

폴더 이름을 입력한 다음 Create를 선택합니다.

파일 업로드

1. 파일을 저장하려는 bucket 또는 folder 를 엽니다.
2. Upload 를 선택한 다음 기기에서 하나 이상의 파일을 선택합니다. 각 파일은 최대 100 MB 까지 가능합니다.
3. 업로드가 완료될 때까지 기다린 다음 파일이 목록에 표시되는지 확인합니다.

파일 목록에는 각 항목의 Name, Type, Size, Last Modified 날짜와 사용할 수 있는 Actions 가 표시됩니다. 현재 폴더의 내용을 다시 불러와야 한다면 refresh 버튼을 선택하세요.

선택한 버킷 또는 폴더에 파일을 업로드합니다.

파일 미리보기 및 관리

파일을 선택하면 File Details 가 열립니다. 지원되는 이미지와 동영상은 패널에서 미리볼 수 있습니다. 다른 파일 형식은 사용 가능한 세부 정보가 표시되며 여전히 다운로드할 수 있습니다. 모든 크레딧을 사용한 경우 File Details 에는 크레딧 소진 상태가 표시되며, 단일 파일 Download 는 다운로드 대신 업그레이드 로 이동합니다.

파일 하나 관리하기

파일의 Actions 열에서 ... 를 연 다음 다음 중 하나를 선택하세요:

• 크레딧을 사용할 수 있을 때 로컬 사본을 저장하려면 Download 를 선택합니다. 모든 크레딧을 사용한 경우 이 작업은 대신 업그레이드 로 이동합니다.
• 파일 이름을 변경하려면 Rename 을 선택합니다. 새 이름에는 문자, 숫자, 점, 하이픈, 밑줄을 사용할 수 있습니다.
• 확인 후 파일을 제거하려면 Delete 를 선택합니다.

파일의 작업 메뉴를 사용해 다운로드, 이름 변경 또는 삭제합니다.

여러 파일 관리하기

1. 각 파일 옆의 체크박스를 선택합니다. 폴더는 일괄 선택에 포함되지 않습니다.
2. 선택한 파일을 함께 다운로드하려면 Download 를 선택하거나, Delete 를 선택합니다.
3. 삭제하는 경우 선택한 파일 수를 검토한 다음 Delete 를 확인합니다.

삭제는 App 스토리지에서 되돌릴 수 없습니다. 파일 이름을 변경하거나 파일을 삭제하기 전에 앱이 여전히 해당 object key를 사용하는지 확인하세요. 이후 저장된 참조를 업데이트하여 앱이 이전 키를 계속 요청하지 않도록 하세요.

앱에서 저장된 파일 사용하기

앱은 각 저장된 파일을 bucket name 과 object key 를 사용해 식별합니다. object key는 파일이 버킷 내부의 어디에 있는지를 보여줍니다. 예를 들어 images/profile/avatar.png 는 images/profile 폴더 안에 저장된 이미지의 object key일 수 있습니다.

앱이 나중에 파일을 찾을 수 있도록 앱의 데이터베이스에 bucket name과 object key를 저장하세요. 앱이 파일을 표시하거나 다운로드해야 할 때 이러한 정보를 사용해 접근 URL을 요청할 수 있습니다.

접근 URL은 일시적일 수 있습니다. 이를 영구적인 앱 데이터로 저장하거나, 앱에 하드코딩하거나, Chat, 스크린샷, 로그 또는 지원 메시지에서 공유하지 마세요. 대신 object key를 저장하고 파일에 접근해야 할 때 새 접근 URL을 요청하세요.

API 키, 비밀번호 또는 기타 자격 증명을 App 스토리지에 저장하지 마세요. 비공개 런타임 자격 증명은 키 및 비밀 정보에 저장하세요. 그곳에서는 워크스페이스 소유자만 비공개 런타임 자격 증명을 관리할 수 있습니다. Editor라면 워크스페이스 소유자에게 자격 증명을 추가하거나 업데이트해 달라고 요청하세요.

현재 제한

제한	현재 값
앱당 버킷 수	10
업로드된 각 파일의 크기	100 MB

현재 Cloud 사용량 및 용량 정보는 Cloud & AI Wallet을 참조하세요.

FAQ

디스크 공간이 가득 찼습니다. 스토리지를 어떻게 확보하나요?

1. 현재 스토리지 사용량을 확인하고 가장 큰 채팅, 프로젝트 또는 파일을 식별합니다.
2. 나중에 필요할 수 있는 항목은 다운로드하거나 백업합니다.
3. 더 이상 필요하지 않은 항목만 삭제합니다. 채팅을 삭제할 때 연결된 디스크 데이터를 제거하는 옵션이 표시되면, 해당 데이터를 삭제해도 되는지 확인한 후에만 선택하세요.
4. 필요 없는 큰 파일을 제거한 다음 새로고침하고 사용 가능한 공간을 다시 확인합니다.

삭제는 영구적일 수 있으며 제거된 파일을 참조하는 프로젝트에 영향을 줄 수 있습니다. 정리 후에도 사용량이 줄어들지 않으면 스토리지 스크린샷, 사용 중인 플랜, 영향을 받는 계정 또는 워크스페이스와 함께 Support에 문의하세요. 승인된 채널을 통해 요청받지 않은 한 파일 내용은 보내지 마세요.