English日本語

文档 · 1.0

市场

这一章讲 市场 菜单:从 GitHub 下载能装在这台主机上的软件包,或者自己上传一个包,然后部署。

1. 市场是什么

市场里放的是 keelOS 签过名的软件包(.kimg 文件),分两类:

  • 能部署成虚拟机的包:keelNAS(小 NAS)、keelAuth(办公室账号服务器)、keelMGR(管理端)。每个包可以部署一台或几台。
  • 应用模板:kcell 里新建应用用的模板,每个模板一个很小的包。

注意:keelOS 只接受用它自己的钥匙签过名的包。别处下来的包、下载不完整的包都会被拒绝。包存在存储池上,所以没有存储池时页面提示"还没有存储池:包要存到池上,先到存储页建一个",见存储。

打开左边菜单的 市场。

页面上方的卡片有 刷新(重新读 GitHub 上的目录)和 上传一个包(见 §4)。读不到目录时(比如没有网络)会提示"读不到目录",本机已有的包仍然能用。

2. 包卡片:下载和部署

每个包一张卡片,左边是名字、说明,以及 最新 版本(和大小)、本机 已有的版本(点 删除 从这台主机上删掉)。带 测试版 标记的是测试版本。

右边是可做的事:

  • 下载:从 GitHub 下载到这台主机。下载中显示进度和 取消。有新版本时按钮变成 下载新版本,并有 有新版本 标记。
  • 部署:本机有包以后出现(要有主机写权限的账户)。用这个包建一台虚拟机;需要几台就部署几台,卡片上标 已部署 N 台。点 下载 后下载完成时,部署对话框自动打开。
  • 打开:已经部署过以后,跳到对应的菜单页(keelNAS 到 keelNAS 页,keelAuth 到 账号 页)。

有已部署的实例比包新时,卡片上有"N 台可以升级",点它去对应的页面升级。

三种包部署的内容:

包 部署对话框 部署后
keelNAS 部署一台 keelNAS:名字、版本、网络、内存、数据盘大小 见 NAS
keelAuth 部署一台 keelAuth:版本、网络上的地址(固定地址或 DHCP)、名字(DNS);keel 生成第一个管理员,密码只显示一次,请记下 见账号、令牌与权限
keelMGR 建管理端:版本、地址;同样显示一次第一个用户的密码 管理端的页面见 keelMGR 的文档

3. 应用模板

页面下方的 应用模板 一张卡片,每个模板一行:图标、标题、说明、最新 和 本机 的版本。

  • 安装 下载这个模板(几 KB);本机有了以后,有新版本时按钮变成 更新,旁边有 删除。
  • 本机装的模板包只在比当前 keelOS 更新时替换同名的内置模板;删掉包就回到内置的模板。已经用它建好的应用照常运行。
  • 如果一个模板包这个 keelOS 用不了(太新或损坏),行里会写"这个 keelOS 用不了它"和原因。

这些模板在 kcell 的 新建应用 里使用。

4. 上传一个包

没有网络、或者别人给了你一个包时:

  1. 点 上传一个包,选一个 .kimg 文件。
  2. 页面显示"上传中 N%"。传完提示"… 已经在这台主机上",卡片里的 本机 一栏就有它了。
  3. 如果提示"… 是非法的软件包(下载可能不完整)",说明文件不完整,或不是 keelOS 签名的包,重新下载再传。

被拒绝的文件会列在页面下方的 不接受的文件 里,写着原因,可以 删除。

注意:下载和上传需要有 image:write 权限的账户;只读账户只能看。