실행 중인 앱에서 사용하는 이미지, 동영상, 문서, 사용자 업로드 파일을 포함한 파일을 저장, 정리 및 관리하려면 App 스토리지를 사용하세요.

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

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

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

주요 용어

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

Public 또는 Private 선택하기

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

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

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

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

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

App 스토리지의 권한

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

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

bucket 만들기

앱에는 최대 10개의 bucket을 둘 수 있습니다. 서로 다른 파일 그룹에 서로 다른 접근 설정이 필요하거나 더 쉽게 정리할 수 있도록 분리해 두어야 하는 경우 별도의 bucket을 만드세요.

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

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

App 스토리지에서 Create Bucket을 선택하세요.

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

파일 업로드 및 정리

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

새 폴더 만들기

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

폴더 이름을 지정한 다음 Create를 선택하세요.

파일 업로드

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

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

선택한 bucket 또는 folder에 파일을 업로드하세요.

파일 미리보기 및 관리

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

파일 하나 관리하기

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

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

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

여러 파일 관리하기

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

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

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

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

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

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

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

현재 제한

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

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

FAQ

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

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

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