Helm on Liangweidong's blog

K8s 工具链速装：kubectl / kubeadm / minikube / kind / helm

Sat, 15 Dec 2018 00:00:00 +0800

写于 2018-12，背景：K8s 1.13 GA、Helm v3 alpha 即将发布。客户端工具已经收敛到 kubectl/kubeadm/kubelet 三件套，本地实验工具有 minikube / kind 双雄，包管理是 helm。

一、工具全景图

K8s 生态里跟"集群打交道的"工具，按使用场景分四类：

场景	工具	角色
客户端	`kubectl`	必装，对集群执行命令的唯一官方 CLI
本地实验	`minikube` / `kind`	一键起本地 K8s 集群（学习/测试用）
集群初始化	`kubeadm`	官方推荐的集群 bootstrap 工具
包管理	`helm`	K8s 应用的包管理（类似 apt/yum）

二、kubectl 安装

2.1 二进制安装（推荐）

1
2
3
4
5
6
7
8
9


# 下载最新稳定版
curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl"

# 安装
sudo install -o root -g root -m 0755 kubectl /usr/local/bin/kubectl

# 验证
kubectl version --client
kubectl version --client --output=yaml

2.2 apt 安装

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16


# 国外官方源
sudo apt-get update
sudo apt-get install -y apt-transport-https ca-certificates curl
curl -fsSL https://pkgs.k8s.io/core:/stable:/v1.28/deb/Release.key | \
 sudo gpg --dearmor -o /etc/apt/keyrings/kubernetes-apt-keyring.gpg
echo 'deb [signed-by=/etc/apt/keyrings/kubernetes-apt-keyring.gpg] https://pkgs.k8s.io/core:/stable:/v1.28/deb/ /' | \
 sudo tee /etc/apt/sources.list.d/kubernetes.list
sudo apt-get update
sudo apt-get install -y kubectl

# 国内阿里源（cn region 推荐）
curl https://mirrors.aliyun.com/kubernetes/apt/doc/apt-key.gpg | \
 gpg --dearmor > /usr/share/keyrings/kubernetes-apt-keyring.gpg
echo 'deb [signed-by=/usr/share/keyrings/kubernetes-apt-keyring.gpg] https://mirrors.aliyun.com/kubernetes/apt/ kubernetes-xenial main' | \
 sudo tee /etc/apt/sources.list.d/kubernetes.list
apt-get update && apt-get install -y kubectl

2.3 命令补全

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


# 装 bash-completion
apt-get install bash-completion

# 加到 .bashrc
echo 'source <(kubectl completion bash)' >> ~/.bashrc
source ~/.bashrc

# 推荐别名：把 kubectl 缩成 k
alias k=kubectl
complete -F __start_kubectl k

2.4 kubectl-convert 转换工具

K8s API 经常废弃/迁移，旧的 Deployment extensions/v1beta1 在 1.16 之后要换成 apps/v1。kubectl-convert 一键转换：

1
2
3
4
5


curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl-convert"
sudo install -o root -g root -m 0755 kubectl-convert /usr/local/bin/kubectl-convert

# 把老 API 转换成新 API
kubectl-convert -f old-deployment.yaml --output-version apps/v1

三、kubeadm / kubelet 安装

kubeadm 用于初始化集群，kubelet 是 worker 节点上的核心 agent。它们必须和 kubectl 版本一致（同 minor 版本）：

1
2
3
4
5
6
7


# apt 安装
sudo apt-get install -y kubelet kubeadm kubectl
# 锁定版本，防止 apt upgrade 时被升级
sudo apt-mark hold kubelet kubeadm kubectl

# 查看可用版本
apt-cache madison kubeadm

为什么 lock 版本？ K8s minor 版本升级时 API 可能废弃，跨版本 kubectl 可能无法解析新格式的 manifest。生产环境永远锁版本。

四、minikube：本地 K8s 一体化

minikube 在你本机（Windows/macOS/Linux）启动一个单节点 K8s 集群，适合学习/开发。

4.1 安装

1
2
3
4
5
6


# Linux
curl -LO https://storage.googleapis.com/minikube/releases/latest/minikube-linux-amd64
sudo install minikube-linux-amd64 /usr/local/bin/minikube

# 验证
minikube version

4.2 启动集群

1
2
3
4
5
6
7
8
9


# 默认 driver（Linux 通常是 docker，macOS 是 hyperkit，Windows 是 hyperv）
minikube start

# 显式指定
minikube start --driver=docker --kubernetes-version=v1.28.5

# 国内环境加代理
minikube start --docker-env http_proxy=http://192.168.x.x:7890 \
 --docker-env https_proxy=http://192.168.x.x:7890

