DevOps on Zayn's Blog

3 行 YAML 接入生产级 GitLab CI/CD：gitlab-ci-templates 实战

yangzun@treesir.pub (Zayn) — Tue, 24 Mar 2026 23:45:00 +0800

来源声明：本文基于开源仓库 cdryzun/gitlab-ci-templates 的 README、目录结构与公开文档整理，重点提炼可直接落地的工程实践。

很多团队在 GitLab CI/CD 上都踩过同一个坑：

每个仓库维护一份独立流水线，重复劳动严重；
语言一多（Java / Node.js / Python / Go），规则开始分裂；
扫描、部署、回滚策略缺少统一治理。

这篇文章的核心目标很明确：用一套可复用模板，把“能跑”升级成“可持续维护”。

一、3 行接入：把流水线从“项目资产”变成“平台能力”
#

最小接入：

Claude Code + GitLab pr-agent：AI 驱动的持续迭代开发实践

yangzun@treesir.pub (Zayn) — Mon, 16 Mar 2026 13:00:00 +0800

32 个 MR 的真实案例，展示 Claude Code + GitLab CI + pr-agent 三位一体的 AI 驱动持续迭代开发工作流。

Docker 常用命令速查手册

yangzun@treesir.pub (Zayn) — Sun, 15 Mar 2026 18:30:00 +0800

前言
#

Docker 是现代 DevOps 工作流中不可或缺的容器化工具。本文整理了日常工作中最常用的 Docker 命令，方便快速查阅。

镜像管理
#

查看镜像
#

docker images
docker image ls

搜索镜像
#

docker search nginx

拉取镜像
#

docker pull nginx:latest
docker pull nginx:1.21

删除镜像
#

docker rmi nginx:latest
docker rmi $(docker images -q) # 删除所有镜像

导出/导入镜像
#

docker save -o nginx.tar nginx:latest
docker load -i nginx.tar

容器管理
#

查看容器
#

docker ps # 查看运行中的容器
docker ps -a # 查看所有容器
docker container ls # 同 docker ps

创建并启动容器
#

docker run -d --name nginx -p 80:80 nginx:latest
docker run -it --name centos centos:7 /bin/bash

启动/停止/重启容器
#

docker start nginx
docker stop nginx
docker restart nginx

进入容器
#

docker exec -it nginx /bin/bash
docker attach nginx

查看容器日志
#

docker logs nginx
docker logs -f nginx # 实时查看
docker logs --tail 100 nginx # 查看最后100行

查看容器详情
#

docker inspect nginx

查看容器资源使用
#

docker stats
docker stats nginx

删除容器
#

docker rm nginx
docker rm -f nginx # 强制删除运行中的容器
docker rm $(docker ps -aq) # 删除所有容器

数据卷管理
#

创建数据卷
#

docker volume create mydata

查看数据卷
#

docker volume ls
docker volume inspect mydata

删除数据卷
#

docker volume rm mydata
docker volume prune # 删除未使用的数据卷

挂载数据卷
#

docker run -d -v mydata:/data nginx
docker run -d -v /host/path:/container/path nginx

网络管理
#

查看网络
#

docker network ls
docker network inspect bridge

创建网络
#

docker network create mynet
docker network create --driver bridge mynet

连接容器到网络
#

docker network connect mynet nginx

断开容器网络
#

docker network disconnect mynet nginx

删除网络
#

docker network rm mynet

系统清理
#

清理退出状态的容器
#

docker rm $(docker container ls -f "status=exited" -q)

清理未使用的镜像
#

docker image prune
docker image prune -a # 删除所有未使用的镜像

一键清理
#

docker system prune
docker system prune -a # 包括镜像
docker system prune --volumes # 包括数据卷

Dockerfile 构建
#

构建镜像
#

docker build -t myimage:v1 .
docker build -t myimage:v1 -f Dockerfile.custom .

Dockerfile 示例
#

FROM centos:7

LABEL maintainer="admin@example.com"

RUN yum install -y vim \
 && yum clean all

COPY app.py /app/

WORKDIR /app

EXPOSE 8080

CMD ["python", "app.py"]

容器转镜像（不推荐）
#

docker commit container_name image_name

