無論是執行 Blocklet Server 實例,還是使用 Blocklet CLI 與其及其他服務互動,正確的設定都至關重要。本指南著重於您作為開發者將用來連接 Blocklet 商店和管理開發環境的本地 CLI 設定。這些設定使用 blocklet config 指令進行管理。
關於伺服器的主要設定檔 config.yml 的詳細資訊,請參閱 初始化伺服器 文件。
使用 blocklet config 管理 CLI 設定
blocklet config 指令集讓您可以檢視、設定和移除儲存在本地 INI 檔案中的設定值。這對於設定與 Blocklet 商店的連線,以便部署和上傳 blocklet 特別有用。
檢視目前設定
若要查看您目前所有的設定,您可以執行不帶任何參數的 blocklet config,或使用 list 子指令。
list configuration
blocklet config list這將輸出目前設定檔的所有鍵值對。
輸出範例:
Example Output
store="https://store.blocklet.dev/"
developerDid="z123..."
name="John Doe"
email="john.doe@example.com"設定一個設定值
使用 set 子指令來新增或更新一個設定鍵。
set configuration
blocklet config set <key> <value>範例:
Set store URL
blocklet config set store https://store.blocklet.dev取得特定值
如果您只需要擷取單一鍵的值,請使用 get 子指令。
get configuration
blocklet config get <key>範例:
Get store URL
blocklet config get store移除一個設定值
若要從您的設定中刪除一個鍵,請使用 unset、del 或 delete。
unset configuration
blocklet config unset <key>範例:
Unset developer email
blocklet config unset email可用的設定鍵
以下鍵可以透過 blocklet config 指令進行管理:
| Key | Description |
|---|---|
store | 您想要互動以上傳或部署 blocklet 的 Blocklet 商店的基礎 URL。必須是有效的 HTTPS 或 HTTP URL。 |
registry | store 的別名。 |
accessToken | 用於向 Blocklet 商店驗證您的 CLI 的密鑰。您通常透過執行 blocklet connect 來取得此金鑰。 |
developerDid | 您作為開發者的唯一去中心化識別碼 (DID)。 |
name | 與您的 DID 關聯的開發者名稱。 |
email | 與您的 DID 關聯的開發者電子郵件。 |
使用設定檔
設定檔讓您可以管理多個獨立的設定組合。這對於在不同環境之間切換非常有用,例如開發商店和生產商店。預設情況下,所有設定都儲存到 default 設定檔中。
若要使用特定的設定檔,請在任何 blocklet config 指令中加入 --profile <profile-name> 旗標。
範例:為 'staging' 設定檔設定一個值
blocklet config set store https://staging.store.example.com --profile staging範例:列出 'staging' 設定檔的值
blocklet config list --profile staging設定檔位置
CLI 設定儲存在一個 INI 格式的檔案中。CLI 會從目前目錄開始,向上層目錄搜尋 .abtnode/conf/config.ini 檔案。
您可以透過設定 ABT_NODE_CONFIG_FILE 環境變數來覆寫此行為並指定確切的檔案路徑。
雖然您可以手動管理這些設定,但建議設定與商店連線的方式是使用 blocklet connect 指令,它會處理驗證流程並為您儲存必要的憑證。