4.3 常用命令

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12


minikube status # 集群状态
minikube ip # 集群 IP
minikube ssh # SSH 进节点
minikube dashboard --url # Dashboard URL
minikube addons enable metrics-server

# 镜像操作（minikube 自带 docker）
minikube image list
minikube image pull nginx:latest

# 清理
minikube delete --purge --all

五、kind：Docker-in-Docker 集群

kind（Kubernetes in Docker）用 Docker 容器模拟 K8s 节点，可以快速起多节点集群做测试。

5.1 安装

1
2
3
4
5
6


# AMD64 / x86_64
[ $(uname -m) = x86_64 ] && curl -Lo ./kind https://kind.sigs.k8s.io/dl/v0.20.0/kind-linux-amd64
# ARM64
[ $(uname -m) = aarch64 ] && curl -Lo ./kind https://kind.sigs.k8s.io/dl/v0.20.0/kind-linux-arm64
chmod +x ./kind
sudo mv ./kind /usr/local/bin/kind

5.2 与 minikube 对比

维度	minikube	kind
实现	VM / 容器	纯 Docker 容器
多节点	实验性	一等公民（multi-node config）
启动速度	较慢（拉镜像+启动 VM）	很快（共享 host docker 缓存）
适合场景	个人学习、单节点	CI/CD、e2e 测试、多节点演练

注意：kind 集群不能用于生产。它的"集群"本质是 Docker 容器，节点宕机 = 容器被回收，etcd 数据可能丢。

六、Helm：K8s 包管理

Helm 把 K8s 资源打成一个 “Chart”（类似 Debian 的 .deb / Python 的 wheel），方便应用分发和版本管理。

6.1 安装

1
2
3
4
5
6
7


# 下载
curl -L -O https://get.helm.sh/helm-v3.13.3-linux-amd64.tar.gz
tar xvf helm-v3.13.3-linux-amd64.tar.gz
sudo cp linux-amd64/helm /usr/local/bin/

# 验证
helm version

6.2 三大概念

概念	含义
Chart	应用包（yaml 模板 + values.yaml）
Release	Chart 的一个部署实例（同一 Chart 可装多次，每次一个 release）
Repository	Chart 仓库（公共有 artifacthub.io）

6.3 常用命令

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20


# 添加仓库
helm repo add bitnami https://charts.bitnami.com/bitnami

# 搜索 chart
helm search repo nginx

# 安装（会生成一个 release）
helm install my-nginx bitnami/nginx

# 查看已安装
helm list -A

# 升级（改 values 后）
helm upgrade my-nginx bitnami/nginx --set replicaCount=3

# 回滚
helm rollback my-nginx 1

# 卸载
helm uninstall my-nginx

七、工具选型决策树

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17


你是要学习 K8s 概念？
 ↓
minikube start （最简单）
 ↓
你需要快速拉起多节点做 CI 测试？
 ↓
kind （Docker 容器，秒级启动）
 ↓
你要部署生产集群？
 ↓
kubeadm init（最常见）
 或
二进制部署（理解原理，2017-2018 主流）
 ↓
你要分发应用到多个集群？
 ↓
helm chart + 私有 repo

八、常见坑

kubectl 与集群版本不一致：kubectl get nodes 报 “couldn’t get version” 时，先 kubectl version 看 client/server 版本
apt 源没换 cn：国外源拉 kubectl 慢到怀疑人生，先换阿里源
minikube 启动失败：99% 是 driver 问题，Linux 推荐 docker，macOS 用 hyperkit
kind 容器间网络不通：通常是因为 host 防火墙，iptables 临时关一下验证
Helm v2 → v3 迁移：v2 还需要 Tiller（一个集群内 agent），v3 完全去除了，更安全

九、前置知识 / 下一步

前置：Docker 基础、K8s 架构概念（参考 2017-06-15《Kubernetes 入门》）

下一步：

Containerd 实战（2019-12-15）—— 替代 Docker 的轻量容器运行时
K8s 二进制部署（2020-03-15）—— 深入理解组件协作
Kubeadm 一键部署（2022-06-15）—— 生产环境部署实战

参考资料

2024+ 视角

K8s 工具链到 2024-2026 年整体走向"轻量化 + 声明式 + 多云"：

