安装

介绍云联壹云产品的安装方法。

云联壹云 3.x版本不同于之前版本采用传统部署方法运行CentOS系统上,3.x版本采用基于 Kubernetes Operator技术部署运行在Kubernetes上,平台服务将支持容器化方式部署运行在Kubernetes集群中,天生具备了高可用,可弹性扩展的能力。

安装准备

获取安装包

请在产品官网的下载中心或联系销售人员获取 云联壹云 产品的DVD安装包。

配置要求

下表为不同场景需要部署的节点及配置要求等。请根据具体使用场景进行规划部署。

部署场景 部署组件 配置需求 资源占用情况 备注
多云场景 控制节点
  • 最低配置:8C16G500G(系统盘不低于200GB);
  • 服务器:支持部署在虚拟机或物理服务器;
  • 操作系统:推荐CentOS 7.6~7.8 Minimal;
  • 配置要求:每增加500台虚拟机,需要增加8C8G200G的系统资源;
  • 高可用要求:至少需要3台相同配置的服务器
  • 全部资源 待纳管的云账号具有读写权限的Access Key ID和Access Key Secret
    私有云场景 控制节点
  • 最低配置:8C16G500G(系统盘不低于200GB);
  • 服务器:支持部署在虚拟机或物理服务器;
  • 操作系统:推荐CentOS 7.6~7.8 Minimal;
  • 配置要求:每增加500台虚拟机,需要增加8C8G200G的系统资源;
  • 高可用要求:至少需要3台相同配置的服务器
  • 全部资源
    计算节点
  • 服务器:带硬件虚拟化特性的通用X86物理服务器;
  • 操作系统:推荐CentOS 7.6~7.8 Minimal;
  • 配置要求:CPU需开启VT、32G以上内存、1T以上的硬盘
  • 产品服务需占用2C2G200G的系统资源
  • 如使用经典网络则需为虚拟机申请网络可达的内网IP。
  • 如使用VPC网络则需要申请内网可达的IP地址段作为弹性公网IP
  • Ceph存储
  • 服务器:通用X86物理服务器;
  • 配置要求:至少32C64G、系统盘使用单独硬盘、数据盘配置4块以上大容量SATA硬盘,且支持直通模式
  • 网络:万兆及以上
  • 不占用资源
    物理机纳管
  • 控制节点
  • 启用Baremetal服务
  • 最低配置:8C16G500G(系统盘不低于200GB);
  • 服务器:支持部署在虚拟机或物理服务器;
  • 操作系统:推荐CentOS 7.6~7.8 Minimal;
  • 配置要求:每增加500台虚拟机,需要增加8C8G200G的系统资源;
  • 高可用要求:至少需要3台相同配置的服务器
  • 全部资源
    裸金属
  • 服务器:通用X86物理服务器;
  • 配置要求:具备IPMI管理功能;启用方式设置为BIOS PXE启动
  • 不占用资源
  • 为物理机单独申请网络可达的IPMI和内网IP子网
  • 若环境不支持DHCP Relay,则要求服务器支持Redfish
  • 安装组件介绍

    • Kubernetes集群由Master(Controlplane)节点和Node节点组成。其中一套Kubernetes集群上Controlplane节点的数量必须为1,3,5个,否则可能会有问题;Node节点数量任意。
    • 产品主要由Controller(控制节点)和Host(计算节点)组成。

    两者关系如下图所示,一台服务器在Kubernetes集群中属于Controlplane节点或Node节点之一,在 云联壹云 集群上既可以作为Controller也可以作为Host节点。服务器在Kubernetes集群和 云联壹云 集群上的角色可以任意搭配组合。

    最简组网举例

    根据上面的组件介绍,可以使用两台服务器搭建最简单的 云联壹云 环境。

    • 服务器说明:
      • 其中First Node服务器作为Kubernetes集群的Controlplane节点, 云联壹云 集群的Controller节点和Host节点;
      • Not First Node服务器作为Kubernetes集群的Node节点, 云联壹云 集群的Host节点。
    • 3.0版本支持离线安装,安装过程可以不访问互联网。但是后面部署过程从镜像市场导入镜像需要访问互联网。

    安装过程

    安装方式介绍

    根据用户服务器是否安装CentOS 7.x操作系统,使用DVD安装包安装 云联壹云 的方式有以下两种,推荐使用第一种。两种仅执行脚本的方式不同,安装配置内容相同。

    • DVD安装:当用户使用未安装操作系统的服务器时,可以直接挂载下载的DVD安装包,安装CentOS以及 云联壹云 。
    • 脚本安装:用户使用已安装CentOS 7.x操作系统的服务器,挂载安装包后可使用里面的install脚本安装 云联壹云 。

    DVD安装

    DVD安装方式会先在服务器上安装CentOS操作系统,安装完成后将会自动执行 云联壹云 安装脚本。

    1. 在服务器上挂载DVD安装包,并启动服务器。
      • 若需要在物理机上安装,需要将在官网下载的DVD格式的ISO安装包刻录为DVD光盘或U盘启动镜像。
        • 若刻录为DVD光盘,请将物理服务器上将BIOS中的boot方式设置为CD-ROM对应的介质。
        • 若制作U盘启动镜像,请将物理服务器上将BIOS中的boot方式设置为USB设备对应的介质。
      • 若在虚拟机上安装,可以直接将DVD格式的ISO安装包挂载到虚拟机的虚拟光驱上,设置虚拟机的启动方式为光驱即可。
    2. CentOS系统安装过程中支持配置以下参数,也可保持默认值,直接开始安装CentOS系统。

      • LANGUAGE(必选):选择CentOS 7操作系统语言,默认English即可,单击\ “Continue” 按钮。

      • KEYBOARD(必选):选择键盘布局。设置完成后,如磁盘、网络等无特殊要求,建议保持默认,直接单击\ “Begin Installation” 按钮,开始安装CentOS系统。

      • INSTALLATION DESTIONATION(可选):设置磁盘分区,如无特殊需求,建议保持默认。也可根据需求划分磁盘分区等。

      • NETWORK&HOST NAME(可选):设置网络和主机名,如无特殊需求,可保持默认。

    3. CentOS系统安装过程中,需要设置root用户密码或新建用户。推荐设置root用户密码。

    4. 等待操作系统安装完成后,自动运行安装脚本,进入安装配置页面。请按照安装配置内容进行配置。

    脚本安装

    当在已安装CentOS的服务器上执行脚本安装产品,需要确保服务器已已关闭selinux,且重启过服务器。若selinux未关闭,请按下面的步骤关闭selinux,并重启服务器。

    # 关闭 selinux
    $ setenforce  0
    $ sed -i 's/SELINUX=enforcing/SELINUX=disabled/' /etc/selinux/config

    在CentOS 7.x服务器上执行脚本方式如下:

    1. 以root用户远程连接CentOS服务器,将DVD安装包上传到服务器。
    1. 上传完成后,将安装包以硬盘分区的形式挂载到mnt目录上,进入mnt/yunion目录,并执行目录下的./install.sh脚本文件,进入安装配置页面。请按照安装配置内容进行配置。

      # 请以从官网下载的安装包名称为准
      $ mount -o loop Yunion-x86_64-DVD-3.0.0-20200108.0.iso /mnt  
      $ cd /mnt/yunion
      $ ./install.sh

    安装配置

    配置内容根据服务器是否为First Node以及安装的组件不同略有不同。

    配置页面常用操作说明:

    • enter键:enter键用于确认选择按钮。
    • 空格键:选中子菜单后也可按空格键进入子菜单配置页面;空格键还可以选中或取消选择具体配置项。
    • 上下方向键:用于切换上下菜单和配置项。
    • Tab键或左右方向键:用于切换底侧“Select”、“OK”和“Help”按钮,按enter键确认选择。

    First Node服务器

    1. 在安装配置页面,如果服务器有多块网卡,需要选择作为管理网的网卡。

    2. 保持默认勾选“First Node”和“Enable Host Agent”不变,如数据库没有其它要求,也可以保持默认勾选。

    3. 如果使用已有数据库,需要通过上下方向键将光标移动到“Install MySQL on Current host”,按空格键取消勾选该项后,并配置Connect MySql的信息。

      • MySQL Host IP:MySQL服务器的IP地址;
      • MySQL Port Number:MySQL服务器的端口号。
      • MySQL Username:连接MySQL服务器的用户名,推荐使用root用户,如果使用其他用户,还需要为用户授权。

        GRANT ALL PRIVILEGES ON * . * TO '<USERNAME>'@'%' WITH GRANT OPTION;
        GRANT ALL PRIVILEGES ON * . * TO '<USERNAME>'@'localhost' WITH GRANT OPTION;
      • MySQL Password:连接MySQL服务器的用户密码。

    4. 本例选择将数据库安装在当前主机上,在安装配置页面将光标选中”OK“按钮,按enter键,在弹出的保存配置对话框中光标选中”Yes”,并按enter键确认选择,开始安装。

    5. 安装过程较长,请耐心等待,直到安装完成。

    6. 在服务器中执行source ~/.bashrc命令加载kubernetes的环境变量,加载完成后,用户可通过kubectl相关命令管理 云联壹云 的系统组件等。

      # 查看K8s节点
      $ kubectl get node
      # 查看组件pod的运行状态,runing表示正常运行
      $ kubectl get pod --namespace onecloud 
    7. 在浏览器中输入https://服务器IP地址,即可打开 云联壹云 平台,进行初始化引导操作

    Not First Node服务器

    本次部署在Not First Node服务器上部署K8s node节点以及host节点。

    1. 在安装配置页面,按空格键取消勾选“First Node”,Role of K8S默认为“K8s Node”;roles默认为“Enable Host Agent”。可根据需求更改角色,本例不修改,直接保持默认。

    2. 配置First Node IP为上一章节配置的First Node的服务器IP地址。

    3. 配置Join Token为在First Node服务器上获取的Token值。

    1. 配置完成后将光标选中”OK“按钮,按enter键,在弹出的保存配置对话框中光标选中”Yes”,并按enter键确认选择,开始安装。

    2. 安装过程较长,请耐心等待,直到安装完成。

    3. 以root用户ssh远程登录服务器,至此host节点部署完成。

    4. 用户部署完成后,可在 云联壹云 平台宿主机页面中查看到host节点。宿主机注册到云管平台上后默认为禁用状态,需要在界面上启用宿主机,启用状态的宿主机可以用于创建虚拟机。

    启用Baremetal服务

    云联壹云 平台安装完成后默认禁用Baremetal服务。Baremetal服务提供PXE Server、DHCP、TFTP、http等功能,用于完成纳管物理机操作并管理物理机。

    用户可以按照下面命令在 云联壹云 环境中的任意节点上启用Baremetal服务。

    1. 通过SSH等以root用户登录到First Node节点。
    2. 执行以下命令。其中$node_name是节点的名称;$listen-interface是baremetal-agent监听的网卡名称。

      # 在指定节点上启用Baremetal服务并监听网卡
      $ ocadm baremetal enable --node $node_name --listen-interface $listen_interface
      # 禁用Baremetal服务
      $ ocadm baremetal disable --node $node_name
      # 如在node1主机上启用baremetal服务,并监听br0网卡。
      $ ocadm baremetal enable --node node1 --listen-interface br0
    3. Baremetal服务启用后,可通过以下命令查看baremetal-agent是否注册到控制节点上。

      $ kubectl get pods --namespace onecloud | grep baremetal
      default-baremetal-agent-fb5d4b5f7-2ld8v          1/1     Running     0          15m
    4. 纳管物理机的预注册以及pxe引导注册方式需要配合DHCP Relay使用,即Baremetal-agent只会处理DHCP Relay服务器的请求,所以还需要用户事先在交换机配置DHCP Relay或者使用Host服务的DHCP Relay功能。

      # 登录到所有已经部署好计算节点的服务器上修改 /etc/yunion/host.conf,添加 dhcp_relay 配置项:
      dhcp_relay:
      - 10.168.222.198 # baremetal agent dhcp服务监听地址
      - 67             # baremetal agent dhcp服务监听端口
      
      # 查看host服务对应pod
      $ kubectl get pods -n onecloud -o wide | grep host
      default-host-p6d8h                       2/2     Running   0          78m    10.168.222.189   k8s-dev1   <none>           <none>
      default-host-xdc7x                       2/2     Running   0          78m    10.168.222.150   k8s-dev2   <none>           <none>
      # 删除host服务pod,重启host服务
      $ kubectl delete pods -n onecloud default-host-p6d8h default-host-xdc7x

    工单组件管理

    云联壹云 系统默认启用流程工单(itsm)组件,管理员可以在First Node节点上对工单组件进行管理。

    工单组件管理命令如下:

    # 启用工单组件
    $ ocadm component enable itsm
    # 禁用工单组件。
    $ ocadm component disable itsm