VMware Tanzu Labs Educates 培训平台本地开发环境搭建指南

前言

VMware Tanzu Labs Educates 培训平台是一个功能强大的Kubernetes教学平台，专为技术培训和教育场景设计。本文将详细介绍如何在本地环境中搭建Educates开发环境，帮助开发者高效地进行培训内容开发。

本地环境概述

Educates提供了一个命令行工具，可以快速在本地创建基于Kind的Kubernetes集群，并部署完整的Educates平台。这个本地环境包含以下核心组件：

1. 基于Kind的轻量级Kubernetes集群
2. Educates平台核心服务
3. 本地镜像仓库（用于存储培训内容和自定义基础镜像）
4. 可选的本地DNS解析器
5. 可选的镜像镜像服务

基础环境搭建

创建本地集群

使用以下命令创建本地Kubernetes集群并部署Educates：

educates create-cluster

这个命令会执行以下操作：

1. 使用Kind创建本地Kubernetes集群
2. 部署Educates平台组件
3. 创建本地镜像仓库
4. 配置默认的nip.io域名访问

删除本地集群

当开发工作完成后，可以使用以下命令删除集群：

educates delete-cluster

如果需要完全清理所有资源（包括本地镜像仓库和DNS解析器），可以添加--all参数：

educates delete-cluster --all

本地镜像仓库管理

Educates本地环境包含一个专用的镜像仓库，用于存储培训内容和自定义镜像。

镜像仓库基本使用

• 推送镜像到本地仓库时，使用localhost:5001作为仓库地址
• 在Kubernetes集群内部，可以使用registry.default.svc.cluster.local访问仓库
• 在培训定义中，推荐使用$(image_repository)变量引用仓库地址

镜像仓库维护

清理未引用的镜像层以释放空间：

educates local registry prune

重新部署镜像仓库：

educates local registry deploy

删除镜像仓库：

educates local registry delete

自定义配置

配置管理

Educates支持通过YAML文件进行自定义配置：

编辑全局默认配置：

educates local config edit

查看当前配置：

educates local config view

自定义域名配置

默认使用nip.io域名存在以下限制：

• 无法获取官方信任的TLS证书
• 某些需要安全入口的功能无法使用

建议使用自定义域名并配置TLS证书：

educates create-cluster --domain your-domain.test

或在配置文件中指定：

clusterIngress:
  domain: your-domain.test

TLS证书配置

添加TLS证书

对于使用Let's Encrypt生成的证书：

educates local secrets add tls your-domain-tls \
 --cert /path/to/fullchain.pem \
 --key /path/to/privkey.pem \
 --domain your-domain.test

对于自签名CA证书：

educates local secrets add ca your-domain-ca \
 --cert /path/to/rootCA.pem \
 --domain your-domain.test

本地DNS解析器

在macOS上部署本地DNS解析器：

educates local resolver deploy

创建resolver配置文件：

sudo mkdir /etc/resolver
sudo sh -c "cat > /etc/resolver/your-domain.test << EOF
nameserver 127.0.0.1
EOF"

测试DNS解析：

scutil --dns www.your-domain.test

删除DNS解析器：

educates local resolver delete

镜像镜像服务

镜像镜像服务可以缓存远程仓库的镜像，提高拉取速度并减少带宽消耗。

配置镜像镜像

在集群配置中添加：

localKindCluster:
  registryMirrors:
    - mirror: docker.io
      url: registry-1.docker.io

管理镜像镜像

部署镜像镜像：

educates local mirror deploy docker.io --url registry-1.docker.io

删除镜像镜像：

educates local mirror delete docker.io

最佳实践建议

1. 对于长期开发环境，建议使用自定义域名而非nip.io
2. 为生产环境准备时，应使用可信CA签发的证书
3. 定期清理镜像仓库以释放磁盘空间
4. 对于常用基础镜像，配置镜像镜像服务提高效率
5. 在团队开发中，统一配置管理可以保证环境一致性

常见问题排查

1. DNS解析失败：检查/etc/resolver配置和本地解析器服务状态
2. 证书信任问题：确保CA证书已正确添加到系统和Educates配置
3. 镜像拉取失败：验证镜像镜像服务配置和网络连接
4. 资源不足：Kind集群默认配置较低，可根据需要调整资源分配

通过本文介绍的配置方法，开发者可以快速搭建功能完善的Educates本地开发环境，高效地进行培训内容开发和测试。