BuildMethod

Build process type for the Rack. Controls whether builds run on dedicated EC2 instances or Fargate. ec2 uses a dedicated build instance; fargate uses a Fargate task. When using fargate, set FargateBuildCpu and FargateBuildMemory.

| Default value | ec2 | | Allowed values | ec2, fargate |

Use Cases

• Using ec2 (default) for builds that need large disk space, fast I/O, or Docker layer caching across builds
• Switching to fargate to eliminate the cost of a continuously running build instance when builds are infrequent
• Using fargate when you want builds to run in an isolated, ephemeral environment for security reasons

Additional Information

When using ec2, build resource allocation is controlled by BuildCpu, BuildMemory, and BuildInstance.

When using fargate, resource allocation is controlled by FargateBuildCpu and FargateBuildMemory instead. Note that Fargate builds do not benefit from Docker layer caching, which may result in longer build times.

$ convox rack params set BuildMethod=fargate

See Also

• BuildInstance
• BuildCpu
• BuildMemory
• FargateBuildCpu
• FargateBuildMemory
• BuildVolumeSize