中国大陆网络环境
⚠️ 本章只适用于中国大陆网络环境。 主机能直接访问
docker.io、registry.k8s.io、gcr.io(海外机房,或已经配好代理)时,整章跳过——拉取镜像与安装 Istio 都不需要任何额外配置。
← 文档索引 · 上一章:集群准备(MicroK8s) · 下一章:安装 Istio
大陆网络环境下装集群会遇到两类问题:镜像拉不下来(K8s 与 Istio 的组件镜像在 docker.io /
gcr.io 上),以及安装包下载不下来(GitHub releases、curl | sh)。本章分别处理,都用得到
的验证命令确认是否生效。
1. 先确认是否真的需要
sudo microk8s ctr images pull docker.io/library/nginx:alpine
curl -sI -m 10 https://registry.k8s.io/v2/ | head -1
两条命令都能在几秒内成功,说明网络是通的,直接回到安装 Istio。超时或长时间 没有输出,再继续往下读。
2. 给 containerd 配镜像加速
做法是给 containerd 配 hosts.toml,不需要重启 Docker,也不需要改每一条清单。
SNAP_DATA=/var/snap/microk8s/current
CERTS_DIR=${SNAP_DATA}/args/certs.d
sudo mkdir -p "${CERTS_DIR}"
先让 containerd 认识这个目录:
sudo microk8s stop
sudo cp ${SNAP_DATA}/args/containerd-template.toml ${SNAP_DATA}/args/containerd-template.toml.bak
grep -q 'config_path' ${SNAP_DATA}/args/containerd-template.toml \
|| sudo sed -i '/plugins.*registry\]$/a\ config_path = "'"${CERTS_DIR}"'"' ${SNAP_DATA}/args/containerd-template.toml
sudo microk8s start
不同 MicroK8s 版本模板里的段名不完全一样(
registry/registry.configs)。写完后一定grep config_path确认只有一条且指向certs.d;写重了 containerd 起不来,microk8s status会一直卡在waiting。
再给每个仓库写一份 hosts.toml(镜像源可替换,这里用兜底最多的组合):
write_mirror() {
local host=$1; shift
sudo mkdir -p "${CERTS_DIR}/${host}"
{ echo "server = \"https://${host}\""
for m in "$@"; do
printf '\n[host."%s"]\n capabilities = ["pull", "resolve"]\n' "$m"
done
} | sudo tee "${CERTS_DIR}/${host}/hosts.toml" > /dev/null
}
write_mirror docker.io \
https://docker.m.daocloud.io https://docker.mirrors.ustc.edu.cn https://mirror.baidubce.com
write_mirror registry.k8s.io https://k8s.m.daocloud.io https://registry.lank8s.cn
write_mirror gcr.io https://gcr.m.daocloud.io
write_mirror registry.istio.io https://gcr.m.daocloud.io
write_mirror quay.io https://quay.m.daocloud.io
write_mirror ghcr.io https://ghcr.m.daocloud.io
registry.istio.io实际是跳转到gcr.io后端存储的服务,所以它单独也要配——只配gcr.io不够,拉镜像时请求打的是registry.istio.io。
验证
注意 --hosts-dir,不加它 ctr 不会读这些配置:
sudo microk8s ctr images pull --hosts-dir ${CERTS_DIR} docker.io/library/nginx:alpine
sudo microk8s ctr images pull --hosts-dir ${CERTS_DIR} registry.k8s.io/pause:3.10
sudo microk8s ctr images rm docker.io/library/nginx:alpine
microk8s 升级后 current 软链会自动指向新版本,镜像源配置通常无需重做;如果升级后拉取又
失败,先看 certs.d 是否还在。
3. 安装 Istio:传包与镜像
两件事分开处理:
| 环节 | 大陆网络下的做法 |
|---|---|
| 安装包 | 在能访问 GitHub 的机器上下载 release 包,scp 到目标主机;不要依赖 curl | sh |
| 镜像 | 安装时加 --set hub=docker.io/istio,让镜像走 Docker Hub(即上一节的加速源) |
# 在有网的机器上下载:https://github.com/istio/istio/releases
scp istio-1.30.0-linux-amd64.tar.gz <用户>@<主机>:/root/
tar -xzf istio-1.30.0-linux-amd64.tar.gz
cd istio-1.30.0
export PATH=$PWD/bin:$PATH
安装前用带 --hosts-dir 的方式确认镜像能拉:
sudo microk8s ctr images pull --hosts-dir ${CERTS_DIR} docker.io/istio/pilot:1.30.0
之后按安装 Istio 第 2 节的命令安装即可。
4. 完全离线:内网 registry 或预导入
主机连镜像源都访问不了时,有两个做法:内网起一个 registry(Harbor,或最小化的 registry:2),
把镜像同步进去,再把 hosts.toml 里的 [host."..."] 换成内网地址;或者用 docker save 导出单张
镜像,再导入 MicroK8s 的 containerd:
# 联网机器上导出
docker save istio/pilot:1.30.0 -o pilot.tar
# 目标节点导入;MicroK8s 的镜像在 k8s.io 命名空间
sudo microk8s ctr --namespace k8s.io images import pilot.tar
sudo microk8s ctr --namespace k8s.io images ls | grep pilot
需要导入哪些镜像,按 服务与端口 与所安装的 Bundle 版本对齐;漏掉一张,
对应的 Pod 就是 ImagePullBackOff。