Build Settings

Introduction

From the Build Settings screen you can edit various aspects related to the image builder, such as the infrastructure on which the builder should run, its cluster, allocated resources and registries where application images should be stored.

Build Settings can be accessed in two ways:

  • From the Project Settings screen. In this case, Build Settings will be inherited by default for environments within the project. This can be overridden at an environment level.
  • From the Environment Settings screen. In this case, Build Settings will be applied only for the current environment.

Access the Project Build Settings

  1. Click on the project name in the upper-right corner of the Bunnyshell interface.

  2. Select View all projects.

  3. Click the Settings button of the project where you want to edit the settings.

  4. From the left side menu, select Build Settings.

Access the Environment Build Settings

  1. Click on the project name in the upper-right corner of the Bunnyshell interface.

  2. Select View all projects.

  3. Select the environment where you want to make the modifications.

  4. Click the Settings button.

  5. From the left side menu, select Build Settings.

 

Build Settings

Builder Infrastructure

Choose where the Image Builder will run.

  • Managed Builder: Run the Image Builder in a cluster managed by Bunnyshell. This involves less configuration, but it comes with less resources.

📘

Note

The resources allocated for managed builds are 1 CPU and 5GB of RAM.

  • Self-Hosted Builder: Run the Image Builder on one of your clusters. This allows you to allocate as many resources as you need.

  • Project Build Settings (only available at the environment level): Use the Build Settings defined at the project level.

 

Select Builder Cluster

📘

Only available if you opted for a Self-Hosted Builder.

In order to use your own Cluster for performing builds, you will have to configure the Cluster to support building images.

 

Build Resources

📘

Only available if you opted for a Self-Hosted Builder.

Choose what resources will be allocated to your Builder Cluster. You can edit the number of CPUs and the amount of RAM. Check out the article on Resource Allocation Recommendations for more information.

 

Container Registry

Select the container registry where your application images will be stored. Choose between one of your personal registries or the Bunnyshell-provided registry.


Build engine

Select from BuildKit (recommended) or Kaniko. BuildKit is recommended because is the default one used by Docker, so it supports latest Dockerfile syntax updates, and also some features like build secrets (to be released soon in Bunnyshell). Kaniko is lagging with Dockerfile syntax updates and new features.