translate and improve the installation and deployment documentation

2024-11-21 15:12:02 +00:00 · 2020-11-26 19:58:56 +08:00 · 2020-11-26 19:58:56 +08:00 · 5b8d4e8292
commit 5b8d4e8292
parent 93b6add264
2 changed files with 108 additions and 53 deletions
--- a/docs/zh/getting-started/index.md
+++ b/docs/zh/getting-started/index.md
@ -1,3 +1,10 @@
+---
+machine_translated: true
+machine_translated_rev: 72537a2d527c63c07aa5d2361a8829f3895cf2bd
+toc_folder_title: "\u5BFC\u8A00"
+toc_priority: 2
+---
+
 # 入门 {#ru-men}

 如果您是ClickHouse的新手，并希望亲身体验它的性能，首先您需要通过 [安装过程](install.md).
--- a/docs/zh/getting-started/install.md
+++ b/docs/zh/getting-started/install.md
@ -1,34 +1,46 @@
+---
+toc_priority: 1
+toc_title: 安装部署
+---
+
 # 安装 {#clickhouse-an-zhuang}

 ## 系统要求 {#xi-tong-yao-qiu}

 ClickHouse可以在任何具有x86_64，AArch64或PowerPC64LE CPU架构的Linux，FreeBSD或Mac OS X上运行。

-虽然预构建的二进制文件通常是为x86  _64编译并利用SSE 4.2指令集，但除非另有说明，否则使用支持它的CPU将成为额外的系统要求。这是检查当前CPU是否支持SSE 4.2的命令：
+官方预构建的二进制文件通常针对x86_64进行编译，并利用`SSE 4.2`指令集，因此，除非另有说明，支持它的CPU使用将成为额外的系统需求。下面是检查当前CPU是否支持SSE 4.2的命令:

 ``` bash
 $ grep -q sse4_2 /proc/cpuinfo && echo "SSE 4.2 supported" || echo "SSE 4.2 not supported"
 ```

