Builds

The Builds view is where you can setup and manage your builds. You can access the Builds view by clicking on the Builds link in the left hand navigation. Read more about Builds.

List View

The list view is the default view for the Builds view. It displays a list of all the builds you have configured. Add a new build by clicking the New Build button. Click on a build to view the build detail view.

Builds can be managed with the three dot menu on the right hand side of the list. You can duplicate, delete, and manage your build on your OttoFMS server from this menubar. This menu is also available in the build detail view.

Build Detail

The build detail view is where you can configure your build.

Build Options

Name

The build name is used to identify the build in the list view in OttoDeploy. It is not required, but it is recommended to give your build a name that is descriptive of what the build does.

Build ID

The build Id is the unique identifier for the build. It should be unique to the build and will be the name of the build zip file and hte folder for the build in the OttoFMS outbox. it is recommended that you use the build Id to add a version number if you are using builds to version your application.

Pre-build Script

The pre-build script is a script that will be run before the build is started. This is useful for setting up the environment for the build. For example, you may want to run a script to update the version number in your application before the build starts.

Overwrite existing build with this name

This setting can be used to overwrite an existing build with this ID. If this is not checked, and a build with the same ID already exists, the build will fail.

Close Files During Build

This setting can be used to close files that are being copied during the build. Copies of closed files are generally much faster than copies of open files, as OttoFMS does not need to use FileMaker to copy the files and can copy them directly. Additionally, copying a closed file does not need to create a backup of the external container data that may be used with the file, speeding up the process further.

Include Container Data

This setting can be used to include external container data in the build. If this is toggled on, container data for copies will be copied to the build and zipped into the .build.zip file that is created. When deploying from this build, you can then transfer the container data to the destination server using the Transfer Container Data option in the advanced options.

Publish Build

Publishing a build is a tool that can be used to make working with builds and moving them around simpler. When you publish a build, OttoFMS will create your build normally, and at the end of the build OttoFMS will push the build in a useable state to whichever destiantion you have defined. Publish destinations are defined per build, and can be a different server, or the current server's HTTP folder. Using a different server as the publish destination will allow you to run a deployment on that server without having to fetch the build as part of the deployment (making deployments run faster), while putting the buiild in the HTTP folder of the current server allows you to deploy the build from a public URL.

Zip Files

By default, OttoFMS zips the build files into a .build.zip file. In OttoFMS 4.10.0 or later, this can be disabled by unchecking the "Zip Files" option. This option is only recommended if you are planning on using the build locally and are not publishing to another location or using the build in a deployment on another server.

Compression Level

The compression setting allows you to specify the compression level for the build. The values for compression level go from 0 to 9, with 0 being an uncompressed build and 9 being the highest level of compression. An uncompressed zip file is the same size as the files that were put into it, with the file getting smaller the higher the compression level setting is. If you are having issues with files pulling down across the network for being too large it may be helpful to increase the compression level. A higher compression level will require more CPU usage and will take longer.

Memory Level

The memory setting allows you to specify the amount of RAM to use for the build. For servers without much RAM we recommend keeping this low. Increasing this setting will speed up the zipping process that we do as part of the build.