KassieZ commented on code in PR #1692: URL: https://github.com/apache/doris-website/pull/1692#discussion_r1903781144
########## docs/gettingStarted/quick-start.md: ########## @@ -24,241 +25,257 @@ specific language governing permissions and limitations under the License. --> -# Quick Start +:::caution Warning: + +Quick deployment **is only suitable for local development**. Do not use this deployment method in production environments: -This guide is about how to download the latest stable version of Apache Doris, install it on a single node, and get it running, including steps for creating a database, data tables, importing data, and performing queries. +1. When deploying quickly using Docker, data will be released when the Docker instance is destroyed. -## Environment requirements +2. Deploying a single-instance Doris manually does not have data replication capability, and a single machine failure may result in data loss. -- A mainstream Linux x86-64 environment. CentOS 7.1 or Ubuntu 16.04 or later versions are recommended. See the "Install and Deploy" section of the doc for guides on more environments. -- Install Java 8 runtime environment. (If you are not an Oracle JDK commercial license user, we suggest using the free Oracle JDK 8u202. [Download now](https://www.oracle.com/java/technologies/javase/javase8-archive-downloads.html#license-lightbox).) -- It is recommended to create a new user for Apache Doris on Linux (avoid using the root user to prevent accidental operations on the operating system). +3. The tables created in this example are single-instance. In production, please use multi-replica storage for data. +::: + +## Use Docker for Quick Deployment + +### Step 1: Create the docker-compose.yaml File + +Copy the following content into the docker-compose.yaml file, and replace the `DORIS_QUICK_START_VERSION` parameter with the specified version, such as `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 +``` -## Download binary package +### Step 2：Start Cluster -Download the Apache Doris installation package from doris.apache.org and proceed with the following steps. +Start the cluster using the docker-compose command. ```shell -# Download the binary installation package of Apache Doris -server1:~ doris$ wget https://apache-doris-releases.oss-accelerate.aliyuncs.com/apache-doris-2.0.3-bin-x64.tar.gz +docker-compose -f ./docker-compose.yaml up -d +``` -# Extract the installation package -server1:~ doris$ tar zxf apache-doris-2.0.3-bin-x64.tar.gz +### Step 3: Connect to the cluster using MySQL client and check the cluster status + +```sql +## Check the FE status to ensure that both the Join and Alive columns are true. +mysql -uroot -P9030 -h127.0.0.1 -e 'SELECT `host`, `join`, `alive` FROM frontends()' ++-----------+------+-------+ +| host | join | alive | ++-----------+------+-------+ +| 127.0.0.1 | true | true | ++-----------+------+-------+ + +## Check the BE status to ensure that the Alive column is true. +mysql -uroot -P9030 -h127.0.0.1 -e 'SELECT `host`, `alive` FROM backends()' ++-----------+-------+ +| host | alive | ++-----------+-------+ +| 127.0.0.1 | 1 | ++-----------+-------+ -# Rename the directory to apache-doris for simplicity -server1:~ doris$ mv apache-doris-2.0.3-bin-x64 apache-doris ``` -## Install Apache Doris -### Configure FE -Go to the `apache-doris/fe/conf/fe.conf` file for FE configuration. Below are some key configurations to pay attention to. Add JAVA_HOME manually and point it to your JDK8 runtime environment. For other configurations, you can go with the default values for a quick single-machine experience. +## Local Quick Deployment -```Shell -# Add JAVA_HOME and point it to your JDK8 runtime environment. Suppose your JDK8 is at /home/doris/jdk8, set it as follows: -JAVA_HOME=/home/doris/jdk8 +::: info Environment Recommendations: 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
