本文档采用自动化机器翻译技术翻译。 尽管我们力求提供准确的译文，但不对翻译内容的完整性、准确性或可靠性作出任何保证。 若出现任何内容不一致情况，请以原始 英文 版本为准，且原始英文版本为权威文本。

创建并导入您的第一个集群

本节将指导您创建第一个集群并将其导入到 Rancher Manager 中。提供了两种集群配置的替代方法：使用 Fleet 的 GitOps 工作流 和 通过 kubectl 手动应用清单。

先决条件

配置 CAPI 工作负载集群

  • 使用 Fleet 的 GitOps

  • 手动使用 kubectl

配置您的 Fleet 储存库

为了简化集群配置过程，我们将使用一系列预配置的示例，您可以在储存库 https://github.com/rancher/turtles/tree/main/examples. 中找到。通过检查该储存库的内容，您将发现：

  1. 一个 applications 文件夹，包含可以使用 Fleet 部署的其他应用程序（CNI、CSI、CPI）。

  2. 一个 clusterclasses 文件夹，里面有一堆 ClusterClass 示例。

  3. 一个 clusters/docker/rke2 文件夹，里面有 Docker 集群定义的示例。

    如果您愿意，可以使用相同的基础结构创建自己的 Fleet 储存库。

使用 Rancher UI 添加您的 Fleet 储存库

现在集群定义已提交到 git 储存库，可以用于配置集群。为此，它们需要通过 持续交付 功能（使用 Fleet）导入到 Rancher Manager 集群中（该集群也充当集群 API 管理集群）。

  1. 前往 Rancher Manager

  2. 从菜单中选择 持续交付： 侧边栏

  3. 从右上角选择 fleet-local 作为名称空间 名称空间

  4. 从侧边栏选择 Git Repos

  5. 单击*添加储存库*

  6. 将*clusters*作为名称输入

  7. 从您的 git 储存库获取*HTTPS* 克隆 URL git clone url

  8. 将 URL 添加到*储存库 URL*字段中

  9. 将分支名称更改为*main*

  10. 添加以下路径以指定要部署的目录：

    Fleet 路径配置

    examples/clusterclasses/docker/rke2
examples/applications/cni/calico
examples/applications/lb/docker
examples/clusters/docker/rke2

  11. 单击*下一步*

  12. 单击*创建*

  13. 单击*clusters*名称

  14. 观察资源变为就绪

  15. 从菜单中选择*集群管理*

  16. 检查您的集群是否已导入

应用集群资源

要使用 kubectl 创建集群，请运行以下命令：

  1. 打开终端并应用 ClusterClass 和相关模板：

    kubectl apply -f https://raw.githubusercontent.com/rancher/turtles/refs/heads/main/examples/clusterclasses/docker/rke2/clusterclass-docker-rke2.yaml

  2. 应用负载均衡器配置：

    kubectl apply -f https://raw.githubusercontent.com/rancher/turtles/refs/heads/main/examples/applications/lb/docker/configmap.yaml

  3. 应用 CNI (Calico) 配置：

    kubectl apply -f https://raw.githubusercontent.com/rancher/turtles/refs/heads/main/examples/applications/cni/calico/helm-chart.yaml

  4. 创建集群：

    kubectl apply -f https://raw.githubusercontent.com/rancher/turtles/refs/heads/main/examples/clusters/docker/rke2/cluster.yaml

  5. 查看资源准备就绪：

    kubectl get clusters -w

  6. 从菜单中选择*集群管理*

  7. 检查您的集群是否已导入

后续步骤：等待集群在 Rancher 仪表板中出现

本教程中配置的集群包含`cluster-api.cattle.io/rancher-auto-import`标签。 该标签将指示Turtles自动将集群导入Rancher。 有关更多信息，请参阅Rancher 集群注册。