KassieZ commented on code in PR #1692: URL: https://github.com/apache/doris-website/pull/1692#discussion_r1903782742
########## i18n/zh-CN/docusaurus-plugin-content-docs/current/gettingStarted/quick-start.md: ########## @@ -25,251 +25,255 @@ specific language governing permissions and limitations under the License. --> -这个简短的指南将告诉你如何下载 Apache Doris 最新稳定版本，在单节点上安装并运行它，包括创建数据库、数据表、导入数据及查询等。 +:::caution 警告： -## 环境准备 +快速部署**仅适用于本地开发**。请勿将该种部署方式用于生产环境： -- 选择一个 x86-64 上的主流 Linux 环境，推荐 CentOS 7.1 或者 Ubuntu 16.04 以上版本。更多运行环境请参考安装部署部分。 +1. 使用 Docker 方式快速部署，当 Docker 实例销毁时，相应的数据也会释放。 -- Java 8 运行环境（非 Oracle JDK 商业授权用户，建议使用免费的 Oracle JDK 8u202，[立即下载](https://www.oracle.com/java/technologies/javase/javase8-archive-downloads.html#license-lightbox)）。 +2. 通过手动部署单副本 Doris 实例，不具有数据多副本存储能力，单台机器宕机可能会造成数据丢失。 -- 建议在 Linux 上新建一个 Doris 用户。请避免使用 Root 用户，以防对操作系统误操作。 - -## 下载二进制包 - -从 doris.apache.org 下载相应的 Apache Doris 安装包，并且解压。 - -```shell -# 下载 Apache Doris 二进制安装包 -server1:~ doris$ wget https://apache-doris-releases.oss-accelerate.aliyuncs.com/apache-doris-2.0.12-bin-x64.tar.gz - -# 解压安装包 -server1:~ doris$ tar zxf apache-doris-2.0.12-bin-x64.tar.gz +3. 本示例中的建表均为单副本，在生产中请使用多副本存储数据。 +::: -# 目录重命名为更为简单的 apache-doris -server1:~ doris$ mv apache-doris-2.0.12-bin-x64 apache-doris +## 使用 Docker 快速部署 + +### 第 1 步：创建 docker-compose.yaml 文件 + +复制以下内容到 docker-compose.yaml，替换 DORIS_QUICK_START_VERSION 参数为指定版本，如 `3.0.1`。 + +```text +version: "3" +services: + fe: + image: apache/doris.fe-ubuntu:${DORIS_QUICK_START_VERSION} + hostname: fe + environment: + - FE_SERVERS=fe1:127.0.0.1:9010 + - FE_ID=1 + network_mode: host + be: + image: apache/doris.be-ubuntu:${DORIS_QUICK_START_VERSION} + hostname: be + environment: + - FE_SERVERS=fe1:127.0.0.1:9010 + - BE_ADDR=127.0.0.1:9050 + depends_on: + - fe + network_mode: host ``` -## 安装 Doris +### 第 2 步：启动集群 -### 配置 FE +使用 docker-compose 命令启动集群 -FE 的配置文件为 `apache-doris/fe/conf/fe.conf`。下面是一些需要关注的核心配置。除了 JAVA_HOME, 需要手动增加，并且指向你的 JDK8 运行环境。其它配置，可以使用默认值，即可支持单机快速体验。 +```shell +docker-compose -f ./docker-compose.yaml up -d +``` -```Plain -# 增加 JAVA_HOME 配置，指向 JDK8 的运行环境。假如我们 JDK8 位于 /home/doris/jdk8, 则设置如下 -JAVA_HOME=/home/doris/jdk8 +### 第 3 步：使用 MySQL 客户端连接集群，并检查集群状态 -# FE 监听 IP 的 CIDR 网段。默认设置为空，有 Apache Doris 启动时自动选择一个可用网段。如有多个网段，需要指定一个网段，可以类似设置 priority_networks=192.168.0.0/24 -# priority_networks = +```sql +## 检查 FE 状态，确定 Join 与 Alive 列都为 true +mysql -uroot -P9030 -h127.0.0.1 -e 'SELECT `host`, `join`, `alive` FROM frontends()' ++-----------+------+-------+ +| host | join | alive | ++-----------+------+-------+ +| 127.0.0.1 | true | true | ++-----------+------+-------+ + +## 检查 BE 状态，确定 Alive 列为 true +mysql -uroot -P9030 -h127.0.0.1 -e 'SELECT `host`, `alive` FROM backends()' ++-----------+-------+ +| host | alive | ++-----------+-------+ +| 127.0.0.1 | 1 | ++-----------+-------+ -# FE 元数据存放的目录，默认是在 DORIS_HOME 下的 doris-meta 目录。已经创建，可以更改为你的元数据存储路径。 -# meta_dir = ${DORIS_HOME}/doris-meta ``` -### 启动 FE -在 apache-doris/fe 下，运行下面命令启动 FE。 -```shell -# 将 FE 启动成后台运行模式，这样确保退出终端后，进程依旧运行。 -server1:apache-doris/fe doris$ ./bin/start_fe.sh --daemon -``` +## 本地快速部署 -### 配置 BE +::: info 环境建议： Review Comment: 去掉空格 -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: commits-unsubscr...@doris.apache.org For queries about this service, please contact Infrastructure at: us...@infra.apache.org --------------------------------------------------------------------- To unsubscribe, e-mail: commits-unsubscr...@doris.apache.org For additional commands, e-mail: commits-h...@doris.apache.org