kubectl 被 Krew 增强：Krew 已成为 kubectl 插件事实标准（200+ 插件），推荐安装 ctx、ns、tail、images、resource-capacity、node-shell、mtail 等，把 kubectl 从 CLI 升级为"瑞士军刀"。
kind 持续领先本地多节点测试：kind v0.20+ 支持 loadbalancer mirror（模拟云 LB）、Ingress dual-stack、extraPortMappings；CI 集成（GitHub Actions、GitLab CI）首选 kind + MetalLB。k3d（k3s on Docker）在低资源 CI 环境也很流行。
minikube 地位变化：v1.32+ minikube 默认 driver 仍为 docker，但实际场景已被 kind/k3d 蚕食——CI 几乎全用 kind/k3d，个人学习仍可用 minikube（自带 dashboard、metrics-server addon）。
Helm 4.0 路线图（2025）：v3.x 仍是主流，但 Helm 4 计划将 --dependency-build 改为 helm dependency up 单一命令、引入 OCI registry 默认（Helm 3.8 已支持 OCI，Helm 4 默认全 OCI）。生产强烈建议 OCI 化——避免 HTTP tgz repo 不可达。
新工具崛起：
- k9s（终端 TUI，kubectl 的视觉化）——运维日常神器
- Lens / OpenLens（桌面 IDE）—— 团队协作场景
- Argo CD / Flux（GitOps）—— K8s 部署的事实标准
- Karpenter（AWS）或 Cluster Autoscaler（多云）——节点自动扩缩容
- Kustomize（裸 YAML 模板）—— 已被 kubectl 1.14+ 内置，kubectl apply -k
包管理二分：Helm 仍是 Chart 的事实标准，KubeVela / Open Application Model（OAM） 在多云/多集群部署场景作为补充。

实战选型更新（2024 视角）：

本地学习：minikube（dashboard 加分）
CI 集成：kind（首选） / k3d（低资源）
生产部署：Helm 3 + OCI + Argo CD（GitOps）
运维日常：k9s + Krew
集群自扩缩：Karpenter（AWS）或 Cluster Autoscaler（多云）

2018 年这篇的"kubectl/kubeadm/kind/helm 四件套"基础仍然成立，变化的是 OCI、GitOps、可视化运维这三层。

Oracle 与 SQL Server：商业数据库 Docker 化部署实战

Sat, 15 Dec 2018 00:00:00 +0800

开源的 MySQL、PostgreSQL 几乎已经成为新项目的默认选择，但存量企业系统——金融、电信、政府——仍然跑在 Oracle 和 SQL Server 上。这些数据库在 Docker 化时遇到的问题和 MySQL 不一样：Oracle 需要改字符集和表空间，SQL Server 对 SA 密码有强校验、还需要 ODBC 驱动。这篇文章把两个"老牌商业数据库"在 Docker 里的安装、字符集、备份、客户端连接一次性说清楚。

阅读对象：维护 Oracle 11g/12c 遗留系统、需要在容器里跑 SQL Server 给 .NET 应用、或者为演示环境准备"商业数据库"镜像的工程师。 覆盖范围：Oracle 11g（helowin 镜像）安装、字符集改 ZHS16GBK、创建表空间与用户、expdp/impdp 数据泵；SQL Server 2019/2022 容器启动、密码策略、ODBC 驱动连接。

一、为什么要在 Docker 里跑商业数据库

场景	价值
演示 / 培训环境	一行 `docker run` 拉起一个完整 Oracle/SQL Server，不用装 Windows 虚拟机
CI/CD 集成测试	每个 Pipeline 起一个干净实例，测完即弃
跨平台交付	Linux 容器里的 SQL Server 让 .NET Core 跨平台运行真正可行
资源隔离	给每个客户/项目单独容器，避免一台机器装多版本冲突
版本快照	数据卷打 tag → 镜像化 → 跨环境一致

注意：生产环境仍建议用物理机/RDS/云数据库，Docker 化适合"非关键路径"——演示、测试、临时验证。Oracle 官方对容器的支持在 12c 之后才完善，11g 主要是社区镜像。

二、Oracle 11g（helowin 镜像）

helowin/oracle_11g 是国内开发者基于 Oracle 11g 打包的镜像（含 sqlplus / expdp / impdp），体积约 2.5GB，是 Docker 圈里最常用的"演示用 Oracle"。

2.1 拉取与启动

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13


# 1. 拉镜像
docker pull registry.cn-hangzhou.aliyuncs.com/helowin/oracle_11g

# 2. 创建数据目录并授权（容器里 oracle 用户 UID=500）
mkdir -p /home/data/oracle/test/data_emp
chown -R 500.500 /home/data/oracle/test/data_emp

# 3. 启动容器
docker run -d --name oracle_11g_test \
 -p 1523:1521 \
 --restart=always \
 -v /home/data/oracle/test/data_emp:/home/oracle/data_temp \
 registry.cn-hangzhou.aliyuncs.com/helowin/oracle_11g