-要在不支持SSE 4.2或具有AArch64或PowerPC64LE体系结构的处理器上运行ClickHouse，您应该[通过源构建ClickHouse](#from-sources)进行适当的配置调整。
+要在不支持`SSE 4.2`或`AArch64`，`PowerPC64LE`架构的处理器上运行ClickHouse，您应该通过适当的配置调整从[源代码构建ClickHouse](#from-sources)。

-## 可用的安装选项 {#install-from-deb-packages}
+## 可用安装包 {#install-from-deb-packages}

-建议为Debian或Ubuntu使用官方的预编译`deb`软件包。 运行以下命令以安装软件包：
+### `DEB`安装包

-然后运行：
+建议使用Debian或Ubuntu的官方预编译`deb`软件包。运行以下命令来安装包:

 ``` bash
 {% include 'install/deb.sh' %}
 ```

-你也可以从这里手动下载安装包：https://repo.clickhouse.tech/deb/stable/main/。
+如果您想使用最新的版本，请用`testing`替代`stable`(我们只推荐您用于测试环境)。

-如果你想使用最新的测试版本，请使用`testing`替换`stable`。
+你也可以从这里手动下载安装包：[下载](https://repo.clickhouse.tech/deb/stable/main/)。

-### 来自RPM包 {#from-rpm-packages}
+安装包列表：

-Yandex ClickHouse团队建议使用官方预编译的`rpm`软件包，用于CentOS，RedHat和所有其他基于rpm的Linux发行版。
+- `clickhouse-common-static` — ClickHouse编译的二进制文件。
+- `clickhouse-server` — 创建`clickhouse-server`软连接，并安装默认配置服务
+- `clickhouse-client` — 创建`clickhouse-client`客户端工具软连接，并安装客户端配置文件。
+- `clickhouse-common-static-dbg` — 带有调试信息的ClickHouse二进制文件。
+
+### `RPM`安装包 {#from-rpm-packages}
+
+推荐使用CentOS、RedHat和所有其他基于rpm的Linux发行版的官方预编译`rpm`包。

 首先，您需要添加官方存储库：

@ -38,84 +50,120 @@ sudo rpm --import https://repo.clickhouse.tech/CLICKHOUSE-KEY.GPG
 sudo yum-config-manager --add-repo https://repo.clickhouse.tech/rpm/stable/x86_64
 ```

-如果您想使用最新版本，请将`stable`替换为`testing`（建议您在测试环境中使用）。
+如果您想使用最新的版本，请用`testing`替代`stable`(我们只推荐您用于测试环境)。`prestable`有时也可用。

-然后运行这些命令以实际安装包：
+然后运行命令安装：

 ``` bash
 sudo yum install clickhouse-server clickhouse-client
 ```

-您也可以从此处手动下载和安装软件包：https://repo.clickhouse.tech/rpm/stable/x86_64。
+你也可以从这里手动下载安装包：[下载](https://repo.clickhouse.tech/rpm/stable/x86_64)。

-### 来自Docker {#from-docker-image}
+### `Tgz`安装包 {#from-tgz-archives}

-要在Docker中运行ClickHouse，请遵循[码头工人中心](https://hub.docker.com/r/yandex/clickhouse-server/)上的指南。那些图像使用官方的`deb`包。
+如果您的操作系统不支持安装`deb`或`rpm`包，建议使用官方预编译的`tgz`软件包。
+
+所需的版本可以通过`curl`或`wget`从存储库`https://repo.clickhouse.tech/tgz/`下载。
+
+下载后解压缩下载资源文件并使用安装脚本进行安装。以下是一个最新版本的安装示例:
+
+``` bash
+export LATEST_VERSION=`curl https://api.github.com/repos/ClickHouse/ClickHouse/tags 2>/dev/null | grep -Eo '[0-9]+\.[0-9]+\.[0-9]+\.[0-9]+' | head -n 1`
+curl -O https://repo.clickhouse.tech/tgz/clickhouse-common-static-$LATEST_VERSION.tgz
+curl -O https://repo.clickhouse.tech/tgz/clickhouse-common-static-dbg-$LATEST_VERSION.tgz
+curl -O https://repo.clickhouse.tech/tgz/clickhouse-server-$LATEST_VERSION.tgz
+curl -O https://repo.clickhouse.tech/tgz/clickhouse-client-$LATEST_VERSION.tgz
+
+tar -xzvf clickhouse-common-static-$LATEST_VERSION.tgz
+sudo clickhouse-common-static-$LATEST_VERSION/install/doinst.sh
+
+tar -xzvf clickhouse-common-static-dbg-$LATEST_VERSION.tgz
+sudo clickhouse-common-static-dbg-$LATEST_VERSION/install/doinst.sh
+
+tar -xzvf clickhouse-server-$LATEST_VERSION.tgz
+sudo clickhouse-server-$LATEST_VERSION/install/doinst.sh
+sudo /etc/init.d/clickhouse-server start
+
+tar -xzvf clickhouse-client-$LATEST_VERSION.tgz
+sudo clickhouse-client-$LATEST_VERSION/install/doinst.sh
+```
+
+对于生产环境，建议使用最新的`stable`版本。你可以在GitHub页面https://github.com/ClickHouse/ClickHouse/tags找到它，它以后缀`-stable`标志。
+
+### `Docker`安装包 {#from-docker-image}
+
+要在Docker中运行ClickHouse，请遵循[Docker Hub](https://hub.docker.com/r/yandex/clickhouse-server/)上的指南。它是官方的`deb`安装包。
+
+### 其他环境安装包 {#from-other}
+
+对于非linux操作系统和Arch64 CPU架构，ClickHouse将会以`master`分支的最新提交的进行编译提供(它将会有几小时的延迟)。
+
+-   [macOS](https://builds.clickhouse.tech/master/macos/clickhouse) — `curl -O 'https://builds.clickhouse.tech/master/macos/clickhouse' && chmod a+x ./clickhouse`
+-   [FreeBSD](https://builds.clickhouse.tech/master/freebsd/clickhouse) — `curl -O 'https://builds.clickhouse.tech/master/freebsd/clickhouse' && chmod a+x ./clickhouse`
+-   [AArch64](https://builds.clickhouse.tech/master/aarch64/clickhouse) — `curl -O 'https://builds.clickhouse.tech/master/aarch64/clickhouse' && chmod a+x ./clickhouse`
+
+下载后，您可以使用`clickhouse client`连接服务，或者使用`clickhouse local`模式处理数据，不过您必须要额外在GitHub下载[server](https://github.com/ClickHouse/ClickHouse/blob/master/programs/server/config.xml)和[users](https://github.com/ClickHouse/ClickHouse/blob/master/programs/server/users.xml)配置文件。
+
+不建议在生产环境中使用这些构建版本，因为它们没有经过充分的测试，但是您可以自行承担这样做的风险。它们只是ClickHouse功能的一个部分。

 ### 使用源码安装 {#from-sources}

-具体编译方式可以参考build.md。
+要手动编译ClickHouse, 请遵循[Linux](../development/build.md)或[Mac OS X](../development/build-osx.md)说明。

-你可以编译并安装它们。
-你也可以直接使用而不进行安装。
+您可以编译并安装它们，也可以使用不安装包的程序。通过手动构建，您可以禁用`SSE 4.2`或`AArch64 cpu`。

-``` text
-Client: programs/clickhouse-client
-Server: programs/clickhouse-server
-```
+      Client: programs/clickhouse-client
+      Server: programs/clickhouse-server

-在服务器中为数据创建如下目录：
+您需要创建一个数据和元数据文件夹，并为所需的用户`chown`授权。它们的路径可以在服务器配置(`src/programs/server/config.xml`)中改变，默认情况下它们是:

-``` text
-/opt/clickhouse/data/default/
-/opt/clickhouse/metadata/default/
-```
+      /opt/clickhouse/data/default/
+      /opt/clickhouse/metadata/default/

-(它们可以在server config中配置。)
-为需要的用户运行’chown’
-
-日志的路径可以在server config (src/programs/server/config.xml)中配置。
+在Gentoo上，你可以使用`emerge clickhouse`从源代码安装ClickHouse。

 ## 启动 {#qi-dong}

-可以运行如下命令在后台启动服务：
+如果没有`service`，可以运行如下命令在后台启动服务：

 ``` bash
-sudo service clickhouse-server start
+$ sudo /etc/init.d/clickhouse-server start
 ```

-可以在`/var/log/clickhouse-server/`目录中查看日志。
+日志文件将输出在`/var/log/clickhouse-server/`文件夹。

-如果服务没有启动，请检查配置文件 `/etc/clickhouse-server/config.xml`。
+如果服务器没有启动，检查`/etc/clickhouse-server/config.xml`中的配置。

-你也可以在控制台中直接启动服务：
+您也可以手动从控制台启动服务器:

-``` bash
-clickhouse-server --config-file=/etc/clickhouse-server/config.xml
+```bash
+$ clickhouse-server --config-file=/etc/clickhouse-server/config.xml
 ```

-在这种情况下，日志将被打印到控制台中，这在开发过程中很方便。
-如果配置文件在当前目录中，你可以不指定’–config-file’参数。它默认使用’./config.xml’。
+在这种情况下，日志将被打印到控制台，这在开发过程中很方便。

-你可以使用命令行客户端连接到服务：
+如果配置文件在当前目录中，则不需要指定`——config-file`参数。默认情况下，它的路径为`./config.xml`。
+
+ClickHouse支持访问限制设置。它们位于`users.xml`文件(与`config.xml`同级目录)。
+默认情况下，允许`default`用户从任何地方访问，不需要密码。可查看`user/default/networks`。
+更多信息，请参见[Configuration Files](../operations/configuration-files.md)。
+
+启动服务后，您可以使用命令行客户端连接到它:

 ``` bash
-clickhouse-client
+$ clickhouse-client
 ```

-默认情况下它使用’default’用户无密码的与localhost:9000服务建立连接。
-客户端也可以用于连接远程服务，例如：
+默认情况下，使用`default`用户并不携带密码连接到`localhost:9000`。还可以使用`--host`参数连接到指定服务器。
+
+终端必须使用UTF-8编码。
+更多信息，请参阅[Command-line client](../interfaces/cli.md)。
+
+示例：

-``` bash
-clickhouse-client --host=example.com
 ```
-
-有关更多信息，请参考«Command-line client»部分。
-
-检查系统是否工作：
-
-``` bash
-milovidov@hostname:~/work/metrica/src/src/Client$ ./clickhouse-client
+$ ./clickhouse-client
 ClickHouse client version 0.0.18749.
 Connecting to localhost:9000.
 Connected to ClickHouse server version 0.0.18749.
@ -135,6 +183,6 @@ SELECT 1

 **恭喜，系统已经工作了!**

-为了继续进行实验，你可以尝试下载测试数据集。
+为了继续进行实验，你可以尝试下载测试数据集或查看[教程](https://clickhouse.tech/tutorial.html)。

 [原始文章](https://clickhouse.tech/docs/en/getting_started/install/) <!--hide-->