搭建 kmpkg 资产缓存
所有资产缓存均通过 X_KMPKG_ASSET_SOURCES 环境变量进行配置。该环境变量的值
遵循特定的配置语法。
在本教程中,你将学习如何:
前提条件
- 终端
- kmpkg
1 - 创建资产缓存目录
kmpkg 提供以下资产缓存提供程序:
x-azurl:设计用于 Azure Blob 存储容器,同时也适用于其他服务提供程序, 甚至本地或网络文件系统。x-script:允许你通过可自定义的脚本或可执行文件添加自定义业务逻辑来处理资产缓存。
本教程使用 x-azurl 作为提供程序,通过 file:// 协议的 URL 将资产存储在文件系统的本地目录中。
信息
你可使用相同步骤搭建基于 Azure Blob 存储的资产缓存。只需将教程中的所有 URL 替换为你的存储 URL, 并提供用于身份验证的 SAS 令牌即可。
- 创建一个目录作为资产缓存位置(可替换为任意你选择的路径):
- cmd
- bash
mkdir Z:\kmpkg\asset-cache
mkdir /home/kmpkg/asset-cache
2 - 配置 X_KMPKG_ASSET_SOURCES
接下来按如下方式设置 X_KMPKG_ASSET_SOURCES 的值:
- powershell
- cmd
- cmd-powershell
- bash
$env:X_KMPKG_ASSET_SOURCES="clear;x-azurl,file:///Z:/kmpkg/asset-cache,,readwrite"
以这种方式设置环境变量仅影响当前终端会话。若要让更改在所有会话中永久生效, 需通过 Windows 系统环境变量面板进行设置。
set "X_KMPKG_ASSET_SOURCES=clear;x-azurl,file:///Z:/kmpkg/asset-cache,,readwrite"
以这种方式设置环境变量仅影响当前终端会话。若要让更改在所有会话中永久生效, 需通过 Windows 系统环境变量面板进行设置。
该 X_KMPKG_ASSET_SOURCES 配置包含以下源字符串:
clear:禁用所有先前配置的资产缓存x-azurl,file:///Z:/kmpkg/asset-cache,,readwrite:设置文件系统资产缓存,路径为Z:\kmpkg\asset-cache,权限为读写。
export X_KMPKG_ASSET_SOURCES="clear;x-azurl,file:///home/kmpkg/asset-cache,,readwrite"
使用
export命令设置环境变量仅影响当前 Shell 会话。若要让更改在所有会话中永久生效, 需将该export命令添加到 Shell 的配置文件中(例如~/.bashrc或~/.zshrc)。
该 X_KMPKG_ASSET_SOURCES 配置包含以下源字符串:
clear:禁用所有先前配置的资产缓存x-azurl,file:///home/kmpkg/asset-cache,,readwrite:设置文件系统资产缓存,路径为/home/kmpkg/asset-cache,权限为读写。
后续步骤
你可尝试以下其他任务: