앱에서 Supabase 데이터베이스, 인증, 파일 스토리지 또는 백엔드 함수를 사용하려는 경우 Atoms 프로젝트를 Supabase에 연결하세요.

이 가이드는 전체 과정을 안내합니다. Supabase 계정과 프로젝트를 준비하고, 올바른 조직을 승인하고, 프로젝트를 연결하고, 연결이 제대로 작동하는지 확인하고, 필요할 때 연결을 해제하는 방법을 다룹니다.

연결 방식

각 Supabase 프로젝트는 organization에 속하며, 이 organization은 그 안에 있는 프로젝트에 누가 접근하고 관리할 수 있는지를 제어합니다. Supabase를 Atoms에 연결할 때는 먼저 사용하려는 organization에 Atoms가 접근할 수 있도록 승인한 다음, 해당 organization에서 연결할 프로젝트를 선택합니다.

각 Atoms 프로젝트는 한 번에 하나의 Supabase 프로젝트에만 연결될 수 있습니다. 하지만 동일한 Supabase 프로젝트를 둘 이상의 Atoms 프로젝트에 연결할 수는 있습니다.

Supabase와 Atoms 클라우드는 대체 가능한 백엔드 옵션입니다. 둘 다를 동시에 같은 Atoms 프로젝트에 연결할 수는 없습니다.

시작하기 전에

Supabase를 연결하기 전에 다음 사항을 확인하세요.

• 프로젝트가 포함된 Atoms 워크스페이스의 소유자여야 합니다. 워크스페이스 소유자만 Supabase를 승인, 연결 또는 연결 해제할 수 있습니다.
• Supabase 계정이 있거나, 설정 중에 새로 만들 준비가 되어 있어야 합니다.
• Supabase organization을 승인하고 연결하려는 프로젝트에 접근할 권한이 있어야 합니다.
• 에이전트가 현재 작업을 완료했으며 레이스 모드가 꺼져 있어야 합니다.
• 브라우저에서 Atoms의 팝업 창을 허용해야 합니다.
• Atoms 프로젝트가 이미 Atoms 클라우드에 연결되어 있지 않아야 합니다.

이 연결을 처음 시도하는 경우, 과정을 익히는 동안 테스트 프로젝트를 사용하는 것을 권장합니다.

Supabase 비밀번호, API 키, 액세스 토큰 또는 기타 자격 증명을 Chat에 절대 붙여넣지 마세요.

Supabase 연동

Supabase 커넥터 열기

1. 연결하려는 프로젝트를 엽니다.
2. 채팅 패널 오른쪽 상단에서 프로젝트 이름을 클릭합니다.
3. 표시되는 드롭다운 메뉴에서 Connectors 를 선택합니다.
4. 사용 가능한 커넥터 목록에서 Supabase 를 찾은 다음 connect를 클릭합니다.

또는 Settings → Connectors → Supabase 를 열고 Connect를 선택할 수도 있습니다.

Settings → Connectors를 열고 Supabase의 Connect를 선택합니다.

Supabase에서 Atoms 승인

이미 Organizations에 사용하려는 Supabase organization이 표시되어 있다면, 이미 승인이 완료된 상태입니다. Supabase 프로젝트 선택으로 계속 진행할 수 있습니다.

1. Atoms가 Supabase 승인 창을 엽니다. 연결하려는 Supabase 계정으로 로그인하거나, 필요하면 새 계정을 만듭니다.
2. 올바른 Supabase 계정으로 로그인되어 있는지 확인한 다음, Atoms가 접근할 organization을 선택합니다.
3. Atoms가 요청하는 권한을 검토합니다. 모든 권한을 보려면 Show detailed permissions를 선택합니다. 동의하면 Authorize Atoms를 선택합니다.
4. Atoms로 돌아가 Connect success 메시지가 표시될 때까지 기다립니다.
5. Atoms에서 Connectors → Supabase를 열고 organization이 Organizations 아래에 표시되는지 확인합니다.

Atoms는 데이터베이스, Secrets, Auth, Edge Functions, Environment, Projects, PostgREST, Storage에 대한 읽기 및 쓰기 권한을 요청합니다. 또한 Organizations와 Domains에 대한 읽기 권한도 요청합니다. 이러한 권한을 통해 Atoms는 프로젝트에서 사용하는 지원되는 Supabase 서비스를 연결하고 관리할 수 있습니다.

