Mise 中文文档

外观

系统文件和目录 ​

[bootstrap.files] 和 [bootstrap.directories] 以声明方式管理可能需要 root 权限的绝对路径。它们与管理用户主目录中文件的 [dotfiles] 相互独立。

toml
[bootstrap.directories."/opt/example"]
owner = "root"
group = "root"
mode = "0755"

[bootstrap.files."/etc/example.conf"]
source = "./files/example.conf"
owner = "root"
group = "root"
mode = "0644"

文件内容可以来自 source 或内联的 content。相对 source 路径相对于声明它们的配置文件进行解析。已存在的文件必须声明且只能声明一个内容来源。目标必须是绝对路径，mise 拒绝管理 / 本身。

目录创建使用 mkdir -p 语义，因此会自动创建缺失的父目录。配置的所有权和模式应用于声明的目录；隐式创建的父目录使用操作系统默认值。当父目录需要特定的所有权或权限时，请单独声明它。

默认情况下，节点类型错误的目标会被报告为 unknown，apply 会拒绝销毁它。为该文件或目录设置 replace = true，即可替换冲突的类型。将目录替换为文件时，只会删除空目录；递归销毁仍需要显式声明一个包含 recursive = true 的 state = "absent" 目录。

设置 template = true，即可使用 mise 的模板引擎渲染文件内容。这样做是显式的，因此字面量 {{ ... }} 内容默认会保持不变。模板可以使用已声明的 bootstrap secret input，其形式为 {{ secret(name="logical_name") }}。机密值永远不会包含在计划、试运行描述、状态输出或特权辅助程序输出中。

Mise 会在应用更改前比较内容、类型、模式、所有者和组。写入操作会先在目标目录中使用临时文件，然后执行原子重命名。首先会尝试以当前用户身份进行更改。如果文件系统因权限错误拒绝某项操作，mise 会重试该操作，并将剩余的有序更改放入同一个特权批处理中。这样，用户可写的目标不需要 sudo。如果当前用户无法检查目标或无法搜索其父目录之一，mise 会在一个特权批处理中比较其元数据和内容。计划和文件内容会通过 stdin 发送给权限范围严格受限的 mise 辅助程序，因此文件内容不会出现在进程参数或日志中。

移除资源 ​

移除始终是显式的：

toml
[bootstrap.files."/etc/obsolete.conf"]
state = "absent"

[bootstrap.directories."/opt/obsolete"]
state = "absent"

目录在移除前必须为空。递归删除目录需要额外设置 recursive = true，并会在计划中显示为破坏性操作。

从配置中移除声明不会移除其目标。

命令 ​

sh
mise bootstrap files status
mise bootstrap files status --json
mise bootstrap files apply --dry-run
mise bootstrap files apply --yes

文件和目录发生更改后，可能会通知已配置的 [bootstrap.services]：

toml
[bootstrap.files."/etc/example/config.toml"]
content = "enabled = true"
notify = ["example"]

在所有受管理的文件完成收敛后，完整的 mise bootstrap 流程会应用通知。专用的 mise bootstrap files apply 命令也会在文件更改成功后运行处理程序。mise bootstrap services apply 仅收敛生命周期状态，并且绝不会在产生因果关系的文件更改之前触发处理程序。

mise bootstrap plan 会包含这些资源，并自动将受管理的文件排列在其受管理的父目录之后。移除操作会反转这一依赖关系，因此会先移除子项，再移除其父项。

mise bootstrap plan、mise bootstrap status 和 mise bootstrap files status 的 JSON 输出包含受管理文件和目录的 origin 对象。该对象会标识声明配置、该配置的 config_root、由其文件名编码的任何配置环境，以及文件使用 source 时解析后的源路径。路径有效 UTF-8 时会作为普通字符串输出。在 Unix 上，包含非 UTF-8 字节的路径会使用 mise:path-bytes:<base64url>，从而确保来源信息无损。