跳到主要内容

配置

正确的配置对于运行 Blocklet Server 实例以及使用 Blocklet CLI 与其和其他服务进行交互至关重要。本指南重点介绍作为开发者用于连接到 Blocklet Stores 和管理开发环境的本地 CLI 设置。这些设置使用 blocklet config 命令进行管理。

有关服务器主配置文件 config.yml 的详细信息,请参阅初始化服务器文档。

使用 blocklet config 管理 CLI 设置

blocklet config 命令集允许你查看、设置和移除存储在本地 INI 文件中的配置值。这对于设置与 Blocklet Store 的连接以便部署和上传 blocklet 特别有用。

查看当前配置

要查看所有当前配置设置,你可以不带任何参数运行 blocklet config,或使用 list 子命令。

列出配置

bash
blocklet config list

这将输出当前配置文件的所有键值对。

输出示例:

输出示例

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

设置配置值

使用 set 子命令添加或更新配置键。

设置配置

bash
blocklet config set <key> <value>

示例:

设置商店 URL

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

获取特定值

如果你只需要检索单个键的值,请使用 get 子命令。

获取配置

bash
blocklet config get <key>

示例:

获取商店 URL

bash
blocklet config get store

移除配置值

要从配置中删除一个键,请使用 unsetdeldelete

取消设置配置

bash
blocklet config unset <key>

示例:

取消设置开发者邮箱

bash
blocklet config unset email

可用配置键

可以通过 blocklet config 命令管理以下键:

描述
store用于上传或部署 blocklet 的 Blocklet Store 的基础 URL。必须是有效的 HTTPS 或 HTTP URL。
registrystore 的别名。
accessToken用于向 Blocklet Store 验证 CLI 的密钥。通常通过运行 blocklet connect 获得。
developerDid你作为开发者的唯一去中心化标识符(DID)。
name与你的 DID 关联的开发者名称。
email与你的 DID 关联的开发者邮箱。

使用配置文件

配置文件允许你管理多组独立的配置。这对于在不同环境(例如开发商店和生产商店)之间切换非常有用。默认情况下,所有配置都保存到 default 配置文件中。

要使用特定的配置文件,请将 --profile <profile-name> 标志添加到任何 blocklet config 命令中。

示例:为 '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 命令,该命令会处理身份验证流程并为你保存必要的凭据。