231 lines
5.9 KiB
Markdown
231 lines
5.9 KiB
Markdown
# CMII Live Services - Merged 部署文档
|
|
|
|
## 概述
|
|
|
|
- **Media Suite**: WVP + ZLM + ZLM-OSS 三个容器合并部署在一个 Pod 中
|
|
- **网络模式**: HostNetwork (直接使用宿主机网络)
|
|
- **共享存储**: ZLM 和 ZLM-OSS 共享 HLS 数据卷
|
|
- **其他服务**: Live Operator、Live Proxy、Live Helper 独立部署 使用 NodePort 暴露
|
|
|
|
## 目录结构
|
|
|
|
```
|
|
merge/
|
|
├── Chart.yaml # Helm Chart 元数据
|
|
├── values.yaml # 配置文件
|
|
├── deploy.sh # 一键部署脚本
|
|
└── templates/
|
|
├── media-suite-deployment.yaml # Media Suite (WVP+ZLM+ZLM-OSS)
|
|
├── live-op-deployment.yaml # Live Operator
|
|
├── live-proxy-deployment.yaml # Live Proxy
|
|
├── live-helper-deployment.yaml # Live Helper
|
|
├── wvp-configmap.yaml # WVP 配置
|
|
├── zlm-configmap.yaml # ZLM 配置
|
|
├── zlm-oss-configmap.yaml # ZLM-OSS 配置
|
|
├── live-op-configmap.yaml # Live Operator 配置
|
|
├── live-proxy-configmap.yaml # Live Proxy 配置
|
|
├── live-helper-configmap.yaml # Live Helper 配置
|
|
├── pvc.yaml # 持久化存储
|
|
├── harborsecret.yaml # 镜像拉取密钥
|
|
└── NOTES.txt # 部署提示
|
|
```
|
|
|
|
## 当前服务前置
|
|
|
|
- Kubernetes 集群 (1.30.14)
|
|
- Helm (3.20.2)
|
|
- kubectl
|
|
- NFS StorageClass (用于 HLS 数据共享存储)
|
|
- 外部服务: MySQL、Redis、MinIO、RabbitMQ
|
|
|
|
## 快速开始
|
|
|
|
### 1. 修改配置
|
|
|
|
编辑 `values.yaml` 文件,根据实际情况修改:
|
|
|
|
```yaml
|
|
# 镜像配置
|
|
images:
|
|
zlm:
|
|
repository: your-registry/zlm
|
|
tag: v2.7.5
|
|
wvp:
|
|
repository: your-registry/wvp
|
|
tag: v2.7.4
|
|
# ... 其他镜像配置
|
|
|
|
# 外部依赖配置
|
|
external:
|
|
database:
|
|
host: "your-mysql-host"
|
|
port: "3306"
|
|
username: "root"
|
|
password: "your-password"
|
|
redis:
|
|
host: "your-redis-host"
|
|
port: "6379"
|
|
password: "your-password"
|
|
minio:
|
|
endpoint: "http://your-minio-host:9000"
|
|
accessKey: "your-access-key"
|
|
secretKey: "your-secret-key"
|
|
rabbitmq:
|
|
host: "your-rabbitmq-host"
|
|
port: "5672"
|
|
username: "admin"
|
|
password: "your-password"
|
|
|
|
# 持久化存储
|
|
persistence:
|
|
zlm:
|
|
hls:
|
|
storageClass: "your-nfs-storage-class"
|
|
```
|
|
|
|
### 2. 配置 Harbor 镜像密钥 (可选)
|
|
|
|
如果使用私有镜像仓库,需要配置镜像拉取密钥:
|
|
|
|
```bash
|
|
# 生成 Docker Config JSON 的 Base64 编码
|
|
cat ~/.docker/config.json | base64 -w 0
|
|
|
|
# 将输出粘贴到 values.yaml 中
|
|
images:
|
|
dockerConfigJson: "eyJhdXRocyI6..."
|
|
```
|
|
|
|
### 3. 执行部署
|
|
|
|
```bash
|
|
# 赋予执行权限
|
|
chmod +x deploy.sh
|
|
|
|
# 执行部署
|
|
./deploy.sh
|
|
```
|
|
|
|
部署脚本会自动:
|
|
|
|
- 检查前置条件
|
|
- 验证配置文件
|
|
- 创建命名空间
|
|
- 安装/升级 Helm Release
|
|
- 等待 Pod 就绪
|
|
- 显示服务状态和访问地址
|
|
|
|
### 4. 验证部署
|
|
|
|
```bash
|
|
# 查看 Pod 状态
|
|
kubectl get pods -n uavcloud-live-test
|
|
|
|
# 查看服务状态
|
|
kubectl get svc -n uavcloud-live-test
|
|
|
|
# 查看 Media Suite 日志
|
|
kubectl logs -f deployment/helm-live-media-suite -n uavcloud-live-test -c zlm
|
|
kubectl logs -f deployment/helm-live-media-suite -n uavcloud-live-test -c wvp
|
|
kubectl logs -f deployment/helm-live-media-suite -n uavcloud-live-test -c zlm-oss
|
|
```
|
|
|
|
```text
|
|
下面的内容为运维内容，按需查看即可 =================================================================================
|
|
```
|
|
|
|
## 服务访问
|
|
|
|
### Media Suite (HostNetwork 模式)
|
|
|
|
使用宿主机 IP 直接访问:
|
|
|
|
| 服务 | 协议 | 端口 | 示例 |
|
|
|------------|--------|------|-------------------------|
|
|
| WVP HTTP | HTTP | 7082 | http://<NODE_IP>:7082 |
|
|
| WVP SIP | UDP | 7060 | <NODE_IP>:7060 |
|
|
| ZLM HTTP | HTTP | 7088 | http://<NODE_IP>:7088 |
|
|
| ZLM HTTPS | HTTPS | 7089 | https://<NODE_IP>:7089 |
|
|
| ZLM RTMP | RTMP | 7935 | rtmp://<NODE_IP>:7935 |
|
|
| ZLM RTSP | RTSP | 7554 | rtsp://<NODE_IP>:7554 |
|
|
| ZLM WebRTC | WebRTC | 7090 | webrtc://<NODE_IP>:7090 |
|
|
| ZLM SRT | SRT | 7556 | srt://<NODE_IP>:7556 |
|
|
| ZLM-OSS | HTTP | 7084 | http://<NODE_IP>:7084 |
|
|
|
|
### 其他服务 (NodePort 模式)
|
|
|
|
| 服务 | 端口 | 示例 |
|
|
|---------------|-------|------------------------|
|
|
| Live Operator | 37086 | http://<NODE_IP>:37086 |
|
|
| Live Proxy | 37081 | http://<NODE_IP>:37081 |
|
|
| Live Helper | 37080 | http://<NODE_IP>:37080 |
|
|
|
|
### 容器间通信
|
|
|
|
由于使用 HostNetwork 和同 Pod 部署,容器间通过 `127.0.0.1` 通信:
|
|
|
|
- WVP → ZLM: `http://127.0.0.1:7088`
|
|
- ZLM → WVP Hooks: `http://127.0.0.1:7082`
|
|
- ZLM → ZLM-OSS Hooks: `http://127.0.0.1:7084`
|
|
|
|
### 共享存储
|
|
|
|
ZLM 和 ZLM-OSS 挂载同一个 PVC:
|
|
|
|
- ZLM: `/home/koisi/zlm/www/zlm/hls`
|
|
- ZLM-OSS: `/cmii/share/hls`
|
|
|
|
## 运维操作
|
|
|
|
### 查看日志
|
|
|
|
```bash
|
|
# Media Suite - WVP
|
|
kubectl logs -f deployment/helm-live-media-suite -n uavcloud-live-test -c wvp
|
|
|
|
# Media Suite - ZLM
|
|
kubectl logs -f deployment/helm-live-media-suite -n uavcloud-live-test -c zlm
|
|
|
|
# Media Suite - ZLM-OSS
|
|
kubectl logs -f deployment/helm-live-media-suite -n uavcloud-live-test -c zlm-oss
|
|
|
|
# Live Operator
|
|
kubectl logs -f deployment/helm-live-live-op -n uavcloud-live-test
|
|
```
|
|
|
|
### 进入容器
|
|
|
|
```bash
|
|
# 进入 ZLM 容器
|
|
kubectl exec -it deployment/helm-live-media-suite -n uavcloud-live-test -c zlm -- bash
|
|
|
|
# 进入 WVP 容器
|
|
kubectl exec -it deployment/helm-live-media-suite -n uavcloud-live-test -c wvp -- bash
|
|
```
|
|
|
|
### 升级服务
|
|
|
|
```bash
|
|
# 修改 values.yaml 后执行升级
|
|
helm upgrade helm-live ./merge -n uavcloud-live-test -f values.yaml
|
|
|
|
# 或使用部署脚本
|
|
bash deploy.sh
|
|
```
|
|
|
|
### 回滚
|
|
|
|
```bash
|
|
# 查看历史版本
|
|
helm history helm-live -n uavcloud-live-test
|
|
|
|
# 回滚到指定版本
|
|
helm rollback helm-live <REVISION> -n uavcloud-live-test
|
|
```
|
|
|
|
### 卸载
|
|
|
|
```bash
|
|
helm uninstall helm-live -n uavcloud-live-test
|
|
```
|