For the complete documentation index, see llms.txt. This page is also available as Markdown.

方案组织

如何在 VergeOS 中使用存储库和目录组织方案,包括与租户和远程系统共享方案的说明。

本页介绍仓库和目录,它们是用于组织租户和 VM 配方的容器。还包括共享配方的说明。

仓库

什么是仓库?

仓库是配方的站点集合。仓库可以包含多个配方目录。

  • 本地仓库:目录/配方在本地系统上创建和维护。

  • 远程仓库:在另一台 VergeOS 系统上创建和维护的配方目录会被检索到本地系统使用。通过远程仓库共享可避免在多个位置管理相同的配方。

自动安装的仓库

"Marketplace" 主机级系统预装了 Marketplace,这是一个由 VergeOS 提供的特殊远程仓库,包含各种可直接使用的 Linux 和 Windows VM 配方。默认情况下,Marketplace 中的配方目录被设置为 scope="global",这也允许系统的所有租户使用它们。

"本地" 默认情况下,您的新 VergeOS 系统会有一个名为 "本地" 的空本地仓库,可用于创建新的目录/配方。

目录

什么是目录?

目录允许您在仓库内将相关配方分组。例如,一个目录可能包含各种 Windows VM 配方,而另一个目录包含所有基于 Linux 的 VM 配方。管理员可以根据组织需要,以最合适的方式使用目录进行组织。目录可以配置为私有,也可以与您的租户或其他外部 VergeOS 系统共享。

创建新目录

  1. 导航到 仓库 > 列表 从顶部菜单中, 双击该仓库 所在位置。它需要是本地仓库;远程仓库由远程系统维护。(默认的 "本地" 在每个新 VergeOS 系统/租户中创建的仓库通常会被使用。)

  2. 点击 目录 在左侧菜单中,然后点击 新建.

  3. 提供一个具有描述性的 名称 用于该目录。可选地,还可以在描述字段中添加其他管理信息。

  4. 选择一个 发布范围 来定义该目录的可访问性:

    • 私有 - 仅对这个特定的 VergeOS 云可用。

    • 无 - 已禁用,任何地方都不可用

    • 租户 - 对该特定云及其自己的租户可用

    • 全局 - 对该特定系统及其租户和外部 VergeOS 系统可用(需要用户凭据)

共享配方

与您的租户共享目录

  1. 将目录的 发布范围 = ‘租户’ (或 ‘全局’,这也将允许使用正确凭据访问外部系统)。

  2. 切换到租户的 UI 完成剩余步骤。

  3. 导航到 服务提供商 仓库并点击 刷新.

  4. 双击所需目录 以查看其中包含的配方。

  5. 点击 VM 配方 -或- 租户配方 以查看相应列表。

  6. 选择所需的配方。

  7. 点击 下载/更新 在左侧菜单中,将其下载到租户环境中。当配方显示状态为 在线 时,即可使用。

当源端的配方更新时,租户 UI 会显示一条消息,表明有可下载的更新。

将目录共享到远程系统

授予目录访问权限(共享端)

  1. 创建一个 新用户,类型为:API 供远程系统/租户用于身份验证。请记下用户名和密码。

  2. 导航到 目录仪表板 (仓库 > 目录 > 双击目标目录)。

  3. 点击 权限 在左侧菜单中。

  4. 点击 添加用户 在左侧菜单中。

  5. 为新权限设置以下字段:

    • 授权对象:上面创建的 API 用户

    • 权限: 列表和读取

    • 类型: 目录

    • 名称: 正在共享的目录名称

  6. 点击 提交 以保存新权限。

连接到远程目录(接收端):

  1. 导航到 仓库 > + 新建仓库.

  2. 完成 字段 用于新仓库:

    • 名称:一个有助于区分此仓库的描述性名称。

    • 描述:(可选)在此输入的附加信息可有助于未来的管理。

    • 类型:远程

    • URL:托管系统的 IP 或 DNS 条目,例如 https://VergeOS.example.com

    • 用户/密码:使用在主机系统上创建的 API 用户凭据(见上文)。

    • 允许不安全证书:提供此选项是为了适应同一私有网络中的自签名证书;使用没有安全 SSL 的公共 URL 可能存在风险,不推荐。

    • 最大最快层级:允许您指定用于配方磁盘的最佳层级(例如,配方在远程系统上有一个位于第 2 层的磁盘,如果此设置设为第 4 层,下载时该磁盘会移动到第 4 层)。

  3. 点击 提交 以保存新仓库。

  4. 创建后,转到 仓库仪表板 并点击 刷新 以重新加载其中的目录。配方可以下载到本地,然后在创建新的 VM/租户时使用。

当远程系统创建连接到您系统的仓库时,他们将能够访问该 API 用户拥有权限的任何目录。

当源端的配方更新时,远程系统的 UI 会显示一条消息,表明有可下载的更新。

最后更新于

这有帮助吗?