作者简介

王海龙，Rancher中国社区技术经理，负责Rancher中国技术社区的维护和运营。拥有6年的云计算领域经验，经历了OpenStack到Kubernetes的技术变革，无论底层操作系统Linux，还是虚拟化KVM或是Docker容器技术都有丰富的运维和实践经验。

前 言

K3s 是一个轻量级的 Kubernetes 发行版，在 2020 年统计的 K3s 下载量中，K3s 的全球下载量已经超过 100 万次，每周平均被安装超过 2 万次，其中 30%的下载量来自于中国。在国内已经有许多用户将 K3s 应用到了各种边缘计算和物联网设备中，同时也被广泛应用于智能工厂部署的生产线机器人和一些世界上最大型的风力发电厂当中。

针对生产环境下的 K3s，一个不可逾越的问题就是离线安装。在你的离线环境需要准备以下 3 个组件：

  • K3s 的安装脚本

  • K3s 的二进制文件

  • K3s 依赖的镜像

以上三个组件都可以通过K3s Release页面（https://github.com/k3s-io/k3s/releases ）下载，如果在国内使用，推荐从 http://mirror.cnrancher.com 获得这些组件。

笔者认为离线安装的重点在于K3s 依赖的镜像部分，因为 K3s 的"安装脚本"和"二进制文件"只需要下载到对应目录，然后赋予相应的权限即可，非常简单。但K3s 依赖的镜像的安装方式取决于你使用的是手动部署镜像还是私有镜像仓库，也取决于容器运行时使用的是containerd还是docker。

针对不同的组合形式，可以分为以下几种形式来实现离线安装：

  • Containerd + 手动部署镜像方式

  • Docker + 手动部署镜像方式

  • Containerd + 私有镜像仓库方式

  • Docker + 私有镜像仓库方式

Containerd + 手动部署镜像方式

假设你已经将同一版本的 K3s 的安装脚本(k3s-install.sh)、K3s 的二进制文件(k3s)、K3s 依赖的镜像(k3s-airgap-images-amd64.tar)下载到了/root目录下。

如果你使用的容器运行时为containerd，在启动 K3s 时，它会检查/var/lib/rancher/k3s/agent/images/是否存在可用的镜像压缩包，如果存在，就将该镜像导入到containerd 镜像列表中。所以我们只需要下载 K3s 依赖的镜像到/var/lib/rancher/k3s/agent/images/目录，然后启动 K3s 即可。

1、导入镜像到 containerd 镜像列表

sudo mkdir -p /var/lib/rancher/k3s/agent/images/

sudo cp /root/k3s-airgap-images-amd64.tar /var/lib/rancher/k3s/agent/images/

2、将 K3s 安装脚本和 K3s 二进制文件移动到对应目录并授予可执行权限

sudo chmod a+x /root/k3s /root/k3s-install.sh

sudo cp /root/k3s /usr/local/bin/

3、安装 K3s

INSTALL_K3S_SKIP_DOWNLOAD=true /root/k3s-install.sh

稍等片刻，即可查看到 K3s 已经成功启动：

root@k3s-docker:~# crictl images

IMAGE                                      TAG                 IMAGE ID            SIZE

docker.io/rancher/coredns-coredns          1.8.0               296a6d5035e2d       42.6MB

docker.io/rancher/klipper-helm             v0.3.2              4be09ab862d40       146MB

docker.io/rancher/klipper-lb               v0.1.2              897ce3c5fc8ff       6.46MB

docker.io/rancher/library-busybox          1.31.1              1c35c44120825       1.44MB

docker.io/rancher/library-traefik          1.7.19              aa764f7db3051       86.6MB

docker.io/rancher/local-path-provisioner   v0.0.14             e422121c9c5f9       42MB

docker.io/rancher/metrics-server           v0.3.6              9dd718864ce61       41.2MB

docker.io/rancher/pause                    3.1                 da86e6ba6ca19       746kB

