README

这是什么？

该存储库包含用于安装和配置管理第三方软件组件的文件。

它包含配置、脚本和附加文件，以配置和管理已安装的组件。

该单体存储库在创建安装程序时检索。

这使得我们能够

• 将软件资源的配置包含到离线安装程序中，以开箱即用进行配置，
• 包含管理已安装软件的CLI任务，
• 包含Web界面支持，允许基于Web的组件管理和维护。

单体仓库到多仓库：https://github.com/wpnxm-software

每个软件资源文件夹都是一个Composer文件夹。

我们使用git subtree split策略将软件资源文件夹拆分到单向只读子树拆分仓库中。

这使得在安装后可以更新软件资源的配置和管理脚本。

您可以在以下位置找到单独的包：https://github.com/wpnxm-software

结构

每个文件夹包含以下顶级文件和文件夹

• a readme.md,
• a manifest.json 配置文件，
• a composer.json 文件，
• 文件夹 files、configs、tasks 和 webinterface。

示例布局：Nginx - https://github.com/WPN-XM/software/tree/master/nginx

  nginx/
    files/
    configs/
    tasks/
    webinterface/
    composer.json
    manifest.json
    readme.md

manifest.json 参考

manifest.json 文件是一个包含包元数据的JSON文件。它用于在WPN-XM服务器堆栈的上下文中识别软件资源。始终在包中包含清单。

以下键被使用

• name - 软件的好听名字
• website - 官方网站URL
• description - 软件描述
• category - （可选）软件类别
• tags - （可选）一个或多个标签
• logo - （可选）到files文件夹中logo的链接
• tasks - 使用任务键来跟踪任务脚本的实现进度
  • install、uninstall、update、configure、unconfigure、backup、restore、version。

这是https://github.com/WPN-XM/software/blob/master/nginx/manifest.json的内容

{
    "name": "Nginx",
    "website": "http:\/\/nginx.org\/",
    "description": "NGINX is a free, open-source, high-performance HTTP server, reverse proxy, and IMAP\/POP3 proxy server.",
    "category": "webserver",
    "tags": [
        "webserver",
        "reverse-proxy",
        "proxy"
    ],
    "logo": "",
    "tasks": {
        "install": "todo",
        "uninstall": "todo",
        "update": "todo",
        "configure": "todo",
        "unconfigure: "todo",
        "backup": "todo",
        "restore": "todo",
        "version": "todo"
    }
}