原始网页:https://www.cockroachlabs.com/docs/stable/initialize-a-cluster.html


本小节将解释cockroach init命令的使用方式,该命令用于初始化一个多节点集群。更加详细的启动和初始化过程,可以查看手动部署

NOTE: 启动单节点集群时,不需要执行cockroach init命令。

概要

# Perform a one-time initialization of a cluster:
cockroach init <flags>

# View help:
cockroach init --help

Flags

客户端连接

Flag 简介
--host 指定服务器ip地址,可以是集群的任意节点。

环境变量COCKROACH_HOST
默认localhost
--port
-p
指定服务器端口

环境变量COCKROACH_PORT
默认26257
--user
-u
指定SQL用户

环境变量COCKROACH_USER
默认root
--insecure 使用非安全模式的连接

环境变量COCKROACH_INSECURE
默认false
--certs-dir 指定存放着CA证书和客户端证书密钥的目录

环境变量COCKROACH_CERTS_DIR
默认${HOME}/.cockroach-certs/

更多细节可以查看:客户端连接参数

日志

cockroach init默认输出日志错误到stderr,更丰富的日志功能可查看:日志行为

示例

以下示例假定已经使用cockroach start命令启动节点,此时集群等待初始化操作。更详细的部署流程可查看手动部署

使用集群节点初始化集群

非安全模式

cockroach init --insecure --host=<address of this node>

执行命令后,节点会在标准输出里打印详细信息,包括了CockroachDB版本信息、Admin界面的URl地址、供客户端访问的SQL地址。

安全模式

cockroach init --certs-dir=certs --host=<address of this node>

执行命令后,节点会在标准输出里打印详细信息,包括了CockroachDB版本信息、Admin界面的URl地址、供客户端访问的SQL地址。

使用集群外机器初始化集群

非安全模式

cockroach init --insecure --host=<address of this node>

执行命令后,节点会在标准输出里打印详细信息,包括了CockroachDB版本信息、Admin界面的URl地址、供客户端访问的SQL地址。

安全模式

cockroach init --certs-dir=certs --host=<address of any node>

执行命令后,节点会在标准输出里打印详细信息,包括了CockroachDB版本信息、Admin界面的URl地址、供客户端访问的SQL地址。