Appearance
建立第一個 Instance
何時用這份文件 你剛跑起 Argus，要把第一個資料庫納管。
前置條件
- Argus server 已運行（安裝與啟動）
- 你有一個可以用來測試的 Postgres
- 該 Postgres 上有一個 DB user，至少擁有以下權限：
CREATE/CONNECT/USAGE- 待會兒會跑變更的對象 schema 上的 DML/DDL 權限
步驟
1. 建立 Project
左側 sidebar → Projects → New Project。
| 欄位 | 範例值 |
|---|---|
| Name | playground |
| Key | PLAY（縮寫，會出現在 issue 編號前） |
2. 新增 Instance
Settings → Instances → Add Instance。
| 欄位 | 範例值 |
|---|---|
| Engine | PostgreSQL |
| Name | dev-postgres |
| Environment | Dev |
| Host | localhost |
| Port | 5432 |
| Username | postgres（或你建的專用 user） |
| Password | … |
按 Test Connection，看到綠勾再 Create。
3. 把 Database 加進 Project
進入剛建的 instance → Databases 頁 → 找到 playground → Transfer to Project → 選 playground project。
為什麼要 transfer？ Argus 用 project 隔離權限與審批規則。Database 必須屬於某個 project，才能被開 Plan。
驗證
回到 Projects → playground，應該看到 playground 資料庫已在 Databases 清單中。
常見錯誤
| 症狀 | 原因 | 排除方式 |
|---|---|---|
| Test Connection 紅叉 | 網路 / 認證 / pg_hba | 在 Argus server 上 psql 直連看看 |
| 看不到資料庫 | sync 還沒跑 | 等 30 秒或手動 Sync |
| 無法 transfer | 你的角色沒有 bb.database.transfer | 請 workspace admin 補權限 |