快速开始

Clusternet 快速入门

本教程将引导您：

将Clusternet安装到本地通过 kind 创建的1个父集群和3个子集群中。
检查子集群注册状态
将应用程序部署到多个集群

准备工作

一些已知问题

由于 “too many open files” 导致的pod错误

你可能会发现一些pod无法运行，这些pod的日志中显示 “too many open files”.

这种现象可能是由于 inotify 资源耗尽导致的.这种资源的限制在 fs.inotify.max_user_watches 和 fs.inotify.max_user_instances 这两个系统变量中定义. 例如, 在 Ubuntu 系统中，这些变量的默认值分别为 8192 和 128, 这不足以创建多种包含多个pod的k8s cluster。

临时提高此资源的限制，可以在主机上运行以下命令:

sudo sysctl fs.inotify.max_user_watches=524288
sudo sysctl fs.inotify.max_user_instances=512

如果要固化这项修改，请编辑这个文件 /etc/sysctl.conf，添加以下几行内容:

fs.inotify.max_user_watches = 524288
fs.inotify.max_user_instances = 512

项目准备

拉取项目到本地

mkdir -p $GOPATH/src/github.com/clusternet/
cd $GOPATH/src/github.com/clusternet/
git clone https://github.com/clusternet/clusternet
cd clusternet

安装 Clusternet

执行下面脚本,

hack/local-running.sh

如果一切顺利，您将看到如下信息提示:

Local clusternet is running now.
To start using clusternet, please run:
  export KUBECONFIG="${HOME}/.kube/clusternet.config"
  kubectl config get-contexts

当你执行 kubectl config get-contexts命令时, 你会看到1个父集群和3个子集群，并且 Clusternet也被自动部署。

# kubectl config get-contexts
CURRENT   NAME     CLUSTER       AUTHINFO      NAMESPACE
          child1   kind-child1   kind-child1   
          child2   kind-child2   kind-child2   
          child3   kind-child3   kind-child3   
*         parent   kind-parent   kind-parent
# kubectl get pod -n clusternet-system
NAME                                            READY   STATUS    RESTARTS   AGE
clusternet-controller-manager-5b54d5f95-bnq8l   1/1     Running   0          2m
clusternet-controller-manager-5b54d5f95-kn6mw   1/1     Running   0          2m
clusternet-controller-manager-5b54d5f95-pkmc6   1/1     Running   0          2m
clusternet-hub-6c7bbcbd68-flbwm                 1/1     Running   0          2m3s
clusternet-hub-6c7bbcbd68-m4rkx                 1/1     Running   0          2m3s
clusternet-hub-6c7bbcbd68-rkw5c                 1/1     Running   0          2m3s
clusternet-scheduler-8675d64884-4r8rx           1/1     Running   0          2m1s
clusternet-scheduler-8675d64884-7nx5d           1/1     Running   0          2m1s
clusternet-scheduler-8675d64884-8c8f5           1/1     Running   0          2m1s

检查集群注册

请按照该教程检查集群注册状态。

将应用程序部署到子集群

请按照我们的交互式教程从父集群中将应用程序部署到上述三个子集群中。如果你在父集群中安装了 clusternet-agent，那么它也可以将自己注册为子集群。

Feedback

Was this page helpful?

Glad to hear it! Please tell us how we can improve.

Sorry to hear that. Please tell us how we can improve.

最后修改 2023.05.04: add zh doc for multi-cluster-apps and quick-start (#81) (0e5bc8c)