腾讯云轻量服务器折腾 K3s 实录 (续)ArgoCD 部署避坑指南上回说到我们在腾讯云的 4G 轻量服务器上成功把 K3s 跑起来了并打通了外网kubectl的直连。今天这篇我们继续推进实战部署 GitOps 的核心控制面 ——ArgoCD。本以为有了 K8s 集群装个 ArgoCD 只是kubectl apply一把梭的事结果依然是“步步惊心”。这里把遇到的两个巨坑和终极解法记录下来。坑一ArgoCD CRD 文件过大导致 Annotation 溢出报错按照官方文档我们满心欢喜地敲下安装命令kubectl create namespace argocd kubectl apply-nargocd-fhttps://raw.githubusercontent.com/argoproj/argo-cd/stable/manifests/install.yaml结果终端直接糊了一长串红字The CustomResourceDefinition applicationsets.argoproj.io is invalid: metadata.annotations: Too long: may not be more than 262144 bytes原因分析K8s 默认的kubectl apply使用的是Client-Side Apply (客户端应用)模式。它会非常实诚地把你整个 YAML 文件的内容塞进这个对象的last-applied-configuration注解 (Annotation) 里。偏偏 ArgoCD 的核心 CRD比如 ApplicationSet的声明文件巨大无比轻轻松松突破了 K8s 注解长度 256KB 的硬性限制直接被 API Server 拒收了。终极解法使用 Server-Side Apply既然客户端算不过来就把合并的压力丢给服务端。只需要在命令里加一个--server-side参数让 K8s 的 API Server 自己去处理状态合并kubectl apply --server-side-nargocd-fhttps://raw.githubusercontent.com/argoproj/argo-cd/stable/manifests/install.yaml敲下这行命令看着屏幕刷刷刷地输出serverside-applied简直强迫症福音。坑二国内网络拉取沙盒镜像 (Pause) 失败导致 Pod 卡死资源对象虽然建好了但我通过kubectl get pods -n argocd一看所有的 Pod 像木头一样死死卡在ContainerCreating状态十几分钟一动不动。用describe命令深挖日志发现了老熟人Failed to pull image rancher/mirrored-pause:3.6... dial tcp 162.125.x.x:443: connect: connection refused原因分析这是国内云主机的通病。K3s/K8s 在启动任何 Pod 之前都需要先从 Docker Hub 拉取基础的沙盒镜像pause 镜像。但目前国内直连registry-1.docker.io基本被掐断连最底层的环境都初始化不了业务镜像更是没戏。终极解法给 K3s 配置国内容器镜像加速器注意K3s 底层用的是 containerd而不是 Docker所以不要去改/etc/docker/daemon.json。你需要登录到服务器上直接修改 K3s 的镜像配置表# 写入国内镜像加速源 (例如 DaoCloud, 南大源等)catEOF|sudotee/etc/rancher/k3s/registries.yamlmirrors: docker.io: endpoint: - https://docker.m.daocloud.io - https://docker.nju.edu.cn - https://registry.docker-cn.com EOF# 重启 K3s 让配置生效sudosystemctl restart k3sK3s 重启速度极快通常不到两秒。重启完成后被卡住的 Pod 就像久旱逢甘霖一样瞬间开始拉取镜像状态全部变为Running。收尾与效果验证当所有 Pod 都跑起来后为了方便在外面通过浏览器直接访问 ArgoCD 的炫酷界面我们直接把它原本内部的 ClusterIP 服务改成 NodePort并固定映射到30080端口# 暴露 NodePortkubectl patch svc argocd-server-nargocd-p{spec: {type: NodePort, ports: [{port: 443, nodePort: 30080}]}}# 窃取初始的超级管理员密码kubectl-nargocd get secret argocd-initial-admin-secret-ojsonpath{.data.password}|base64 -d;echo最后记得去腾讯云控制台的安全组里把TCP 30080端口放通。打开浏览器访问https://你的公网IP:30080忽略证书警告输入admin和刚拿到的密码。看到 ArgoCD 后台界面的那一刻所有的折腾都值了下一篇我们将继续向这台 4G 战舰里塞入 Kong 网关数据面真正把 GitOps 闭环跑通。敬请期待
腾讯云轻量服务器折腾 K3s 实录 (续)：ArgoCD 部署避坑指南
腾讯云轻量服务器折腾 K3s 实录 (续)ArgoCD 部署避坑指南上回说到我们在腾讯云的 4G 轻量服务器上成功把 K3s 跑起来了并打通了外网kubectl的直连。今天这篇我们继续推进实战部署 GitOps 的核心控制面 ——ArgoCD。本以为有了 K8s 集群装个 ArgoCD 只是kubectl apply一把梭的事结果依然是“步步惊心”。这里把遇到的两个巨坑和终极解法记录下来。坑一ArgoCD CRD 文件过大导致 Annotation 溢出报错按照官方文档我们满心欢喜地敲下安装命令kubectl create namespace argocd kubectl apply-nargocd-fhttps://raw.githubusercontent.com/argoproj/argo-cd/stable/manifests/install.yaml结果终端直接糊了一长串红字The CustomResourceDefinition applicationsets.argoproj.io is invalid: metadata.annotations: Too long: may not be more than 262144 bytes原因分析K8s 默认的kubectl apply使用的是Client-Side Apply (客户端应用)模式。它会非常实诚地把你整个 YAML 文件的内容塞进这个对象的last-applied-configuration注解 (Annotation) 里。偏偏 ArgoCD 的核心 CRD比如 ApplicationSet的声明文件巨大无比轻轻松松突破了 K8s 注解长度 256KB 的硬性限制直接被 API Server 拒收了。终极解法使用 Server-Side Apply既然客户端算不过来就把合并的压力丢给服务端。只需要在命令里加一个--server-side参数让 K8s 的 API Server 自己去处理状态合并kubectl apply --server-side-nargocd-fhttps://raw.githubusercontent.com/argoproj/argo-cd/stable/manifests/install.yaml敲下这行命令看着屏幕刷刷刷地输出serverside-applied简直强迫症福音。坑二国内网络拉取沙盒镜像 (Pause) 失败导致 Pod 卡死资源对象虽然建好了但我通过kubectl get pods -n argocd一看所有的 Pod 像木头一样死死卡在ContainerCreating状态十几分钟一动不动。用describe命令深挖日志发现了老熟人Failed to pull image rancher/mirrored-pause:3.6... dial tcp 162.125.x.x:443: connect: connection refused原因分析这是国内云主机的通病。K3s/K8s 在启动任何 Pod 之前都需要先从 Docker Hub 拉取基础的沙盒镜像pause 镜像。但目前国内直连registry-1.docker.io基本被掐断连最底层的环境都初始化不了业务镜像更是没戏。终极解法给 K3s 配置国内容器镜像加速器注意K3s 底层用的是 containerd而不是 Docker所以不要去改/etc/docker/daemon.json。你需要登录到服务器上直接修改 K3s 的镜像配置表# 写入国内镜像加速源 (例如 DaoCloud, 南大源等)catEOF|sudotee/etc/rancher/k3s/registries.yamlmirrors: docker.io: endpoint: - https://docker.m.daocloud.io - https://docker.nju.edu.cn - https://registry.docker-cn.com EOF# 重启 K3s 让配置生效sudosystemctl restart k3sK3s 重启速度极快通常不到两秒。重启完成后被卡住的 Pod 就像久旱逢甘霖一样瞬间开始拉取镜像状态全部变为Running。收尾与效果验证当所有 Pod 都跑起来后为了方便在外面通过浏览器直接访问 ArgoCD 的炫酷界面我们直接把它原本内部的 ClusterIP 服务改成 NodePort并固定映射到30080端口# 暴露 NodePortkubectl patch svc argocd-server-nargocd-p{spec: {type: NodePort, ports: [{port: 443, nodePort: 30080}]}}# 窃取初始的超级管理员密码kubectl-nargocd get secret argocd-initial-admin-secret-ojsonpath{.data.password}|base64 -d;echo最后记得去腾讯云控制台的安全组里把TCP 30080端口放通。打开浏览器访问https://你的公网IP:30080忽略证书警告输入admin和刚拿到的密码。看到 ArgoCD 后台界面的那一刻所有的折腾都值了下一篇我们将继续向这台 4G 战舰里塞入 Kong 网关数据面真正把 GitOps 闭环跑通。敬请期待
