Kubernetes에서 AlloyDB Omni용 커널 파라미터 구성

커널 매개변수를 구성하면 AlloyDB Omni가 과도한 워크로드를 처리할 때 시스템 메모리와 IO 리소스를 더 효율적으로 사용할 수 있습니다.

기본 요건

시작하기 전에 Kubernetes 노드가 Linux 커널 6.1 이상, 특히 MADV_COLLAPSE 및 MADV_POPULATE_WRITE 플래그를 지원하는 커널을 실행하는지 확인하세요. 이러한 플래그에 대한 자세한 내용은 Linux madwise 문서를 참고하세요.

Kubernetes 노드에 권장 커널 설정 적용

다음 표에는 데이터베이스 클러스터 포드를 실행하는 Kubernetes 노드에 필요한 커널 매개변수와 해당 값이 나와 있습니다.

DaemonSet를 사용하여 Kubernetes 노드에서 커널 매개변수를 구성하려면 다음 단계를 따르세요.

1. 노드에 라벨 추가의 안내에 따라 데이터베이스 클러스터를 실행할 노드에 라벨을 적용합니다.

2. LABEL_KEY=LABEL_VALUE 라벨이 지정된 노드에서 커널 매개변수를 설정하려면 DaemonSet를 만드세요.

   cat << EOF | kubectl apply -f -
   apiVersion: apps/v1
   kind: DaemonSet
   metadata:
     name: alloydb-omni-kernel-tuning
     namespace: DS_NAMESPACE
   spec:
     selector:
       matchLabels:
         name: alloydb-omni-kernel-tuning
     template:
       metadata:
         labels:
           name: alloydb-omni-kernel-tuning
       spec:
         volumes:
           - name: host-sys
             hostPath:
               path: /sys
         nodeSelector:
           LABEL_KEY: "LABEL_VALUE"
         restartPolicy: Always
         terminationGracePeriodSeconds: 1
         initContainers:
           - name: enable-thp-mmc
             image: INIT_IMAGE
             volumeMounts:
               - name: host-sys
                 mountPath: /sys
             securityContext:
               privileged: true
             command: ["sh", "-c", "sysctl -w vm.max_map_count=MAX_MAP_COUNT && echo within_size >/sys/kernel/mm/transparent_hugepage/shmem_enabled"]
         containers:
           - name: CONTAINER_NAME
             image: CONTAINER_IMAGE
             command: ["watch", "-n", "600", "cat", "/sys/kernel/mm/transparent_hugepage/shmem_enabled"]
   EOF
   

   다음을 바꿉니다.

   • DS_NAMESPACE: DaemonSet을 배포할 네임스페이스입니다(예: default).
   • LABEL_KEY: 라벨의 식별자입니다(예: workload).
   • LABEL_VALUE: 라벨의 식별자와 연결된 데이터입니다(예: database).
   • INIT_IMAGE: init 컨테이너에 사용된 이미지의 이름입니다.
   • MAX_MAP_COUNT: 프로세스가 만들 수 있는 최대 메모리 맵 영역 수입니다(예: 1073741824).
   • CONTAINER_NAME: 기본 컨테이너의 이름입니다(예: main).
   • CONTAINER_IMAGE: 기본 컨테이너에 사용되는 이미지의 이름입니다(예: latest).

3. DaemonSet를 배포한 후 Kubernetes 클러스터의 모든 포드가 Running 상태이고 LABEL_KEY=LABEL_VALUE 라벨이 지정된 각 노드에 포드가 하나씩 있는지 확인하려면 다음 명령어를 사용하세요.

   kubectl get pods -l LABEL_KEY=LABEL_VALUE
   

   출력 예시는 다음과 같습니다.

   NAME                               READY   STATUS    RESTARTS   AGE
   alloydb-omni-kernel-tuning-2dkwh   1/1     Running   0          22s
   alloydb-omni-kernel-tuning-pgkbj   1/1     Running   0          19s
   

4. 커널 플래그가 성공적으로 적용되었는지 확인하려면 DaemonSet을 배포한 후 식별된 각 포드에 대해 다음 명령어를 실행합니다.

   kubectl logs POD_NAME
   

   POD_NAME을 로그를 검사하려는 포드의 이름으로 바꿉니다.

   출력 예시는 다음과 같습니다.

   always [within_size] advise never deny force
   

권장 커널 매개변수를 사용하여 Kubernetes 노드에서 데이터베이스 클러스터 실행

권장 커널 매개변수를 사용하여 Kubernetes 노드에 데이터베이스 클러스터를 배포하려면 데이터베이스 클러스터 매니페스트의 다음 섹션 중 하나에 nodeAffinity 섹션을 추가하세요.

• 기본 인스턴스의 경우 primarySpec.schedulingConfig
• 읽기 풀 인스턴스의 경우 spec.schedulingConfig

      nodeaffinity:
        requiredDuringSchedulingIgnoredDuringExecution:
          nodeSelectorTerms:
          - matchExpressions:
            - key: LABEL_KEY
              operator: In
              values:
              - "LABEL_VALUE"

특정 Kubernetes 노드에서 데이터베이스 클러스터를 실행하는 방법에 대한 자세한 내용은 예약을 사용하여 데이터베이스 클러스터에 노드 할당을 참고하세요.

커널 매개변수 적용 확인

커널 매개변수가 데이터베이스 포드에 적용되었는지 확인하려면 다음을 실행하세요.

1. 고가용성이 사용 설정된 경우(특히 spec.availability.numberOfStandbys이 0보다 큰 값으로 설정된 경우) 데이터베이스 맞춤 리소스가 DBCLUSTERPHASE 열에 DBClusterReady을 표시하고 HAREADYSTATUS 열에 True을 표시하는지 확인합니다.

   kubectl get dbcluster -n DBCLUSTER_NAMESPACE DBCLUSTER_NAME
   

   다음을 바꿉니다.

   • DBCLUSTER_NAME: 확인하는 데이터베이스 클러스터의 이름입니다.
   • DBCLUSTER_NAMESPACE: 데이터베이스 클러스터가 있는 특정 네임스페이스의 이름입니다.

   출력 예시는 다음과 같습니다.

   NAME               PRIMARYENDPOINT   PRIMARYPHASE   DBCLUSTERPHASE   HAREADYSTATUS   HAREADYREASON
   dbcluster-sample   10.29.21.240      Ready          DBClusterReady   True            Ready
   

2. 데이터베이스 클러스터에 속하는 Kubernetes 포드를 나열합니다.

   kubectl get pods -n DBCLUSTER_NAMESPACE -l alloydbomni.internal.dbadmin.goog/dbcluster=DBCLUSTER_NAME
   

3. 공유 메모리 정보를 확인하려면 다음 명령어를 실행합니다.

   kubectl exec -n DBCLUSTER_NAMESPACE POD_NAME -- grep Shmem /proc/meminfo
   

4. 출력의 모든 항목에 0이 아닌 숫자가 포함되어야 합니다.

   출력 예시는 다음과 같습니다.

   Shmem:          126255872 kB
   ShmemHugePages: 18403328 kB
   ShmemPmdMapped:  2961408 kB
   

   항목에 0 kB가 표시되면 해당 포드를 다시 시작합니다.

   kubectl delete pod -n DBCLUSTER_NAMESPACE POD_NAME
   

5. 포드가 Running 상태가 되면 1~5단계를 반복합니다.