挂载 /home/oracle/data_temp：这是 Oracle 的 DIRECTORY 路径，导入导出文件都走这里。把宿主机目录挂载进来，备份文件就能直接在宿主机拿到。

2.2 修改 system 密码 & 创建用户

1
2
3
4
5
6
7
8
9


# 1. 进入容器
docker exec -it <container_id> /bin/bash

# 2. 加载环境变量，切换到 oracle 用户
source ~/.bash_profile
sqlplus /nolog
SQL> connect /as sysdba; # OS 认证，最高权限
SQL> select status from v$instance; -- 应为 OPEN
SQL> alter user system identified by oracle; -- 改密码

解锁 scott 示例账户（helowin 镜像默认带 scott 库）：

1
2
3
4
5
6


SQL> alter user scott account unlock;
SQL> commit;
SQL> grant dba to scott;
SQL> grant resource to scott;
SQL> grant connect to scott;
SQL> alter user scott identified by 123456;

2.3 修改字符集为 ZHS16GBK

Oracle 11g 默认是 WE8MSWIN1252（美式编码），中文数据会乱码。改成 ZHS16GBK：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12


SQL> select * from nls_database_parameters where parameter = 'NLS_CHARACTERSET';
-- 记录当前值

SQL> shutdown immediate;
SQL> startup mount;
SQL> ALTER SYSTEM ENABLE RESTRICTED SESSION;
SQL> ALTER SYSTEM SET JOB_QUEUE_PROCESSES=0;
SQL> ALTER SYSTEM SET AQ_TM_PROCESSES=0;
SQL> alter database open;
SQL> ALTER DATABASE character set INTERNAL_USE ZHS16GBK;
SQL> shutdown immediate;
SQL> startup;

关键：INTERNAL_USE 关键字跳过字符集子集检查，从 AL32UTF8 / WE8MSWIN1252 强制改 ZHS16GBK。改完重启后用第 1 步的 select 复查。

2.4 创建表空间、用户、授权

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17


-- 查询临时表空间路径（用它的父目录）
SQL> select name from v$tempfile;

-- 创建表空间
SQL> create tablespace cmcc
 datafile '/home/oracle/app/oracle/oradata/helowin/cmcc.dbf'
 size 2G reuse autoextend on next 500M maxsize unlimited
 default storage(initial 128k next 128k minextents 2 maxextents unlimited);

-- 创建用户（指定默认表空间）
SQL> create user test01 identified by testpasswd
 default tablespace cmcc
 temporary tablespace TEMP;

-- 授权
SQL> grant connect, dba, exp_full_database, imp_full_database
 to test01 with admin option;

2.5 创建 DIRECTORY（数据泵路径）

1

SQL> create or replace directory DATA_TEMP as '/home/oracle/data_temp';

这样 expdp / impdp 用 directory=DATA_TEMP 导出/导入的文件直接在宿主机就能看到。

2.6 数据泵导入/导出

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14


# 导出 scott 用户的全 schema
expdp scott/123456@helowin schemas=scott dumpfile=expdp.dmp DIRECTORY=DATA_TEMP;

# 导入到 test01 用户
impdp scott/123456@helowin schemas=scott dumpfile=expdp.dmp DIRECTORY=DATA_TEMP;

# 替换 schema（把 scott 导入到 test01）
impdp test01/testpasswd@helowin table_exists_action=replace \
 directory=DATA_TEMP dumpfile=BPM.EXPDP \
 logfile=BPM_20180124.log \
 REMAP_SCHEMA=scott:test01 schemas=scott;

# 旧版 imp（10g 时代的 dmp 文件）
imp scott/123456@helowin file=/home/oracle/data_temp/dbzznew_2020-03-26.dmp full=y;

2.7 定时备份脚本

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13


cat << 'EOF' > /home/oracle/oracle_backup.sh
#!/bin/bash
source /home/oracle/.bash_profile
a=$(date +%Y%m%d)
expdp scott/123456@helowin schemas=scott \
 dumpfile=bpm_$a.dmp DIRECTORY=DATA_TEMP
EOF

chmod 777 /home/oracle/oracle_backup.sh

# 每天凌晨 3 点备份
echo "* 3 * * * root /home/oracle/oracle_backup.sh" >> /etc/crontab
service crond start

三、SQL Server 2019/2022

微软从 SQL Server 2017 开始官方支持 Linux，2019/2022 在 Linux 上的稳定性已经非常好。Docker 镜像基于 Ubuntu，是 .NET 跨平台部署的关键拼图。

3.1 拉取与启动

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17