注意：不推荐使用 commit 创建镜像。建议使用 Dockerfile 构建镜像，因为 commit 创建的镜像不可复现。

Nexus3 PyPI 私服 Blob Storage 异常修复记录

yangzun@treesir.pub (Zayn) — Thu, 22 Jul 2021 15:38:00 +0800

问题描述
#

在 DevOps 集成环境的测试环境中，发现多条 Pipeline 持续处于构建超时状态。初步排查以为是依赖版本兼容性问题导致 pip 无法找到合适版本，与开发团队联合排查后发现：开发环境正常，测试环境异常，且使用相同的代码和 Dockerfile 文件，排除了版本相关问题。具体错误表现如下：

检查 Nexus3 私服日志

docker logs -f --tail 100 nexus3

使用 Docker Compose 部署 Nexus3 Docker 私服并配置 Traefik 代理

yangzun@treesir.pub (Zayn) — Thu, 10 Jun 2021 09:51:36 +0800

环境说明
#

软件版本
#

操作系统：CentOS 7.9.2009
Docker 版本：20.10.7
Docker Compose 版本：1.18.0
Mkcert 版本：v1.4.3

端口规划
#

Nexus 私服端口规划
#

私服名称	私服作用	私服类型	私服端口
docker-custom	存放自定义 push 的镜像，与项目环境无关	hosted	8086
idocker.io	代理仓库和 custom 仓库的集合	group	8082
docker-dev	存放项目 dev 环境镜像	hosted	8083
docker-qa	存放项目 qa 环境镜像	hosted	8084
docker-prod	存放项目 prod 环境镜像	hosted	8085

除了上述 Docker 私服端口外，还有 Nexus3 管理面板端口 8081

在 Kubernetes 中使用 localPv 部署 Gitlab

yangzun@treesir.pub (Zayn) — Tue, 01 Jun 2021 10:13:29 +0800

环境说明
#

Kubernetes Version: v1.20.4
Postgres Version: 12.7
Redis Version: 5.0.9

因在官方提供的 gitlab-ce 镜像中，内置了 Postgres & Redis 的安装，在实际生产使用过程中，想让其连接使用外部统一的服务进行使用，来合理统一的管理，并有效降低对应资源使用率，这里使用 dokcer 非官方镜像: sameersbn/gitlab:13.12.1 进行使用

Maven ReleasePlugin 的使用记录

yangzun@treesir.pub (Zayn) — Sun, 16 May 2021 17:52:05 +0800

`maven` settings.xml 配置使用展示
#

 <?xml version="1.0" encoding="UTF-8"?>
 <settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">
 <!-- localRepository
 | The path to the local repository maven will use to store artifacts.
 |
 | Default: ${user.home}/.m2/repository
 <localRepository>/path/to/local/repo</localRepository>
 -->
 <pluginGroups>
 <!-- pluginGroup
 | Specifies a further group identifier to use for plugin lookup.
 <pluginGroup>com.your.plugins</pluginGroup>
 -->
 </pluginGroups>

 <!-- proxies
 | This is a list of proxies which can be used on this machine to connect to the network.
 | Unless otherwise specified (by system property or command-line switch), the first proxy
 | specification in this list marked as active will be used.
 |-->
 <proxies>
 </proxies>

 <servers>
 <server>
 <id>user-snapshot</id>
 <username>yangzun</username>
 <password>12345678</password>
 </server>

 <server>
 <id>user-release</id>
 <username>yangzun</username>
 <password>12345678</password>
 </server>
 </servers>

 <mirrors>
 <mirror>
 <id>user-snapshot</id>
 <mirrorOf>*</mirrorOf>
 <url>http://mirror.treesir.pub/repository/maven-hub</url>
 </mirror>
 <mirror>
 <id>user-release</id>
 <mirrorOf>*</mirrorOf>
 <url>http://mirror.treesir.pub/repository/maven-hub</url>
 </mirror>
 </mirrors>

 <profiles>

 <profile>
 <id>nexus</id>
 <repositories>
 <repository>
 <id>central</id>
 <name>_nexus</name>
 <url>http://mirror.treesir.pub/repository/maven-hub/</url>
 <releases><enabled>true</enabled></releases>
 <snapshots><enabled>true</enabled></snapshots>
 </repository>
 </repositories>
 <pluginRepositories>
 <pluginRepository>
 <id>central</id>
 <name>_nexus</name>
 <url>http://mirror.treesir.pub/repository/maven-hub/</url>
 <releases><enabled>true</enabled></releases>
 <snapshots><enabled>true</enabled></snapshots>
 </pluginRepository>
 </pluginRepositories>
 </profile>

 </profiles>

 <activeProfiles>
 <activeProfile>nexus</activeProfile>
 </activeProfiles>
 </settings>

