本文档采用自动化机器翻译技术翻译。 尽管我们力求提供准确的译文,但不对翻译内容的完整性、准确性或可靠性作出任何保证。 若出现任何内容不一致情况,请以原始 英文 版本为准,且原始英文版本为权威文本。

快速入门指南

本指南将帮助您快速启动一个具有默认选项的集群。在继续之前,请确保您的节点满足要求

  • 有关安装和配置K3s的详细信息,请参阅安装页面。

  • 有关K3s组件如何协同工作的更多信息,请参阅架构页面。

  • 如果您是Kubernetes新手,https://kubernetes.io/docs/tutorials/kubernetes-basics/[官方Kubernetes文档]提供了很好的教程,涵盖所有集群管理员应熟悉的基础知识。

您可以使用在Prime Artifacts URL上列出的任何K3s Prime版本来获取这些步骤中提到的资产。要了解有关Prime Artifacts URL的更多信息,请参阅我们的https://scc.suse.com/rancher-docs/rancherprime/latest/en/reference-guide.html#prime-artifacts-url[仅限Prime的文档]。需要身份验证。使用您的https://scc.suse.com/home[SUSE 客户中心(SCC)]凭据登录。

安装脚本

SUSE® Rancher Prime: K3s提供了一个安装脚本,这是在基于systemd或openrc的系统上作为服务安装的便捷方式。该脚本可在https://get.k3s.io.获取。要使用此方法安装SUSE® Rancher Prime: K3s,请执行以下操作:

运行安装程序,其中`INSTALL_K3S_ARTIFACT_URL`是https://scc.suse.com/rancher-docs/rancherprime/latest/en/reference-guide.html#prime-artifacts-url[Prime Artifacts URL],INSTALL_K3S_CHANNEL`是您可以订阅的发布渠道,默认为`stable。在此示例中,`INSTALL_K3S_CHANNEL="latest"`为您提供SUSE® Rancher Prime: K3s的最新版本。

curl -sfL https://get.k3s.io | INSTALL_K3S_ARTIFACT_URL=<PRIME-ARTIFACTS-URL>/k3s INSTALL_K3S_CHANNEL="latest" sh -

如果您想指定一个版本,请设置`INSTALL_RKE2_VERSION`环境变量:

curl -sfL https://get.k3s.io/ | sudo INSTALL_K3S_ARTIFACT_URL=<PRIME-ARTIFACTS-URL>/k3s INSTALL_K3S_VERSION="<VERSION>" sh -

运行此安装后:

  • K3s服务将配置为在节点重启后或进程崩溃或被终止时自动重启。

  • 将安装其他实用程序,包括`kubectl`、crictlctrk3s-killall.sh`和`k3s-uninstall.sh

  • 一个 kubeconfig 文件将被写入到 /etc/rancher/k3s/k3s.yaml,由 SUSE® Rancher Prime: K3s 安装的 kubectl 将自动使用它

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

要安装额外的代理节点并将其添加到集群中,请使用 K3S_URLK3S_TOKEN 环境变量运行安装脚本。以下是一个示例,展示如何加入一个代理:

curl -sfL https://get.k3s.io | INSTALL_K3S_ARTIFACT_URL=<PRIME-ARTIFACTS-URL>/k3s K3S_URL=https://myserver:6443 K3S_TOKEN=mynodetoken sh -

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

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

如果您有兴趣拥有更多服务器节点,请查看 高可用性嵌入式 etcd高可用性外部数据库 页面以获取更多信息。