root@k3s-docker:~# kubectl get pods -A

NAMESPACE     NAME                                      READY   STATUS      RESTARTS   AGE

kube-system   local-path-provisioner-7c458769fb-zdg9z   1/1     Running     0          38s

kube-system   coredns-854c77959c-696gk                  1/1     Running     0          38s

kube-system   metrics-server-86cbb8457f-hs6vw           1/1     Running     0          38s

kube-system   helm-install-traefik-4pgcr                0/1     Completed   0          38s

kube-system   svclb-traefik-bq7wl                       2/2     Running     0          17s

kube-system   traefik-6f9cbd9bd4-jccd7                  1/1     Running     0          17s

Docker + 手动部署镜像方式

假设你已经将同一版本的 K3s 的安装脚本(k3s-install.sh)、K3s 的二进制文件(k3s)、K3s 依赖的镜像(k3s-airgap-images-amd64.tar)下载到了/root目录下。

与 containerd 不同，使用 docker 作为容器运行时，启动 K3s 不会导入/var/lib/rancher/k3s/agent/images/目录下的镜像。所以在启动 K3s 之前我们需要将 K3s 依赖的镜像手动导入到 docker 镜像列表中。

1、导入镜像到 docker 镜像列表

sudo docker load -i /root/k3s-airgap-images-amd64.tar

2、将 K3s 安装脚本和 K3s 二进制文件移动到对应目录并授予可执行权限

sudo chmod a+x /root/k3s /root/k3s-install.sh

sudo cp /root/k3s /usr/local/bin/

3、安装 K3s

INSTALL_K3S_SKIP_DOWNLOAD=true INSTALL_K3S_EXEC='--docker' /root/k3s-install.sh

稍等片刻，即可查看到 K3s 已经成功启动：

root@k3s-docker:~# docker images

REPOSITORY                       TAG                 IMAGE ID            CREATED             SIZE

rancher/klipper-helm             v0.3.2              4be09ab862d4        7 weeks ago         145MB

rancher/coredns-coredns          1.8.0               296a6d5035e2        2 months ago        42.5MB

rancher/library-busybox          1.31.1              1c35c4412082        7 months ago        1.22MB

rancher/local-path-provisioner   v0.0.14             e422121c9c5f        7 months ago        41.7MB

rancher/library-traefik          1.7.19              aa764f7db305        14 months ago       85.7MB

rancher/metrics-server           v0.3.6              9dd718864ce6        14 months ago       39.9MB

rancher/klipper-lb               v0.1.2              897ce3c5fc8f        19 months ago       6.1MB

rancher/pause                    3.1                 da86e6ba6ca1        3 years ago         742kB

root@k3s-docker:~# kubectl get pods -A

NAMESPACE     NAME                                      READY   STATUS      RESTARTS   AGE

kube-system   metrics-server-86cbb8457f-8ckr6           1/1     Running     0          30s

kube-system   local-path-provisioner-7c458769fb-vhkjr   1/1     Running     0          30s

kube-system   helm-install-traefik-4b46c                0/1     Completed   0          31s

kube-system   coredns-854c77959c-4ql8t                  1/1     Running     0          30s

kube-system   svclb-traefik-kbtbx                       2/2     Running     0          27s

kube-system   traefik-6f9cbd9bd4-rbm6k                  1/1     Running     0          27s

Containerd + 私有镜像仓库方式

假设你已经将同一版本的 K3s 的安装脚本(k3s-install.sh)、K3s 的二进制文件(k3s)下载到了/root目录下。并且 K3s 所需要的镜像已经上传到了镜像仓库（本例的镜像仓库地址为：http://192.168.64.44:5000）。K3s 所需的镜像列表可以从 K3s Release页面的k3s-images.txt获得。

1、配置 K3s 镜像仓库

