이 주제에서는 Apigee Hybrid의 최소 클러스터 구성을 설명합니다. 이러한 최소 구성은 지원되는 모든 Kubernetes 플랫폼에 적용됩니다. 이 주제의 권장사항은 무료 체험판 또는 테스트 시나리오와 같은 비프로덕션 설치에 적용됩니다. Apigee Hybrid 설치 단계를 수행할 때는 다음 권장사항에 유의하세요.
노드 풀 정보
노드 풀은 클러스터 내에서 구성이 모두 동일한 노드 그룹입니다. 기본적으로 하이브리드는 모든 pod를 기본 노드 풀에 할당합니다. 그러나 전용 노드 풀을 만들고 여기에 하이브리드 구성요소를 할당하여 리소스를 배포할 수 있습니다.
일반적으로 리소스 요구사항이 서로 다른 pod가 있는 경우 전용 노드 풀을 정의합니다. 예를 들어 apigee-cassandra pod에는 영구 스토리지가 필요하지만 다른 Apigee Hybrid pod에는 필요하지 않습니다. 따라서 Cassandra용 스테이트풀(Stateful) 노드 풀과 나머지 하이브리드 런타임 서비스용 스테이트리스(Stateless) 노드 풀을 만드는 것이 좋습니다. 자세한 내용은 전용 노드 풀 구성을 참조하세요.
다음 섹션에는 스테이트풀(Stateful) 및 스테이트리스(Stateless) 노드 풀의 구성이 모두 나와 있습니다.
SAN 또는 직접 연결된 스토리지를 사용하는 경우 2,000IOPS. NFS는 필요한 IOPS를 지원할 수 있는 경우에도 권장되지 않습니다.
SAN 또는 직접 연결된 스토리지를 사용하는 경우 2,000IOPS. NFS는 필요한 IOPS를 지원할 수 있는 경우에도 권장되지 않습니다.
Cassandra 네트워크 요구사항
Cassandra는 Gossip 프로토콜을 사용하여 네트워크 토폴로지에 대한 정보를 다른 노드와 교환합니다.
읽기 및 쓰기 작업을 위해 여러 노드와 통신해야 하는 Cassandra의 분산 특성과 Gossip를 함께 사용하면 네트워크를 통해 많은 데이터가 전송됩니다.
프로덕션 시스템에서는 최소 1Gbps 네트워크 대역폭과 1Gbps 이상의 인스턴스 유형을 사용하는 것이 좋습니다.
Cassandra 클러스터에는 프로덕션 환경에서 가용성을 유지하기 위해 3개의 가용성 영역이 필요합니다. 한 영역이 다운되면 영역이 온라인 상태로 전환되는 동안 나머지 영역이 요청에 계속 응답합니다. 영역 2개 이상이 작동 중단되면 Cassandra는 최소 2개 이상의 영역이 다시 온라인 상태가 될 때까지 요청에 응답할 수 없습니다. Apigee에서는 데이터 업데이트가 누락될 위험을 최소화하기 위해 3시간 이내에 영역을 다시 온라인으로 전환하는 것이 권장됩니다.
멀티 리전 하이브리드 환경을 배포하는 경우 Apigee는 VPN 또는 Google Cloud VPN과 같은 클라우드 솔루션을 사용하여 리전 간 연결을 보호하는 것이 좋습니다. Cassandra 연결 문제가 발생할 수 있으므로 겹치는 서브넷이 없는지 확인합니다. 현재 방화벽 구성이 Cassandra 포드 간에 Cassandra 트래픽의 통과를 허용하는지 확인합니다. Cassandra 포트에 대한 자세한 내용은 보안 포트 사용을 참조하세요.
Cassandra의 최대 또는 99번째 백분위수 지연 시간은 100밀리초 미만이어야 합니다.
Cassandra NTP 요구사항
Cassandra 데이터는 시스템의 타임스탬프를 기준으로 동기화됩니다. 시간이 Cassandra 클러스터 내의 모든 포드와 모든 리전에서 동기화되었는지 확인합니다. 노드와 리전 간의 시간 지연으로 인해 데이터 불일치가 발생합니다.
구성 확장
추가 용량 또는 처리량 요구에 따라 초기 구성을 확장해야 하는 경우 다음 주제를 참조하세요.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["이해하기 어려움","hardToUnderstand","thumb-down"],["잘못된 정보 또는 샘플 코드","incorrectInformationOrSampleCode","thumb-down"],["필요한 정보/샘플이 없음","missingTheInformationSamplesINeed","thumb-down"],["번역 문제","translationIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-09-04(UTC)"],[[["\u003cp\u003eThis documentation outlines the minimum cluster configurations for non-production Apigee hybrid installations, applicable across all supported Kubernetes platforms.\u003c/p\u003e\n"],["\u003cp\u003eApigee hybrid utilizes node pools, and it's recommended to create dedicated node pools: a stateful pool for Cassandra and a stateless pool for other runtime services.\u003c/p\u003e\n"],["\u003cp\u003eThe minimum configurations include one node per zone (three per region) for both stateful and stateless node pools, each with 4 CPUs, 15 RAM, and a minimum disk IOPS of 2000, while the storage of stateless nodes is managed by ApigeeDeployment CRD.\u003c/p\u003e\n"],["\u003cp\u003eCassandra requires a minimum of 1 Gbps network bandwidth, and for production environments, three availability zones are essential to maintain availability.\u003c/p\u003e\n"],["\u003cp\u003eEnsuring that time is synchronized across all pods and regions within the Cassandra cluster is crucial for consistent data synchronization.\u003c/p\u003e\n"]]],[],null,["# Minimum cluster configurations\n\n| You are currently viewing version 1.9 of the Apigee hybrid documentation. **This version is end of life.** You should upgrade to a newer version. For more information, see [Supported versions](/apigee/docs/hybrid/supported-platforms#supported-versions).\n\n\nThis topic describes minimum cluster configurations for\nApigee hybrid. These minimum configurations apply to all of the supported\n[Kubernetes platforms](/apigee/docs/hybrid/supported-platforms). The recommendations\nin this topic apply for non-production installations, such as trial or testing scenarios. Keep\nthese recommendations in mind when performing the Apigee hybrid installation steps..\n\nAbout node pools\n----------------\n\n\nA node pool is a group of nodes within a cluster that all have the same configuration. By\ndefault, hybrid assigns all pods to the default node pool; however, you can create dedicated\nnode pools and assign hybrid components to them as a way of distributing resources.\n\n\nTypically, you define dedicated node pools when you have pods with differing resource\nrequirements. For example, the `apigee-cassandra` pods require persistent storage, while\nthe other Apigee hybrid pods do not. For this reason, we recommend that you create\na stateful node pool for Cassandra and a stateless node pool for the rest of the hybrid\nruntime services. See [Configure dedicated node pools](/apigee/docs/hybrid/v1.9/configure-dedicated-nodes) for\ndetails.\n\n\nThe following section lists configurations for both stateful and stateless node pools.\n\nMinimum configurations\n----------------------\n\n\nUse these minimum configurations when setting up your cluster:\n\n| **Note:** For **production** environments, we recommend a minimum of two clusters.\n\nCassandra network requirements\n------------------------------\n\n\nCassandra uses the\n[Gossip protocol](https://en.wikipedia.org/wiki/Gossip_protocol) to\nexchange information with other nodes about network topology.\n\n\nThe use of Gossip plus the distributed nature of Cassandra---which involves talking to multiple\nnodes for read and write operations---results in a lot of data transfer through the network.\n\n\nApigee recommends using instance type with a minimum 1 Gbps network bandwidth and more than 1 Gbps\nfor production systems.\n\n\nCassandra clusters need three availability zones to maintain availability in a\nproduction environment. If one zone goes down, the remaining zones will\ncontinue responding to requests while the remaining zone comes back online. If\ntwo or more zones go down, Cassandra will be unable to respond to requests\nuntil at least two zones come back online. Apigee recommends bringing zones\nback online within three hours to minimize the risk of missing data\nupdates.\n\n\nWhen deploying multi-region hybrid environments, Apigee recommends using a VPN\nor cloud solution like\n[Google Cloud VPN](/network-connectivity/docs/vpn/concepts/overview) to secure connectivity between the\nregions. Make sure there are no overlapping subnets as these may cause\nCassandra connectivity issues. Ensure the current firewall configurations\nallow for Cassandra traffic to pass between Cassandra pods. See\n[Secure ports usage](/apigee/docs/hybrid/v1.9/ports) for information on Cassandra ports.\n\n\nThe maximum or 99th percentile latency for Cassandra should be below 100 milliseconds.\n\nCassandra NTP requirements\n--------------------------\n\n\nCassandra data synchronizes based on the timestamp of the system. Ensure that the time is\nsynchronized across all pods and all regions within the Cassandra cluster. Time delays\nbetween the nodes and regions causes data inconsistencies.\n\nScaling the configuration\n-------------------------\n\n\nIf you need to scale your initial configuration based on additional capacity or throughput needs,\nsee the following topics:\n\n- [Configuring Cassandra for production](/apigee/docs/hybrid/v1.9/cassandra-production)\n- [Scaling Cassandra pods](/apigee/docs/hybrid/v1.9/cassandra-scaling)\n- [Configuring dedicated node pools](/apigee/docs/hybrid/v1.9/configure-dedicated-nodes)\n- [Scale and autoscale runtime services](/apigee/docs/hybrid/v1.9/scale-and-autoscale)"]]
