Setting a Maximum Number of Started Containers

Page last updated:

This topic describes how to use the auctioneer job to configure the maximum number of app instances running at a given time. This prevents Diego from scheduling too much work for your platform to handle. A lower default can prevent server overload, which may be important if you’re using a small server.

The auctioneer only schedules a fixed number of app instances to start at one time. This limit applies to both single and multiple Diego Cells. For example, if you set the limit to five started instances, it does not matter if you have one Diego Cell with ten instances or five Diego Cells with two instances each. The auctioneer will not allow more than five instances to start at the same time.

If you are using a cloud-based IaaS, rather than a smaller on-premise solution, Cloud Foundry recommends leaving the default at 0.

You can configure the maximum number of started instances by changing the diego.auctioneer.starting_container_count_maximum property in the Diego manifest.

  1. Open the Diego manifest in a text editor.
  2. Find the diego.auctioneer.starting_container_count_maximum property.
  3. Set the maximum number of instances the auctioneer should allow to start.
  4. Save the changes and redeploy BOSH.

For example, the following Diego manifest excerpt shows the diego.auctioneer.starting_container_count_maximum property set to 100.

diego.auctioneer.starting_container_count_maximum:
    description: "Maximum number of inflight container starts allowed globally. Value of 0 or less indicates no limit."
    default: 100
Create a pull request or raise an issue on the source for this page in GitHub