Wiki Schema
Domain
运维排障与数据管理 — 涵盖 Kubernetes 集群运维、Redis/MySQL 等数据库管理、容器化部署、生产环境最佳实践 2026-05-12 拓宽:新增"电商运营与广告投放"领域(亚马逊广告策略) 2026-05-13 拓宽:新增"无线网络与硬件优化"领域(Wi-Fi 6/7 路由器性能调优)
Conventions
- File names: lowercase, hyphens, no spaces (e.g.,
pod-troubleshooting.md) - Every wiki page starts with YAML frontmatter (see below)
- Use
[[wikilinks]]to link between pages (minimum 2 outbound links per page) - When updating a page, always bump the
updateddate - Every new page must be added to
index.mdunder the correct section - Every action must be appended to
log.md - Provenance markers: On pages that synthesize 3+ sources, append
[raw/articles/source-file.md](/page/raw/articles/source-file)at the end of paragraphs whose claims come from a specific source.
Concepts 子目录结构
概念页按领域分类存入 concepts/ 下的子目录,禁止平铺:
concepts/
├── kubernetes/ # K8s 集群、Pod、Service、存储、调度
├── linux/ # Linux 系统与内核、性能分析、安全加固
├── nginx/ # Nginx 反向代理配置与排障
├── database/ # MySQL + Redis 数据库
├── docker/ # Docker 容器化与镜像
├── amazon/ # 电商运营与广告
├── hardware/ # 无线网络与硬件
├── terraform/ # Terraform 基础设施即代码
└── general/ # 跨领域/综合性内容
归类优先规则:
- 文件名前缀优先(
k8s-*→kubernetes/,linux-*→linux/) - 无明确前缀按 tags 中 domain 级标签归类
- 跨 3+ 领域的综合性内容放
general/ - 新建概念页前确认已有对应子目录;如需新增子目录,先更新本文件再创建
Frontmatter
---
title: Page Title
created: YYYY-MM-DD
updated: YYYY-MM-DD
type: entity | concept | comparison | query | summary
tags: [kubernetes, troubleshooting, ...]
sources: [raw/articles/k8s-troubleshooting-article.md]
confidence: high | medium | low
contested: true
contradictions: [other-page-slug]
---
raw/ Frontmatter
---
source_url: https://...
ingested: YYYY-MM-DD
sha256: <hex digest of the body content>
---
Tag Taxonomy
核心域:
- tcp: TCP 协议与连接排查
- kubernetes: 核心 K8s 概念
- scheduling: Pod 调度策略与机制
- troubleshooting: 排障相关
- production: 生产环境
- deployment: 部署相关
- networking: 网络相关
- nfs: NFS 网络文件系统
- storage: 存储相关
- security: 安全/RBAC/权限
- monitoring: 监控与日志
- linux: Linux 系统与内核
- performance: 性能分析与优化
- java: Java 应用层排障
- jvm: JVM 调优与 GC 分析
- cni: CNI 网络插件(Flannel/Calico)
- dns: DNS 解析/CoreDNS
- certificate: 证书管理与 TLS
- messaging: 消息队列/Kafka/RocketMQ
工作负载:
- pod: Pod 相关
- service: Service/网络
- node: Node 相关
- statefulset: 有状态应用
- daemonset: DaemonSet
资源对象:
- configmap: ConfigMap/Secret
- pvc: 持久化存储
- ingress: Ingress/入口
- hpa: 自动伸缩
运维工具:
- kubectl: kubectl 命令
- debugging: 调试工具与方法
- automation: 自动化脚本与工具
- disk: 磁盘管理工具
- filesystem: 文件系统
- case-study: 实战案例分析
- command: Linux 命令与工具用法
- compression: 压缩与解压技术
- tar: tar 归档工具
- gzip: gzip 压缩工具
- archive: 归档与备份策略
数据库:
- redis: Redis 内存数据库
- mysql: MySQL 数据库
- database: 数据库通用
- persistence: 数据持久化
- backup: 备份恢复
- data-loss: 数据丢失与容灾
- deadlock: 死锁分析
- lock: 锁机制详解
- replication: 复制机制
- sentinel: Redis Sentinel 哨兵
- memory: 内存管理与优化
容器化:
- docker: Docker 容器与镜像
- container: 容器技术通用
- image: 镜像构建/优化
- build: 构建与 CI
- multistage: 多阶段构建
- golang: Go 语言编译/部署
微服务:
- microservices: 微服务架构
- service-discovery: 服务发现
- nacos: Nacos 注册中心/配置中心
- zookeeper: Zookeeper 分布式协调
- consul: Consul 服务目录
- architecture: 架构设计与选型
负载均衡与高可用:
- nginx: Nginx 反向代理与配置
- websocket: WebSocket 协议与代理
- sse: Server-Sent Events 实时推送
- keepalived: Keepalived 高可用管理
- ha: 高可用架构
- high-availability: 高可用架构(全称)
- load-balancing: 负载均衡
电商运营与广告:
- amazon: 亚马逊平台运营
- advertising: 广告投放策略
- ecommerce: 电商运营
- ppc: PPC 广告竞价
- brand: 品牌建设与推广
工具推荐:
- tools: 工具推荐与评测
- opensource: 开源项目
无线网络与硬件:
- wifi: Wi-Fi 6/7 路由器性能调优
基础设施即代码 (IaC):
- terraform: Terraform 基础设施即代码
- iac: 基础设施即代码通用概念
- devops: DevOps 工具链与平台工程
Page Thresholds
- Create a page when an entity/concept appears in 2+ sources OR is central to one source
- Add to existing page when a source mentions something already covered
- DON'T create a page for passing mentions, minor details, or things outside the domain
- Split a page when it exceeds ~200 lines — break into sub-topics with cross-links
- Archive a page when its content is fully superseded — move to
_archive/, remove from index
Entity Pages
One page per notable entity (tool, controller, resource type). Include:
- Overview / what it is
- Key facts and common issues
- Relationships to other entities (wikilinks)
- Source references
Concept Pages
One page per concept or scenario. Include:
- Definition / explanation
- Common failure patterns
- Troubleshooting steps
- Related concepts (wikilinks)
Comparison Pages
Side-by-side analyses. Include:
- What is being compared and why
- Dimensions of comparison (table format preferred)
- Verdict or synthesis
- Sources
Update Policy
When new information conflicts with existing content:
- Check the dates — newer sources generally supersede older ones
- If genuinely contradictory, note both positions with dates and sources
- Mark the contradiction in frontmatter:
contradictions: [page-name] - Flag for user review in the lint report