插件打包的使用记录说明
#

maven plugin 在打包过程中，是会基于当前分支，创建一个分支进行打包，并会将创建的分支 push 至远端。与项目的分支管理模式有所冲突，并不想push 至远端的话

Kind 部署本地k8s集群的使用记录

yangzun@treesir.pub (Zayn) — Sun, 15 Nov 2020 14:24:42 +0800

参考资料
#

安装
#

curl -Lo ./kind "https://kind.sigs.k8s.io/dl/v0.9.0/kind-$(uname)-amd64"
chmod +x ./kind
mv ./kind /some-dir-in-your-PATH/kind

启动集群
#

注意启动集群前请确认 docker 服务是否启动

使用 helm 在 Kubernetes 中部署 Nexus 私服

yangzun@treesir.pub (Zayn) — Sun, 23 May 2021 15:50:31 +0800

环境说明
#

helm version: v3.3.1
kubernetes: v1.17.9
nexus: 3.29.0

部署
#

准备 storageClass
#

非 必要 操作，可以选择手动创建 pvc & pv，如果想部署 nfsStorageClass 的话，请参考早期整理的文档。此篇文档实战部署步骤中基于 nfsStorageClass 进行实现。如果是用于 生产环境 的话，还是建议使用 ssd 或 iops 较高的 磁盘 作为数据盘使用，数据盘管理方式可以使用 localPv or hostPath 绑定到对应节点进行运行。

企业级 Nexus3 制品仓库平台部署与运维完整指南

yangzun@treesir.pub (Zayn) — Tue, 22 Dec 2020 09:24:55 +0800

Nexus3 是世界领先的企业级制品仓库管理平台，为现代 DevOps 工具链提供统一的制品管理解决方案。本指南将从基础部署到企业级配置，全面介绍 Nexus3 的部署、配置、管理和运维最佳实践。

Nexus3 平台简介
#

什么是 Nexus3
#

Nexus Repository Manager 3 是由 Sonatype 公司开发的下一代制品仓库管理平台，作为 DevOps 工具链的核心组件，为软件开发生命周期提供统一的制品管理能力。

Docker 部署 OpenLDAP 统一身份认证服务

yangzun@treesir.pub (Zayn) — Fri, 18 Dec 2020 16:24:43 +0800

OpenLDAP 简介
#

什么是 OpenLDAP
#

OpenLDAP 是一个开源的轻量级目录访问协议（LDAP）实现，广泛用于企业级统一身份认证和目录服务。它提供了集中化的用户管理、身份验证和授权功能。

Git 使用问题的记录

yangzun@treesir.pub (Zayn) — Sun, 25 Apr 2021 10:35:57 +0800

指定特定仓库拉取代码
#

git remote add origin https://github.com/demo/example.git
git pull https://repo.csheidou.com/forestry_afterend/prevention_fire_test.git master
git branch --set-upstream-to=origin/master
git status
git pull

更改远程仓库地址
#

git remote -v
git remote set-url origin https://github.com/demo/example.git
git pull origin master --allow-unrelated-histories
git push
git branch --set-upstream-to=origin/master

清理本地错误的用户信息
#

运行一下命令缓存输入的用户名和密码：
git config --global credential.helper wincred

清除掉缓存在git中的用户名和密码
git credential-manager uninstall

解决 Windows git pull 卡住不动问题
#

原因在 git clone 时后面仓库地址是非公开的需要验证用户及密码而windows 默认是已弹窗形式

企业级 GitLab 平台部署与运维完整指南

yangzun@treesir.pub (Zayn) — Thu, 04 Mar 2021 16:31:06 +0800

GitLab 平台简介
#

什么是 GitLab
#

