fix docker

Websoft9 · Apr 19, 2024 · 8d6f359 · 8d6f359
1 parent fa604ae
commit 8d6f359
Show file tree

Hide file tree

Showing 22 changed files with 494 additions and 3,597 deletions.
diff --git a/docs/apps/activemq.md b/docs/apps/activemq.md
@@ -27,9 +27,4 @@ import Meta from './_include/activemq.md';
 
 通过应用的**编排**修改密码
 
-### 升级
-
-ActiveMQ 可以直接通过容器进行升级，当需要根据自身需求是否迁移 */opt/activemq*
-
-
 ## 故障
diff --git a/docs/apps/alfresco.md b/docs/apps/alfresco.md
@@ -24,7 +24,7 @@ Websoft9 控制台安装 Alfresco 后，通过【我的应用】管理应用，
 1. 访问地址打开后， 点击 "Alfresco Repository" > "Alfresco Share"
    ![](https://libs.websoft9.com/Websoft9/DocsPicture/zh/alfresco/alfresco-login-websoft9.png)
 
-2. 输入账号密码（[不知道账号密码？](./user/credentials)），成功登录到 Alfresco 后台  
+2. 输入账号密码，成功登录到 Alfresco 后台  
    ![](https://libs.websoft9.com/Websoft9/DocsPicture/zh/alfresco/alfresco-consolegui-websoft9.png)
 
 3. Alfresco会自动根据浏览器语言来选择程序语言
@@ -42,7 +42,7 @@ Alfresco 后台支持多语言切换（包括中文），支持用户主页（Al
 - 数据存储目录：dir.root
 - 元数据：Alfreco 会自动对上传的文件创建后缀为 metadata.properties.xml 的[元数据文件](https://docs.alfresco.com/content-services/latest/develop/repo-ext-points/metadata-extractors/)
 - 官方文档：[Alfresco Documentation](https://docs.alfresco.com/content-services/community/using/content/) 
-- 官方视频[Alfresco Videos](https://docs.alfresco.com/content-services/latest/tutorial/video/)
+- 官方视频：[Alfresco Videos](https://docs.alfresco.com/content-services/latest/tutorial/video/)
 - [ReST API Guide](https://docs.alfresco.com/content-services/latest/develop/rest-api-guide/)
 
 #### 截图
@@ -75,14 +75,10 @@ Alfresco 后台支持多语言切换（包括中文），支持用户主页（Al
 但是针对 Office 文档，Alfresco 只能[离线编辑或集成 Google Docs](https://docs.alfresco.com/content-services/community/using/content/files-folders/)
 
 
+## 配置选项{#configs}
 
-### 配置 SMTP{#smtp}
-
-1. 在邮箱管理控制台获取 [SMTP](./administrator/smtp) 相关参数
-
-2. 填写 Alfresco 邮件相关配置
-
-3. 测试邮件发送是否可用
+- 多语言（✅）
+- SMTP（✅）
 
 
 ## 管理维护{#administrator}

diff --git a/docs/apps/ansible.md b/docs/apps/ansible.md
@@ -0,0 +1,199 @@
+---
+title: Ansible
+slug: /ansible
+tags:
+  - Ansible
+  - DevOps
+---
+
+import Meta from './_include/ansible.md';
+
+<Meta name="meta" />
+
+
+## 入门指南
+
+### 快速体验
+
+在体验 Ansible 之前需准备好受控端的连接信息（IP,用户和密码），然后再开始测试：
+
+1. Websoft9 控制台安装 Ansible 后，通过【我的应用】管理应用，进入容器的命令模式
+
+2. 运行如下几个测试命令以确认 Ansible 是否正常工作
+   ```
+   # 查看帮助
+   ansible -h
+
+   # 查看系统信息
+   ansible localhost -m setup
+   ```
+
+3. 运行容器中已经存在的 test 范例
+   ```
+   cd test
+
+   # 设置受控端连接信息
+   vim inventory
+
+   # 启动运行命令
+   ansible-playbook -i inventory playbook.yml
+   ```
+
+### 常用命令
+
+ansible-playbook 是最常见的命令，也是运行程序的主要入口。  
+
+实际上，Ansible 也支持在一条命令中运行[Ad-doc](https://docs.ansible.com/ansible/2.9/user_guide/intro_adhoc.html) 使用模块，实现我们的部署目标。  
+
+```
+# 打印本机磁盘信息
+ansible localhost -m command -a 'df -h'
+
+# 获取 facts 信息
+ansible localhost -m setup
+
+# 连通性测试
+ansible all -m ping
+
+# 本机上安装 docker-composer
+ansible localhost -m get_url -a "url=https://getcomposer.org/composer-stable.phar dest=/usr/bin/composer mode=0750"
+```
+
+命令解释：
+
+* localhost/all：主机名/IP/分组
+* -m：指定模块（默认是command，所以可以把-m command这个去掉）
+* command/setup/ping：模块名称
+* -a：模块参数
+* 'df -h'：参数值
+
+### 主机清单
+
+[Ansible Inventory](https://docs.ansible.com/ansible/latest/user_guide/intro_inventory.html#intro-inventory) （主机清单） 就是为了灵活的管理主机信息的技术标准。  
+
+下面先展示一个包含丰富信息的 hosts 文件示例：
+
+```
+[webservers]
+86.21.14.177
+web1.websoft9.com
+we2.websoft9.com
+192.165.2.50
+
+[database]
+86.21.14.172
+host1.websoft9.com
+host2.websoft9.com
+192.165.2.51
+
+[monitor]
+86.21.14.173 ansible_user=root ansible_ssh_pass=123456 proxy=proxy.websoft9.com
+86.21.14.174 ansible_user=root ansible_ssh_private_key_file=/root/mykey
+host1.websoft9.com
+www[01:50].example.com
+
+[monitor:vars]
+proxy=proxy.websoft9.com
+```
+
+主机清单中的变量说明：
+
+| ansible_ssh_host             | 远程主机                             |
+| ---------------------------- | ------------------------------------ |
+| ansible_ssh_port             | 指定原创主机ssh端口                  |
+| ansible_ssh_root             | ssh连接远程主机的用户                |
+| ansible_ssh_pass             | ssh连接远程主机的密码                |
+| ansible_sudo_pass            | sudo密码                             |
+| ansible_connection           | 指定连接类型：local、ssh、paramiko   |
+| ansible_ssh_private_key_file | ssh连接使用的私钥                    |
+| ansible_shell_type           | 指定连接端的shell类型，sh、csh、fish |
+| ansible_python_interpreter   | 指定远程主机使用的python路径         |
+
+
+### 配置文件{#cfg}
+
+Ansible 支持多个位置存放 ansible.cfg 配置文件，包括：
+
+* ./ansible.cfg 当前工作目录下的 ansible.cfg
+* ~/.ansible.cfg 当前用户家目录下的 .ansible.cfg
+* /etc/ansible/ansible.cfg 安装自动产生的 ansible.cfg
+* ANSIBLE_CONFIG 配置文件环境路径的环境变量
+
+如果有多个配置文件怎么办？ Ansible 有优先级原则：环境变量 > 当前工作目录 > 用户家目录 > etc
+
+
+下面是常用的配置项：
+
+| 项                | 说明                                                         | 示例                            |
+| ----------------- | ------------------------------------------------------------ | ------------------------------- |
+| log_path          | 日志文件地址，Ansible 默认不记录日志，需自定义             | log_path = /var/log/ansible.log |
+| inventory         | 资源清单（主机列表）文件位置                                 | inventory = /etc/ansible/hosts  |
+| library           | 模块目录，有默认值                                           | library = /usr/share/ansible    |
+| forks             | 工作进程最大值，默认值为 5                                   | forks = 10                      |
+| sudo_user         | 设置运行 Ansible 程序的默认用户                              | sudo_user = root                |
+| remote_port       | 远程主机的端口，用于连接被管理主机，默认值为 22              | remote_port = 22                |
+| host_key_checking | 是否检查 SSH 主机的秘钥，默认为 True。适用于同一台被管理主机秘钥发生变化的错误提示，如果不希望出现这种提示，可以设置本项为 False | host_key_checking = False       |
+| timeout           | 设置连接远程主机的 SSH 超时时间                              | timeout = 60                    |  
+
+
+## 配置选项
+
+- Ansible 配置文件： */etc/ansible/ansible.cfg*  
+- Ansible 示例目录： */ansible/project* 
+- 版本：`ansible --version`
+- 环境变量：以 ANSIBLE_ 开头的环境变量与 ansible.cfg 有对应关系。例如：export ANSIBLE_SUDO_USER=root
+- Ansible 可视化工具：Red Hat Ansible Automation Platform
+- 命令行:
+   - [ansible](https://docs.ansible.com/ansible/latest/cli/ansible.html)：主命令
+   - [ansible-config](https://docs.ansible.com/ansible/latest/cli/ansible-config.html)：配置文件和配置项修改
+   - [ansible-console](https://docs.ansible.com/ansible/latest/cli/ansible-console.html)：交互式运行 ansible 命令
+   - [ansible-doc](https://docs.ansible.com/ansible/latest/cli/ansible-doc.html)：查询文档
+   - [ansible-galaxy](https://docs.ansible.com/ansible/latest/cli/ansible-galaxy.html)：galaxy 项目库发布与下载
+   - [ansible-inventory](https://docs.ansible.com/ansible/latest/cli/ansible-inventory.html)：主机清单管理
+   - [ansible-playbook](https://docs.ansible.com/ansible/latest/cli/ansible-playbook.html)：运行 playbook 程序
+   - [ansible-pull](https://docs.ansible.com/ansible/latest/cli/ansible-pull.html)：拉取并运行 playbook 程序
+   - [ansible-vault](https://docs.ansible.com/ansible/latest/cli/ansible-vault.html)：加密处理
+
+## 管理维护
+
+## 问题与故障{#troubleshoot}
+
+#### python-urllib3 报错？
+
+python-urllib3 报错大部分情况下，通过 yum install python-urllib3 解决，而不是 pip install
+
+#### 账号准确，仍无法连接受控机？
+
+清空服务器中的 */root/.ssh/known_hosts* 文件
+
+#### Ansible 是否支持动态主机清单？
+
+支持。由于在实际生产场景中，如果清单采用手动维护这些列表将是一个非常繁琐的任务。  
+
+Ansible 支持动态生产主机清单，即 ansible.cfg 指向一个生产主机清单的程序，再由程序产生符合格式的清单列表。
+
+#### Ansible 有没有默认分组？
+
+有。默认有包含文件所有主机的 all 组，同时还有没有归属的 ungrouped 组。
+
+
+#### Ansible 变量优先级有哪些？
+
+有高到低：ansible命令带入的变量 > cfg配置文件的变量 > 主项目的var变量 > role中的var变量 > role default 变量
+
+#### Ansible 有全局变量的概念吗？
+
+没有
+
+
+#### 客户端和服务端 Python 版本一致？
+
+可以
+
+#### Ansible 有哪些内置变量？
+
+Ansible 有三种类型的内置变量：
+
+* 用于 ansible.cfg 配置的[系统变量（环境变量）](https://docs.ansible.com/ansible/latest/reference_appendices/config.html)
+* 用于工作过程的[特殊变量](https://docs.ansible.com/ansible/latest/reference_appendices/special_variables.html)
+* 收集到受控端的 [Facts 变量](https://docs.ansible.com/ansible/latest/user_guide/playbooks_vars_facts.html)
diff --git a/docs/apps/apex.md b/docs/apps/apex.md
@@ -73,6 +73,9 @@ APEX 支持多语言（包含中文），通过控制台即可修改语言。
 3. 点击【App Builder】，新APP已经创建，登陆即可开始体验
    ![](https://libs.websoft9.com/Websoft9/DocsPicture/en/apex/apex-imp06-websoft9.png)
 
+## 配置选项{#configs}
+
+- 多语言（✅）
 
 ## 管理维护{#administrator}
 

diff --git a/docs/apps/autogptnextweb.md b/docs/apps/autogptnextweb.md
@@ -15,9 +15,9 @@ import Meta from './_include/autogptnextweb.md';
 
 ### 初始化{#wizard}
 
-1. Websoft9 控制台安装 AutoGPT.NextWeb 后，通过【我的应用】管理应用，在**访问**标签页中获取登录信息。  
+1. Websoft9 控制台安装 AutoGPT.NextWeb 后，通过【我的应用】管理应用，在**访问**标签页中获取登录信息  
 
-2. 通过 AutoGPT.NextWeb 右侧菜单的 "设置"，设置 OpenAI 的 Key
+2. 通过 AutoGPT.NextWeb 左侧菜单的 "设置"，设置 OpenAI 的 Key
 
 ## 管理维护{#administrator}
 

diff --git a/docs/apps/bitwarden.md b/docs/apps/bitwarden.md
@@ -18,7 +18,7 @@ import Meta from './_include/bitwarden.md';
 
 Websoft9 控制台安装 Bitwarden 后，通过【我的应用】管理应用，在**访问**标签页中获取登录信息。  
 
-1. 确保安装时已填写正确的 ID 和 Key。如果没有，需到 Bitwarden [申请](https://bitwarden.com/host) ，然后通过**应用编排**的方式重建容器。  
+1. 确保安装时已填写正确的 ID 和 Key。如果没有，需到 Bitwarden [申请](https://bitwarden.com/host) ，然后通过**应用编排**的方式重建容器  
 
 2. 将 Bitwarden 应用设置为 HTTPS 访问（必须）
 

diff --git a/docs/apps/chatgptnextweb.md b/docs/apps/chatgptnextweb.md
@@ -19,7 +19,7 @@ import Meta from './_include/chatgptnextweb.md';
 
 Websoft9 控制台安装 ChatGPT Next Web 后，通过【我的应用】管理应用，在**访问**标签页中获取登录信息。  
 
-1. 点击 ChatGPT Next Web 右下角的 **设置** 按钮
+1. 点击 ChatGPT Next Web 左下角的 **设置** 按钮
 
 2. 找到设置项的 **访问密码**，设置从 Websoft9 控制台获得的密码
 
@@ -33,7 +33,7 @@ Azure 提供了优化后的 OpenAPi 服务，ChatGPT Next Web 支持 Azure AI
 
 1. 编辑 ChatGPT Next Web 编排文件 .env
 
-2. 删除 OpenAI 的可以，输入 Azure 相关的信息
+2. 删除 OpenAI 的相关变量，输入 Azure 相关的信息
    ```
    AZURE_URL=
    AZURE_API_KEY=
@@ -45,6 +45,7 @@ Azure 提供了优化后的 OpenAPi 服务，ChatGPT Next Web 支持 Azure AI
 ### 节省成本
 
 - 尽量使用**新的聊天**，减少不必要的连续对话：连续对话会消耗大量算力
+- 设置合适的**附带历史消息数量**：设置太大会消耗大量算力
 - 选用 preview 模型：preview 是官方提供的预览版模型，定价是正式版的1/5
 
 ## 配置选项{#configs}

diff --git a/docs/os/centos.md b/docs/os/centos.md
@@ -1,6 +1,10 @@
 ---
 sidebar_position: 2
 slug: /centos
+tags:
+  - Linux
+  - CentOS
+  - 操作系统
 ---
 
 # CentOS