正确的配置对于运行 Blocklet Server 实例以及使用 Blocklet CLI 与其和其他服务进行交互至关重要。本指南重点介绍作为开发者用于连接到 Blocklet Stores 和管理开发环境的本地 CLI 设置。这些设置使用 blocklet config 命令进行管理。
有关服务器主配置文件 config.yml 的详细信息,请参阅初始化服务器文档。
使用 blocklet config 管理 CLI 设置
blocklet config 命令集允许你查看、设置和移除存储在本地 INI 文件中的配置值。这对于设置与 Blocklet Store 的连接以便部署和上传 blocklet 特别有用。
查看当前配置
要查看所有当前配置设置,你可以不带任何参数运行 blocklet config,或使用 list 子命令。
列出配置
blocklet config list这将输出当前配置文件的所有键值对。
输出示例:
输出示例
store="https://store.blocklet.dev/"
developerDid="z123..."
name="John Doe"
email="john.doe@example.com"设置配置值
使用 set 子命令添加或更新配置键。
设置配置
blocklet config set <key> <value>示例:
设置商店 URL
blocklet config set store https://store.blocklet.dev获取特定值
如果你只需要检索单个键的值,请使用 get 子命令。
获取配置
blocklet config get <key>示例:
获取商店 URL
blocklet config get store移除配置值
要从配置中删除一个键,请使用 unset、del 或 delete。
取消设置配置
blocklet config unset <key>示例:
取消设置开发者邮箱
blocklet config unset email可用配置键
可以通过 blocklet config 命令管理以下键:
| 键 | 描述 |
|---|---|
store | 用于上传或部署 blocklet 的 Blocklet Store 的基础 URL。必须是有效的 HTTPS 或 HTTP URL。 |
registry | store 的别名。 |
accessToken | 用于向 Blocklet Store 验证 CLI 的密钥。通常通过运行 blocklet connect 获得。 |
developerDid | 你作为开发者的唯一去中心化标识符(DID)。 |
name | 与你的 DID 关联的开发者名称。 |
email | 与你的 DID 关联的开发者邮箱。 |
使用配置文件
配置文件允许你管理多组独立的配置。这对于在不同环境(例如开发商店和生产商店)之间切换非常有用。默认情况下,所有配置都保存到 default 配置文件中。
要使用特定的配置文件,请将 --profile <profile-name> 标志添加到任何 blocklet config 命令中。
示例:为 '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 命令,该命令会处理身份验证流程并为你保存必要的凭据。