FargateBuildCpu

How much CPU to reserve for the builder. Only used when BuildMethod is set to fargate.

| Default value | "" |

Use Cases

• Increase CPU allocation for builds that are CPU-intensive, such as compiling large codebases or running asset pipelines.
• Set to a lower value for lightweight builds to reduce Fargate costs.
• Tune alongside FargateBuildMemory to find the optimal cost-performance balance for your build workloads.

Additional Information

This parameter is only effective when BuildMethod is set to fargate. When using the default ec2 build method, this parameter is ignored.

The value is specified in CPU units. Fargate supports specific CPU and memory combinations. Valid CPU values are 256 (0.25 vCPU), 512 (0.5 vCPU), 1024 (1 vCPU), 2048 (2 vCPU), and 4096 (4 vCPU). The available memory values depend on the CPU value selected. See AWS Fargate task size for valid combinations.

When left blank, the builder runs at 1024 CPU units.

$ convox rack params set FargateBuildCpu=1024

AWS enforces the pairing, so a CPU value that is not legal for the current memory value is rejected even though each value is valid on its own. Setting FargateBuildCpu=4096 while FargateBuildMemory is 4096 fails with:

No Fargate configuration exists for given values: 4096 CPU, 4096 memory

The Rack rolls back cleanly and keeps running on its previous parameters, but the change does not apply. Set both values together to move between task sizes:

$ convox rack params set FargateBuildCpu=4096 FargateBuildMemory=8192

See Also

• FargateBuildMemory
• FargateBuildVolumeSize
• BuildMethod
• BuildCpu
• Rack Parameters for a full list of available parameters