安装环境准备

开始安装蓝鲸社区版前,需按以下文档指南,做好准备工作。

获取安装包

蓝鲸社区版包含部署脚本、产品软件和开源组件。蓝鲸提供完整包与分包的下载通道,请自行到下载地址按需获取。新装环境及新用户建议下载完整包使用。

下载地址: https://bk.tencent.com/download/

下载完成后,请核对MD5码。

硬件选择

对于蓝鲸部署所需的硬件配置选型,并无定规。蓝鲸由众多开源组件和自研组件构成。 开源组件的硬件选型可以参考相应的官方文档,参见附录。

蓝鲸产品本身的建议配置如下:

如果硬件资源富余,可以一开始拆分搭建部署。若硬件资源不足,一开始可以混合搭建,注意观测资源消耗情况,可以适时增加机器,迁移模块的方式来保证整体的可用性。

资源规划是一个复杂的、动态的过程,更像是一门艺术而不是科学。

这里给出的一个比较合理的初始配置,基于以下考虑:

  1. 分布式模块达到高可用至少三个节点,所以至少需要三个OS(物理机或虚拟机均可)
  2. Bkdata是耗费资源最多的蓝鲸组件。请分配到4核16G以上的机器。
  3. 若日志检索,蓝鲸监控是主要使用场景,请给influxdb和elasticsearch模块更多的内存,更好磁盘性能比如SSD。
  4. nginx模块所在的机器需要有对外提供服务,可访问的IP。这是蓝鲸平台的总入口。
  5. 如果需要有跨云管理需求,gse部署的机器需要有跨云的网络条件。

根据以上考虑,安装蓝鲸初始配置,请满足:

  • 1台4核16G
  • 2台4核8G

CentOS系统设置

准备好硬件,安装完原生CentOS系统后。我们需要对初始系统做一些配置,保证后续安装过程的顺畅,和蓝鲸平台的运行。注意:所有待安装蓝鲸的机器均需要按以下清单检查和操作。

  1. 系统版本:要求CentOS-7.0以上版本,推荐CentOS-7.5

  2. 关闭SELinux

     # 检查SELinux的状态,如果它已经禁用,可以跳过后面的命令
     $ sestatus
    

    可以使用以下命令禁用SELinux,或者修改配置文件:

     # 通过命令禁用SELinux
     $ setenforce 0
     # 或者修改配置文件
     $ sed -i 's/^SELINUX=enforcing/SELINUX=disabled/g' /etc/sysconfig/selinux
    

    接着,重启机器:

     $ reboot
    
  3. 安装rsync命令

    安装脚本依赖rsync分发同步文件。

     # 检查是否有rsync命令,如果有返回rsync路径,可以跳过后面的命令
     $ which rsync
     # 安装rsync
     $ yum -y install rsync
    
  4. 关闭默认防火墙(firewalld)

    安装和运行蓝鲸时,模块之间互相访问的端口策略较多,建议对蓝鲸后台服务器之间关闭防火墙。

     # 检查默认防火墙状态, 如果返回not running,可以跳过后面的命令
     firewall-cmd --state
    

    停止并禁用firewalld:

     systemctl stop firewalld    # 停止firewalld
     systemctl disable firewalld # 禁用firewall开机启动
    
  5. 调整最大文件打开数

     # 检查当前root账号下的max open files值
     ulimit -n
    

    如果为默认的1024,建议通过修改配置文件调整为102400或更大。

     cat <<EOF > /etc/security/limits.d/99-nofile.conf
     root soft nofile 102400
     root hard nofile 102400
     EOF
    

    这里使用的单独的配置文件覆盖/etc/security/limits.conf默认值的方式,请根据系统环境自行调整。

    修改后,重新使用root登录检查是否生效。

  6. 确认服务器时间同步

    服务器后台时间不同步会对时间敏感的服务带来不可预见的后果。务必在安装和使用蓝鲸时保证时间同步。

     # 检查每台机器当前时间和时区是否一致,若相互之间差别大于3s(考虑批量执行时的时差),建议校时。
     date -R
     # 查看和ntp server的时间差异(需要外网访问,如果内网有ntpd服务器,自行替换域名为该服务的地址)
     ntpdate -d cn.pool.ntp.org
    

    如果输出的最后一行offset大于1s建议校时

     # 和ntp服务器同步时间
     ntpdate cn.pool.ntp.org
    

    更可靠的方式包括通过运行ntpd或者chrony等服务在后台保持时间同步。具体请参考官方文档使用ntpd配置NTP使用chrony配置NTP

  7. 检查是否存在全局HTTP代理

    蓝鲸服务器之间会有的http请求,如果存在http代理,且未能正确代理这些请求,会发生不可预见的错误。

     # 检查http_proxy https_proxy变量是否设置,若为空可以跳过后面的操作
     $ echo "$http_proxy" "$https_proxy"
    

    对于本机配置http_proxy变量的方式,请依次查找文件/etc/profile、/etc/bashrc、$HOME/.bashrc等是否有设置。 或者咨询网络管理员/IT部门协助处理。

