跳转至

在私有资源上以单机模式安装WeCube

在这里,我们将为您说明如何在您自己的机器资源上安装以单机模式运行的WeCube。

先决条件

硬件资源

在单机模式下,我们建议您为WeCube的正常运行预留至少 4核CPU的计算资源16GB的内存资源50GB的硬盘存储资源

系统和软件资源

CentOS 7

WeCube的运行仅仅依赖于Docker,但是安装脚本是基于CentOS制作的。所以,请在安装了 CentOS 7(7.2或以上版本) 的Linux服务器上来安装WeCube。

Docker

如果您希望使用我们提供的缺省设置的Docker安装版本,您可以跳过此节的内容,直接 执行WeCube的安装脚本,WeCube的安装过程将会检查并根据需要自动安装Docker。

如果您希望自行定义和设置Docker的安装,请参考以下内容。

您需要安装最新稳定版本的 Docker Engine Docker Compose ,请参阅此处提供的链接所指向的相关站点获取它们各自的安装信息和指引。

请注意

您需要将Docker Engine配置为在运行时监听主机上非本地回环地址127.0.0.1TCP 2375端口,因为WeCube将使用此端口调用Docker Engine API来进行插件运行时环境的管理。您可以参阅 此站点 获取如何进行此配置的相关信息和指引。

如果您使用CentOS,也可以考虑使用这里提供的命令行指令来进行Docker的安装与配置,请展开来查看。

但是,我们还是强烈建议您从 Docker官方网站 获取安装和配置的信息和指引。

# 移除已安装的旧版本Docker
yum remove docker \
           docker-client \
           docker-client-latest \
           docker-common \
           docker-latest \
           docker-latest-logrotate \
           docker-logrotate \
           docker-engine

# 安装Docker
yum install -y yum-utils device-mapper-persistent-data lvm2
yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
yum-config-manager --add-repo http://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo
yum makecache fast
yum install -y docker-ce docker-ce-cli containerd.io

# 安装Docker Compose
curl -L --fail https://github.com/docker/compose/releases/download/1.25.4/run.sh -o /usr/local/bin/docker-compose
chmod +x /usr/local/bin/docker-compose

# 配置Docker Engine以监听远程API请求
# 我们在这里启用了腾讯云的Docker Hub镜像为中国大陆境内的访问进行加速,请根据您自己的实际情况进行调整
mkdir -p /etc/systemd/system/docker.service.d
cat <<EOF >/etc/systemd/system/docker.service.d/docker-wecube-override.conf
[Service]
ExecStart=
ExecStart=/usr/bin/dockerd -H fd:// -H tcp://0.0.0.0:2375 --registry-mirror=https://mirror.ccs.tencentyun.com
EOF

# 启动Docker服务
systemctl enable docker.service
systemctl start docker.service

# 启用IP转发并配置桥接来解决Docker容器对外部网络的通信问题
cat <<EOF >/etc/sysctl.d/zzz.net-forward-and-bridge-for-docker.conf
net.ipv4.ip_forward = 1
net.bridge.bridge-nf-call-ip6tables = 1
net.bridge.bridge-nf-call-iptables = 1
EOF
sysctl -p /etc/sysctl.d/zzz.net-forward-and-bridge-for-docker.conf

####
如果您的主机在访问公共网络时必须启用网络代理,请记得为Docker Engine服务设置正确的启动环境变量。

如果您采用上面提供的命令行指令安装Docker,那么您需要在文件 /etc/systemd/system/docker.service.d/docker-wecube-override.conf 中添加类似如下的配置内容,具体的配置请与您的网络管理员联系。

# 请联系您的网络管理员来确认这些环境变量的配置
Environment="http_proxy=http://<PROXY_IP>:<PROXY_PORT>"
Environment="no_proxy=localhost, 127.0.0.1, ::1"

安装并配置完成后,您可以使用以下命令行指令来确认Docker的运行情况:

docker version
docker-compose version
curl http://127.0.0.1:2375/version

如果以上指令的版本信息输出一切正常,那么恭喜,我们现在就可以开始安装WeCube了。

执行WeCube安装脚本

请执行如下命令行指令:

curl -fsSL https://raw.githubusercontent.com/WeBankPartners/delivery-by-terraform/master/get-wecube.sh -o get-wecube.sh && sh get-wecube.sh | tee ./out.log 2>&1

如果您在执行以上指令时遇到了访问GitHub站点raw.githubusercontent.com的网络错误,那么您可以执行以下命令行指令来通过我们在Gitee上的镜像站点进行安装:

curl -fsSL https://gitee.com/WeBankPartners/delivery-by-terraform/raw/master/get-wecube.sh -o get-wecube.sh && sh get-wecube.sh | tee ./out.log 2>&1

脚本执行时首先会提示您输入以下安装配置项:

配置项名称 默认值 用途说明
INSTALL_TARGET_HOST 127.0.0.1 WeCube安装的目标主机名称或IP地址
请勿使用此默认值,详见下方说明。)
WECUBE_RELEASE_VERSION latest WeCube安装的目标版本,默认为最新发布版本 latest,可指定为某个特定版本,如 v2.9.0
WECUBE_SETTINGS standard WeCube安装后的插件配置方案,默认为 标准安装配置 standard,可指定为 上手指引配置 bootcamp 或 空配置 empty
WECUBE_HOME /data/wecube WeCube的安装目录
WECUBE_USER root WeCube运行使用的用户
INITIAL_PASSWORD Wecube@123456 WeCube运行使用的用户密码,同时用于MySQL数据库root账号的初始密码
USE_MIRROR_IN_MAINLAND_CHINA true 是否在安装过程中使用位于中国大陆的镜像站点进行加速:true - 是;其它值 - 否

请注意

由于当前版本的WeCube设计,请勿使用默认的本地回环地址127.0.0.1作为安装目标主机的IP地址。大部分情况下,您应当使用为主机分配的内网IP地址作为部署配置项install_target_host的输入值。

请根据情况提供合适的输入值,如要使用默认值直接回车即可。提供了所有输入值之后,安装脚本将最后再次请您确认以上配置项的值,确认后将开始执行WeCube的安装过程。安装脚本执行完毕后,将输出如下内容:

Please visit WeCube at http://<您输入的主机名称或IP地址>:19090

请依据提示,使用默认的用户名 umadmin 和密码 umadmin 来访问安装好的WeCube。

卸载和重新安装WeCube

如果您想要卸载已经安装的WeCube,或者想要使用不同的版本或插件配置方案来安装WeCube,请执行以下命令行指令来清除WeCube的运行组件和安装目录(默认为 /data/wecube,请根据您的实际情况对命令行指令进行调整):

docker rm -f $(docker ps -a -q -f name=wecube -f name=wecmdb -f name=open-monitor -f name=service-mgmt) && sudo rm -rfI /data/wecube

进一步了解

关于WeCube安装目录结构的详细信息,请参见文档“WeCube安装目录结构”。


最后更新: 2021年8月25日