13.10. 클러스터 검사 실행

절차

1. 프레임워크를 설정하는 리소스가 포함된 구성 파일을 생성합니다. 여기에는 프레임워크의 네임스페이스 및 서비스 계정, 서비스 계정에 대한 권한을 정의하는 ClusterRole 및 ClusterRoleBinding 오브젝트가 포함됩니다.

   예 13.3. 프레임워크 매니페스트 파일 예

   ---
   apiVersion: v1
   kind: Namespace
   metadata:
     name: kiagnose
   ---
   apiVersion: v1
   kind: ServiceAccount
   metadata:
     name: kiagnose
     namespace: kiagnose
   ---
   apiVersion: rbac.authorization.k8s.io/v1
   kind: ClusterRole
   metadata:
     name: kiagnose
   rules:
     - apiGroups: [ "" ]
       resources: [ "configmaps" ]
       verbs:
         - get
         - list
         - create
         - update
         - patch
     - apiGroups: [ "" ]
       resources: [ "namespaces" ]
       verbs:
         - get
         - list
         - create
         - delete
         - watch
     - apiGroups: [ "" ]
       resources: [ "serviceaccounts" ]
       verbs:
         - get
         - list
         - create
     - apiGroups: [ "rbac.authorization.k8s.io" ]
       resources:
         - roles
         - rolebindings
         - clusterrolebindings
       verbs:
         - get
         - list
         - create
         - delete
     - apiGroups: [ "rbac.authorization.k8s.io" ]
       resources:
         - clusterroles
       verbs:
         - get
         - list
         - create
         - bind
     - apiGroups: [ "batch" ]
       resources: [ "jobs" ]
       verbs:
         - get
         - list
         - create
         - delete
         - watch
   ---
   apiVersion: rbac.authorization.k8s.io/v1
   kind: ClusterRoleBinding
   metadata:
     name: kiagnose
   roleRef:
     apiGroup: rbac.authorization.k8s.io
     kind: ClusterRole
     name: kiagnose
   subjects:
     - kind: ServiceAccount
       name: kiagnose
       namespace: kiagnose
   ...

2. 프레임워크 매니페스트를 적용합니다.

   $ oc apply -f <framework_manifest>.yaml

3. 검사를 통해 클러스터 액세스에 필요한 권한을 사용하여 ClusterRole 및 Role 오브젝트가 포함된 구성 파일을 만듭니다.

   클러스터 역할 매니페스트 파일 예

   apiVersion: rbac.authorization.k8s.io/v1
   kind: ClusterRole
   metadata:
     name: kubevirt-vm-latency-checker
   rules:
   - apiGroups: ["kubevirt.io"]
     resources: ["virtualmachineinstances"]
     verbs: ["get", "create", "delete"]
   - apiGroups: ["subresources.kubevirt.io"]
     resources: ["virtualmachineinstances/console"]
     verbs: ["get"]
   - apiGroups: ["k8s.cni.cncf.io"]
     resources: ["network-attachment-definitions"]
     verbs: ["get"]

4. 검사 역할 매니페스트를 적용합니다.

   $ oc apply -f <latency_roles>.yaml

5. 확인에 대한 입력 매개변수가 포함된 ConfigMap 매니페스트를 생성합니다. 구성 맵은 검사를 실행하고 점검 결과를 저장할 프레임워크에 대한 입력을 제공합니다.

   입력 구성 맵의 예

   apiVersion: v1
   kind: ConfigMap
   metadata:
     name: kubevirt-vm-latency-checkup
     namespace: kiagnose
   data:
     spec.image: registry.redhat.io/container-native-virtualization/vm-network-latency-checkup:v4.11.0
     spec.timeout: 10m
     spec.clusterRoles: |
       kubevirt-vmis-manager
     spec.param.network_attachment_definition_namespace: "default" 1
     spec.param.network_attachment_definition_name: "bridge-network" 2
     spec.param.max_desired_latency_milliseconds: "10" 3
     spec.param.sample_duration_seconds: "5" 4

   1

   NetworkAttachmentDefinition 오브젝트가 있는 네임스페이스입니다.

   2

   NetworkAttachmentDefinition 오브젝트의 이름입니다.

   3

   선택 사항: 가상 머신 간에 필요한 최대 대기 시간(밀리초)입니다. 측정된 대기 시간이 이 값을 초과하면 검사가 실패합니다.

   4

   선택 사항: 대기 시간 점검 기간(초)입니다.

6. 프레임워크의 네임스페이스에 구성 맵을 생성합니다.

   $ oc apply -f <latency_config_map>.yaml

7. 검사를 실행할 Job 오브젝트를 생성합니다.

   작업 매니페스트 예

   apiVersion: batch/v1
   kind: Job
   metadata:
     name: kubevirt-vm-latency-checkup
     namespace: kiagnose
   spec:
     backoffLimit: 0
     template:
       spec:
         serviceAccount: kiagnose
         restartPolicy: Never
         containers:
           - name: framework
             image: registry.redhat.io/container-native-virtualization/checkup-framework:v4.11.0
             env:
               - name: CONFIGMAP_NAMESPACE
                 value: kiagnose
               - name: CONFIGMAP_NAME
                 value: kubevirt-vm-latency-checkup

8. 작업 매니페스트를 적용합니다. 점검에서는 ping 유틸리티를 사용하여 연결을 확인하고 대기 시간을 측정합니다.

   $ oc apply -f <latency_job>.yaml

9. 작업이 완료될 때까지 기다립니다.

   $ oc wait --for=condition=complete --timeout=10m job.batch/kubevirt-vm-latency-checkup -n kiagnose

10. ConfigMap 오브젝트의 상태를 검색하여 대기 시간 점검 결과를 검토합니다. 측정된 대기 시간이 spec.param.max_desired_latency_ millisecondss 속성보다 크면 확인 작업이 실패하고 오류를 반환합니다.

    $ oc get configmap kubevirt-vm-latency-checkup -n kiagnose -o yaml

    출력 구성 맵(success)의 예

    apiVersion: v1
    kind: ConfigMap
    metadata:
      name: kubevirt-vm-latency-checkup
      namespace: kiagnose
    ...
      status.succeeded: "true"
      status.failureReason: ""
      status.result.minLatencyNanoSec: 2000
      status.result.maxLatencyNanoSec: 3000
      status.result.avgLatencyNanoSec: 2500
      status.results.measurementDurationSec: 300
    ...

11. 프레임워크를 삭제하고 이전에 생성한 리소스를 확인합니다. 여기에는 작업, 구성 맵, 클러스터 역할, 프레임워크 매니페스트 파일이 포함됩니다.

    참고

    다른 검사를 실행하려는 경우 프레임워크 및 클러스터 역할 매니페스트 파일을 삭제하지 마십시오.

    $ oc delete -f <file_name>.yaml