Build Tools for VMware Aria

This repository contains the source code for the Build Tools for VMware Aria, formally knows as vRealize Build Tools. Build Tools for VMware Aria provides development and release management tools for implementing automation solutions based on the VMware Aria Suite (VMware Aria Automation, VMware Aria Automation Orchestrator, VMware Aria Operations, VMware Aria Automation Pipelines, Aria Operations for Logs) and VMware Cloud Director. The solution enables Virtual Infrastructure Administrators and Automation Developers to use standard DevOps practices for managing and deploying content.

Documentation

• Installation and Operations Documents
• Workstation Setup Guide

How to build

1. Update ~/.m2/settings.xml with:

   <profiles>
       <profile>
           <id>packaging</id>
           <properties>
               <keystoreGroupId>com.vmware.pscoe.build</keystoreGroupId>
               <keystoreArtifactId>keystore.example</keystoreArtifactId>
               <keystoreVersion>4.6.0</keystoreVersion>
               <vroPrivateKeyPem>target/${keystoreArtifactId}-${keystoreVersion}/private_key.pem</vroPrivateKeyPem>
               <vroCertificatePem>target/${keystoreArtifactId}-${keystoreVersion}/cert.pem</vroCertificatePem>
               <vroKeyPass>VMware1!</vroKeyPass>
           </properties>
       </profile>
   </profiles>
   <activeProfiles>
       <activeProfile>packaging</activeProfile>
   </activeProfiles>

2. Execute:

   mvn clean install -D modules.plugins
   mvn clean install -D modules.tools
   mvn clean package -D modules.repository

Package dependencies

• npm: 6.14.x (One compatible with your node version)
• node: 22.x.x (only 14 is supported for vcd-ng)
• maven: 3.9.x
• jdk: 17, 21, 24

To check if the dependencies are met, you can run:

curl -o- https://raw.githubusercontent.com/vmware/build-tools-for-vmware-aria/main/health.sh | bash

Encoding (UTF-8)

Some development environments default to a platform-specific file encoding (for example, Cp1252 on some Windows systems). Build Tools for VMware Aria reads and writes files using UTF-8 where possible, but JVM and toolchain defaults may still affect behavior. If you encounter issues where non-ASCII characters are replaced by question marks (for example emoji in CSS/form styles), ensure Java uses UTF-8 by one of the following:

• Start the JVM with the system property: -Dfile.encoding=UTF-8.
• Set the environment variable for JVM launches: JAVA_TOOL_OPTIONS="-Dfile.encoding=UTF-8".
• When running Maven, you can pass the property: mvn -Dfile.encoding=UTF-8 <goal>.

Support

You can find detailed support statement here