启动 K3s 默认会从docker.io拉取镜像。使用containerd容器运行时在离线安装时，我们只需要将镜像仓库地址配置到docker.io下的endpoint即可，更多配置说明请参考配置 containerd 镜像仓库完全攻略或K3s 官方文档：

https://docs.rancher.cn/docs/k3s/installation/private-registry/_index/

sudo mkdir -p /etc/rancher/k3s

sudo cat >> /etc/rancher/k3s/registries.yaml <<EOF

mirrors:

  "docker.io":

    endpoint:

      - "http://192.168.64.44:5000"

      - "https://registry-1.docker.io"

EOF

2、将 K3s 安装脚本和 K3s 二进制文件移动到对应目录并授予可执行权限

sudo chmod a+x /root/k3s /root/k3s-install.sh

sudo cp /root/k3s /usr/local/bin/

3、安装 K3s

INSTALL_K3S_SKIP_DOWNLOAD=true /root/k3s-install.sh

稍等片刻，即可查看到 K3s 已经成功启动：

root@k3s-containerd:~# crictl images

IMAGE                                      TAG                 IMAGE ID            SIZE

docker.io/rancher/coredns-coredns          1.8.0               296a6d5035e2d       12.9MB

docker.io/rancher/klipper-helm             v0.3.2              4be09ab862d40       50.7MB

docker.io/rancher/klipper-lb               v0.1.2              897ce3c5fc8ff       2.71MB

docker.io/rancher/library-traefik          1.7.19              aa764f7db3051       24MB

docker.io/rancher/local-path-provisioner   v0.0.14             e422121c9c5f9       13.4MB

docker.io/rancher/metrics-server           v0.3.6              9dd718864ce61       10.5MB

docker.io/rancher/pause                    3.1                 da86e6ba6ca19       326kB

root@k3s-containerd:~# kubectl get pods -A

NAMESPACE     NAME                                      READY   STATUS      RESTARTS   AGE

kube-system   local-path-provisioner-7c458769fb-7w8hb   1/1     Running     0          37s

kube-system   coredns-854c77959c-f8m2n                  1/1     Running     0          37s

kube-system   helm-install-traefik-9lbrx                0/1     Completed   0          38s

kube-system   svclb-traefik-x8f6f                       2/2     Running     0          29s

kube-system   metrics-server-86cbb8457f-f7lb7           1/1     Running     0          37s

kube-system   traefik-6f9cbd9bd4-4s66r                  1/1     Running     0          29s

Docker + 私有镜像仓库方式

假设你已经将同一版本的 K3s 的安装脚本(k3s-install.sh)、K3s 的二进制文件(k3s)下载到了/root目录下。并且 K3s 所需要的镜像已经上传到了镜像仓库（本例的镜像仓库地址为：http://192.168.64.44:5000）。K3s 所需的镜像列表可以从 K3s Release页面的k3s-images.txt获得。

1、配置 K3s 镜像仓库

Docker 不支持像 containerd 那样可以通过修改 docker.io 对应的 endpoint（默认为 https://registry-1.docker.io）来间接修改默认镜像仓库的地址。但在Docker中可以通过配置registry-mirrors来实现从其他镜像仓库中获取K3s镜像。这样配置之后，会先从registry-mirrors配置的地址拉取镜像，如果获取不到才会从默认的docker.io获取镜像，从而满足了我们的需求。

cat >> /etc/docker/daemon.json <<EOF

{

    "registry-mirrors": ["http://192.168.64.44:5000"]

}

EOF

sudo systemctl daemon-reload

sudo systemctl restart docker

2、将 K3s 安装脚本和 K3s 二进制文件移动到对应目录并授予可执行权限

sudo chmod a+x /root/k3s /root/k3s-install.sh

sudo cp /root/k3s /usr/local/bin/

3、安装 K3s

INSTALL_K3S_SKIP_DOWNLOAD=true INSTALL_K3S_EXEC='--docker' /root/k3s-install.sh

