title: 介绍 description: 安装 Rancher 的方式有两种：单节点安装和高可用集群安装。因为单节点安装只适用于测试和 demo 环境，而且单节点安装和高可用集群安装之间不能进行数据迁移，所以我们推荐从一开始就使用高可用集群安装的方式安装 Rancher。本文将详细介绍高可用集群安装的配置方式。如果您仍然准备在单节点上安装 Rancher，本文只有分开部署 Rancher 与下游集群的部分适用于单节点安装。 keywords:

  • rancher
  • rancher中文
  • rancher中文文档
  • rancher官网
  • rancher文档
  • Rancher
  • rancher 中文
  • rancher 中文文档
  • rancher cn
  • 系统工具

概述

系统工具是 Rancher 自带的运维工具，您可以使用系统工具管理RKE 集群和高可用集群。系统工具提供了logs、stats和remove三类指令，分别对应以下三种用途：

下载系统工具

您可以从GitHub下载最新版的系统工具，下载时请根据您的操作系统选择对应的版本。

操作系统 文件名称
MacOS system-tools_darwin-amd64
Linux system-tools_linux-amd64
Windows system-tools_windows-amd64.exe

完成下载后，请完成以下步骤：

  1. 重命名您下载的系统工具文件为system-tools。

  2. 执行以下命令，对system-tools文件开放执行权限。

    说明 如果系统工具已经是可执行文件，可以跳过此步骤。

    1. chmod +x system-tools

收集 Kubernetes 日志

指令介绍

收集 Kubernetes 日志的命令logs，它的用途是收集 RKE 集群和高可用集群节点中，核心 Kubernetes 组件的日志文件。请参考常见故障排查，查看核心 Kubernetes 组件的列表。

系统工具使用 kubeconfig 文件部署 DaemonSet。这个 DaemonSet 的作用是将核心 Kubernetes 组件的所有日志文件复制一遍后，打包成一个 tar 文件（默认文件名称是cluster-logs.tar）。如果您需要收集单节点的日志，您可以在命令中指定节点，例如--node NODENAME和 -n NODENAME，将NODENAME替换为节点名称后，可以指定单个节点，只收集该节点的日志。

使用方法

  1. ./system-tools_darwin-amd64 logs --kubeconfig <KUBECONFIG>

logs指令有以下几种选项和使用方式：

选项 描述
--kubeconfig <KUBECONFIG_PATH>, -c <KUBECONFIG_PATH> 集群 kubeconfig 文件的路径
--output <FILENAME>, -o cluster-logs.tar 系统工具 DaemonSet 打包的文件名称，默认文件名称是cluster-logs.tar ，您也可以修改为其他名称。
--node <NODENAME>, -n node1 收集日志的节点范围。把 NODENAME 修改为节点名称后，您可以指定收集某一个节点的日志。如果没有指定节点，则默认收集该集群中全部节点的日志。

查看节点系统指标

指令介绍

查看节点系统指标的命令stats，它的用途是查看RKE 集群和高可用集群中，节点的系统指标。

系统工具部署的 DaemonSet，会运行基于sar（System Activity Report）的预先定义好的指令，收集和显示系统指标。

使用方法

  1. ./system-tools_darwin-amd64 stats --kubeconfig <KUBECONFIG>

stats指令有以下几种选项和使用方式：

选项 描述
--kubeconfig <KUBECONFIG_PATH>, -c <KUBECONFIG_PATH> 集群 kubeconfig 文件的路径。
--node <NODENAME>, -n node1 收集系统指标的节点范围。把 NODENAME 修改为节点名称后，您可以指定收集某一个节点的系统指标。如果没有指定节点，则默认收集该集群中全部节点的系统指标。
--stats-command value, -s value 触发系统工具，显示系统参数的命令，默认命令是/usr/bin/sar -u -r -F 1 1。

移除 Kubernetes 资源

指令介绍

警告： 这条命令会从 etcd 中移除数据。执行这条命令前，请检查是否已经完成etcd 节点备份。

当您在 Kubernetes 集群中安装 Rancher 的时候，Rancher 会创建 Kubernetes 资源，用于运行 Rancher Server 和配置存储。如果您需要删除集群中的 Rancher，您可以使用remove命令，移除 Kubernetes 资源。执行remove命令会移除以下资源：

  • Rancher 部署的命名空间，默认名称是cattle-system。

  • Rancher 通过cattle.io/creator:norman标签标记的serviceAccount、 clusterRoles和clusterRoleBindings。使用 Rancher v2.1.0 或更新版本创建的所有及资源都会被打上cattle.io/creator:norman的标签。

  • 标签、备注和 finalizers。
  • Rancher Deployment。
  • 机器、集群、项目和用户相关的 CRD。
  • management.cattle.io API Group 内创建的所有资源。
  • 使用 Rancher v2.x 创建的所有 CRD。

说明： 如果您使用的2.0.8或之前的版本，执行remove命令后需要手动删除serviceAccount、clusterRole和clusterRoleBindings 资源。

使用方法

执行remove 命名后，会从集群中移除上述的所有资源。

警告： 这条命令会从 etcd 中移除数据。执行这条命令前，请检查是否已经完成etcd 节点备份

  1. ./system-tools remove --kubeconfig <KUBECONFIG> --namespace <NAMESPACE>

remove指令有以下几种选项和使用方式：

选项 描述
--kubeconfig <KUBECONFIG_PATH>, -c <KUBECONFIG_PATH> 集群 kubeconfig 文件的路径。
--namespace <NAMESPACE>, -n cattle-system Rancher 2.x 部署的命名空间，如果没有指定命名空间，默认是cattle-system。
--force 跳过确认信息，强制执行移除命令。