Clustered Installation Overview
This article provides a platform-independent overview of CircleCI Enterprise. CircleCI Enterprise matches the experience of https://circleci.com but runs behind your organization’s firewall, allowing your code, builds, and production hosts to be inaccessible outside of your network.
We are constantly working on making the installation process as smooth as possible and expanding the administrative tooling. We appreciate your feedback on ways to make CircleCI Enterprise easier and more valuable for you and your team, so please contact us at email@example.com with any suggestions.
At a high level, CircleCI Enterprise has two kinds of instances that it needs in order to run: the services box and builder boxes.
The Services Box
The first is a services box which contains the CircleCI frontend and all internal resources we use to store data and run the service. This machine should not be restarted, and should be backed up regularly using VM snapshots at a minimum. You should have DNS resolution point to this machine’s IP.
|End Users||80, 443||HTTP/HTTPS Traffic|
|Builder Boxes||all traffic / all ports||Internal Communication|
|GitHub (Enterprise or .com)||80, 443||Incoming Webhooks|
The Builder Boxes
Our Builder Boxes handle running your builds, and store no state themselves. Each builder machine reserves 2CPU/4G for coordinating builds, and then uses the remaining space to create build containers. The larger machine, the more containers it will run. See our configuration doc for more information about how many containers a particular machine can run. Since they store no state, they can be scaled up or down at will. When shutting machines down, be sure to use the
circle-shutdown command to a gracefully shut down the machine.
|End Users||64535-65535||SSH into builds feature|
|Administrators||80, 443||CircleCI API Access (graceful shutdown, etc)|
|Services Box||all traffic / all ports||Internal Communication|
|Builder Boxes (including itself)||all traffic / all ports||Internal Communication|
|Services Box||22||Git Access|
|Services Box||80, 443||API Access|
|Builder Boxes||22||Git Access|
|Builder Boxes||80, 443||API Access|