# 查看可用版本
docker search mssql
docker pull mcr.microsoft.com/mssql/server:2022-latest
docker pull mcr.microsoft.com/mssql/server:2019-latest

# 创建数据目录
mkdir -p /home/docker/mssql/2022
chmod 777 /home/docker/mssql/2022

# 启动 SQL Server 2022
docker run -d --name mssql2022 \
 --restart=always \
 -e "ACCEPT_EULA=Y" \
 -e "MSSQL_SA_PASSWORD=<your-org>@123456" \
 -p 1433:1433 \
 -v /home/docker/mssql/2022:/var/opt/mssql \
 mcr.microsoft.com/mssql/server:2022-latest

关键参数：

ACCEPT_EULA=Y：必须接受许可

MSSQL_SA_PASSWORD：必须满足强密码策略（≥8 字符、含大写/小写/数字/非字母数字符号，如 <your-org>@123456）

不满足强密码策略会启动失败，日志里会写 Password validation failed

创建数据库 + 应用账号（可选，启动时也可以指定）：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


docker run -d --name mssql \
 -e "ACCEPT_EULA=Y" \
 -e "MSSQL_SA_PASSWORD=<your-org>@123456" \
 -e "MSSQL_PID=Express" \  # 指定 Express 版（免费）
 -e "SQLSERVER_DATABASE=demo" \  # 启动时创建 demo 库
 -e "SQLSERVER_USER=xiaofei" \  # demo 库的专属用户
 -e "SQLSERVER_PASSWORD=<your-org>@123456" \
 -p 1433:1433 \
 --restart=always \
 -v /home/docker/mssql:/var/opt/mssql \
 mcr.microsoft.com/mssql/server:2019-latest

3.2 进入容器操作

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12


docker exec -it mssql bash

# 使用 sqlcmd 连接
/opt/mssql-tools/bin/sqlcmd -S localhost -U sa -P "<your-org>@123456"

# 在 sqlcmd 中
1> use master
2> go
1> select * from ftable
2> go
3> exit
# 容器里 Ctrl+D 退出

Why sqlcmd？ sqlcmd 是微软官方的命令行客户端，linux 版工具包在 /opt/mssql-tools/bin/。比图形化工具轻量，适合 CI 脚本和排错。

3.3 客户端连接（Windows）

SQL Server 容器跑在 Linux 上，Windows 客户端用 ODBC Driver 18（2022 之后强制）连接：

下载：ODBC Driver for SQL Server
安装：msodbcsql.msi（如果下载不到，就用 Navicat 安装目录里的 msodbcsql_64.msi）

坑：旧的 SQL Server Native Client 11.0 已经被微软停维护（2025 年），新项目不要再用它。

3.4 Navicat 创建数据库的建议配置

项	推荐值
排序规则	`Chinese_PRC_CI_AS`（中文、不区分大小写）
恢复模式	`SIMPLE`（开发/演示环境；生产用 FULL + 定期日志备份）
兼容级别	100（SQL Server 2008 兼容）或 150（SQL Server 2019）
文件初始大小	数据 100MB、日志 50MB（按业务增长可调）

四、Oracle 11g vs SQL Server 2019/2022：选型速查

维度	Oracle 11g	SQL Server 2019/2022
起源	1977（最早商用 RDBMS）	1989（Sybase 衍生）
Docker 官方支持	12c 之后才有	2017 之后
推荐镜像	`helowin/oracle_11g`（社区）	`mcr.microsoft.com/mssql/server`（官方）
镜像大小	~2.5GB	~1.5GB
内存需求	≥2GB	≥2GB（Express 256MB）
字符集	默认 WE8MSWIN1252，要手动改 ZHS16GBK	默认 SQL_Latin1_General_CP1_CI_AS（中文/西文混排可接受）
备份工具	expdp/impdp（数据泵）	BACKUP DATABASE / VDP / Ola Hallengren 脚本
客户端	sqlplus、PL/SQL Developer	SSMS、Azure Data Studio、sqlcmd
跨平台	Linux/Win（11g 主要跑在 Linux）	2017 之后完整 Linux 支持
授权模式	按 CPU 授权，贵	标准版/企业版/Express（免费）

经验法则：

老项目迁云、ERP/金融 → Oracle
.NET Core 跨平台 / 中小企业 OA → SQL Server
临时演示 / 培训 → 两个都可以容器化，SQL Server 启动更轻

五、扩展阅读

Oracle 11g Docker 镜像：helowin/oracle_11g
SQL Server 官方镜像：mcr.microsoft.com/mssql/server
Oracle 数据泵（expdp/impdp）官方文档：docs.oracle.com
ODBC Driver for SQL Server：learn.microsoft.com