이 승인은 선택한 Supabase organization에 적용되며, 나중에 현재 Atoms 프로젝트에 연결하는 Supabase 프로젝트로 제한되지 않습니다. Atoms는 연결된 Supabase 계정 자체가 접근할 수 없는 organization이나 프로젝트에는 접근할 수 없으며, Supabase 권한에 따라 추가 제한이 적용될 수 있습니다.

Atoms를 승인하기 전에 organization과 권한을 검토합니다.

Supabase 프로젝트 선택

1. Organizations 아래에서 승인한 organization을 펼칩니다.
2. Projects 아래에서 연결하려는 활성 Supabase 프로젝트를 찾습니다.
3. 필요한 organization이 목록에 없다면 New Organization을 선택하고 승인합니다. 이것은 새 Supabase organization을 만드는 것이 아니라, Supabase 계정에 이미 존재하는 다른 organization을 승인할 수 있게 해줍니다.
4. 아직 프로젝트가 없다면 Create Project를 선택하고 Supabase에서 프로젝트를 만듭니다. 프로젝트가 활성화되어 사용할 준비가 될 때까지 기다린 다음, Atoms로 돌아와 Update를 선택해 프로젝트 목록을 새로고침합니다.
5. 사용하려는 프로젝트 옆에서 Connect를 선택합니다.

승인된 organization에서 Supabase 프로젝트를 선택합니다.

프로젝트 확인

1. 확인 창에서 Supabase Project 아래에 표시된 organization과 프로젝트를 확인합니다.
2. 필요하면 Supabase Dashboard 또는 View Tables를 사용해 올바른 프로젝트를 선택했는지 확인합니다.
3. Connect를 선택합니다.
4. Atoms가 프로젝트 Chat에 Supabase 연결 항목을 추가합니다. 페이지를 열린 상태로 유지하고 완료될 때까지 기다린 후, 에이전트에게 데이터베이스, 인증, 스토리지 또는 백엔드 기능을 만들도록 요청하세요.

연결하기 전에 선택한 Supabase 프로젝트를 확인합니다.

연결이 제대로 작동하는지 확인

1. Settings → Connectors → Supabase를 엽니다.
2. 올바른 organization과 Supabase 프로젝트가 연결된 상태로 표시되는지 확인합니다.
3. Dashboard 또는 Tables를 선택하고, Supabase에서 동일한 프로젝트가 열리는지 확인합니다.

연결된 프로젝트 패널에는 Manage Users, SQL Editor, Edge Functions, Manage Secrets 링크가 포함될 수도 있습니다. 만들고 있는 기능과 관련된 영역만 사용하면 됩니다.

연결된 Supabase 프로젝트와 관리 링크를 검토합니다.

앱이 데이터를 저장할 수 있는지 테스트

Supabase를 연결한다고 해서 앱에 데이터베이스 기능이 자동으로 추가되지는 않습니다. Chat에서 에이전트에게 원하는 기능을 만들고, 연결된 Supabase 프로젝트를 사용해 데이터를 저장하도록 요청하세요. 에이전트가 작업을 마친 후에는 전체 흐름을 테스트하세요.

1. Chat에서 원하는 기능, 저장해야 하는 정보, 그리고 사용자가 그 정보를 어디에서 다시 보게 될지를 설명하세요. 에이전트에게 연결된 Supabase 프로젝트를 사용하라고 알려주세요.
2. 에이전트가 기능 구축을 완료할 때까지 기다립니다.
3. App 뷰어에서 사용자가 하듯 기능을 사용하고 무해한 테스트 데이터를 입력합니다. 개인 정보, 기밀 정보 또는 민감한 정보는 사용하지 마세요.
4. App 뷰어를 새로고침하거나 기능을 다시 엽니다. 저장된 정보가 유지되고 올바른 위치에 표시되는지 확인합니다.
5. Settings → Connectors → Supabase를 열고 Tables를 선택한 다음, 일치하는 레코드가 올바른 테이블에 표시되는지 확인합니다.

