應用程式模板和混音
可用性
範本 manifest and app-record workflow is implemented。它可以列出操作員策劃的清單,從一個清單建立新的應用程式記錄,在配置環境儲存時播種非秘密環境值,並從符合條件的應用程式建立乾淨的混音記錄。
實例化不會部署應用程式。聲明的資料庫、儲存桶和身份驗證服務不會自動配置。有些聲明的服務本身只是存根,因此清單聲明並不是依賴關係存在的證據。
瀏覽清單
GET /api/apps/templates?category=web&q=next
GET /api/apps/templates/{template_id}畫廊可供公眾閱讀。清單描述了來源 Git URL、分支、執行時間預設值、環境變數架構和聲明的服務。在實例化之前檢查儲存庫、目前版本、許可證、維護狀態和執行時間命令。清單是操作員元數據,而不是安全認可。
兩個內建種子清單使 API 非空。它們的外部存儲庫可能會改變或消失,並且還沒有對每個種子進行自動煙霧測試。
實例化
POST /api/apps/templates/{template_id}/instantiate
Content-Type: application/json
{
"name": "My app",
"env": {
"NEXT_PUBLIC_APP_NAME": "My app"
}
}此呼叫建立私有應用程式記錄並傳回其 app_id、來源資訊、執行時間類型和聲明的服務。僅接受清單聲明的密鑰。此呼叫不會為秘密字段播種。
實例化後:
- 檢查新應用程式的來源和運行時設定; 2.透過應用程式環境變數提供機密;
- 自己提供真正的外部依賴項,除非明確報告服務準備就緒; 4.呼叫部署端點;和
- 透過建置、運行狀況檢查和啟動來追蹤部署。
混音
POST /api/apps/{source_app_id}/remix
Content-Type: application/json
{
"name": "My private remix"
}所有者可以重新組合自己的應用程式。另一個用戶只能重新混合公開且標記為可重新混合的應用程式。新的應用程式是私人的。
混音包含來源 URL、分支、部署類型、連接埠和沿襲。它故意複製環境值、機密、資料庫或儲存桶參考、驗證綁定、檢查點、IDE 狀態或資料。它也不會分叉或固定遠端 Git 儲存庫。如果來源擁有者稍後變更或刪除該儲存庫,則新部署可能會有所不同或失敗。
為了獲得持久的重新混合,請將原始程式碼分叉到您控制的儲存庫中,檢查並固定修訂版本,更新新應用程式的原始程式碼,然後進行部署。
範本的發布清單
在將模板呈現為可用之前:
- 確認儲存庫和許可證;
- 固定或記錄經過測試的修訂版;
- 驗證安裝、建置、運作、移植和運作狀況行為;
- 在不暴露秘密的情況下測試所需的環境欄位;
- 驗證每項聲明的服務實際上可用;和
- 在乾淨的環境中實例化、部署、冒煙測試和刪除它。