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. By default, Fargate builds do not reuse Docker layers across builds. To cache layers across Fargate builds, enable the persistent BuildCache parameter.

$ convox rack params set BuildMethod=fargate

See Also

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