기능에서 사용자가 저장된 정보를 수정하거나 삭제할 수 있다면, 해당 작업도 테스트하고 앱과 Supabase 모두에서 결과가 올바른지 확인하세요. Supabase에서 직접 변경한 내용이 앱에 즉시 반영되는지는 앱이 어떻게 구축되었는지에 따라 달라집니다.

Supabase 연결 해제

현재 Atoms 프로젝트가 연결된 Supabase 프로젝트를 더 이상 사용하지 않게 하려면 Supabase 연결을 해제하세요.

1. Settings → Connectors → Supabase를 엽니다.
2. 올바른 Atoms 프로젝트의 연결을 보고 있는지 확인합니다.
3. Disconnect Project를 선택합니다.
4. Chat에서 Supabase 연결 해제 항목이 완료될 때까지 기다립니다.
5. Connectors → Supabase를 다시 열고 프로젝트가 더 이상 연결된 상태로 표시되지 않는지 확인합니다.

연결 해제는 현재 Atoms 프로젝트에서의 연결만 제거합니다. Supabase 프로젝트나 그 데이터가 삭제되지는 않으며, Supabase organization에 대한 승인도 제거되지 않습니다.

Atoms 프로젝트에서 Supabase에 의존하는 기능은 연결 해제 후 작동을 멈출 수 있습니다. 앱이 이미 게시된 경우, 변경 사항이 적용되기 전에 게시된 버전을 업데이트해야 할 수 있습니다. 연결 해제 후에는 프로젝트와 라이브 앱을 모두 테스트하세요.

하나의 Atoms 프로젝트에서 Supabase 연결을 해제해도, 같은 Supabase 프로젝트에 연결된 다른 Atoms 프로젝트에는 영향을 주지 않습니다.

FAQ

내 Supabase 연결이 왜 작동을 멈췄나요?

1. Supabase Dashboard를 열고 영향을 받은 프로젝트의 상태를 확인하세요. 활동이 적은 무료 플랜 프로젝트는 7일 기간 후 일시 중지될 수 있습니다.
2. 일시 중지된 경우 Resume project를 선택하고 Supabase가 활성 상태라고 표시할 때까지 기다리세요.
3. Atoms로 돌아가 프로젝트의 Connectors 패널을 열고 Supabase 연결을 확인하세요. 실패한 작업을 한 번 다시 시도하세요.
4. Supabase가 이미 활성 상태라면, 정확한 Atoms 또는 Supabase 오류를 기록하고 연결이 해제됨 또는 만료됨으로 표시되는지 확인하세요. 상태가 필요함을 나타낼 때만 다시 연결하세요.

원인을 파악하고 기존 데이터를 보호하기 전까지는 키를 교체하거나 대체 프로젝트를 만들지 마세요. 문제가 계속되면 Chat Link, 시간 및 시간대, 연결 상태, 민감한 정보를 제거한 오류 스크린샷과 함께 Support에 문의하세요.

외부 참고 자료: Supabase — Project Pausing

일시 중지된 Supabase 프로젝트를 다시 연결하려면 어떻게 하나요?

1. 올바른 Supabase organization에 로그인하고 일시 중지된 프로젝트를 엽니다.
2. Resume project를 선택하고 상태가 활성화될 때까지 기다립니다. 현재 Supabase 안내에 따르면 활동이 적은 무료 플랜 프로젝트는 7일간 활동이 적으면 일시 중지될 수 있습니다.
3. Atoms로 돌아가 프로젝트의 Connectors 패널을 엽니다. Supabase가 연결되어 있는지 확인한 다음, 영향을 받은 작업을 다시 시도합니다.
4. Atoms에서 여전히 커넥터가 연결 해제됨 또는 만료됨으로 표시되면, 다시 연결하고 요청된 승인을 완료하세요.

기존 데이터가 보호되기 전까지는 새 Supabase 프로젝트를 만들거나 자격 증명을 교체하지 마세요. 다시 연결에 실패하면 Chat Link, Supabase 프로젝트 상태, 시간 및 시간대, 민감한 정보를 제거한 오류 스크린샷을 Support에 제공하세요.

외부 참고 자료: Supabase — Project Pausing