GitLab 是一个基于 Web 的 DevOps 生命周期工具，提供了 Git 仓库管理、代码审查、问题跟踪、CI/CD 流水线和 Wiki 等功能。作为一个完整的 DevOps 平台，GitLab 帮助团队协作开发、测试和部署应用程序。

Python DevOps 完整实战指南

yangzun@treesir.pub (Zayn) — Thu, 05 Oct 2023 20:40:24 +0800

Python 在 DevOps 领域扮演着重要角色，其简洁的语法、丰富的生态系统和强大的自动化能力使其成为运维自动化的首选语言。本指南将从 DevOps 理念开始，逐步深入到 Python 在各个 DevOps 场景中的实际应用，帮助您构建高效的自动化运维体系。

图：《Python for DevOps: Learn Ruthlessly Effective Automation》

DevOps 理念与文化
#

什么是 DevOps
#

DevOps 是一种文化、实践和工具的组合，旨在提高组织快速交付应用程序和服务的能力。它强调开发（Development）和运维（Operations）团队之间的协作与沟通。

Argocd Cli Usage Tips

yangzun@treesir.pub (Zayn) — Mon, 24 Jul 2023 14:19:17 +0800

说明
#

此篇文档，用于记录在使用 ArgoCD CLi 的过程中，所使用到的一些常用命令，且供参考。

使用记录
#

ArgoCD cli 安装文档，使用前，配置登录

Rke 集群集成 Kube-Vip 实现 Loadbalance Service 资源的使用

yangzun@treesir.pub (Zayn) — Tue, 12 Oct 2021 13:44:45 +0800

背景
#

Kube-Vip 最初是为 Kubernetes 控制平面提供 HA 解决方案而创建的，随着时间的推移，它已经发展为将相同的功能合并到 Kubernetes 的 LoadBalancer 类型的 Service 中。Kube-Vip 特点 如下：

VIP 地址可以是 IPv4 或 IPv6

带有 ARP（第2层）或 BGP（第3层）的控制平面

使用领导选举或 raft 控制平面

带有 kubeadm（静态 Pod）的控制平面 HA

带有 K3s/和其他（DaemonSets）的控制平面 HA

使用 ARP 领导者选举的 Service LoadBalancer（第 2 层）

通过 BGP 使用多个节点的 Service LoadBalancer

每个命名空间或全局的 Service LoadBalancer 地址池

Service LoadBalancer 地址通过 UPNP 暴露给网关

集群 master 节点一般不会很多，kube-vip 只需在 k8s 中的控制平面部署。这里使用方法采用 静态 pod + ARP 来简单实现。在大规模的场景下可以尝试使用 BGP ，这需要相应的 BGP 服务来做支撑。

记录一次 JupyterLab 插件打包问题的修复

yangzun@treesir.pub (Zayn) — Tue, 20 Jul 2021 17:04:26 +0800

背景
#

在所关联项目的 jenkins pipeline ci 流水线中，开发告诉我生成的 pip 包中未有生成相关的 labextension 依赖文件夹，导致 pip 包虽然是安装成功了，但仍是一个不可用的状态。开发人员告诉我在 linux & windows 环境下均是可以正常生成相关依赖文件夹的，问我是不是哪里配置有点问题，思索了一下和他说会不会是 jenkins slave 使用的是 容器 的原因？给了他一个启动命令，测试在容器里面生成一下包看看，启动命令如下所示:

使用 Kaniko 在 Kubernetes 中构建 Docker 镜像

yangzun@treesir.pub (Zayn) — Tue, 15 Jun 2021 10:02:48 +0800

在 Kubernetes 环境中构建 Docker 镜像一直是一个挑战，传统的 Docker-in-Docker 方案存在安全风险和复杂性问题。Kaniko 作为 Google 开源的容器镜像构建工具，提供了一个安全、高效的解决方案。

什么是 Kaniko
#

Kaniko 是由 Google 开发的开源工具，专门用于在容器或 Kubernetes 集群内构建容器镜像。它的核心优势包括：

使用 Helm 部署 Spinnaker 持续部署(CD)平台

yangzun@treesir.pub (Zayn) — Mon, 24 May 2021 16:33:49 +0800

环境说明
#

Kubernetes Version: v1.17.9
操作系统: CentOS 7.8.2003
Helm Version: v3.2.1
Spinnaker Version: 1.26.3