稍等片刻，即可查看到 K3s 已经成功启动：

root@k3s-docker:~# docker images

REPOSITORY                       TAG                 IMAGE ID            CREATED             SIZE

rancher/klipper-helm             v0.3.2              4be09ab862d4        7 weeks ago         145MB

rancher/coredns-coredns          1.8.0               296a6d5035e2        2 months ago        42.5MB

rancher/local-path-provisioner   v0.0.14             e422121c9c5f        7 months ago        41.7MB

rancher/library-traefik          1.7.19              aa764f7db305        14 months ago       85.7MB

rancher/metrics-server           v0.3.6              9dd718864ce6        14 months ago       39.9MB

rancher/klipper-lb               v0.1.2              897ce3c5fc8f        19 months ago       6.1MB

rancher/pause                    3.1                 da86e6ba6ca1        3 years ago         742kB

root@k3s-docker:~# kubectl get pods -A

NAMESPACE     NAME                                      READY   STATUS      RESTARTS   AGE

kube-system   helm-install-traefik-bcclh                0/1     Completed   0          33s

kube-system   coredns-854c77959c-kp85f                  1/1     Running     0          33s

kube-system   metrics-server-86cbb8457f-85fpd           1/1     Running     0          33s

kube-system   local-path-provisioner-7c458769fb-r5nkw   1/1     Running     0          33s

kube-system   svclb-traefik-rbmhk                       2/2     Running     0          24s

kube-system   traefik-6f9cbd9bd4-k6t9n                  1/1     Running     0          24s

后 记

手动部署镜像方式比较适合小规模安装、节点数量不多的场景。私有镜像仓库比较适合规模比较大节点数比较多的集群。本文的docker registry采用的是最简单的搭建方式docker run -d -p 5000:5000 --restart=always --name registry registry:2，可能在你的环境中由于镜像仓库的搭建方式不同，你可能需要修改一些关于registry的参数。

参考资料

K3s离线安装文档：

https://docs.rancher.cn/docs/k3s/installation/airgap/_index/

