OpenYurt — Yurtctl

深藏阁楼爱情的钟 2023-10-05 16:29 8阅读 0赞

## 目录 ##

#### 文章目录 ####

*  目录
 *  Yurtctl
 *  一键转换 Kubernetes 集群为 OpenYurt
 *  将 OpenYurt 转换回 Kubernetes

## Yurtctl ##

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0ptaWxr_size_16_color_FFFFFF_t_70]

*  文档：https://github.com/alibaba/openyurt/tree/master/docs/tutorial

Yurtctl 是一个中心化的管控工具，直接与 Kubernetes API Server 进行交互。它借助原生 Kubernetes 的 Job workload 对每个 Node 进行运维操作。如上图所示，在执行转换（Convert）操作时，Yurtctl 会通过 Job 将一个 servant Pod 部署到用户指定的 Edge Node 上。

由于 servant Pod 需要直接操作节点 root 用户的文件系统，例如：将 yurthub 配置文件放置于 /etc/kubernetes/manifests 目录下，并且需要重置系统管理程序（kubelet.service），servant Pod 中的 container 将被赋予 privileged 权限，允许其与节点共享 pid namespace，并将借由 nsenter 命令进入节点主命名空间完成相关操作。当 servant Job 成功执行后，Job 会自动删除。如果失败，Job 则会被保留，方便运维人员排查错误原因。借由该机制，Yurtctl 还可对 Yurthub 进行更新或者删除。

## 一键转换 Kubernetes 集群为 OpenYurt ##

*  下载 OpenYurt 仓库之后，即可通过编译获得 yurtctl，编译成功之后，yurtctl 可执行文件就可以在 \_output/bin/ 目录下找到：

$ make build WHAT=cmd/yurtctl
    hack/make-rules/build.sh cmd/yurtctl
    Building cmd/yurtctl

*  将 Kubernetes 转换为 OpenYurt：如果我们想将一个双节点（node1 和 node2）的 Kubernetes 集群转换成 OpenYurt 集群，并且只想让 node2 成为自治边缘节点，那么可以通过执行 yurtctl convert 来实现，具体命令如下：

$ yurtctl convert --cloud-nodes node1 --provider ack
    I0603 14:34:33.714304   40825 convert.go:164] mark node1 as the cloud-node
    I0603 14:34:33.719816   40825 convert.go:172] mark node2 as the edge-node
    I0603 14:34:33.736609   40825 convert.go:198] deploy the yurt controller manager
    I0603 14:34:33.742272   40825 convert.go:210] deploying the yurt-hub and resetting the kubelet service...
    I0603 14:34:53.810165   40825 util.go:168] servant job(yurtctl-servant-convert-node2) has succeeded

*  成功配置节点之后，我们需要将边缘节点标记为自治状态，具体命令如下：

# 如果用户只想标记部分边缘节点，则可以使用 --autonomous-nodes 选项指定
    $ yurtctl markautonomous 
    I0602 11:22:05.610222   89160 markautonomous.go:149] mark node2 as autonomous

*  接着我们就可以测试 node2 在断网环境下是否能实现节点自治。首先，在 node2 上部署一个测试 pod：

$ kubectl apply -f-<<EOF
    apiVersion: v1
    kind: Pod
    metadata:
      name: bbox
    spec:
      nodeName: node2
      containers:
      - image: busybox
        command:
        - top
        name: bbox
    EOF
    pod/bbox created

登陆到 node2 上，将 Yurthub 的 --server-addr 参数设置为一个不可访问的地址：

sudo sed -i 's|--server-addr=.*|--server-addr=https://1.1.1.1:1111|' /etc/kubernetes/manifests/yurt-hub.yaml

耐心等待 40 秒，我们将观察到，即使 node2 已经处于 NotReady 状态，pod1 仍然处于 Running 状态。这说明当边缘节点处于自治状态时，即使 node 不在线，Pod 也不会被云端 node controller 驱逐。

$ kubectl get node 
    NAME           STATUS     ROLES    AGE   VERSION
    node1          Ready      master   14m   v1.14.8
    node2          NotReady   <none>   12m   v1.14.8
    $ kubectl get pod
    NAME   READY   STATUS    RESTARTS   AGE
    bbox   1/1     Running   0          5m12s

这时如果将 node2 重启，我们可以用 docker ps （假设节点使用 docker 作为 container runtime）命令来验证 bbox Pod 会被重新拉起。

$ docker ps --format 'table {
        {.ID}}\t{
        {.Image}}\t{
        {.RunningFor}}' | grep busybox
    d0c8134fddc1        busybox          About a minutes ago

这是因为 Kubelet 会从 Yurthub 读取缓存的数据，恢复重启前的 Pod 状态。

## 将 OpenYurt 转换回 Kubernetes ##

相对的，通过运行 yurtctl revert 命令，用户可以将一个 OpenYurt 集群转换回 Kubernetes 集群。假设我们想将上述双节点 Kubernetes 集群转换回 Kubernetes 模式，那么只需运行以下命令即可（运行该命令前，请先将 node2 上的 yurthub 重新连上 apiserver）：

$ yurtctl revert
    I0603 14:38:55.522376   41016 revert.go:106] label alibabacloud.com/is-edge-worker is removed
    I0603 14:38:55.527998   41016 revert.go:116] yurt controller manager is removed
    I0603 14:38:55.548354   41016 revert.go:130] ServiceAccount node-controller is created
    I0603 14:39:05.572686   41016 util.go:168] servant job(yurtctl-servant-revert-node2) has succeeded
    I0603 14:39:05.572718   41016 revert.go:142] yurt-hub is removed, kubelet service is reset

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0ptaWxr_size_16_color_FFFFFF_t_70]: https://img-blog.csdnimg.cn/20201226205837406.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0ptaWxr,size_16,color_FFFFFF,t_70