跳到主要內容

設定

無論是執行 Blocklet Server 實例,還是使用 Blocklet CLI 與其及其他服務互動,正確的設定都至關重要。本指南著重於您作為開發者將用來連接 Blocklet 商店和管理開發環境的本地 CLI 設定。這些設定使用 blocklet config 指令進行管理。

關於伺服器的主要設定檔 config.yml 的詳細資訊,請參閱 初始化伺服器 文件。

使用 blocklet config 管理 CLI 設定

blocklet config 指令集讓您可以檢視、設定和移除儲存在本地 INI 檔案中的設定值。這對於設定與 Blocklet 商店的連線,以便部署和上傳 blocklet 特別有用。

檢視目前設定

若要查看您目前所有的設定,您可以執行不帶任何參數的 blocklet config,或使用 list 子指令。

list configuration

bash
blocklet config list

這將輸出目前設定檔的所有鍵值對。

輸出範例:

Example Output

ini
store="https://store.blocklet.dev/"
developerDid="z123..."
name="John Doe"
email="john.doe@example.com"

設定一個設定值

使用 set 子指令來新增或更新一個設定鍵。

set configuration

bash
blocklet config set <key> <value>

範例:

Set store URL

bash
blocklet config set store https://store.blocklet.dev

取得特定值

如果您只需要擷取單一鍵的值,請使用 get 子指令。

get configuration

bash
blocklet config get <key>

範例:

Get store URL

bash
blocklet config get store

移除一個設定值

若要從您的設定中刪除一個鍵,請使用 unsetdeldelete

unset configuration

bash
blocklet config unset <key>

範例:

Unset developer email

bash
blocklet config unset email

可用的設定鍵

以下鍵可以透過 blocklet config 指令進行管理:

KeyDescription
store您想要互動以上傳或部署 blocklet 的 Blocklet 商店的基礎 URL。必須是有效的 HTTPS 或 HTTP URL。
registrystore 的別名。
accessToken用於向 Blocklet 商店驗證您的 CLI 的密鑰。您通常透過執行 blocklet connect 來取得此金鑰。
developerDid您作為開發者的唯一去中心化識別碼 (DID)。
name與您的 DID 關聯的開發者名稱。
email與您的 DID 關聯的開發者電子郵件。

使用設定檔

設定檔讓您可以管理多個獨立的設定組合。這對於在不同環境之間切換非常有用,例如開發商店和生產商店。預設情況下,所有設定都儲存到 default 設定檔中。

若要使用特定的設定檔,請在任何 blocklet config 指令中加入 --profile <profile-name> 旗標。

範例:為 'staging' 設定檔設定一個值

bash
blocklet config set store https://staging.store.example.com --profile staging

範例:列出 'staging' 設定檔的值

bash
blocklet config list --profile staging

設定檔位置

CLI 設定儲存在一個 INI 格式的檔案中。CLI 會從目前目錄開始,向上層目錄搜尋 .abtnode/conf/config.ini 檔案。

您可以透過設定 ABT_NODE_CONFIG_FILE 環境變數來覆寫此行為並指定確切的檔案路徑。

雖然您可以手動管理這些設定,但建議設定與商店連線的方式是使用 blocklet connect 指令,它會處理驗證流程並為您儲存必要的憑證。