快速入门指南

本指南将帮助您使用默认选项快速启动集群。该 安装部分 更详细地介绍了如何设置 K3s。

在继续之前，请确保您的节点满足 要求。

有关 K3s 组件如何协同工作的信息，请参阅 架构部分。

信息

Kubernetes 新手？官方 Kubernetes 文档已经提供了一些很棒的教程，概述了基础知识 在这里。

安装脚本

K3s 提供了一个安装脚本，它是一种便捷的方式，可以将 K3s 作为系统d 或 openrc 基于系统的服务安装。该脚本可在 https://get.k3s.io 获取。要使用此方法安装 K3s，只需运行

curl -sfL https://get.k3s.io | sh -

运行此安装后

• K3s 服务将被配置为在节点重启后或进程崩溃或被杀死后自动重启
• 将安装其他实用程序，包括 kubectl、crictl、ctr、k3s-killall.sh 和 k3s-uninstall.sh
• 一个 kubeconfig 文件将被写入 /etc/rancher/k3s/k3s.yaml，并且 K3s 安装的 kubectl 将自动使用它

单节点服务器安装是一个功能齐全的 Kubernetes 集群，包括托管工作负载 Pod 所需的所有数据存储、控制平面、kubelet 和容器运行时组件。没有必要添加额外的服务器或代理节点，但您可能希望这样做，以向您的集群添加额外的容量或冗余。

要安装额外的代理节点并将它们添加到集群，请使用 K3S_URL 和 K3S_TOKEN 环境变量运行安装脚本。以下示例展示了如何加入代理

curl -sfL https://get.k3s.io | K3S_URL=https://myserver:6443 K3S_TOKEN=mynodetoken sh -

设置 K3S_URL 参数会导致安装程序将 K3s 配置为代理，而不是服务器。K3s 代理将向在提供的 URL 上监听的 K3s 服务器注册。用于 K3S_TOKEN 的值存储在服务器节点上的 /var/lib/rancher/k3s/server/node-token 中。

注意

每台机器必须具有唯一的 hostname。如果您的机器没有唯一的 hostname，请传递 K3S_NODE_NAME 环境变量，并为每个节点提供一个具有有效且唯一 hostname 的值。

如果您有兴趣拥有更多服务器节点，请参阅 高可用性嵌入式 etcd 和 高可用性外部数据库 页面以了解更多信息。