从零开始：cube-studio 云原生机器学习平台单机部署全攻略
1. 环境准备：从零搭建你的机器学习工作站
第一次接触cube-studio的朋友可能会被"云原生"这个词吓到，其实单机部署比想象中简单得多。我去年在旧笔记本上测试时，发现只要硬件配置过得去，整个过程就像搭积木一样有趣。咱们先从最基础的环境搭建说起，我会把每个细节都掰开揉碎讲清楚。
操作系统建议选择Ubuntu 20.04 LTS版本，这个版本长期支持且社区资源丰富。我实测过18.04和22.04，前者有些依赖包需要手动解决，后者偶尔会遇到兼容性问题。安装系统时记得勾选"安装OpenSSH服务器"，后面远程操作会方便很多。内存建议至少8GB，我试过4GB的机器，跑起来就像老牛拉车一样吃力。
装好系统后第一件事是更新软件源，这个步骤很多教程会忽略，但能避免很多奇怪的依赖问题：
sudo apt update && sudo apt upgrade -y sudo apt install -y curl git vim net-tools2. Docker安装与配置：容器化部署的基石
Docker是cube-studio运行的基础环境，这里有个小坑要注意：社区版和企业版的区别。我刚开始用企业版踩过坑，后来发现社区版反而更稳定。安装时建议指定版本号，避免自动升级带来意外：
sudo apt install -y docker.io=20.10.7-0ubuntu5安装完成后需要把当前用户加入docker组，不然每次都要sudo很麻烦：
sudo usermod -aG docker $USER newgrp docker # 立即生效不用重启配置国内镜像加速能大幅提升拉取镜像的速度，这是我常用的配置：
sudo mkdir -p /etc/docker sudo tee /etc/docker/daemon.json <<-'EOF' { "registry-mirrors": ["https://mirror.ccs.tencentyun.com"] } EOF sudo systemctl restart docker验证安装是否成功时，别只用docker version就完事，我建议跑个实际容器测试：
docker run --rm hello-world3. Kubernetes单机部署：迷你版云环境搭建
cube-studio依赖Kubernetes环境，单机部署我们选用轻量级的minikube。这里有个性能优化技巧：使用docker作为驱动比默认的virtualbox快很多：
curl -LO https://storage.googleapis.com/minikube/releases/latest/minikube-linux-amd64 sudo install minikube-linux-amd64 /usr/local/bin/minikube minikube start --driver=docker --image-mirror-country='cn'部署完成后需要安装kubectl管理工具，版本要和minikube匹配：
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 get pods -A && minikube status4. Cube-Studio核心部署：步步为营的实战指南
终于来到重头戏，从GitHub拉取代码时建议使用国内镜像加速：
git clone https://github.com/tencentmusic/cube-studio.git --depth=1 cd cube-studio/install/kubernetes启动前有个关键步骤很多人会忽略——修改命名空间。我去年帮三个团队部署时，都因为没改这个导致服务冲突：
sed -i 's/default/cube-studio/g' $(grep -rl "default" ./)执行启动脚本时可能会遇到Redis镜像问题，这是我验证过的解决方案：
sudo docker pull ranchercharts/bitnami-redis sudo docker tag ranchercharts/bitnami-redis bitnami/redis启动命令建议这样写，可以实时查看日志：
bash start.sh | tee install.log5. 部署后配置：让你的平台真正跑起来
部署完成后需要重置默认密码，这里有两种情况处理：
# 知道原密码的情况 https://<你的服务器IP>:443/update-password # 忘记密码的情况 sudo docker exec -it <container_id> reset-password几个关键的管理界面需要收藏：
- 集群管理：https://:443/
- 应用页面：http://:8080/
我建议首次登录后立即做三件事：
- 在系统设置里配置SMTP邮件服务
- 创建第一个测试项目验证功能
- 设置定期备份任务
6. 常见问题排坑指南
问题1：镜像拉取失败这是最常见的问题，解决方法是在pull_image_kubeflow.sh脚本里替换镜像源。我整理了几个可靠的国内源：
sed -i 's/ccr.ccs.tencentyun.com/mirror.ccs.tencentyun.com/g' pull_image_kubeflow.sh问题2：缺少knative-serving组件手动安装这个组件：
kubectl apply -f https://github.com/knative/serving/releases/download/v0.22.0/serving-crds.yaml kubectl apply -f https://github.com/knative/serving/releases/download/v0.22.0/serving-core.yaml问题3：端口冲突检查端口占用情况：
ss -tulnp | grep -E '443|80|8080'7. 环境清理与重置
当部署失败需要重来时，这个清理脚本能帮你节省大量时间：
docker stop $(docker ps -aq) docker system prune -f docker volume rm -f $(docker volume ls -q) # 谨慎执行以下命令，会删除所有镜像 # docker image rm -f $(docker image ls -q) # 清理Kubernetes残留 sudo rm -rf /etc/ceph /etc/cni /etc/kubernetes /opt/cni /opt/rke \ /run/secrets/kubernetes.io /run/calico /run/flannel \ /var/lib/calico /var/lib/etcd /var/lib/cni \ /var/lib/kubelet /var/lib/rancher/rke/log \ /var/log/containers /var/log/pods /var/run/calico清理完成后建议重启机器，确保所有服务干净启动。我在某次部署中遇到过网络插件残留导致的问题，重启后神奇地解决了。