From f29f0431a70ac21d36df4ff56cbd4c0fb4441b7e Mon Sep 17 00:00:00 2001 From: chendelin1982 <27513732@qq.com> Date: Thu, 1 Feb 2024 10:24:19 +0000 Subject: [PATCH] apps --- docs/apps/_include/activemq.md | 6 +- docs/apps/_include/akeneo.md | 0 docs/apps/_include/meta-zh.jinja2 | 6 +- docs/apps/_template/README.md | 1 + docs/apps/_template/template.md | 36 ++++++++++ docs/apps/activemq.md | 27 ++------ docs/apps/activemq/_category_.yml | 5 -- docs/apps/activemq/admin.md | 60 ----------------- docs/apps/activemq/readme.md | 92 -------------------------- docs/apps/activemq/solution.md | 13 ---- docs/apps/akeneo.md | 59 +++++++++++++++++ docs/apps/akeneo/_category_.yml | 5 -- docs/apps/akeneo/admin.md | 38 ----------- docs/apps/akeneo/readme.md | 106 ------------------------------ docs/apps/akeneo/solution.md | 13 ---- 15 files changed, 108 insertions(+), 359 deletions(-) create mode 100644 docs/apps/_include/akeneo.md create mode 100644 docs/apps/_template/README.md create mode 100644 docs/apps/_template/template.md delete mode 100644 docs/apps/activemq/_category_.yml delete mode 100644 docs/apps/activemq/admin.md delete mode 100644 docs/apps/activemq/readme.md delete mode 100644 docs/apps/activemq/solution.md create mode 100644 docs/apps/akeneo.md delete mode 100644 docs/apps/akeneo/_category_.yml delete mode 100644 docs/apps/akeneo/admin.md delete mode 100644 docs/apps/akeneo/readme.md delete mode 100644 docs/apps/akeneo/solution.md diff --git a/docs/apps/_include/activemq.md b/docs/apps/_include/activemq.md index c4dce75f..c78ff42b 100644 --- a/docs/apps/_include/activemq.md +++ b/docs/apps/_include/activemq.md @@ -3,4 +3,8 @@ ![](https://libs.websoft9.com/Websoft9/DocsPicture/zh/activemq/activemq-logined-websoft9.png) -部署 Websoft9 提供的 ActiveMQ 之后，请参考下面的步骤快速入门。 \ No newline at end of file +部署 Websoft9 提供的 ActiveMQ 之后，请参考下面的步骤快速入门。 + +## ActiveMQ 初始化 + +Websoft9 控制台安装 ActiveMQ 后，通过【我的应用】进入它的编辑窗口，在**访问**标签页中获取登录地址和账号。 \ No newline at end of file diff --git a/docs/apps/_include/akeneo.md b/docs/apps/_include/akeneo.md new file mode 100644 index 00000000..e69de29b diff --git a/docs/apps/_include/meta-zh.jinja2 b/docs/apps/_include/meta-zh.jinja2 index d74fe851..f568bbf8 100644 --- a/docs/apps/_include/meta-zh.jinja2 +++ b/docs/apps/_include/meta-zh.jinja2 @@ -12,8 +12,4 @@ - 应用是基于 Websoft9 安装的 - 应用的用途符合 [{{license}}](license_url) 开源许可协议 -- 应用具备访问条件：[配置域名](./guide/appsetdomain) 或 **服务器安全组**开启网外端口 - -## {{trademark}} 初始化 - -Websoft9 控制台安装 {{trademark}} 后，通过【我的应用】进入它的编辑窗口，在**访问**标签页中获取登录地址和账号。 \ No newline at end of file +- 应用具备访问条件：[配置域名](./guide/appsetdomain) 或 **服务器安全组**开启网外端口 \ No newline at end of file diff --git a/docs/apps/_template/README.md b/docs/apps/_template/README.md new file mode 100644 index 00000000..e7e46e3a --- /dev/null +++ b/docs/apps/_template/README.md @@ -0,0 +1 @@ +# App docs template \ No newline at end of file diff --git a/docs/apps/_template/template.md b/docs/apps/_template/template.md new file mode 100644 index 00000000..aa5d2436 --- /dev/null +++ b/docs/apps/_template/template.md @@ -0,0 +1,36 @@ +--- +title: Appname +slug: /appname +tags: + - 产品主数据 + - pim + - 电商 +--- + +import Meta from './_include/appname.md'; + + + +## 入门指南 + +### Appname 初始化 + +Websoft9 控制台安装 Appname 后，通过【我的应用】进入它的编辑窗口，在**访问**标签页中获取登录地址和账号。 + +### 标题1？ + +### 标题2？{#502} + +## 管理维护 + +### 备份与恢复 + +### 升级 + +### 数据导入导出 + +## 故障 + +#### 标题1？ + +#### 标题2？{#502} \ No newline at end of file diff --git a/docs/apps/activemq.md b/docs/apps/activemq.md index 1ca55a10..62744012 100644 --- a/docs/apps/activemq.md +++ b/docs/apps/activemq.md @@ -1,7 +1,6 @@ --- title: ActiveMQ -slug: /activemq2 -sidebar_exclude: true +slug: /activemq tags: - ActiveMQ - IT 架构 @@ -12,11 +11,7 @@ import Meta from './_include/activemq.md'; -## ActiveMQ 初始化 - -Websoft9 控制台安装 ActiveMQ 后，通过【我的应用】进入它的编辑窗口，在**访问**标签页中获取登录地址和账号。 - -## ActiveMQ 指南 +## 入门指南 阅读官方文档 [Using Apache ActiveMQ](https://activemq.apache.org/using-activemq) 并结合下面的指南快速掌握它的使用。 @@ -54,13 +49,13 @@ ActiveMQ 附带了许多 Web 演示，这些演示说明了如何将 ActiveMQ 官方方案：http://activemq.apache.org/configuration.html -## ActiveMQ 管理 +## 管理维护 ### 修改控制台密码 进入 ActiveMQ 容器，通过 */opt/apache-activemq/conf/jetty-realm.properties* 文件修改，重启 [ActiveMQ 服务](#service)后生效 -### ActiveMQ 升级 +### 升级 ActiveMQ 主要采用二级制安装方式，其升级方案差不多等于安装： @@ -92,7 +87,7 @@ systemctl stop activemq ``` -## ActiveMQ 故障 +## 故障 #### ActiveMQ 服务无法启动？ @@ -126,14 +121,4 @@ docker exec -it activemq bash chown -R activemq.activemq /opt/activemq find /opt/activemq -type d -exec chmod 750 {} \; find /opt/activemq -type f -exec chmod 640 {} \; -``` - -## ActiveMQ 问答 - -#### Active Classic vs ActiveMQ Artemis？ - -ActiveMQ Artemis 是 ActiveMQ 下一代产品，未来将替换 ActiveMQ Classic。 具体参考：[ActiveMQ Classic](https://activemq.apache.org/getting-started), [ActiveMQ Artemis](https://activemq.apache.org/components/artemis/documentation/) - -#### ActiveMQ 中是否包含 Tomcat？ - -ActiveMQ 官方提供的二级制包中包含 Tomcat，但已经集成到 ActiveMQ 服务中。 \ No newline at end of file +``` \ No newline at end of file diff --git a/docs/apps/activemq/_category_.yml b/docs/apps/activemq/_category_.yml deleted file mode 100644 index 01a7c45d..00000000 --- a/docs/apps/activemq/_category_.yml +++ /dev/null @@ -1,5 +0,0 @@ -position: 1 -label: "ActiveMQ" -collapsible: true -collapsed: true -className: "red" \ No newline at end of file diff --git a/docs/apps/activemq/admin.md b/docs/apps/activemq/admin.md deleted file mode 100644 index b63999a0..00000000 --- a/docs/apps/activemq/admin.md +++ /dev/null @@ -1,60 +0,0 @@ ---- -sidebar_position: 3 -slug: /activemq/admin -tags: - - ActiveMQ - - IT 架构 - - 中间件 ---- - -# 维护指南 - -本章提供的是本应用自身特殊等维护与配置。而**配置域名、HTTPS设置、数据迁移、应用集成、Web Server 配置、Docker 配置、修改数据库连接、服务器上安装更多应用、操作系统升级、快照备份**等操作通用操作请参考：[管理员指南](../administrator) 和 [安装后配置](../install/setup) 相关章节。 - -## 场景 - -### ActiveMQ 升级 - -ActiveMQ 主要采用二级制安装方式，其升级方案差不多等于安装： - -1. 进入容器，依次运行如下的命令做好准备： - ``` - docker exec -it activemq bash - # stop ActiveMQ service - systemctl stop activemq - - # rename the dir of ActiveMQ for backup - mv /opt/activemq /opt/activemqBK - ``` -2. 访问 ActiveMQ 官方网站，[下载](http://activemq.apache.org/components/classic/download/)后解压并上传到：*/opt* 目录，并命名为 *activemq* -3. 分别运行下面的修改权限 - ``` - chown -R activemq. /opt/activemq - chmod 640 /opt/activemq/examples/stomp/php/* - chmod +x /opt/activemq/bin/activemq - ``` -4. 重启 [ActiveMQ服务](../activemq#service) 后升级完成 - -## 故障排除 - -除以下列出的 ActiveMQ 故障问题之外， [通用故障处理](../troubleshoot) 专题章节提供了更多的故障方案。 - -#### ActiveMQ 服务无法启动？ - -1. 以调试模式运行`activemq console`，便可以查看启动状态和错误 - ``` - docker exec -it activemq bash - /opt/activemq/bin/activemq - ``` -2. 打开日志文件：*/opt/activemq/data/activemq.log*，检索 **failed** 关键词，分析错误原因 - -3. 常见的无法启动ActiveMQ服务的原因有如下几点： - - * 主机名不符合要求。例如：activemq5.6，这种包含"."的主机名就会导致ActiveMQ无法重启。参考如下命令重置主机名 - ``` - hostnamectl set-hostname activemq - ``` - * 缺乏Java的环境变量。通过：`echo $JAVA_HOME` 或 `which java` 查看反馈信息。 - -## 常见问题 - diff --git a/docs/apps/activemq/readme.md b/docs/apps/activemq/readme.md deleted file mode 100644 index 7f0ef590..00000000 --- a/docs/apps/activemq/readme.md +++ /dev/null @@ -1,92 +0,0 @@ ---- -sidebar_position: 1 -slug: /activemq -tags: - - ActiveMQ - - IT 架构 - - 中间件 ---- - -# 快速入门 - -[Apache ActiveMQ](https://activemq.apache.org) 是老牌的开源消息总线，完全支持 JMS1.1 和 J2EE 1.4 规范，它支持多种语言和协议编写客户端。 - -![](https://libs.websoft9.com/Websoft9/DocsPicture/zh/activemq/activemq-logined-websoft9.png) - - -部署 Websoft9 提供的 ActiveMQ 之后，请参考下面的步骤快速入门。 - -## 准备 - -1. 在云控制台获取您的 **服务器公网IP地址** -2. 在云控制台安全组中，确保 **Inbound（入）规则** 下的 **TCP:8161** 端口已经开启 -3. 在服务器中查看 ActiveMQ 的 **[默认账号和密码](./user/credentials)** -4. 若想用域名访问 ActiveMQ，务必先完成 **[域名五步设置](./administrator/domain_step)** 过程 - - -## ActiveMQ 初始化向导 - - - -1. 使用本地电脑浏览器访问网址：*http://域名:8161* 或 *http://服务器公网IP:8161*, 进入初始化页面 - ![ActiveMQ初始化页面](http://libs.websoft9.com/Websoft9/DocsPicture/zh/activemq/activemq-login-websoft9.png) - -2. 点击【Manage ActiveMQ broker】登录 ActiveMQ 控制台 （[不知道账号密码？](./user/credentials)） - ![ActiveMQ控制台](http://libs.websoft9.com/Websoft9/DocsPicture/zh/activemq/activemq-logined-websoft9.png) - - -## ActiveMQ 使用入门 - -### 访问 - -### - -[Using Apache ActiveMQ](https://activemq.apache.org/using-activemq) - -## ActiveMQ 常用操作 - - - -## 参数 - -ActiveMQ 应用中包含 Docker 等组件，可通过 **[通用参数表](./administrator/parameter)** 查看路径、服务、端口等参数。 - -通过运行 `docker ps`，查看 ActiveMQ 运行时所有的服务组件： - -```bash -CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES -abeaf50ef7ec alfresco/alfresco-activemq:5.18.2-jre17-rockylinux8 "/bin/sh -c './init.…" 37 minutes ago Up 37 minutes 0.0.0.0:5672->5672/tcp, :::5672->5672/tcp, 0.0.0.0:8161->8161/tcp, :::8161->8161/tcp, 0.0.0.0:61613->61613/tcp, :::61613->61613/tcp, 0.0.0.0:61616->61616/tcp, :::61616->61616/tcp activemq -``` - -### 路径{#path} - -ActiveMQ 安装目录： */data/apps/activemq* -ActiveMQ 配置目录： */data/apps/activemq/data* - -### 端口{#port} - -| 端口号 | 用途 | 必要性 | -| ------ | --------------------------------------------- | ------ | -| 8161 | HTTP 访问 ActiveMQ Web 界面 | 可选 | -| 5672 | amqp | 可选 | - - -### 版本{#version} - -```shell -sudo docker exec -it activemq find /opt/activemq -name activemq-all* | cut -d- -f3 -``` - -### 服务{#service} - -```shell -sudo docker start | stop | restart activemq -``` - -### 命令行{#cmd} - -暂无 - -### API - -[ActiveMQ API](https://activemq.apache.org/maven/apidocs/index.html) diff --git a/docs/apps/activemq/solution.md b/docs/apps/activemq/solution.md deleted file mode 100644 index c855ed81..00000000 --- a/docs/apps/activemq/solution.md +++ /dev/null @@ -1,13 +0,0 @@ ---- -sidebar_position: 2 -slug: /activemq/solution -tags: - - ActiveMQ - - IT 架构 - - 中间件 ---- - -# 场景方案 - -ActiveMQ 可以与其他的软件平台**集成**一起使用，解决 微服务架构 过程中的各种场景问题。 - diff --git a/docs/apps/akeneo.md b/docs/apps/akeneo.md new file mode 100644 index 00000000..864bd7de --- /dev/null +++ b/docs/apps/akeneo.md @@ -0,0 +1,59 @@ +--- +title: Akeneo +slug: /akeneo +tags: + - 产品主数据 + - pim + - 电商 +--- + +import Meta from './_include/akeneo.md'; + + + +## 入门指南 + +### 连接 App Store {#Appstore} + +Akeneo 通过 App Store 通过扩展应用。连接到 App Store 需要2个步骤： + +1. 给用户授权管理App Store。依次点击：System - Users - Roles - Administrator - Permissions - System - Manager apps / Open apps + ![](https://libs.websoft9.com/Websoft9/DocsPicture/zh/akeneo/akeneo-appmanager-websoft9.png) + +2. 配置 AKENEO_PIM_URL ：修改 /data/apps/akeneo/data/akeneo/.env.local 文件，将 AKENEO_PIM_URL 值修改成服务器 IP 或域名，比如 AKENEO_PIM_URL=http://100.100.100.100 + +### 设置多语言{#setlan} + +Akeneo 完美支持多语言，下面以中文作为范例： + +1. 设置登陆页面为中文：点击 System - Configuration 进行设置 + ![](https://libs.websoft9.com/Websoft9/DocsPicture/zh/akeneo/akeneo-setlanguage01-websoft9.png) + +2. 设置后台页面为中文：点击右上角个人头像进行设置 + ![](https://libs.websoft9.com/Websoft9/DocsPicture/zh/akeneo/akeneo-setlanguage02-websoft9.png) + +## 管理维护 + +### 备份与恢复 + +参考：[Akeneo 备份管理](https://docs.akeneo.com/6.0/technical_architecture/technical_information/operation_processes.html#backup-management) + +### 升级 + +参考：[Akeneo 升级](https://docs.akeneo.com/6.0/migrate_pim/upgrade_major_version.html#upgrade-from-5-0-to-6-0) + +### 数据导入导出 + +参阅官方文档： [Import and Export data](https://docs.akeneo.com/6.0/import_and_export_data/index.html) + +## 故障 + +#### 更改域名导致无法访问 Akeneo ？ + +#### 访问 Akeneo 出现 502 错误？{#502} + +## 问答 + +## 参数 + +暂无特殊需要说明的参数 \ No newline at end of file diff --git a/docs/apps/akeneo/_category_.yml b/docs/apps/akeneo/_category_.yml deleted file mode 100644 index 797941e3..00000000 --- a/docs/apps/akeneo/_category_.yml +++ /dev/null @@ -1,5 +0,0 @@ -position: 100 -label: "Akeneo" -collapsible: true -collapsed: true -className: "red" diff --git a/docs/apps/akeneo/admin.md b/docs/apps/akeneo/admin.md deleted file mode 100644 index dfa9bd41..00000000 --- a/docs/apps/akeneo/admin.md +++ /dev/null @@ -1,38 +0,0 @@ ---- -sidebar_position: 3 -slug: /akeneo/admin -tags: - - 故障 - - 路径 ---- - - -# 维护指南 - -本章提供的是本应用自身特殊等维护与配置。而**配置域名、HTTPS设置、数据迁移、应用集成、Web Server 配置、Docker 配置、修改数据库连接、服务器上安装更多应用、操作系统升级、快照备份**等操作通用操作请参考：[管理员指南](../administrator) 和 [安装后配置](../install/setup) 相关章节。 - -## 场景 - -### Akeneo 备份与恢复 - -详细请参照[Akeneo 备份管理](https://docs.akeneo.com/6.0/technical_architecture/technical_information/operation_processes.html#backup-management) - -### Akeneo 升级 - -详细请参照[Akeneo 升级](https://docs.akeneo.com/6.0/migrate_pim/upgrade_major_version.html#upgrade-from-5-0-to-6-0) - -## 故障排除{#troubleshoot} - -除以下列出的 Akeneo 故障问题之外， [通用故障处理](../troubleshoot) 专题章节提供了更多的故障方案。 - -#### 更改域名导致无法访问 Akeneo ？ - -#### 访问 Akeneo 出现 502 错误？{#502} - - -## 问题解答{#faq} - -#### Akeneo 支持多语言吗？ - -支持多语言（包含中文），通过控制台即可修改语言 - diff --git a/docs/apps/akeneo/readme.md b/docs/apps/akeneo/readme.md deleted file mode 100644 index be3ded77..00000000 --- a/docs/apps/akeneo/readme.md +++ /dev/null @@ -1,106 +0,0 @@ ---- -sidebar_position: 100 -slug: /akeneo -tags: - - Akeneo ---- - -# 快速入门 - -[Akeneo](https://www.akeneo.com/) 是一个开源的产品体验管理 (PXM) 和产品信息管理 (PIM) 软件产品。可帮助商家和品牌在所有销售渠道中提供引人入胜的客户体验、提高产品数据质量并简化产品目录管理。使用 Akeneo 作为产品基础设施管理，能够转变业务模式，消减产品浓缩成本。 - -![](https://libs.websoft9.com/Websoft9/DocsPicture/zh/akeneo/akeneo-main-websoft9.png) - -部署 Websoft9 提供的 Akeneo 之后，请参考下面的步骤快速入门。 - -## 准备{#prepare} - -1. 在云控制台获取您的 **服务器公网IP地址** -2. 在云控制台安全组中，确保 **Inbound（入）规则** 下的 **TCP:80** 端口已经开启 -3. 在服务器中查看 Akeneo 的 **[默认账号和密码](./user/credentials)** -4. 若想用域名访问 Akeneo，务必先完成 **[域名五步设置](./administrator/domain_step)** 过程 - -## Akeneo 初始化向导{#wizard} - -### 详细步骤 - -1. 使用本地电脑浏览器访问网址：*http://域名* 或 *http://服务器公网IP*, 进入初始化页面 - ![](https://libs.websoft9.com/Websoft9/DocsPicture/zh/akeneo/akeneo-login-websoft9.png) - -2. 输入用户名和密码([不知道密码?](./user/credentials)) ，登陆 Akeneo 开始产品管理 - ![](https://libs.websoft9.com/Websoft9/DocsPicture/zh/akeneo/akeneo-product-websoft9.png) - -### 碰到问题？ - -若碰到问题，请第一时刻联系 **[技术支持](./helpdesk)**。也可以先参考下面列出的问题定位或 **[FAQ](./faq#setup)** 尝试快速解决问题。 - -## Akeneo 使用入门{#quickstart} - -下面以 **Akeneo 数据导入导出** 作为一个任务，帮助用户快速入门： - -详细请参照[Akeneo 数据导入导出](https://docs.akeneo.com/6.0/import_and_export_data/index.html) - -## Akeneo 常用操作{#guide} - -### 连接 App Store {#Appstore} -Akeneo 通过 App Store 通过扩展应用。连接到 App Store 需要2个步骤： -1. 给用户授权管理App Store。依次点击：System - Users - Roles - Administrator - Permissions - System - Manager apps / Open apps - ![](https://libs.websoft9.com/Websoft9/DocsPicture/zh/akeneo/akeneo-appmanager-websoft9.png) -2. 配置 AKENEO_PIM_URL ：修改 /data/apps/akeneo/data/akeneo/.env.local 文件，将 AKENEO_PIM_URL 值修改成服务器 IP 或域名，比如 AKENEO_PIM_URL=http://100.100.100.100 - -### 设置中文{#setlan} -Akeneo 完美支持中文，可以通过如下操作进行设置中文： -1. 设置登陆页面为中文：点击 System - Configuration 进行设置 - ![](https://libs.websoft9.com/Websoft9/DocsPicture/zh/akeneo/akeneo-setlanguage01-websoft9.png) - -2. 设置后台页面为中文：点击右上角个人头像进行设置 - ![](https://libs.websoft9.com/Websoft9/DocsPicture/zh/akeneo/akeneo-setlanguage02-websoft9.png) - -## 参数{#parameter} - -Akeneo 应用中包含 Docker, Portainer 等组件，可通过 **[通用参数表](./administrator/parameter)** 查看路径、服务、端口等参数。 - -通过运行 `docker ps`，查看 Akeneo 运行时所有的服务组件： - -```bash -CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES -7d46c77c8bc7 phpmyadmin:latest "/docker-entrypoint.…" 6 minutes ago Up 6 minutes 0.0.0.0:9090->80/tcp, :::9090->80/tcp phpmyadmin -db9a7668dad3 websoft9dev/akeneo:latest "/entrypoint.sh /usr…" 7 minutes ago Up 6 minutes 0.0.0.0:9001->80/tcp, :::9001->80/tcp akeneo -6ecce79ee4c1 mysql:8.0 "docker-entrypoint.s…" 7 minutes ago Up 6 minutes 0.0.0.0:3306->3306/tcp, :::3306->3306/tcp, 33060/tcp akeneo-mysql -8ea176b3bf04 docker.elastic.co/elasticsearch/elasticsearch-oss:7.10.1 "/tini -- /usr/local…" 7 minutes ago Up 6 minutes 0.0.0.0:9200->9200/tcp, :::9200->9200/tcp, 9300/tcp akeneo-elasticsearch -``` - -### 路径{#path} - -Akeneo 安装目录： */data/apps/akeneo* -Akeneo 配置文件： */data/apps/akeneo/000-default.conf* -Akeneo 站点目录： */data/apps/akeneo/data/akeneo* - -### 端口{#port} - -除 80, 443 等常见端口需开启之外，以下端口可能会用到： - -暂无特殊端口 - -### 版本{#version} - -``` -docker exec -i akeneo grep "pim-community-dev/tree" /var/www/html/composer.lock |awk -F"/v" '{print $2}' -``` - -### 服务{#service} - -```shell -sudo docker start | stop | restart | stats akeneo -sudo docker start | stop | restart | stats akeneo-elasticsearch -sudo docker start | stop | restart | stats akeneo-mysql -``` - -### 命令行{#cli} - -暂无 - -### API{#api} - -Akeneo 采用 [REST API](https://api.akeneo.com/documentation/introduction.html) 规范。 - diff --git a/docs/apps/akeneo/solution.md b/docs/apps/akeneo/solution.md deleted file mode 100644 index 38c65b57..00000000 --- a/docs/apps/akeneo/solution.md +++ /dev/null @@ -1,13 +0,0 @@ ---- -sidebar_position: 2 -slug: /akeneo/solution -tags: - - 集成 - - 场景 ---- - -# 场景方案 - -Akeneo 可以与其他的软件平台**集成**一起使用，适用于各种业务场景。 - -