一文搞定全场景K3s离线安装的更多相关文章

  1. 一文搞定 SonarQube 接入 C#(.NET) 代码质量分析

    1. 前言 C#语言接入Sonar代码静态扫描相较于Java.Python来说,相对麻烦一些.Sonar检测C#代码时需要预先编译,而且C#代码必须用MSbuid进行编译,如果需要使用SonarQub ...

  2. 一文搞定Spring Boot + Vue 项目在Linux Mysql环境的部署（强烈建议收藏）

    本文介绍Spring Boot.Vue .Vue Element编写的项目,在Linux下的部署,系统采用Mysql数据库.按照本文进行项目部署,不迷路. 1. 前言 典型的软件开发,经过" ...

  3. 一文搞定MySQL的事务和隔离级别

    一.事务简介 事务是数据库管理系统执行过程中的一个逻辑单位,由一个有限的数据库操作序列构成. 一个数据库事务通常包含了一个序列的对数据库的读/写操作.它的存在包含有以下两个目的: 为数据库操作序列提供 ...

  4. 一文搞定scrapy爬取众多知名技术博客文章保存到本地数据库，包含：cnblog、csdn、51cto、itpub、jobbole、oschina等

    本文旨在通过爬取一系列博客网站技术文章的实践,介绍一下scrapy这个python语言中强大的整站爬虫框架的使用.各位童鞋可不要用来干坏事哦,这些技术博客平台也是为了让我们大家更方便的交流.学习.提高 ...

  5. 一文搞定Redis五大数据类型及应用场景

    本文学习知识点 redis五大数据类型数据类型:string.hash.list.set.sorted_set 五大类型各自的应用场景 @TOC 1. string类型 1-1 string类型数据的 ...

  6. 一文搞定 Mybatis 的应用

    Mybatis 介绍 Mybatis 是一个开源的持久层框架,原来叫 ibatis ,它对 jdbc 操作数据库的过程进行了封装,使开发者只需要关注 SQL 本身,而不需要花费精力去处理例如注册驱动. ...

  7. 21.SpringCloud实战项目-后台题目类型功能（网关、跨域、路由问题一文搞定）

    SpringCloud实战项目全套学习教程连载中 PassJava 学习教程 简介 PassJava-Learning项目是PassJava(佳必过)项目的学习教程.对架构.业务.技术要点进行讲解. ...

  8. JDK8 一文搞定👍

    ! https://zhuanlan.zhihu.com/p/442182870 Java8 新特性 学习来源于 B站 尚硅谷yyds Java学习源码 2021/11/22 距离,过年还有 57 天 ...

  9. 一文搞定FastDFS分布式文件系统配置与部署

    Ubuntu下FastDFS分布式文件系统配置与部署 白宁超 2017年4月15日09:11:52 摘要: FastDFS是一个开源的轻量级分布式文件系统,功能包括:文件存储.文件同步.文件访问(文件 ...

随机推荐

  1. 给小白整理的一篇Python知识点

    1.基本概念 1.1 四种类型 python中数有四种类型:整数.长整数.浮点数和复数. python中数有四种类型:整数.长整数.浮点数和复数. 整数, 如 1 长整数 是比较大的整数 浮点数 如 ...

  2. 制作3D小汽车游戏（上）

    之前一段时间家里和公司的事太多,一直没有时间写博客,最近腾出一段时间,看了一遍官方的examples,收货颇多,想整理一点东西出来,又苦于没有好的东西,three写点东西真是太难了.好吧,今天郭先生就 ...

  3. MySQL 触发器、存储过程 练习

    创建表并插入数据: ```        字段名 数据类型 主键 外键 非空 唯一 自增        id INT    是 否 是  是 否        name VARCHAR(50) 否 否 ...

  4. .net core 3.1 过滤器(Filter) 与中间件与AOP面向切面 与拦截器及其应用

    Filter(过滤器) 总共有五种,Authorization Filter,Resource Filter,Exception Filter,Action Filter,Result Filter ...

  5. mybatis实现MySQL数据库的增删改查

    环境: jdk1.8 mysql5.7 maven3.6.0 IDEA 什么是mybatis框架? MyBatis 是一款优秀的持久层框架, 它支持自定义 SQL.存储过程以及高级映射. MyBati ...

  6. 记 CentOS 服务器上安装 neo4j 图数据库及本地访问

    下载 去官网下载压缩包放到服务器上.地址为neo4j 下载中心,我这里选择的是 Neo4j 3.5.25 (tar).具体如何做呢?我这里使用的是土方法,即先压缩包下载到本地电脑(win 10系统), ...

  7. JQuery特点:

    轻量级 强大的选择器 出色的DOM封装 可靠的事件处理机制 完善的Ajax 出色的浏览器兼容性 丰富的插件支持 完善的文档 支持链式操作

  8. JustAuth 1.15.9 版发布，支持飞书、喜马拉雅、企业微信网页登录

    新增 修复并正式启用 飞书 平台的第三方登录 AuthToken 类中新增 refreshTokenExpireIn 记录 refresh token 的有效期 PR 合并 Github #101:支 ...

  9. 二本非科班，秋招，实习，面试，offer之路

    不知不觉已经工作一年多的,我是2019年7月毕业的,但是如果算上实习就工作差不多两年了的吧. 最近不是刚刚过了圣诞节吗?然后又准备到元旦了,迎来2021年!在微信公众号上看到小部分公众号在总结2020 ...

  10. 多媒体开发（4）：在视频上显示文字或图片--ffmpeg命令

    小白:我录了段视频,里面用的音乐是有版权的,而且快过期了,能把音乐去掉吗? 小程拿到视频后,一个快捷键打开命令终端,快速打下一行命令: ffmpeg -i 小白.flv -vcodec copy -a ...