diff --git a/i18n/en/docusaurus-plugin-content-docs/current.json b/i18n/en/docusaurus-plugin-content-docs/current.json index 7a4f72bc..b7cb4109 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current.json +++ b/i18n/en/docusaurus-plugin-content-docs/current.json @@ -700,12 +700,12 @@ "description": "The label for category 集成第三方网关 in sidebar docs" }, "sidebar.docs.category.管理数据库": { - "message": "管理数据库", + "message": "Manage database", "description": "The label for category 管理数据库 in sidebar docs" }, "sidebar.docs.category.管理容器": { - "message": "管理容器", - "description": "The label for category 管理容器 in sidebar docs" + "message": "Manage your container", + "description": "The label for category Manage your container in sidebar docs" }, "sidebar.docs.category.管理服务器": { "message": "Manage your server", diff --git a/i18n/en/docusaurus-plugin-content-docs/current/guide/container/README.md b/i18n/en/docusaurus-plugin-content-docs/current/guide/container/README.md index c13ce437..0a980758 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/guide/container/README.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/guide/container/README.md @@ -1,15 +1,15 @@ import DocCardList from '@theme/DocCardList'; import {useCurrentSidebarCategory} from '@docusaurus/theme-common'; -# 使用和管理容器 +# Manage and set container -容器技术是 Websoft9 多应用托管平台的核心基础架构组件。因此,在管理应用时,您可能需要执行容器相关的操作。 +Container technology is the core infrastructure of Websoft9's multi-application hosting platform. -## 相关指南 +## Tutorials -## 容器引擎 +## Container engines - [Docker](https://www.docker.com/) - [Podman](https://podman.io/) \ No newline at end of file diff --git a/i18n/en/docusaurus-plugin-content-docs/current/guide/container/assets/websoft9-container-console.png b/i18n/en/docusaurus-plugin-content-docs/current/guide/container/assets/websoft9-container-console.png new file mode 100644 index 00000000..afe23bf5 Binary files /dev/null and b/i18n/en/docusaurus-plugin-content-docs/current/guide/container/assets/websoft9-container-console.png differ diff --git a/i18n/en/docusaurus-plugin-content-docs/current/guide/container/assets/websoft9-containers.png b/i18n/en/docusaurus-plugin-content-docs/current/guide/container/assets/websoft9-containers.png new file mode 100644 index 00000000..35f08bdd Binary files /dev/null and b/i18n/en/docusaurus-plugin-content-docs/current/guide/container/assets/websoft9-containers.png differ diff --git a/i18n/en/docusaurus-plugin-content-docs/current/guide/container/assets/websoft9-myapps-runcmd-websoft9.png b/i18n/en/docusaurus-plugin-content-docs/current/guide/container/assets/websoft9-myapps-runcmd-websoft9.png index 40a53509..5cb6c638 100644 Binary files a/i18n/en/docusaurus-plugin-content-docs/current/guide/container/assets/websoft9-myapps-runcmd-websoft9.png and b/i18n/en/docusaurus-plugin-content-docs/current/guide/container/assets/websoft9-myapps-runcmd-websoft9.png differ diff --git a/i18n/en/docusaurus-plugin-content-docs/current/guide/container/assets/websoft9-portainer.png b/i18n/en/docusaurus-plugin-content-docs/current/guide/container/assets/websoft9-portainer.png deleted file mode 100644 index e0c0deca..00000000 Binary files a/i18n/en/docusaurus-plugin-content-docs/current/guide/container/assets/websoft9-portainer.png and /dev/null differ diff --git a/i18n/en/docusaurus-plugin-content-docs/current/guide/container/container.md b/i18n/en/docusaurus-plugin-content-docs/current/guide/container/container.md index f50e5989..3fbc02dd 100755 --- a/i18n/en/docusaurus-plugin-content-docs/current/guide/container/container.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/guide/container/container.md @@ -3,29 +3,25 @@ sidebar_position: 6 slug: /container --- -# 容器生命周期与资源管理 +# Manage containers resource -Websoft9 控制台是为管理应用的生命周期的而设计。实际托管中,也需要对容器的生命周期进行管理。 +The applications hosted by Websoft9 is based on containers, so user need to be familiar with container state and resource management. -## 管理工具 +There are several container management tools: -- Docker 官方客户端工具:[docker](https://docs.docker.com/engine/) 命令和 [docker compose](https://docs.docker.com/compose/) 命令 -- 可视化 Web 工具:Websoft9 集成 [Portainer](./portainer) 作为唯一个容器可视化管理平台,100% 保持其原生性。 +- [docker client commands](https://docs.docker.com/engine/) +- [docker compose](https://docs.docker.com/compose/) +- [Websoft9 Containers](./portainer): Integrated Portainer for container mangement platform + ![](./assets/websoft9-containers.png) - Websoft9 控制台的 "网关" 菜单即可进入 Portainer: - ![](./assets/websoft9-portainer.png) +## Running container +Websoft9 is fully Docker-compatible, so users can deploy applications consisting of multiple containers directly using [Docker compose templates](https://github.com/Websoft9/docker-library) without relying on the Websoft9 Console. -## 运行容器 -Websoft9 完全兼容 Docker,所以用户可以不依赖于 Websoft9 控制台而直接使用 Docker 客户端工具部署由多容器组成的应用。 +## Upgrade containers -Websoft9 提供了一个包含 200+ 开源 [Docker compose 模板](https://github.com/Websoft9/docker-library),只需 `docker compose` 命令启动,即可安装任何想要的应用。 - - -## 升级多容器 - -Docker Compose 升级应用只需运行如下三条命令: +You can use Docker Compose to Upgrade containers by below commands ``` docker-compose down @@ -33,12 +29,12 @@ docker-compose pull docker-compose up -d ``` -## 清空容器日志 +## Clear container logs ``` -# 获取容器日志路径 +# Get the logs path in container docker inspect --format='{{.LogPath}}' Container_Name -# 清空日志 +# Clear the logs echo "" > log_path ``` \ No newline at end of file diff --git a/i18n/en/docusaurus-plugin-content-docs/current/guide/container/inner-container.md b/i18n/en/docusaurus-plugin-content-docs/current/guide/container/inner-container.md index e8d90a9b..4fa07658 100755 --- a/i18n/en/docusaurus-plugin-content-docs/current/guide/container/inner-container.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/guide/container/inner-container.md @@ -1,64 +1,83 @@ --- sidebar_position: 1 +title: Run commands in container slug: /inner-container --- -# 在容器内运行命令 +# Run commands in the container -用户需要掌握在容器内运行命令的操作,便于更好的实现个性化的托管设置。 +When managing Docker containers, you may need to connect to a running container. It is very helpful if you want to see what is happening inside the container. You can use the [docker exec](https://docs.docker.com/reference/cli/docker/container/exec/) command, SSH into a running Docker container, or get a shell to the container. -## 原理 +## Concepts -在容器内运行命令之前,先列出几个相关的原理: +Before running commands inside a container, let's list a few related concepts: -- 容器内运行命令与 Linux 虚拟机内运行命令的原理基本一致 -- 容器内运行命令改变的是容器的文件系统 -- 容器内也可以切换用户 -- 容器内改变文件系统后,也需要考虑权限问题 -- 容器内安装或下载的软件包,若没有存放到持久化目录中,重建容器后这些增加的文件会丢失 +- Running commands in containers is similar to host machine. +- Commands in containers alter the container's filesystem. +- You can change the user account within containers. +- Filesystem changes in containers require permission considerations. +- Software installed in non-persistent directories will be lost after redeploy. -## 进入容器{#docker-exec} +## Method of access to containers{#docker-exec} -进入容器后,默认便可以运行 shell 命令。有两种进入容器的方法: +Two methods for you to access container: -### 登录服务器运行命令{#fromserver} +### Access by docker exec commands{#fromserver} -Docker 自身提供了进入了容器的操作指令 [docker exec](https://docs.docker.com/reference/cli/docker/container/exec/) ,具体步骤: +The `docker exec` command runs a new command in a running container at your host machine. -- 确认容器的 shell 命令环境: bash, sh, ash 三者之一,大部分都是 bash -- 服务器端运行 `docker ps` 找到容器名称,然后运行命令 `docker exec -it container_name bash` +``` +# sample1 +docker exec -it container_name bash -### 在线运行命令{#fromweb} +# sample2 +docker exec -it container_name sh -Websoft9 提供了可视化的在线运行容器命令的功能,它是 **docker exec** 的 Web 实现。 +# sample2 +docker exec -it container_name ash -1. Websoft9 控制台进入应用的详情页面,在 "容器" 标签页下点击 `<>` 操作 - ![](./assets/websoft9-myapps-runcmd-websoft9.png) +# sample4 +docker run --name mycontainer -d -i -t alpine /bin/sh +``` + +You should know or try to get the shell environment of your container, it may `bash`, `sh`, or `ash` + +### Access container by Websoft9 Console{#fromweb} -2. 在容器命令行控制台,点击 **Connetc** 按钮,开始连接 +You can access container by Websoft9 Console which is the implementation of **docker exec** command. - - Command:选择可用的命令执行(三选一,bash 绝大部分情况下都可用) - - user: 默认 root(推荐) +1. Login to Websoft9 Console, go to application mangement from **My Apps** + +2. Open the **Containers** tab, click `<>` icon of Actions column + ![](./assets/websoft9-myapps-runcmd-websoft9.png) -3. 成功连接,即可开始运行命令 +3. It will jump to the **Container console** and you can select the items and **Connect** container + ![](./assets/websoft9-container-console.png) + +4. Once connection success, you can run shell command from terminal ![](./assets/websoft9-myapps-runcmdss-websoft9.png) -## 安装软件包 -容器内安装软件与 Linux 安装软件基本一致: +## Commans samples + +### Install packages in the container + +Install packages in the container is the same with host machine: + +- Install by Linux repo tools: `apt`, `yum`, `dnf`, `pacman`, `zypper`, `apk` +- Download and compile +- Install by languages repo tools: `pip`, `npm`, `yarn`, `gem` -- 操作系统包管理器:apt, yum, dnf, pacman, zypper, apk 等 -- 手工下载编译安装 -- 程序语言安装包:pip, npm, yarn, gem 等 +### Check system settings in the container -## 查看容器内配置 +- Process and services: `top`, `ps aux` +- Get users: `cat /etc/passwd` +- Network: `netstat -tulnp`, `ss -tuln` -- 进程与服务:`top`, `ps aux` -- 用户:`cat /etc/passwd` -- 网络:`netstat -tulnp`, `ss -tuln` +## Troubleshoot -## 权限处理 +### Container permission issues? -- 如果 Dockerfile 没有创建普通用户,容器就会默认以 root 用户权限运行。 -- 容器 root 与宿主机 root 是同一个用户,但容器 root 需加上 `--privileged=true` 才拥有宿主机同等权限 -- 容器内可以通过 `su` 切换用户 \ No newline at end of file +- If the dockerfile does not create non-root user, the container will run as root by default. +- Container root equals host root, needs `--privileged=true` for same privileges. +- You can switch users within the container using `su`. \ No newline at end of file diff --git a/i18n/en/docusaurus-plugin-content-docs/current/guide/container/server.md b/i18n/en/docusaurus-plugin-content-docs/current/guide/container/server.md index 33b30bf6..2fddd65d 100755 --- a/i18n/en/docusaurus-plugin-content-docs/current/guide/container/server.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/guide/container/server.md @@ -3,74 +3,75 @@ sidebar_position: 2 slug: /docker-server --- -# 设置 Docker 服务端 +# Set your Docker -本章介绍使用 Websoft9 托管应用过程中,可能需要对 Docker 服务端进行的设置。 +You may need to set your Docker when using Websoft9 for applications hosting. -## 任务指南 +## Tutorials -### 安装 Docker{#install} +### Install Docker{#install} -如果您的服务器尚未安装 Docker,请使用如下命令安装它: +If there not have Docker on your server, please run below command to install it. ``` wget -O - https://websoft9.github.io/websoft9/install/install_docker.sh | bash ``` -### 更换默认镜像仓库{#imagespeed} +### Add your registry-mirrors{#imagespeed} -Docker 默认从 Dockerhub 下载镜像。如果想更换仓库地址,请参考如下步骤: +You will need to set up docker registry-mirrors if the server is having network issues accessing DockerHub. -1. 自行准备新的仓库地址或选择[第三方镜像仓库](./imagehub) +1. Prepare your [registry mirrors](./imagehub) - -2. 向 Docker 配置文件(不存在需新建) */etc/docker/daemon.json* 中插入仓库地址(支持多个) +2. Edit `/etc/docker/daemon.json` and add the **registry-mirrors** key and value, to make the change ``` { "registry-mirrors": ["https://registry.docker-cn.com","http://hub-mirror.c.163.com"] } ``` -3. 重启 Docker 服务后生效 +3. Restart docker service + ``` + sudo systemctl restart docker + ``` -### 更改默认存储卷位置{#changepath} +### Change docker volume path{#changepath} -在Docker中,*/var/lib/docker/volumes* 是默认存储卷的位置。如果你的主分区空间有限,你可能会想要更改这个位置。 +The default docker volume path is */var/lib/docker/volumes*, you can change it by below steps: -1. 停止 Docker 服务 +1. Stop you docker service + ``` + sudo systemctl stop docker + ``` -2. 向 Docker 配置文件(不存在需新建) */etc/docker/daemon.json* 中插入 data-root 属性来指定新的目录 +2. Edit `/etc/docker/daemon.json` and add the **data-root** key and value, to make the change ``` { "data-root": "/new/path/to/docker-data" } ``` -3. 将现有的 Docker 数据移动到新位置 +3. Move the data to new path ``` sudo mv /var/lib/docker /new/path/to/docker-data ``` -4. 重启服务后生效 - -## 相关内容 - -- [Docker 服务端配置参数](./parameter#path) -- [Docker 命令行](./parameter#cmd) -- [开启 Docker API 外部访问](https://docs.docker.com/reference/cli/dockerd/#daemon-socket-option) - -## 参考文档 - -- [Docker 官方文档](https://docs.docker.com/) +4. Restart docker service + ``` + sudo systemctl restart docker + ``` -## 故障{#troubleshoot} +## Related topics -#### docker-containerd.socket: timeout? +- [Docker parameters](./parameter#path) +- [Docker CLI](./parameter#cmd) +- [Enable Docker API](https://docs.docker.com/reference/cli/dockerd/#daemon-socket-option) +- [Docker docs](https://docs.docker.com/) -请关闭 SELinux,如果 SELinux 开启会导致 docker 无法启动。 +## Troubleshoot{#troubleshoot} -#### Windows 中 Docker 无法启动? +### docker-containerd.socket: timeout? -检查您的 Windows 是否安装了 360 之类的安全软件,如果有请卸载它。 +Please turn off SELinux. If SELinux is on, docker will not start. diff --git a/i18n/en/docusaurus-plugin-content-docs/current/guide/database/README.md b/i18n/en/docusaurus-plugin-content-docs/current/guide/database/README.md index 36b0e2b6..6fe2ad8d 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/guide/database/README.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/guide/database/README.md @@ -6,18 +6,18 @@ slug: /database import DocCardList from '@theme/DocCardList'; import {useCurrentSidebarCategory} from '@docusaurus/theme-common'; -# 创建、连接和管理数据库 +# Create, connect and manage databases -Websoft9 托管平台在设计上专注于为用户提供数据库的灵活使用和管理。不论是与应用捆绑启动的数据库,独立运行的数据库服务,还是第三方数据库实例,平台都能够提供一个集中的、[可视化的管理接口](./dbtools)。 +Websoft9 focuses on flexible database usage and management. Whether it's an application's database, standalone database service, or third-party database instance, the platform offers a [Graphical and centralized interface](./dbtools). -这样的设计使得数据库的维护和操作变得简洁而直观,无论数据库的部署形式如何,用户都能从同一平台上获得一致的管理体验。 +This design simplifies and streamlines database maintenance and operations. Regardless of deployment form, users receive a consistent management experience from the same platform. -## 指南 +## Tutorials -## 问题 +## Troubleshoot -#### 应用默认的数据库形式? +#### Where is the application's database? -Websoft9 默认为每个应用捆绑一个包含独立配置的数据库实例,不同应用的数据库是独立运行的,应用间数据互不干扰。 +Websoft9 create independent database container for application which need database. The data between applications do not interfere with each other. diff --git a/i18n/en/docusaurus-plugin-content-docs/current/guide/database/assets/websoft9-appstore-dbmanagelist.png b/i18n/en/docusaurus-plugin-content-docs/current/guide/database/assets/websoft9-appstore-dbmanagelist.png index c5c588ed..2b889f55 100644 Binary files a/i18n/en/docusaurus-plugin-content-docs/current/guide/database/assets/websoft9-appstore-dbmanagelist.png and b/i18n/en/docusaurus-plugin-content-docs/current/guide/database/assets/websoft9-appstore-dbmanagelist.png differ diff --git a/i18n/en/docusaurus-plugin-content-docs/current/guide/database/connectdb.md b/i18n/en/docusaurus-plugin-content-docs/current/guide/database/connectdb.md index 5a969966..1fccaef6 100755 --- a/i18n/en/docusaurus-plugin-content-docs/current/guide/database/connectdb.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/guide/database/connectdb.md @@ -3,7 +3,7 @@ sidebar_position: 2.0 slug: /connectdb --- -# 连接应用的数据库 +# Connect App database Websoft9 提供了两种数据库连接方式:Web 在线连接和本地客户端连接。 diff --git a/i18n/en/docusaurus-plugin-content-docs/current/guide/database/createdb.md b/i18n/en/docusaurus-plugin-content-docs/current/guide/database/createdb.md index b38a765e..9efc5c05 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/guide/database/createdb.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/guide/database/createdb.md @@ -3,41 +3,34 @@ sidebar_position: 1.0 slug: /createdb --- -# 部署数据库服务 +# Deploy database service -Websoft9 平台为您提供了市场上主流数据库系统的广泛选择。内置的部署模板包括了多个版本的 MySQL, MariaDB, PostgreSQL, MongoDB, Redis, SQL Server, Elasticsearch, Oracle Database, Neo4j 等数据库,允许用户一键部署自己的数据库服务。 +The **Websoft9 App Store** provides you with a wide selection of the major database systems. Built-in deployment templates include multiple versions of MySQL, MariaDB, PostgreSQL, MongoDB, Redis, SQL Server, Elasticsearch, Oracle Database, Neo4j and other databases, allowing users to deploy their own database services with a one-click. -## 开始部署 +## Deploy a database -用户通过 Websoft9 应用商店的 "数据库" 类目,即可快速部署数据库服务: - -1. 登录 Websoft9 控制台,进入 "应用商店" 下的 "数据库",列出所支持的数据库 +1. Login to Websoft9 Console, list all databases from **App Store** database catalog ![](./assets/websoft9-dblist.png) -2. 根据需要可以通过二级分类进一步查询 - -3. 选择目标数据库,开始 [部署数据库应用](./deployment#appstore) - - -## 配置参考 +2. Select and [Install](./deployment#appstore) one database you want to use -在 Websoft9 应用商店中启动的数据库服务,遵循一套默认配置标准,以确保安全性和易用性。 +## Configuration options -以下是这些数据库服务默认配置的关键属性及其说明: +In the Websoft9 App Store, database services follow default configurations for security and usability. -- **运行模式**:数据库实例采用容器化技术运行,保证了环境的一致性和可移植性。 -- **数据持久化**:通过命名卷(Named Volume)实现数据持久化,确保数据的持久存储和独立管理。 -- **外部连接**:数据库默认已映射到宿主机端口,仅需在安全组中开放相应端口,即可实现外网访问。 -- **配置管理**:数据库配置可通过容器环境变量或挂载的配置文件进行调整和管理。 +- **Running Mode**: Databases run in containers, ensuring consistency and portability. +- **Data Persistence**: Named volumes ensure persistent and independent data storage. +- **External Access**: Databases map to host ports; open ports in security groups for external access. +- **Config Management**: Adjust configurations via container environment variables or mounted config files. -若需进一步自定义数据库配置,可参照数据库应用启动后对应的[Git仓库](./plan-git#manage)进行操作。 +For further customization and redeploy, refer to the [Git repository](./plan-git#manage). -## 默认账号对照表{#table} +## Fleet{#table} -基于 Websoft9 部署的数据库,其默认系统账号、端口与管理工具对应表,供您参考: +Default system accounts, ports, and management tools for Websoft9-deployed databases for your reference: -| 数据库 | 管理员 | 端口 | Web 版管理工具 | +| Database | administrator | port | Web-based tools | | --------------- | -------- | ----- | ----------------------- | | MySQL | root | 3306 | phpMyadmin, CloudBeaver | | MariaDB | root | 3306 | phpMyadmin, CloudBeaver | @@ -48,8 +41,8 @@ Websoft9 平台为您提供了市场上主流数据库系统的广泛选择。 | Redis | 空 | 6379 | RedisInsight | -## 相关操作 +## Related topics -- [部署数据库管理工具](./dbtools) -- [连接并管理数据库](./connectdb) +- [Deploy database tools](./dbtools) +- [Connect and manage database](./connectdb) diff --git a/i18n/en/docusaurus-plugin-content-docs/current/guide/database/dbtools.md b/i18n/en/docusaurus-plugin-content-docs/current/guide/database/dbtools.md index 0c8fae95..483cb7fd 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/guide/database/dbtools.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/guide/database/dbtools.md @@ -3,23 +3,23 @@ sidebar_position: 1.1 slug: /dbtools --- -# 部署数据库管理工具 +# Deploy database tools -Websoft9 平台提供了丰富的**在线数据库工具**,支持导入导出、备份、SQL查询、可视化操作、用户管理、访问控制以及数据库审计等常用功能,确保用户能选用最适合的管理解决方案。 +Websoft9 platform provides a wealth of **Online database management tools** that support common functions such as import/export, backup, SQL query, visualization, user management, access control and database auditing, ensuring that users can choose the most suitable management solution. -## 开始部署 +## Deploy datbase tools -1. 登录 Websoft9 控制台,打开应用商店功能 +1. Login to Websoft9 Console, and enter to **App Store** -2. 进入 "数据库" > "管理与迁移" 子类目 +2. List **Databases > Database Management Tools** catalog ![](./assets/websoft9-appstore-dbmanagelist.png) -3. 选择目标数据库工具,开始 [部署应用](./deployment#appstore) +2. Select and [Install](./deployment#appstore) one database tool you want to use -## 相关操作 +## Related topics -- [部署数据库服务](./createdb) -- [连接并管理数据库](./connectdb) -- [接入外部数据库实例](./externaldb) +- [Deploy database service](./createdb) +- [Connect and manage database](./connectdb) +- [Integrate external database instances](./externaldb) diff --git a/i18n/en/docusaurus-plugin-content-docs/current/guide/database/externaldb.md b/i18n/en/docusaurus-plugin-content-docs/current/guide/database/externaldb.md index d851127d..792f7fa2 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/guide/database/externaldb.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/guide/database/externaldb.md @@ -3,7 +3,7 @@ sidebar_position: 1.1 slug: /externaldb --- -# 接入外部数据库到平台 +# Integrate external database 接入外部数据库到平台是指将不在 Websoft9 平台直接控制下的数据库实例连接到该平台,以便集中管理和操作。 diff --git a/i18n/en/docusaurus-plugin-content-docs/current/guide/database/replacedb.md b/i18n/en/docusaurus-plugin-content-docs/current/guide/database/replacedb.md index 1dabf019..1c64b1f2 100755 --- a/i18n/en/docusaurus-plugin-content-docs/current/guide/database/replacedb.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/guide/database/replacedb.md @@ -3,7 +3,7 @@ sidebar_position: 2.1 slug: /migratedb --- -# 更换应用的数据库 +# Replace App database Websoft9 托管平台支持用户根据个人偏好或企业IT标准将应用的默认数据库更换(迁移)为外部数据库。此功能确保了用户能够根据自己的需求选择合适的数据库产品。 diff --git a/i18n/en/docusaurus-plugin-content-docs/current/guide/server/os/assets/linux-remoteip-websoft9.png b/i18n/en/docusaurus-plugin-content-docs/current/guide/server/os/assets/linux-remoteip-websoft9.png old mode 100755 new mode 100644 index 20e15647..dc1eecb7 Binary files a/i18n/en/docusaurus-plugin-content-docs/current/guide/server/os/assets/linux-remoteip-websoft9.png and b/i18n/en/docusaurus-plugin-content-docs/current/guide/server/os/assets/linux-remoteip-websoft9.png differ diff --git a/i18n/en/docusaurus-plugin-content-docs/current/guide/server/os/linux.md b/i18n/en/docusaurus-plugin-content-docs/current/guide/server/os/linux.md index 2272face..8dbf3657 100755 --- a/i18n/en/docusaurus-plugin-content-docs/current/guide/server/os/linux.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/guide/server/os/linux.md @@ -8,304 +8,145 @@ import TabItem from '@theme/TabItem'; # Linux -Websoft9 为企业用户提供个性化的 Linux 系统托管技术支持服务,满足用户 DevOps 以及应用托管的特殊需求场景。 +Websoft9 provides enterprise users with Linux system hosting support services to meet the special needs of DevOps and application hosting. -## 系统支持 +Linux Desktop image powered by Websoft9 on Cloud platform provides an secure, reliable and flexible virtual workspace for enterprise users, helping companies improve work efficiency, ensure data security and reduce operational costs. -目前支持个性化的操作系统包括: -- 纯净版的操作系统,例如:Oracle Linux, Rocky Linux, CentOS7.x -- 含桌面的操作系统,例如:Oracle Linux with Gnome -- 含软件包的操作系统,例如:Ubuntu with Docker, Ubuntu with AI 大模型 +## Supported Linux images -### Oracle Linux -[Oracle Linux](https://www.oracle.com/linux/) 是一个完全免费、开源并可以自由分发的 Linux 发行版。它与其他免费 Linux 相比,有几个特别之处: +You can use supported images powered by Websoft9 with technical service at major cloud provider. -1. 更兼容 Oracle 的其他产品线,例如:[Why Oracle Database Runs Best on Oracle Linux](https://www.oracle.com/a/ocom/docs/linux/oracle-database-runs-best-on-oracle-linux.pdf) +- **Linux server distributions**, like [Oracle Linux](https://www.oracle.com/linux/), Rocky Linux, CentOS7.x +- **Linux with Desktop**, like Gnome, KDE, Mate -2. 修复补丁后无需重启(零停机) + + + ![Gnome Desktop](./assets/linux-desktop-gnome-websoft9.jpg) + + + ![kde Desktop](./assets/linux-desktop-kde-websoft9.jpg) + + + ![mate Desktop](./assets/linux-desktop-mate-websoft9.png) + + + ![Gnome Desktop](./assets/linux-desktop-xfce-websoft9.png) + + -3. Oracle Linux 官方提供了比较完善的配套支持: - * [Oracle Linux 认证应用程序](https://apexapps.oracle.com/pls/apex/f?p=10263:17::::::) - * [Oracle Linux 硬件兼容商](https://linux.oracle.com/ords/f?p=117:1) - * [Oracle Linux CVE](https://linux.oracle.com/ords/f?p=130:21:) - * [Oracle Linux 升级包](https://linux.oracle.com/ords/f?p=105:21:117077190823888:pg_R_1213672130548773998:NO&pg_min_row=1&pg_max_rows=50&pg_rows_fetched=50) - * [Oracle Linux 勘误表](https://oss.oracle.com/mailman/listinfo/el-errata) +- **Linux with common packages**, like Docker, AI, machine learning -4. Oracle 官方提供了可选的[技术支持订阅](https://shop.oracle.com/apex/f?p=dstore:2:0::NO:RIR,RP,2:PROD_HIER_ID:4510272175861805728468) -5. Oracle 在云上提供了一个 Oracle Autonomous Linux 系统,具备自主更新升级的能力(零停机) +## Remote Desktop for Linux{#desktop} -6. Oracle Linux 内核 [Unbreakable Enterprise Kernel](https://github.com/oracle/linux-uek),兼容 RHCK +This paragraph details how to configure a desktop environment and remote desktop (**[XRDP](https://cloudzy.com/rdp-vs-vnc-remote-desktop-comparison/)**) for your Linux VM. -7. Oracle Linux 在一个维护周期内会发布多个安全漏洞和 Bug 补丁,更可靠的**升级流程** - 1. 订阅 Oracle 官方的[补丁通知邮件](https://www.oracle.com/cn/security-alerts/):注册免费 Oracle 账号 > 用户控制面板 > 订阅管理 > Oracle 安全通知 - 2. 选择一种升级方案: - - 普通升级方案:[Linux 标准的软件包升级方案](https://docs.oracle.com/en/operating-systems/oracle-linux/software-management/sfw-mgmt-UpdateSoftwareonOracleLinux.html#update-software) - - 不停机升级方案:Oracle 官方提供的升级工具[Ksplice](https://ksplice.oracle.com/try/trial) +### Prepare +Before connecting to the desktop, you need to know the parameters associated with it -### CentOS7.x - -CentOS7.x 是一个已经官方停止支持的操作系统发行版,Websoft9 当前为它继续提供支持。 - -## 桌面支持{#desktop} - -Websoft9 在云平台上提供的 Linux 桌面,为企业用户提供了一个高效、安全、可靠且灵活的虚拟工作空间,助力企业提升工作效率,确保数据安全,降低运营成本。 - -无论是日常办公、软件开发还是数据分析,Websoft9 的 Linux 云桌面解决方案都能满足企业的多样化需求。 - - - - ![Gnome Desktop](./assets/linux-desktop-gnome-websoft9.jpg) - - - ![kde Desktop](./assets/linux-desktop-kde-websoft9.jpg) - - - ![mate Desktop](./assets/linux-desktop-mate-websoft9.png) - - - ![Gnome Desktop](./assets/linux-desktop-xfce-websoft9.png) - - - -### 准备 - -使用桌面之前,需要准备如下事项: - -* 创建可登陆的用户:必须使用 `adduser` 创建 - -* 开启服务器安全组端口 - - XRDP 连接端口: 3389 - - VNC 连接端口:5901 - -* SSH 登录到服务器,设置 VNC 密码(仅适用 VNC 连接需要) - ``` - vncpasswd - systemctl restart vnc - ``` -* 与桌面有关的服务 - +- XRDP server port: 3389 +- systemd service ``` # For RDP sudo systemctl start | stop | restart | status xrdp # For Gnome sudo systemctl start | stop | restart | status gdm - - # For VNC - sudo systemctl start | stop | restart | status vncserver ``` -* 默认的 VNC 服务器: [TigerVNC](https://github.com/TigerVNC/tigervnc) - -### 连接桌面 - -连接 Linux 桌面主要有两种方式:XRDP 和 VNC 模式,推荐使用 [XRDP](https://cloudzy.com/rdp-vs-vnc-remote-desktop-comparison/) +- Set a local user account password + ``` + sudo passwd your_user + ``` -| | 速度 | 实现原理 | 多用户 | 平台 | 安全协议 | -| ------- | ---- | ------------ | ---------------- | ------------------------------ | ---------- | -| **RDP** | 效率高,速度快 | 计算资源共享,本地渲染 | 继承操作系统用户 | Linux, Windows, macOS, Android | SSL/TLS | -| **VNC** | 效率底,速度慢 | 屏幕共享 ,服务端渲染 | 没有用户 | Linux, Windows, macOS | SSH tunnel | +### Connect Desktop by XRDP - -#### XRDP 连接(推荐) - -本地电脑如果是 Windows 系统,那么可以使用系统自带的远程桌面客户端去连接 Linux 桌面: - -1. 打开 开始菜单,输入”mstsc“ ,系统会搜索远程桌面连接工具 - -2. 输入 **服务器公网IP** ,点击【连接】 +1. Open your local remote desktop client and connect to the IP addressof your Linux. ![image.png](./assets/linux-remoteip-websoft9.png) - - > 确保云控制台中服务器安全组 3389 端口是开启状态 - -3. 如果出现下面的提示,点击【是】继续 - ![image.png](./assets/linux-remotereminder-websoft9.png) - -4. XRDP 对话框中,输入服务器 root 账号和密码 - ![enter image description here](./assets/gnome-login-websoft9.png) - - > 建议采用普通用户登录 Linux 桌面,而不是 root 用户。请参照下面命令创建普通用户: - ``` - sudo su - adduser xxxuser # 根据提示完成密码设置 - ``` -5. 成功登录后,就可以看到 Linux 桌面 +2. Enter the username and password for the user account on your VM as follows + ![enter image description here](./assets/gnome-login-websoft9.png) -6. 以 Gnome 为例,打开:【Setting】>【Region&Lanuage】>【Language】设置中文(重启后生效) +3. After authenticating, the xfce desktop environment will load and look similar to the following example ![enter image description here](./assets/gnome-changelanguage-websoft9.png) +### Set languages for Desktop -#### VNC 连接 - -VNC 是一种传统的连接 Linux 服务器桌面的方式: - -1. 使用 SSH 登录 Linux 桌面所在的服务器,设置你的 VNC 服务端访问密码 - ``` - sudo su - rm -rf /root/.vnc/passwd - vncpasswd - ``` -2. 本地电脑安装 [VNC viewer](https://www.realvnc.com/download/viewer/) 客户端 - -3. 登录云服务器控制台,为你的云服务器安全组中开启 **5901** 端口 - -4. 本地电脑打开 VNC 客户端,创建一个VNC连接(服务器公网IP地址:5901) - ![](./assets/vnc-connection001-websoft9.png) - -5. 点击【Continue】进入下一步 - ![](./assets/vnc-connection002-websoft9.png) - -6. 输入VNC密码后登录即可进入图形化界面 - ![](./assets/vnc-connection003-websoft9.png) - ![](./assets/vnc-setlanguage-websoft9.png) - ![](./assets/vnc-startuse-websoft9.png) - ![](./assets/vnc-gnomehome-websoft9.png) +Three steps for set lanuages for Desktop, below is the sample for KDE: -7. 如果服务器处于下图所示的锁定状态,请输入你的**服务器的密码**进行解锁 - ![](./assets/vnc-connection-rootlogin-websoft9.png) - - -8. VCN 使用过程中可参考如下命令进行维护 - ``` - # 查看已经运行的桌面编号 - vncserver -list - - # 终止2号桌面进程 - kill -9 :1 - - # 管理桌面服务 - systemctl start vncserver@:1.service - systemctl stop vncserver@:1.service - systemctl status vncserver@:1.service - systemctl restart vncserver@:1.service - ``` - -### 设置桌面语言 - -设置 Linux 桌面为中文一般分三个步骤,安装语言包、安装字体(防乱码)和设置区域和语言,下面以 CentOS KDE 桌面为例演示: - -1. 查询系统支持语言包并安装语言包 +- Install language packs ``` yum search kde | grep -i chinese yum install kde-l10n-Chinese.noarch ``` - -2. 安装字体 + +- Install fonts ``` yum groupinstall "fonts" ``` -3. 远程登录 KDE 桌面,设置语言: [system settings] - [Commone Appearance and Behavior] - [Local] - [Languages] +- Change the default settings by **system settings > Commone Appearance and Behavior > Local > Languages** + ![](./assets/kde-setlang-websoft9.png) + - ![](./assets/kde-setlang-websoft9.png) +## Common reference -### 安装 Web 浏览器 +### Create user{#createuser} -Linux 桌面安装 Google Chrome 为例: +You can run below commands to create new user and password ``` -# For CentOS7 -wget https://dl.google.com/linux/direct/google-chrome-stable_current_x86_64.rpm -sudo yum localinstall google-chrome-stable_current_x86_64.rpm -/usr/bin/google-chrome --no-sandbox - -# For Ubuntu -wget https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb -sudo apt install ./google-chrome-stable_current_amd64.deb -vim /usr/bin/google-chrome/google-chrome -exec -a "$0" "$HERE/chrome" "$@" 修改为 exec -a "$0" "$HERE/chrome" "$@" --no-sandbox -rm -r ~/.config/google-chrome +sudo su +adduser xxxuser ``` -## 常用操作 +### Enable root account{#enable} -### 启用 root 账号密码{#enable} +If your `root` account is can not login, please following below stes to enable it -如果云平台默认没有开放 Linux 系统的 `root` 账号,那么请参考下面的步骤启用它: +1. SSH connect your Linux -1. 通过云控制台的 Web 版 SSH 工具连接服务器 - -2. 运行下面的命令为 root 账号设置密码 +2. Use below commands to set password for root ``` sudo su sudo passwd root ``` -3. 编辑 */etc/ssh/sshd_config* 文件和 */etc/ssh/sshd_config.d* 目录的下的配置文件,确保最终为 sshd 服务端提供了准确的配置: +3. Edit file */etc/ssh/sshd_config* and files at directory */etc/ssh/sshd_config.d* - 1. 增加的配置项:`PermitRootLogin yes` 和 `PasswordAuthentication yes` - 2. 删除的配置项:`PermitRootLogin no` 和 `PasswordAuthentication no` + 1. Add configuration item: `PermitRootLogin yes` and `PasswordAuthentication yes` + 2. Delete configuration item: `PermitRootLogin no` and `PasswordAuthentication no` -3. 重启 sshd 服务后生效 +4. Restart SSH server ``` sudo systemctl restart sshd ``` -### 编码与字体 - -编码与字体两者都是为字符服务,但有本质差异: - -- 编码是计算机存储各种文字的格式(UTF8,Unicode等),是**面向机器**的设计形式,运行 `locale` 命令查看编码 -- 字体是计算机将字符显示出来的格式(中文黑体、 Google Fonts),是**面向人类**的设计形式 - -## 相关参考 - -- [Linux 命令](./linux-commands) -- [Linux 使用容器](./guide/container/) - -## 故障排除{#troubleshoot} - -#### CPU 100% 导致系统重启? - -如果 CPU 100% 负荷持续一段时间,系统可能会自动重启,其实这是 Linux 的一种设计。原因是 Linux 系统中有一个叫 [WatchDog](https://linux.die.net/man/8/watchdog) 的程序在起作用。但监测到系统异常且预计无法自愈,则只能触发重启机制以解决问题。 - -``` -The Linux kernel can reset the system if serious problems are detected. This can be implemented via special watchdog hardware, or via a slightly less reliable software-only watchdog inside the kernel. -``` - -重启是果,CPU 100% 是根本原因。当然,也可以修改 WatchDog 的配置以降低它通过重启解决问题的权重。 - -#### IO 密集型计算下服务器重启? - -问题描述:数据库建索引等 IO 密集型计算负载下或资源耗尽 CPU 100%,服务器出现重启的情况? -解决方案:Oracle 官方建议及时升级补丁 - -#### 磁盘已满,需要清理? - -1. 查看文件的占用大小情况 - ``` - # 查看当前目录下各文件、文件夹的大小 - du -h –max-depth=1 * - - # 查询当前目录总大小 - du -sh - - # 显示直接子目录文件及文件夹大小统计值 - du -h –max-depth=0 * - ``` +### Encoding and Fonts -2. 根据查询结果进行对应的删除 +Encoding and fonts both serve characters, but there are fundamental differences: -#### 服务器连不上? +- Encoding is the format in which the computer stores all kinds of characters (UTF8, Unicode, etc.), it is a **machine oriented** design form, run the `locale` command to see the encoding. +- Fonts are the formats that computers use to display characters (Google Fonts), and are **human-oriented** design forms. -下图显示了无法连接云服务器的主要原因分类及出现概率,按照对应的原因进行排查: +## Related topics -![](./assets/ecs-cannotconnect.png) +- [Linux commands](./linux-commands) +- [Container guide for Linux](./guide/container/) +## Troubleshoot{#troubleshoot} -#### 远程桌面报错:“由于安全设置错误,客户端无法连接到远程计算机...” +### Can I use VNC to connect desktop? -原因:本地远程桌面客户端与服务端协议不匹配 -方案:需根据实际情况修正 +Yes, but you should install VNC Server at Linux, e.g [TigerVNC](https://github.com/TigerVNC/tigervnc) +### My desktop unlocked? -#### 桌面锁屏了怎么办? +The login password cannot be unlocked, you can only log in again after restarting the server. -登录密码无法解锁,只能重启服务器后再登录。建议登录桌面后,关闭锁屏功能。 +It is recommended to turn off the screen lock function after logging into the desktop. -以 Gnome 为例,关闭步骤:【Privacy】>【Screen Lock】,将【Automatic Screen Lock】设置为 off \ No newline at end of file +Take Gnome as an example, turn it off by **Privacy > Screen Lock** and set **Automatic Screen Lock** to off. \ No newline at end of file diff --git a/i18n/en/docusaurus-plugin-content-docs/current/guide/server/os/windows.md b/i18n/en/docusaurus-plugin-content-docs/current/guide/server/os/windows.md index 40c8a7b3..cc8a220e 100755 --- a/i18n/en/docusaurus-plugin-content-docs/current/guide/server/os/windows.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/guide/server/os/windows.md @@ -5,176 +5,57 @@ slug: /windowsserver # Windows Server -Websoft9 拥有丰富的 Windows Server 托管经验,能够帮助用户提升性能和可靠性,提供卓越的安全与身份服务,支持迁移,提供广泛而深入的功能,并降低总拥有成本,同时提供灵活的许可选项。 +Websoft9 have the most experience with Microsoft applications in the cloud and we offer the best platform for Windows Server and SQL Server for higher performance and reliability, greater security and identity services, more migration support, the broadest and deepest capabilities, lower total cost of ownership, and flexible licensing options. -此为,Websoft9 提供构建和运行 Windows 应用程序所需的一切,包括 .NET、Microsoft SQL Server、Docker 等。凭借我们的专业知识,可以帮助用户轻松实现基于 Windows 的 DevOps 流程。 +Websoft9 can supports everything you need to build and run Windows applications including Active Directory, .NET, Microsoft SQL Server, Windows desktop-as-a-service, and all supported versions of Windows Server. With our proven expertise, we can help you easily lift-and-shift, refactor, or even modernize your Windows workloads. -## 指南 +## Supported images -### 连接 Windows{#connectwindows} +You can use supported Windows images powered by Websoft9 with technical service at major cloud provider. -可以通过本地电脑的远程桌面工具 (MSTSC) 连接 Window 服务器。具体步骤如下: +- Windows with [SQL Sever Express](./sqlserver) +- Windows with AI and ML +- Windows with [Visual Studio](https://docs.microsoft.com/zh-cn/visualstudio/get-started/visual-studio-ide) for developer -1. 获取需要登录的服务器的**公网IP地址**,并开启服务器安全组的 **3389** 端口 +## Tutorial and reference -2. 选择一种打开本地电脑远程桌面的方式(三选一): +### Remote desktop for Windows{#connectwindows} - - 打开 **开始菜单** -> **远程桌面连接** - - 打开 **开始菜单**,输入”mstsc“ ,系统会搜索远程桌面连接工具 - - 通过 **Windows Logo** + **R** 打开系统的命令窗口,输入”mstsc“来启动远程桌面连接工具 +You must meet the following prerequisites to connect to your Windows instance using an RDP client. -3. 打开远程桌面连接,输入公网IP地址 +1. Install an RDP client + - Windows includes an RDP client **MSTSC** by default + - macOS need Download the [Microsoft Remote Desktop](https://apps.apple.com/us/app/microsoft-remote-desktop/id1295203466?mt=12) app from the Mac App Store + - Linux Use [Remmina](https://remmina.org/) - ![img](./assets/windows-remote.png) +2. Get the **Internet IP** of Windows Server, and enable **3389** port of Security Group -4. 点击连接,成功后会看到Windows界面 +3. Prepare Administrator (Other) username and password of Windows + +4. When finish logging on, you can see Windows screen ![image.png](./assets/windows-2019desktop-websoft9.png) -5. 远程登录后,就可以直接从本地**拷贝**文件,然后**粘贴**文件到服务器上。 +5. You can copy and paste files from local computer to remote Windows directly ![img](./assets/windows-copyfilewin-websoft9.png) -### 使用 IIS 发布网站 - -IIS 部署网站是 Windows Server 平台上流行的网站发布工具: - -- 绑定域名:IIS 中右键点击需配置域名的网站,选择【编辑绑定】 -- 设置伪静态:IIS 需先安装 **[URL重写](https://www.iis.net/downloads/microsoft/url-rewrite)** 组件后,打开 IIS 选择具体的网站,打开 URL 重写工具 -- 设置 HTTPS 访问:准备证书后,点击 IIS 的主菜单,在 IIS 的配置页面找到 "服务器证书" 设置项 -- IIS 网站根目录: *C:\inetpub\wwwroot* - -### 分析日志{#logs} - -分析 Windows 系统日志是诊断错误的最直接的方法: - -1. 进入到 Windows 系统的**事件查看器**,选择 Windows 日志下的应用程序 - ![event](./assets/windows-eventerror1-websoft9.png) - -2. 单击查看目标应用程序的错误详情 - ![event](./assets/windows-eventerror2-websoft9.png) - -## 技术栈 - -### Docker - -Windows 系统可以同时支持 Linux 容器 和 Windows 容器两种方案。 - -[Windows 容器](https://docs.microsoft.com/zh-cn/virtualization/windowscontainers/)是微软的专项,它的用途是处理微软开发生态下的编译构建问题。 - -Windows 上的 Dockerfile 语法与 Linux 有一定的区别,具体参考[官方文档](https://docs.microsoft.com/en-us/virtualization/windowscontainers/manage-docker/manage-windows-dockerfile)说明。 - - -### SQL Server - -Websoft9 提供了在云上开机即用的包含 [SQL Sever](./sqlserver) 的 Windows 托管镜像与服务。 - -### PowerShell - -[PowerShell](https://docs.microsoft.com/zh-cn/powershell/scripting/overview) 同时支持在 Windows 和 Linux 上运行,PowerShell 使用“动词-名词”名称对来命名 cmdlet。 - -``` -# 安装 Powershell 软件库 -Install-PackageProvider -Name NuGet -Force -``` - -### Windows command - -参考:[Windows 命令](https://docs.microsoft.com/zh-cn/windows-server/administration/windows-commands/windows-commands) - -### Windows Admin Center - -[Windows Admin Center](https://www.microsoft.com/en-us/windows-server/windows-admin-center) 是一个集中式的跨平台 Windows Server 的远程管理工具。 - -### MSBuild - -[MSBuild](https://docs.microsoft.com/zh-cn/visualstudio/msbuild/msbuild) 又名 Microsoft 编译引擎,是一个用于编译应用程序的平台。 - -MSBuild 不依赖于 Visual Studio 可以单独运行 `msbuild.exe`,它类似 Linux 的 CMake。 - -Visual Studio 使用项目文件(.csproj、.vbproj、vcxproj 等)中包含的 MSBuild XML 配置来加载和编译构建。 - -也支持直接运行命令构建: - -``` -MSBuild.exe MyProj.proj -property:Configuration=Debug -``` - -### Windows Installer - -Windows Installer 是 Microsoft 提供的一套全面的安装打包解决方案,其中自动化安装程序 [msiexec](https://docs.microsoft.com/zh-cn/windows/win32/msi/command-line-options) 被广泛使用。 - - ``` - # 安装程序 - Msiexec /package Application.msi /quiet - Msiexec /uninstall Application.msi /quiet - Msiexec /update msipatch.msp /quiet - Msiexec /uninstall msipatch.msp /package Application.msi / quiet - - # 查询静默安装参数(有些软件不支持) - ./Application.exe /? - - # 打开记事本 - notepad - ``` - -### Visual Studio for CI/CD - -[Visual Studio](https://docs.microsoft.com/zh-cn/visualstudio/get-started/visual-studio-ide) 不仅仅是一个支持多项目、多解决方案级的代码编辑器,它也支持多种编译构建。 - -#### 自动化安装 Visual Studio - -在 Windows 下安装 Visual Studio 是非常方便的,因为官方提供了安全管理器。 - -![](./assets/vs-installergui-websoft9.png) - -但是,自动化的 DevOps 场景下,往往在编译构建之前,需通过 [命令行安装](https://docs.microsoft.com/zh-cn/visualstudio/install/use-command-line-parameters-to-install-visual-studio?view=vs-2019) 或 [命令行+响应文件安装](https://docs.microsoft.com/zh-cn/visualstudio/install/automated-installation-with-response-file?view=vs-2019) 实现自动化。 - - - ``` - # Powershell 命令 - .\vs_Community.exe --installPath C:\minVS --add Microsoft.VisualStudio.Workload.CoreEditor --quiet --norestart - - # Shell 命令 - start /w vs_Community.exe --installPath C:\minVS --add Microsoft.VisualStudio.Workload.CoreEditor --quiet --norestart - - # Shell 命令 + Jason 响应文件 - vs_Community.exe --in customInstall.json - ``` - -#### 编译构建 - -编译是将开发者的代码转变成可运行的程序的过程。通俗的说,**编译就是将代码变成软件的过程**。 - -编译的主要流程: - -1. 确保项目代码完整性(自编写代码 + 第三方库) -2. 准备编译环境(环境从 IDE 中解耦,更有利于自动化) -3. 准备项目中的编译的编排文件 -3. 运行编译过程 - -Visual Studio IDE 自带 C# 和 C++ 环境,其他环境需安装。它也支持集成:MSBuild, Cmake, DevOps 流水线等第三方编译工具。 - -## 问题与故障{#troubleshoot} -#### Windows 容器包含桌面吗? +### Get Windows logs{#logs} -Windows 容器并不支持以 RDP 模式的图形化远程桌面操作,Windows 容器是为持续集成而生。 +Refer to [Manage and monitor Windows Server event logs](https://learn.microsoft.com/en-us/training/modules/manage-monitor-event-logs/) -#### VS 是否可以被安装到容器? +### Windows workloads -可以,具体请参考:[官方文档](https://docs.microsoft.com/zh-cn/visualstudio/install/build-tools-container?view=vs-2019) 或 [docker-visualstudio](https://github.com/Websoft9/docker-visualstudio) +- [Containers on Windows](https://learn.microsoft.com/en-us/virtualization/windowscontainers/) +- [MSBuild](https://docs.microsoft.com/zh-cn/visualstudio/msbuild/msbuild) +- [Visual Studio](https://docs.microsoft.com/zh-cn/visualstudio/get-started/visual-studio-ide) -#### 无法连接 Windows 远程桌面?{#notconnectwin} -检查账号和密码是正确,请保证 **服务器安全组** 3389 端口是开启的,下图是排查方法 -![](./assets/windows-remotefail-websoft9.png) +## Troubleshoot{#troubleshoot} -#### Windows 容器无法访问外网?{#winnonetwork} +#### Windows container include desktop? -在使用某云 Windows 2019 数据中心版(含 Container) 的时候发现网络不通,后面采用如下的办法解决了此问题: +No, Windows container is for DevOps automation -1. 远程桌面登录到服务器 -2. 到【网络管理】中禁用本地网络,此时远程桌面断开 -3. 到云控制台 VNC 连接中重新远程到服务器,重新开启被禁用的本地网络 +#### Can I install VS to container? -以上解决办法的根本原因未知。 - \ No newline at end of file +Yes, refer to [build-tools-container](https://docs.microsoft.com/zh-cn/visualstudio/install/build-tools-container?view=vs-2019) and [docker-visualstudio](https://github.com/Websoft9/docker-visualstudio) \ No newline at end of file diff --git a/i18n/en/docusaurus-plugin-content-docs/current/reference/glossary.md b/i18n/en/docusaurus-plugin-content-docs/current/reference/glossary.md index bdf54b8b..6416ff3f 100755 --- a/i18n/en/docusaurus-plugin-content-docs/current/reference/glossary.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/reference/glossary.md @@ -18,6 +18,10 @@ Capitalize any proper nouns, e.g. Docker, Github, URL, Apache, Open Source Use enterpise as a modifier. E.g. **customized needs**, **customized deployment**. Don't use personalized which is not informal +## graphical + +Graphical User Interface, not use **visual** + ## application-centric Use application-centric not application-focused