About cluster nodes

Minimum hardware recommendations

Each node must have a root volume, as well as a separate data volume. These are minimum recommendations. More resources may be required depending on your usage, such as user activity and selected integrations.

Services	Minimum Memory Required	Minimum Data Volume Free Space Required
job-server, memcache-server, web-server	14 GB	1 GB
consul-server, mysql-server, redis-server	14 GB	10 GB
git-server, metrics-server, pages-server, storage-server	14 GB	10 GB
elasticsearch-server	14 GB	10 GB

Services required for clustering

For adequate redundancy, use these minimum nodes operating each service.

Services	Minimum Nodes Required
job-server, memcache-server, metrics-server, web-server	2
mysql-server, redis-server	2
consul-server	3
git-server, pages-server, storage-server	3
elasticsearch-server	3

Cluster design recommendations

Clustering allows services that make up GitHub Enterprise Server to be scaled out independently of each other. This flexibility can be used to design and implement a cluster that fits organizations with different scalability requirements. For example, some organizations may need more storage throughput for large or frequent fetches, but web server usage may be relatively low. Another organization may have good performance with fewer storage resources, but need many nodes running pages-server or elasticsearch-server. Many different combinations are possible. Work with your account representative to determine the best cluster configuration for your specific needs.

• Spread redundant nodes across independent hardware. If you share CPU, memory, or storage devices, you'll reduce performance and introduce single points of failure. Shared networking components can also reduce throughput and increase risk of loss of connectivity in the event of an outage.
• Use fast storage. Storage area networks (SAN) are often optimized for maximum space utilization, availability and fault tolerance, not absolute throughput. GitHub Enterprise Server clustering provides redundancy and availability, and will perform best on the fastest storage available. Local SSD storage is recommended.
• Establish tiers of nodes that make sense for your organization. An example configuration:
  • Front-end tier with two nodes and the following services:
    • web-server
    • jobs-server
    • memcache-server
  • Database tier with three nodes and the following services:
    • consul-server
    • mysql-server
    • redis-server
  • Search tier with three nodes and the following service:
    • elasticsearch-server
  • Storage tier with three nodes and the following services:
    • git-server
    • pages-server
    • storage-server
    • metrics-server

Example cluster diagram