在这些主机中,选择任意一台机器作为蓝鲸的运维中控机。之后的安装命令执行,如果没有特别说明,均在这台中控机上执行。

将下载的蓝鲸社区版完整包上传到中控机,并解压到 同级 目录下。以解压到/data 目录为例:

tar xf bkce_src-5.0.3.tar.gz  -C /data

解压之后, 得到两个目录: src, install

  • src: 存放蓝鲸产品软件, 以及依赖的开源组件
  • install: 存放安装部署脚本、安装时的参数配置、日常运维脚本等

配置 YUM 源

在所有蓝鲸服务器上配置好 yum 源,要求该 yum 源包含 EPEL。

不能连外网YUM源的环境, 可以配置一个内部的 yum 源 或者本地 YUM 源

本地 YUM 源

参考附录中的 离线安装的配置方法

在线 YUM 源

推荐使用以下 yum 源

配置文件

在 install 目录下, 共有三个配置

  • install.config
  • globals.env
  • ports.env

install.config

install.config 是模块和服务器对应关系的配置文件,描述在哪些机器上安装哪些模块。 每行两列,第一列是IP地址;第二列是以英文逗号分隔的模块名称。 详情参考install.config.3IP.sample文件(可将install.config.3IP.sample 复制为install.config)。

[bkce-basic]
10.0.0.1 nginx,rabbitmq,kafka(config),zk(config),es,appt,fta,consul,bkdata(databus)
10.0.0.2 mongodb,appo,kafka(config),zk(config),es,mysql,consul,bkdata(dataapi),beanstalk
10.0.0.3 paas,cmdb,job,gse,license,kafka(config),zk(config),es,redis,influxdb,consul,bkdata(monitor)

说明:

  • 该配置文件,ip 后面使用空格与服务名称隔开,含有多个内网 ip 的机器,默认使用 /sbin/ifconfig 输出中的第一个内网ip, 在 ip 后面写上该机器要安装的服务列表即可, 部署过程中默认使用标准私有地址, 若企业环境使用非标准私有地址, 请参考非标准内网ip处理的处理方法。
  • zk 表示 zookeeper, es 表示 elasticsearch
  • gse 与 redis 需要部署在同一台机器上
  • gse 若需要跨云支持, gse 所在机器必须有外网 IP
  • 增加机器数量时, 可以将以上配置中的服务挪到新的机器上,分担负载。 要保证: kafka, es, zk 的每个组件的总数量为3

globals.env

