feat: add configurable mirror source generators and version management

This commit is contained in:
2026-11-05 13:06:57 +08:00
parent 8fc4feb10d
commit 8ebf69bf0a
38 changed files with 1173 additions and 314 deletions
+16 -34
View File
@@ -1,72 +1,54 @@
本站镜像 Kubernetes 的版本化软件包仓库,可用于安装 `kubelet`、`kubeadm` 和 `kubectl`。容器镜像、容器运行时及集群网络插件需要另行配置。
本文以 `v1.35` 仓库为例。它是示例版本,不代表最新版本;已有集群应根据官方升级流程及版本偏差策略选择次版本,并在所有仓库地址中保持一致。修改软件源不会自动完成集群升级。
## 选择版本和软件包格式
## Debian / Ubuntu
先根据安装或升级计划确定 Kubernetes 次版本。已有集群需要遵守官方版本偏差策略;修改软件源不会自动完成集群升级。控件中的版本是本站已提供的仓库分支,不代表所有版本都仍处于官方支持期。
安装所需工具:
Debian、Ubuntu 选择 APT,RPM 系统选择 RPM。下面的公钥地址和软件源会一起随版本变化。
## 准备工具
APT 系统先安装工具:
```sh
sudo apt update
sudo apt install ca-certificates curl gpg
sudo install -d -m 0755 /etc/apt/keyrings
```
从 Kubernetes 官方仓库获取该通道的签名公钥。如果同名密钥文件已经存在,先核对、备份,再更新:
备份已有 Kubernetes 源文件和同名签名密钥文件,再按控件中的步骤配置。APT 显示的第一段命令导入官方公钥,第二段是需要保存的源文件内容;RPM 配置通过 `gpgkey` 指定对应的官方公钥。
```sh
curl -fsSL https://pkgs.k8s.io/core:/stable:/v1.35/deb/Release.key | sudo gpg --dearmor -o /etc/apt/keyrings/kubernetes-apt-keyring.gpg
sudo chmod 0644 /etc/apt/keyrings/kubernetes-apt-keyring.gpg
```mirror-config
{"type":"kubernetes"}
```
备份已有 `/etc/apt/sources.list.d/kubernetes.list`,然后写入:
## 刷新索引并安装
```text
deb [signed-by=/etc/apt/keyrings/kubernetes-apt-keyring.gpg] https://mirrors.app.itstudio.club/mirrors/kubernetes/core:/stable:/v1.35/deb/ /
```
更新索引并查看可安装版本:
APT 系统查看可安装版本:
```sh
sudo apt update
apt-cache madison kubeadm
```
新节点需要安装组件时,可执行:
新节点需要安装组件时:
```sh
sudo apt install kubelet kubeadm kubectl
sudo apt-mark hold kubelet kubeadm kubectl
```
已有集群请按升级指南逐个处理节点,不要直接套用新节点安装步骤。
## RPM 系统
备份已有 `/etc/yum.repos.d/kubernetes.repo`,配置为:
```ini
[kubernetes]
name=Kubernetes
baseurl=https://mirrors.app.itstudio.club/mirrors/kubernetes/core:/stable:/v1.35/rpm/
enabled=1
gpgcheck=1
gpgkey=https://pkgs.k8s.io/core:/stable:/v1.35/rpm/repodata/repomd.xml.key
exclude=kubelet kubeadm kubectl cri-tools kubernetes-cni
```
刷新缓存并查看版本:
RPM 系统查看可安装版本:
```sh
sudo dnf makecache
dnf --disableexcludes=kubernetes list --showduplicates kubeadm
```
新节点安装组件时使用 `sudo dnf install kubelet kubeadm kubectl --disableexcludes=kubernetes`。`exclude` 用于避免普通系统更新意外升级集群组件。
新节点安装使用 `sudo dnf install kubelet kubeadm kubectl --disableexcludes=kubernetes`。配置中的 `exclude` 避免普通系统更新意外升级集群组件。已有集群应按升级指南逐个处理节点。
## 检查地址
本站使用 `core:/stable:/v1.xx/` 目录布局,不使用旧的 `apt.kubernetes.io` 地址。其他版本请先查看 [仓库目录](/mirrors/kubernetes/core:/stable:/)是否已同步,并确认该版本仍符合项目的支持策略。
本站使用 `core:/stable:/v1.xx/` 目录布局,不使用旧的 `apt.kubernetes.io` 地址。其他版本请查看 [仓库目录](/mirrors/kubernetes/core:/stable:/),并确认对应分支已完成同步。
## 参考资料