Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: update Kubernetes version and installation guide #38

Merged
merged 1 commit into from
Mar 24, 2025
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
32 changes: 15 additions & 17 deletions content/docs/k8s/quick-start/deploy-kubernetes.zh-cn.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -6,11 +6,11 @@ description: 使用Sealos快速部署Kubernetes集群,支持在线和离线安

Sealos 支持安装 `amd64` 和 `arm64` 架构的 K8s 集群。

## 先决条件
## 先决条件

首先需要[下载 Sealos 命令行工具](/developer-guide/lifecycle-management/quick-start/install-cli.md),sealos 是一个简单的 Golang 二进制文件,可以安装在大多数 Linux 操作系统中。
首先需要[下载 Sealos 命令行工具](./install-cli),sealos 是一个简单的 Golang 二进制文件,可以安装在大多数 Linux 操作系统中。

以下是一些基本的安装要求:
以下是一些基本的安装要求:

+ 每个集群节点应该有不同的主机名。主机名不要带下划线。
+ 所有节点的时间需要同步。
Expand All @@ -25,32 +25,30 @@ Sealos 支持安装 `amd64` 和 `arm64` 架构的 K8s 集群。

Sealos 所有的集群镜像都可以在 [cluster-image-docs](https://github.com/labring-actions/cluster-image-docs) 仓库里找到。除了推送到 Docker Hub 之外,这些镜像还被同步到了阿里云的镜像仓库。

Docker Hub 上可以通过以下链接查看 Sealos 所有的集群镜像:[https://hub.docker.com/u/labring](https://hub.docker.com/u/labring).
Docker Hub 上可以通过以下链接查看 Sealos 所有的集群镜像:[https://hub.docker.com/u/labring](https://hub.docker.com/u/labring)

使用 [Registry Explorer](https://explore.ggcr.dev/) 可以查看 K8s 集群镜像的所有版本,直接输入 `registry.cn-shanghai.aliyuncs.com/labring/kubernetes`,然后点击 “Submit Query”:
使用 [Registry Explorer](https://explore.ggcr.dev/) 可以查看 K8s 集群镜像的所有版本,直接输入 `registry.cn-shanghai.aliyuncs.com/labring/kubernetes`,然后点击“Submit Query”:

![](./images/registry-explorer.png)

就会看到这个集群镜像的所有 tag。

Docker Hub 同理,输入 `docker.io/labring/kubernetes` 即可查看所有 tag。

:::info注意

K8s 的小版本号越高,集群越稳定。例如 v1.28.x,其中的 x 就是小版本号。建议使用小版本号比较高的 K8s 版本。到本文截止时间为止,v1.27 最高的版本号是 v1.27.7,而 v1.28 最高的版本号是 v1.28.3,所以**建议使用 v1.27.7**。你需要根据实际情况来选择最佳的 K8s 版本

:::
<Callout type="warn">
K8s 的小版本号越高,集群越稳定。例如 v1.29.x,其中的 x 就是小版本号。建议使用小版本号比较高的 K8s 版本。到本文截止时间为止,v1.29 最高的版本号是 v1.29.9,而 v1.30 最高的版本号是 v1.30.5,所以**建议使用 v1.29.9**。你需要根据实际情况来选择最佳的 K8s 版本
</Callout>

## 安装 K8s 单机版

```shell
$ sealos run registry.cn-shanghai.aliyuncs.com/labring/kubernetes:v1.27.7 registry.cn-shanghai.aliyuncs.com/labring/helm:v3.9.4 registry.cn-shanghai.aliyuncs.com/labring/cilium:v1.13.4 --single
$ sealos run registry.cn-shanghai.aliyuncs.com/labring/kubernetes:v1.29.9 registry.cn-shanghai.aliyuncs.com/labring/helm:v3.9.4 registry.cn-shanghai.aliyuncs.com/labring/cilium:v1.13.4 --single
```

## 安装 K8s 集群

```shell
$ sealos run registry.cn-shanghai.aliyuncs.com/labring/kubernetes:v1.27.7 registry.cn-shanghai.aliyuncs.com/labring/helm:v3.9.4 registry.cn-shanghai.aliyuncs.com/labring/cilium:v1.13.4 \
$ sealos run registry.cn-shanghai.aliyuncs.com/labring/kubernetes:v1.29.9 registry.cn-shanghai.aliyuncs.com/labring/helm:v3.9.4 registry.cn-shanghai.aliyuncs.com/labring/cilium:v1.13.4 \
--masters 192.168.64.2,192.168.64.22,192.168.64.20 \
--nodes 192.168.64.21,192.168.64.19 -p [your-ssh-passwd]
```
Expand Down Expand Up @@ -121,13 +119,13 @@ $ sealos reset
首先在有网络的环境中导出集群镜像:

```shell
$ sealos pull registry.cn-shanghai.aliyuncs.com/labring/kubernetes:v1.27.7
$ sealos save -o kubernetes.tar registry.cn-shanghai.aliyuncs.com/labring/kubernetes:v1.27.7
$ sealos pull registry.cn-shanghai.aliyuncs.com/labring/kubernetes:v1.29.9
$ sealos save -o kubernetes.tar registry.cn-shanghai.aliyuncs.com/labring/kubernetes:v1.29.9
```

### 导入镜像并安装

将 kubernetes.tar 拷贝到离线环境, 使用 load 命令导入镜像即可:
将 kubernetes.tar 拷贝到离线环境使用 load 命令导入镜像即可:

```shell
$ sealos load -i kubernetes.tar
Expand All @@ -137,7 +135,7 @@ $ sealos load -i kubernetes.tar

```shell
$ sealos images # 查看集群镜像是否导入成功
$ sealos run registry.cn-shanghai.aliyuncs.com/labring/kubernetes:v1.27.7 # 单机安装,集群安装同理
$ sealos run registry.cn-shanghai.aliyuncs.com/labring/kubernetes:v1.29.9 # 单机安装,集群安装同理
```

### 快速启动 K8s 集群
Expand Down Expand Up @@ -187,4 +185,4 @@ $ sealos run kubernetes.tar # 单机安装,集群安装同理

## 总结

您可以根据自己的需求和偏好,在不同的镜像类型和版本中进行选择。同时,不要忘记查看 [更新日志](https://github.com/labring/sealos/blob/main/CHANGELOG/CHANGELOG.md),以了解各个版本的更新内容和修复问题。
您可以根据自己的需求和偏好,在不同的镜像类型和版本中进行选择。同时,不要忘记查看[更新日志](https://github.com/labring/sealos/blob/main/CHANGELOG/CHANGELOG.md),以了解各个版本的更新内容和修复问题。
17 changes: 14 additions & 3 deletions content/docs/k8s/quick-start/install-cli.zh-cn.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -18,11 +18,22 @@ $ curl --silent "https://api.github.com/repos/labring/sealos/releases" | jq -r '
$ VERSION=`curl -s https://api.github.com/repos/labring/sealos/releases/latest | grep -oE '"tag_name": "[^"]+"' | head -n1 | cut -d'"' -f4`
```

另外由于国内网络的特殊原因,访问 GitHub 可能会受限,建议先到以下几个网站寻找最新可用的 GitHub 代理:

- https://ghproxy.link/
- https://ghproxy.net/

找到可用的 GitHub 代理之后,将其设置为环境变量 `PROXY_PREFIX`,例如:

```bash
export PROXY_PREFIX=https://ghfast.top
```

## 二进制自动下载

```shell

$ curl -sfL https://mirror.ghproxy.com/https://raw.githubusercontent.com/labring/sealos/main/scripts/install.sh | PROXY_PREFIX=https://mirror.ghproxy.com sh -s ${VERSION} labring/sealos
$ curl -sfL ${PROXY_PREFIX}/https://raw.githubusercontent.com/labring/sealos/main/scripts/install.sh | PROXY_PREFIX=${PROXY_PREFIX} sh -s ${VERSION} labring/sealos

```

Expand All @@ -31,12 +42,12 @@ $ curl -sfL https://mirror.ghproxy.com/https://raw.githubusercontent.com/labring
<Tabs items={['amd64', 'arm64']}>

```bash tab="amd64"
$ wget https://mirror.ghproxy.com/https://github.com/labring/sealos/releases/download/${VERSION}/sealos_${VERSION#v}_linux_amd64.tar.gz \
$ wget ${PROXY_PREFIX}/https://github.com/labring/sealos/releases/download/${VERSION}/sealos_${VERSION#v}_linux_amd64.tar.gz \
&& tar zxvf sealos_${VERSION#v}_linux_amd64.tar.gz sealos && chmod +x sealos && mv sealos /usr/bin
```

```bash tab="arm64"
$ wget https://mirror.ghproxy.com/https://github.com/labring/sealos/releases/download/${VERSION}/sealos_${VERSION#v}_linux_arm64.tar.gz \
$ wget ${PROXY_PREFIX}/https://github.com/labring/sealos/releases/download/${VERSION}/sealos_${VERSION#v}_linux_arm64.tar.gz \
&& tar zxvf sealos_${VERSION#v}_linux_arm64.tar.gz sealos && chmod +x sealos && mv sealos /usr/bin
```
</Tabs>
Expand Down
2 changes: 0 additions & 2 deletions content/docs/msa/terms-of-service.zh-cn.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -2,8 +2,6 @@
title: Sealos 云服务服务协议
---

# Sealos 云服务服务协议

Sealos 云服务服务协议是您与珠海环界云计算有限公司 (以下简称“我们”或“本公司”) 之间就云服务 (以下简称“本服务”) 的使用等相关事项所订立的协议。请您仔细阅读并充分理解本协议各条款,特别是免除或者限制我们责任的条款、对您权益的限制条款、争议解决和法律适用条款等。如您不同意本协议任一内容,请勿注册或使用本服务。

**第 1 条服务内容**
Expand Down