该文件定义了各类组件的账号密码信息. 功能开关控制选项等. 可根据实际情况进行修改.
配置项含义, 请查看文件中的注释

  • 该文件含密码信息,请保证除了root用户外,其他用户不可读。
  • 各类账号密码建议修改, 注意设置的各类密码不能有 / $ ` < > &等特殊字符
  • 配置HTTP代理: 若公司不能访问外网, 但有自己的 proxy, 在该配置文件的 BK_PROXY 选项中指定代理地址.
  • 若需要跨云管理功能(服务器在不同的 IDC, 内网不互通的情况):
    • 需要将 gse 所在机器的外网IP填到该文件中 GSE_WAN_IP 配置项中的括号里 如: export GSE_WAN_IP=(1.2.3.4), 若没有外网IP 则留空
  • HAS_DNS_SERVER 配置默认为0,表示配置的蓝鲸域名需要通过/etc/hosts来解析,此时部署脚本会自动修改每台机器的/etc/hosts添加相关域名。如果想走自己的dns配置,改为非0即可。
  • HTTP_SCHEMA=http 默认HTTP_SCHEMA设置为http即蓝鲸软件全站为http,若设置为https则蓝鲸软件全站为https,可支持http和https的切换。
  • 该配置文件中提供了访问蓝鲸三大平台的域名配置, 需要提前准备好.

    export BK_DOMAIN="bk.com"                # 蓝鲸根域名(不含主机名)
    export PAAS_FQDN="paas.$BK_DOMAIN"       # PAAS 完整域名
    export CMDB_FQDN="cmdb.$BK_DOMAIN"       # CMDB 完整域名
    export JOB_FQDN="job.$BK_DOMAIN"         # JOB 完整域名
    

说明:

  1. BK_DOMAIN的值不能为"com" "net" 这种顶级域名, 至少二级域名开始。
  2. FQDN的选择需要遵循DNS的命名规范,可选的字符集是[A-Za-z0-9.]以及"-", 特别要注意,下划线(_)是不允许的。
  3. PAAS_FQDN CMDB_FQDN JOB_FQDN的值都必须在BK_DOMAIN定义的根域名之下,保证登陆鉴权的cookie文件有效。

ports.env

端口定义。 默认情况下, 不用修改。特殊场景下,若有端口冲突,可以自行定义。

非标准私有地址处理方法

蓝鲸社区版部署脚本中(install目录)下有以下文件中有获取 ip 的函数 get_lan_ip, 非标准地址, 均需要在安装部署前完成修改。

./appmgr/docker/saas/buildsaas
./appmgr/docker/build
./functions
./scripts/gse/server/gsectl
./scripts/gse/plugins/reload.sh
./scripts/gse/plugins/start.sh
./scripts/gse/plugins/stop.sh
./scripts/gse/agent/gsectl
./scripts/gse/proxy/gsectl
./scripts/gse/agentaix/gsectl.ksh
./agent_setup/download#agent_setup_pro.sh
./agent_setup/download#agent_setup_aix.ksh
./agent_setup/download#agent_setup.sh

这些文件列表,可能随版本迭代变动,也可以用以下命令查找出来包含这个函数的脚本文件有哪些:

grep -l 'get_lan_ip *()' -r /data/install

修改方法:

假设服务器的的ip是:138.x.x.x,它不在标准的私有地址范围,那么你需要修改get_lan_ip ()函数为:

get_lan_ip  () {
...省略
               if ($3 ~ /^10\./) {
                   print $3
               }
               if ($3 ~ /^138\./) {
                   print $3
               }
          }'

   return $?
}

pip.conf

在线安装时,依赖pip,需要配置可用的 pip 源。

vi src/.pip/pip.conf
  • 设置为能连上的 pip 源,默认的pip源配置通常无法使用,验证方式如下:
  • 在每台机器上对 pip.conf 中配置的url进行操作:curl http://xxxxxxx,若能正常返回列表信息则为成功。

获取证书

  1. 通过ifconfig或者ip addr命令获取install.config文件中,license和gse模块所在服务器的第一个内网网卡的MAC地址。如果分别属于两台服务器,那么两个的MAC地址以英文;分隔。
  2. 在官网证书生成页面根据输入框提示填入MAC地址,生成并下载证书。
  3. 上传证书到中控机,并解压到 src/cert 目录下

     tar xf ssl_certificates.tar.gz -C /data/src/cert/
    

配置 SSH 免密登陆

登录到中控机,执行以下操作

cd /data/install
bash configure_ssh_without_pass  # 根据提示输入各主机的 root 密码完成免密登陆配置

安装前校验环境是否满足

按文档要求做完环境和部署的配置后,准备开始安装前,请运行以下脚本,来校验是否满足:

cd /data/install
bash precheck.sh

正常输出如下图所示:

start <<check_ssh_nopass>> ... [OK]
start <<check_password>> ... [OK]
start <<check_cert_mac>> ... [OK]
start <<check_get_lan_ip>> ... [OK]
start <<check_install_config>> ... [OK]
start <<check_selinux>> ... [OK]
start <<check_umask>> ... [OK]
start <<check_rabbitmq_version>> ... [OK]
start <<check_http_proxy>> ... [OK]
start <<check_open_files_limit>> ... [OK]
start <<check_domain>> ... [OK]
start <<check_rsync>> ... [OK]
start <<check_service_dir>> ... [OK]
start <<check_networkmanager>> ... [OK]
start <<check_firewalld>> ... [OK]

如果发现有[FAIL]的报错,按照提示和本文档修复。修复后,可继续跑precheck.sh脚本,直到不再出现[FAIL]。如果需要从头开始检查,请使用 precheck.sh -r 参数。

Copyright © 腾讯蓝鲸 2012-2018 all right reserved,powered by Gitbook最后修订日期: 2019-08-06

results matching ""

    No results matching ""