spinnaker 版本说明

spinnaker 组件说明
#

Deck：前端web页面端口9000

Rancher 开启监控后的，阈值告警配置说明 (三)

yangzun@treesir.pub (Zayn) — Wed, 19 May 2021 08:41:26 +0800

环境说明
#

此文档为 rancher monitor 使用系列的 第三篇 ，主要介绍与 dingtalk 关联配置告警通知、prometheus 告警阈值的配置使用

配置安装 dingtalk webhook
#

webhook github 地址

Rancher 开启监控，及生产应用的优化配置工作说明 (一)

yangzun@treesir.pub (Zayn) — Mon, 17 May 2021 10:41:26 +0800

环境说明
#

kubernetes version: v1.17.9
rancher dashboard: v2.3.5
操作系统: centos 7.8.2003

基础环境配置
#

使用 kubekey 部署 kubernetes 集群
#

由于篇幅原因，此处省略部署说明，请参考较早期的文档说明

Rancher 开启监控后，exporter/metrics 的添加说明 (二)

yangzun@treesir.pub (Zayn) — Mon, 17 May 2021 10:41:26 +0800

环境说明
#

上期 介绍了 rancher prometheus operator 的安装和基础 targets 的修复工作。有的时候我们抓取的 exporter metrics 并不在同集群且与集群没有任何关联时，应该怎么和 rancher monitor 进行关联配置呢？下面文档将配置展示部署外部 exporter , 的安装说明、指标抓取、和监控系统的关联。

Velero 备份迁移工具安装与配置

yangzun@treesir.pub (Zayn) — Sun, 16 May 2021 18:00:36 +0800

环境准备
#

安装基础依赖
#

安装 Docker Compose：

GitLab Pre-receive 钩子的配置与使用指南

yangzun@treesir.pub (Zayn) — Mon, 12 Apr 2021 17:25:58 +0800

环境说明
#

版本信息
#

GitLab 版本：13.10.2

如需了解 GitLab 服务器安装方法，请参考安装文档。本文将详细介绍如何在 GitLab 中添加和配置 pre-receive 钩子，并演示如何对 git push 操作进行限制。

Gitlab 和 jira 之间的集成

yangzun@treesir.pub (Zayn) — Fri, 09 Apr 2021 15:52:44 +0800

环境说明
#

Gitlab-ce 版本： 13.10.2

Jira 版本：v8.13.4

Jira
#

获取工作流结束 id
#

企业级 Prometheus 监控平台部署与运维完整指南

yangzun@treesir.pub (Zayn) — Tue, 09 Mar 2021 15:50:54 +0800

Prometheus 监控平台简介
#

什么是 Prometheus
#

Prometheus 是由 SoundCloud 开发并贡献给 CNCF（Cloud Native Computing Foundation）的开源监控和告警系统。作为云原生监控的事实标准，Prometheus 为现代化的微服务架构和容器化环境提供了强大的监控能力。

企业级 Jenkins CI/CD 平台部署与配置完整指南

yangzun@treesir.pub (Zayn) — Tue, 02 Mar 2021 19:31:09 +0800

Jenkins 平台简介
#

什么是 Jenkins
#

Jenkins 是世界领先的开源自动化服务器，由 Kohsuke Kawaguchi 于 2004 年创建。作为 DevOps 工具链的核心组件，Jenkins 为软件开发生命周期提供了强大的自动化能力。

JIRA & Confluence 完整安装配置指南

yangzun@treesir.pub (Zayn) — Sun, 21 Feb 2021 11:02:00 +0800

系统环境要求
#

环境信息
#

组件	版本	说明
操作系统	CentOS 7+	推荐使用 CentOS 7 或更高版本
JIRA 版本	8.13.4	企业级项目管理工具
数据库	MySQL 5.7	存储 JIRA 数据
Java 环境	OpenJDK 1.8	JIRA 运行环境

💡 提示：可以访问 JIRA 官方下载页面查看最新版本信息

DevOps on Zayn's Blog

3 行 YAML 接入生产级 GitLab CI/CD：gitlab-ci-templates 实战

一、3 行接入：把流水线从“项目资产”变成“平台能力” #

Claude Code + GitLab pr-agent：AI 驱动的持续迭代开发实践

