How to use `kubeconfig` to experience OpenYurt capabilities

This document will describe how to experience the multi-domain workload manage capability of OpenYurt through kubeconfig provided by Experience Center.

Configure kubeconfig locally

You need to configure kubeconfig locally before you can manage the cluster via kubectl.

1. Copy kubeconfig information in "Connection Information" tab under "Cluster Information" page

2. Save the copied kubeconfig information to the local ~/.kube/config file

3. If the configuration is correct, you can use kubectl to manage the cluster

Experience OpenYurt's multi-domain workload manage capability

OpenYurt is designed for edge computing scenarios, allowing users to group workloads into different units distributed in different geographical locations. Here is a simple scenario to experience the multi-domain workload manage capability of OpenYurt.

Now that we have two edge-side nodes, node1 and node2, in different locations (e.g. node1 in Hangzhou and node2 in Shanghai). We want to deploy applications to the Hangzhou node but not to the Shanghai node. OpenYurt does this with two resources, NodePool and YurtAppSet (previous UnitedDeployment) to achieve this capability.

1. Suppose we have two nodes, node1 and node2, connected to OpenYurt cluster (Don't know how to join nodes? Please refer to the documentation: How to use web_console)

2. Create a NodePool resource by kubectl on local node where kubeconfig is configured, and add node1 to that NodePool

# 创建nodepool hangzhou
cat <<EOF | kubectl apply -f -
apiVersion: apps.openyurt.io/v1alpha1
kind: NodePool
metadata:
  name: hangzhou
spec:
  type: Edge
EOF


# 将node1节点加入nodepool
kubectl label node node1 apps.openyurt.io/desired-nodepool=hangzhou

# 获取nodepool
kubectl get nodepool

The corresponding NodePool information can be seen in browser page.

3. Create workload resources via kubectl and only deploy the application to hangzhou's node pool via YurtAppSet

# 单元化部署pod
cat <<EOF | kubectl apply -f -
apiVersion: apps.openyurt.io/v1alpha1
kind: UnitedDeployment
metadata:
  labels:
    controller-tools.k8s.io: "1.0"
  name: ud-test
  namespace: "183xxxxxxxx"  # 注意: 替换成你的namespace
spec:
  selector:
    matchLabels:
      app: ud-test
  workloadTemplate:
    deploymentTemplate:
      metadata:
        labels:
          app: ud-test
      namespace: "183xxxxxxxx"  # 注意: 替换成你的namespace
      spec:
        template:
          metadata:
            labels:
              app: ud-test
          spec:
            containers:
              - name: nginx
                image: nginx
  topology:
    pools:
    - name: hangzhou
      nodeSelectorTerm:
        matchExpressions:
        - key: apps.openyurt.io/nodepool
          operator: In
          values:
          - hangzhou
      replicas: 1
  revisionHistoryLimit: 5
EOF

# 查看资源
kubectl get node
kubectl get pod -A
kubectl get nodepool

After successful creation, you can see on the browser page that the corresponding Pod is assigned to node1 in hangzhou node pool.