클러스터 생성 문제 해결

문서 버전을 선택합니다.

이 페이지에서는 RPM 오케스트레이터를 사용하여 AlloyDB Omni 문제를 해결하는 방법을 보여줍니다.

클러스터 만들기 오류

이 섹션에서는 발생할 수 있는 클러스터 만들기 오류를 나열하고 이를 해결하는 방법을 설명합니다.

권한 에스컬레이션이 사용 설정되지 않아 설치가 실패함

설치 플레이북의 ansible_user 변수가 루트 사용자가 아닌 사용자를 지정하고 플레이에서 권한 에스컬레이션을 사용 설정하지 않는 경우 다음과 같은 문제가 발생합니다.

This command has to be run under the root user.

이 문제는 google.alloydbomni_orchestrator.install 역할이 루트 권한이 필요한 dnf 패키지 관리자를 사용하여 패키지를 설치하기 때문에 발생합니다.

이 문제를 해결하려면 다음 단계를 따르세요.

  1. 플레이북에서 Ansible을 사용하여 AlloyDB Omni 구성요소 설치에 표시된 대로 플레이 수준에서 become: true을(를) 추가합니다.
  2. ansible_user 변수의 사용자가 인벤토리의 모든 노드에서 sudo를 실행할 수 있는지 확인합니다.
  3. 플레이북을 다시 실행합니다.

    ansible-playbook -i deployment_spec.yaml install.yaml

문제가 해결되었는지 확인하려면 Install SELinux python utilities 작업이 ok 또는 changed를 보고하고 플레이 요약에 모든 호스트에 대해 failed=0이 표시되는지 확인합니다.

데이터베이스 노드에 데이터 디렉터리가 없어 부트스트랩이 실패함

다음 문제는 부트스트랩 플레이북이 모든 데이터베이스 노드에서 메시지 Timeout when waiting for DB_NODE_1:5432와 함께 시간 초과되고 노드 관리자 로그에 누락된 데이터 디렉터리와 관련된 오류가 표시될 때 발생합니다.

누락된 디렉터리를 식별하려면 다음 단계를 따르세요.

  1. journalctl을 사용하여 노드 관리자 로그를 확인합니다.

    sudo journalctl -u alloydbomni_node_manager
  2. 다음과 유사한 메시지가 출력에 있는지 확인합니다.

    service "dbprocess": root data directory does not exist: PG_DATA_DIR
    

이러한 메시지에는 다음 값이 포함됩니다.

  • DB_NODE_1: 데이터베이스 노드의 IP 주소 또는 정규화된 도메인 이름(FQDN)
  • PG_DATA_DIR: 데이터베이스 데이터가 저장된 디렉터리의 호스트 경로

이 문제는 모든 데이터베이스 노드에 PG_DATA_DIR이 없기 때문에 발생합니다. 오케스트레이터는 부트스트랩 전에 디렉터리가 존재할 것으로 예상합니다.

이 문제를 해결하려면 다음 단계를 따르세요.

  1. 모든 데이터베이스 노드에서 PG_DATA_DIR을 만들고 외부 볼륨을 마운트합니다. 자세한 내용은 클러스터 만들기를 참조하세요.
  2. 재부팅 시 마운트가 지속되도록 구성합니다.
  3. 부트스트랩 플레이북을 다시 실행합니다.

문제가 해결되었는지 확인하려면 다음 명령어를 실행합니다.

alloydbctl get -d deployment_spec.yaml -t DBCluster -n CLUSTER_NAME -o yaml

CLUSTER_NAME을 데이터베이스 클러스터 이름으로 바꿉니다.

출력에 DatabaseReady 조건이 status: "True"와 함께 표시됩니다.

DBCluster 파라미터 값이 따옴표로 묶이지 않아 부트스트랩이 실패함

DBCluster 사양의 parameters 섹션에 따옴표가 없는 숫자 값이 포함되어 있고 google.alloydbomni_orchestrator.bootstrap 역할을 호출하는 플레이북을 실행하는 경우 다음과 같은 문제가 발생합니다.

invalid parameters in DBCluster resource specification: json: cannot unmarshal number into Go struct field AlInstanceSpec.primarySpec.InstanceSpec.parameters of type string

이 문제는 parameters 필드의 각 항목이 키-값 문자열 쌍이기 때문에 발생합니다. DBCluster 커스텀 리소스 정의에 설명된 대로

이 문제를 해결하려면 다음 단계를 따르세요.

  1. spec.primarySpec.parameters 필드의 모든 값을 따옴표로 묶습니다.클러스터 사양 준비 에 표시된 대로

    DBCluster:
      spec:
        primarySpec:
          parameters:
            max_connections: "100"
            max_wal_size: "2GB"
    
  2. 부트스트랩 플레이북을 다시 실행합니다.

문제가 해결되었는지 확인하려면 다음 명령어를 실행합니다.

alloydbctl get -d deployment_spec.yaml -t DBCluster -n CLUSTER_NAME -o yaml

CLUSTER_NAME을 데이터베이스 클러스터 이름으로 바꿉니다.

출력에 DatabaseReady 조건이 status: "True"와 함께 표시됩니다.