Docker 常用命令速查手册

前言 #

镜像管理 #

查看镜像 #

搜索镜像 #

拉取镜像 #

删除镜像 #

导出/导入镜像 #

容器管理 #

查看容器 #

创建并启动容器 #

启动/停止/重启容器 #

进入容器 #

查看容器日志 #

查看容器详情 #

查看容器资源使用 #

删除容器 #

数据卷管理 #

创建数据卷 #

查看数据卷 #

删除数据卷 #

挂载数据卷 #

网络管理 #

查看网络 #

创建网络 #

连接容器到网络 #

断开容器网络 #

删除网络 #

系统清理 #

清理退出状态的容器 #

清理未使用的镜像 #

一键清理 #

Dockerfile 构建 #

构建镜像 #

Dockerfile 示例 #

容器转镜像（不推荐） #

Nexus3 PyPI 私服 Blob Storage 异常修复记录

问题描述 #

使用 Docker Compose 部署 Nexus3 Docker 私服并配置 Traefik 代理

环境说明 #

软件版本 #

端口规划 #

Nexus 私服端口规划 #

在 Kubernetes 中使用 localPv 部署 Gitlab

环境说明 #

Maven ReleasePlugin 的使用记录

maven settings.xml 配置使用展示 #

插件打包的使用记录说明 #

Kind 部署本地k8s集群的使用记录

参考资料 #

安装 #

启动集群 #

使用 helm 在 Kubernetes 中部署 Nexus 私服

环境说明 #

部署 #

准备 storageClass #

企业级 Nexus3 制品仓库平台部署与运维完整指南

Nexus3 平台简介 #

什么是 Nexus3 #

Docker 部署 OpenLDAP 统一身份认证服务

OpenLDAP 简介 #

什么是 OpenLDAP #

Git 使用问题的记录

指定特定仓库拉取代码 #

更改远程仓库地址 #

清理本地错误的用户信息 #

解决 Windows git pull 卡住不动问题 #

企业级 GitLab 平台部署与运维完整指南

推荐阅读 #

GitLab 平台简介 #

什么是 GitLab #

Python DevOps 完整实战指南

DevOps 理念与文化 #

什么是 DevOps #

Argocd Cli Usage Tips

说明 #

一、3 行接入：把流水线从“项目资产”变成“平台能力”
#

前言
#

镜像管理
#

查看镜像
#

搜索镜像
#

拉取镜像
#

删除镜像
#

导出/导入镜像
#

容器管理
#

查看容器
#

创建并启动容器
#

启动/停止/重启容器
#

进入容器
#

查看容器日志
#

查看容器详情
#

查看容器资源使用
#

删除容器
#

数据卷管理
#

创建数据卷
#

查看数据卷
#

删除数据卷
#

挂载数据卷
#

网络管理
#

查看网络
#

创建网络
#

连接容器到网络
#

断开容器网络
#

删除网络
#

系统清理
#

清理退出状态的容器
#

清理未使用的镜像
#

一键清理
#

Dockerfile 构建
#

构建镜像
#

Dockerfile 示例
#

容器转镜像（不推荐）
#

问题描述
#

环境说明
#

软件版本
#

端口规划
#

Nexus 私服端口规划
#

环境说明
#

`maven` settings.xml 配置使用展示
#

插件打包的使用记录说明
#

参考资料
#

安装
#

启动集群
#

环境说明
#

部署
#

准备 storageClass
#

Nexus3 平台简介
#

什么是 Nexus3
#

OpenLDAP 简介
#

什么是 OpenLDAP
#

指定特定仓库拉取代码
#

更改远程仓库地址
#

清理本地错误的用户信息
#

解决 Windows git pull 卡住不动问题
#

推荐阅读
#

GitLab 平台简介
#

什么是 GitLab
#

DevOps 理念与文化
#

什么是 DevOps
#

说明
#

使用记录
#

背景
#

背景
#

什么是 Kaniko
#

环境说明
#

spinnaker 组件说明
#

环境说明
#

配置安装 dingtalk webhook
#

环境说明
#

基础环境配置
#

使用 kubekey 部署 kubernetes 集群
#

环境说明
#

环境准备
#

安装基础依赖
#

环境说明
#

版本信息
#