Builds

A build is a package that includes profiles and the files that the profiles require to run such as maps, guidelines, and so on. To create a build, you should first create a project folder in the WORKSPACE directory in the Cloud Repository, and then save your XEServer profile images there.

To create a build:

1. On the top of the Builds page, click Create Build.
2. In the Create Build dialog, in the field Name, enter a name for your build.
3. From the drop-down list in Project Folder, select the project folder that contains the profiles, maps, guidelines, and so on that have been uploaded to the Cloud Repository.
4. In Project Assets, select a required asset, for example, configuration, profiles, data, maps, or guidelines. You can add as many project assets (for example, profiles) as you need.
5. In Common Assets, you can select any artifact (that is common to all the projects) that has been shared with other Trading Partners.
6. In Comment, enter an informative description for your build to describe its purpose.
7. Click Create.

On the Builds page, you can view the created builds with the details on their deployments and build versions.

Once you create a build, you cannot update or edit the build. To make changes to a build within the Compute service, you have to create a new version of your build, and then make changes to that copy.

To create a new build version, you may have to change the profile configuration in the project folder of the Cloud Repository. The Cloud Repository uses version control for all your deployments.

Note You cannot deploy the same build twice in a particular environment.

To create a new build version:

1. On the Builds page, in the left pane, select a build for which you want to create a new version.
2. In the right pane with build details, click .
3. In the Create New Version dialog, under the name of the build, in Project Folder, by default, the project folder name is pulled in automatically from the Cloud Repository based on the selected build, but you can also select another project folder.
4. In Modify Project Assets, select the required asset, for example, configuration, profiles, data, maps, or guidelines.
5. In Modify Common Assets, select the profiles that you share with other trading partners to execute in your environment.
6. In Comment, enter an informative description for your build version to describe its purpose.
7. Click Create.

When you select a build in the left pane, you can view its versions with the following details on the right:

• The date and time when the build version was created.
• The location of the project folder and the common folder in the Cloud Repository.
• The build comments.
• The list of assets (files) with their location, the date and time when the file was created, and a version of the build to which the file belongs. To filter assets, you can use search or select a specific folder to display its assets.

To deploy a build, you must associate the build with an environment. To do this, on the Builds page, select a build from the list, and then click Deploy Build on the top right. You are redirected to the Deployments page.

To remove a build:

1. On the Environments page, make sure that the environments where the build is deployed have the status Ready.
2. On the Deployments page, stop and remove all the deployments of the build.
3. When the deployments removal is complete, on the Builds page, select the build you want to remove.
4. In the right pane with build details, click .
5. Click OK to remove the build with all its versions.