在Kubernetes（k8s）中使用本地镜像的方法有以下几种：修改imagePullPolicy为IfNotPresent、设置镜像Pull Secrets、使用私有镜像仓库、配置本地Docker Registry。其中，修改imagePullPolicy为IfNotPresent是最常用的方法之一，通过这种方式，你可以确保Kubernetes在本地镜像存在时不会尝试从远程仓库拉取镜像。具体做法是，在Pod的yaml配置文件中，将imagePullPolicy字段设为IfNotPresent，这样系统会优先使用本地镜像。如果本地镜像不存在，才会尝试从远程仓库拉取。此方法适用于开发和测试环境，可以提高部署效率并减少网络流量。
一、修改imagePullPolicy为IfNotPresent
修改imagePullPolicy为IfNotPresent是最直接的方法之一。这个配置项位于Pod的yaml文件中，通过设置这个参数，Kubernetes会检查本地是否已有指定镜像，如果有则直接使用本地镜像，不再从远程仓库拉取。具体步骤如下：
- 编辑Pod配置文件：在Pod的yaml配置文件中找到spec.containers.imagePullPolicy字段。
- 设置为IfNotPresent：将imagePullPolicy的值设置为IfNotPresent。
- 确保本地镜像存在：在执行kubectl apply命令之前，确保本地已经有对应的镜像。
示例：
apiVersion: v1
kind: Pod
metadata:
name: mypod
spec:
containers:
- name: mycontainer
image: myimage:latest
imagePullPolicy: IfNotPresent
通过这种方式，Kubernetes会首先检查本地是否已经存在myimage:latest这个镜像，如果存在则直接使用，如果不存在才会尝试从远程仓库拉取。
二、设置镜像Pull Secrets
如果你的镜像存储在一个私有的镜像仓库中，你需要配置镜像Pull Secrets来允许Kubernetes从该仓库拉取镜像。步骤如下：
- 创建Secret：使用kubectl create secret命令创建一个包含镜像仓库认证信息的Secret。
- 配置Pod使用Secret：在Pod的yaml文件中，指定imagePullSecrets字段来引用这个Secret。
示例：
kubectl create secret docker-registry myregistrykey --docker-server=myregistry.example.com --docker-username=myuser --docker-password=mypassword --docker-email=myemail@example.com
在Pod的yaml文件中：
apiVersion: v1
kind: Pod
metadata:
name: mypod
spec:
containers:
- name: mycontainer
image: myregistry.example.com/myimage:latest
imagePullSecrets:
- name: myregistrykey
这种方法适用于需要从私有镜像仓库中拉取镜像的场景，确保了镜像的安全性。
三、使用私有镜像仓库
除了本地镜像，你也可以使用私有镜像仓库来存储和管理你的镜像。私有镜像仓库提供了更高的安全性和访问控制。步骤如下：
- 搭建私有镜像仓库：你可以使用Docker Registry或Harbor等工具搭建一个私有镜像仓库。
- 推送镜像到私有仓库：使用docker push命令将镜像推送到私有镜像仓库。
- 配置Kubernetes拉取镜像：在Pod的yaml文件中，指定镜像的路径为私有仓库的地址，并配置相应的imagePullSecrets。
示例：
docker tag myimage:latest myregistry.example.com/myimage:latest
docker push myregistry.example.com/myimage:latest
在Pod的yaml文件中：
apiVersion: v1
kind: Pod
metadata:
name: mypod
spec:
containers:
- name: mycontainer
image: myregistry.example.com/myimage:latest
imagePullSecrets:
- name: myregistrykey
这种方法适用于需要管理多个镜像并且需要更高安全性的场景。
四、配置本地Docker Registry
你还可以在本地搭建一个Docker Registry，然后将镜像推送到这个本地Registry，从而使Kubernetes可以从本地Registry拉取镜像。步骤如下：
- 搭建本地Docker Registry：使用Docker自带的registry镜像搭建一个本地Docker Registry。
- 推送镜像到本地Registry：使用docker push命令将镜像推送到本地Registry。
- 配置Kubernetes拉取镜像：在Pod的yaml文件中，指定镜像的路径为本地Registry的地址。
搭建本地Docker Registry：
docker run -d -p 5000:5000 --name registry registry:2
推送镜像到本地Registry：
docker tag myimage:latest localhost:5000/myimage:latest
docker push localhost:5000/myimage:latest
在Pod的yaml文件中：
apiVersion: v1
kind: Pod
metadata:
name: mypod
spec:
containers:
- name: mycontainer
image: localhost:5000/myimage:latest
imagePullPolicy: IfNotPresent
这种方法适用于本地开发和测试环境，可以大大提高部署效率并减少网络流量。
五、使用Kubernetes DaemonSet来分发镜像
你还可以使用Kubernetes的DaemonSet来在集群中的所有节点上分发镜像。DaemonSet确保在每个节点上运行一个副本，从而在所有节点上都预先下载了所需的镜像。步骤如下：
- 创建DaemonSet：编写一个DaemonSet的yaml文件，指定需要分发的镜像。
- 应用DaemonSet：使用kubectl apply命令应用这个DaemonSet，从而在所有节点上拉取镜像。
示例：
apiVersion: apps/v1
kind: DaemonSet
metadata:
name: imageloader
spec:
selector:
matchLabels:
name: imageloader
template:
metadata:
labels:
name: imageloader
spec:
containers:
- name: imageloader
image: myimage:latest
imagePullPolicy: Always
应用DaemonSet：
kubectl apply -f daemonset.yaml
这种方法适用于需要在所有节点上预先拉取镜像的场景，可以确保在Pod调度时镜像已经存在，提高调度效率。
六、使用Kubernetes Pre-pull机制
Kubernetes还提供了一个预拉取（Pre-pull）机制，可以在Pod启动前预先拉取镜像。你可以通过配置Kubernetes的节点守护进程（kubelet）来实现这一点。步骤如下：
- 配置kubelet：编辑kubelet的配置文件，添加预拉取镜像的配置项。
- 重启kubelet：应用配置并重启kubelet，使其生效。
编辑kubelet配置文件：
kind: KubeletConfiguration
apiVersion: kubelet.config.k8s.io/v1beta1
imageGCHighThresholdPercent: 85
imagePullProgressDeadline: 1m
这种方法适用于需要在Pod启动前确保镜像已经拉取到本地的场景，可以提高Pod的启动速度。
七、使用CRI-O容器运行时
除了Docker，你还可以使用CRI-O作为Kubernetes的容器运行时。CRI-O是一个开放式容器运行时，专为Kubernetes设计，支持OCI标准的容器镜像。步骤如下：
- 安装CRI-O：根据官方文档安装和配置CRI-O。
- 配置Kubernetes使用CRI-O：编辑Kubernetes集群的配置文件，指定使用CRI-O作为容器运行时。
- 拉取镜像：使用crictl命令手动拉取镜像到本地。
安装CRI-O：
sudo apt-get install cri-o
配置Kubernetes使用CRI-O：
apiVersion: kubeadm.k8s.io/v1beta2
kind: ClusterConfiguration
kubernetesVersion: v1.18.0
criSocket: /var/run/crio/crio.sock
拉取镜像：
crictl pull myimage:latest
这种方法适用于需要使用轻量级容器运行时的场景，CRI-O可以提供比Docker更高的性能和安全性。
八、使用PodPreset自动注入镜像Pull Secrets
PodPreset是Kubernetes的一种机制，可以自动向Pod中注入环境变量、卷和镜像Pull Secrets等配置。通过使用PodPreset，你可以简化Pod的配置管理。步骤如下：
- 创建PodPreset：编写一个PodPreset的yaml文件，指定需要注入的镜像Pull Secrets。
- 应用PodPreset：使用kubectl apply命令应用这个PodPreset。
- 创建Pod：当新的Pod创建时，PodPreset会自动将镜像Pull Secrets注入到Pod中。
示例：
apiVersion: settings.k8s.io/v1alpha1
kind: PodPreset
metadata:
name: inject-secrets
spec:
selector:
matchLabels:
app: myapp
env:
- name: ENVIRONMENT
value: production
imagePullSecrets:
- name: myregistrykey
这种方法适用于需要统一管理多个Pod的镜像Pull Secrets配置的场景，可以提高配置管理的效率。
九、使用Kustomize管理镜像配置
Kustomize是Kubernetes内置的一种配置管理工具，可以用于定制化和管理Kubernetes资源。通过Kustomize，你可以更灵活地管理镜像的配置。步骤如下：
- 创建Kustomization文件：编写一个kustomization.yaml文件，指定需要修改的镜像配置。
- 应用Kustomize配置：使用kubectl kustomize命令应用配置。
示例：
apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization
images:
- name: myimage
newName: myregistry.example.com/myimage
newTag: latest
应用Kustomize配置：
kubectl apply -k .
这种方法适用于需要对多个环境进行不同配置管理的场景，可以提高配置的灵活性和可维护性。
十、结合CI/CD工具自动管理镜像
你还可以结合CI/CD工具，如Jenkins、GitLab CI、Argo CD等，自动化管理Kubernetes镜像的构建、推送和部署。步骤如下：
- 配置CI/CD工具：在CI/CD工具中编写pipeline脚本，自动化构建和推送镜像。
- 配置Kubernetes部署：在pipeline中添加步骤，自动化更新Kubernetes的部署配置。
- 触发CI/CD流程：通过代码提交或定时任务等方式触发CI/CD流程。
示例（使用GitLab CI）：
stages:
- build
- deploy
build:
stage: build
script:
- docker build -t myregistry.example.com/myimage:latest .
- docker push myregistry.example.com/myimage:latest
deploy:
stage: deploy
script:
- kubectl set image deployment/mydeployment mycontainer=myregistry.example.com/myimage:latest
这种方法适用于需要高效自动化管理Kubernetes镜像和部署的场景，可以大大提高开发和运维效率。
通过以上十种方法，你可以在Kubernetes中灵活地使用本地镜像，满足不同场景下的需求。无论是开发、测试还是生产环境，都有适合你的解决方案。
相关问答FAQs：
K8s如何用本地镜像？
在 Kubernetes（K8s）中，使用本地镜像是一种常见的实践，尤其在开发和测试阶段。使用本地镜像可以加快开发周期，减少对网络的依赖。下面将详细探讨如何在 K8s 中使用本地镜像的几个步骤和注意事项。
1. 如何构建本地镜像？
要在 K8s 中使用本地镜像，首先需要构建镜像。使用 Docker 构建镜像的基本命令如下：
docker build -t my-local-image:latest .
在此命令中，my-local-image:latest 是你为镜像指定的名称和标签，. 指的是 Dockerfile 所在的当前目录。
2. 如何在本地 Docker Registry 中推送镜像？
为了方便在 K8s 中使用本地镜像，你可以选择将镜像推送到本地 Docker Registry。首先，启动一个本地 Docker Registry：
docker run -d -p 5000:5000 --restart=always --name registry registry:2
接下来，将构建好的镜像推送到本地 Registry：
docker tag my-local-image:latest localhost:5000/my-local-image:latest
docker push localhost:5000/my-local-image:latest
3. 如何在 K8s 中使用本地镜像？
在 K8s 中使用本地镜像有几种方法，取决于你的集群配置。
3.1 使用 Pod 配置文件
可以在 Pod 的 YAML 配置文件中指定本地镜像，如下所示：
apiVersion: v1
kind: Pod
metadata:
name: my-pod
spec:
containers:
- name: my-container
image: localhost:5000/my-local-image:latest
然后，通过以下命令创建 Pod：
kubectl apply -f pod.yaml
3.2 使用 Minikube
如果你使用 Minikube，可以直接在 Minikube 中构建本地镜像。使用以下命令进入 Minikube 的 Docker 环境：
minikube docker-env
然后，执行如下命令以构建镜像：
docker build -t my-local-image:latest .
此时，K8s 中的 Pod 可以直接使用 my-local-image:latest 作为镜像。
4. 如何处理镜像拉取失败？
在使用本地镜像时，可能会遇到镜像拉取失败的情况。以下是一些常见的解决方案：
- 确保 K8s 节点能够访问到本地 Docker Registry。
- 使用
imagePullPolicy: IfNotPresent确保 K8s 只在本地找不到镜像时再从远程拉取。
apiVersion: v1
kind: Pod
metadata:
name: my-pod
spec:
containers:
- name: my-container
image: localhost:5000/my-local-image:latest
imagePullPolicy: IfNotPresent
5. 使用 Kind
如果你使用 Kind（Kubernetes IN Docker），可以通过以下命令创建集群，并在集群中使用本地镜像：
kind create cluster
接下来，构建本地镜像并将其推送到 Kind 集群：
docker build -t my-local-image:latest .
kind load docker-image my-local-image:latest
这将确保你的镜像在 Kind 集群中可用，接下来可以在 Pod 配置文件中引用该镜像。
6. 本地镜像的优缺点
使用本地镜像有其优缺点。以下是一些考虑因素：
-
优点：
- 提高开发效率，减少网络延迟。
- 在没有网络连接的环境中进行测试。
-
缺点：
- 在生产环境中可能不适用，需考虑镜像的一致性和可用性。
- 需要管理本地镜像的存储。
7. 总结
在 K8s 中使用本地镜像可以提高开发效率，尤其适合开发和测试环境。通过构建本地镜像、将其推送到本地 Registry，或者在 Minikube 和 Kind 中使用本地镜像，可以有效地进行容器化应用的开发。
关于 GitLab 的更多内容，可以查看官网文档：
官网地址： https://gitlab.cn
文档地址： https://docs.gitlab.cn
论坛地址： https://forum.gitlab.cn
原创文章，作者：DevSecOps，如若转载，请注明出处：https://devops.gitlab.cn/archives/48876
