Administer > Deploy > Overview: WebSphere Commerce Build and Deployment tool
Customize the Build and Deployment tool
Although the Build and Deployment tool supports a wide range of configuration by default through samples and configurable files, a WebSphere Commerce customization project may have very specific needs that is not supported.
To tailor to such needs, the Build and Deployment tool provides extension points which can be leveraged to develop customized build and deployment processes. This section provides customization guidelines and instructions.
Advanced skills in Apache Ant are required to customize the Build and Deployment tool. The Apache Ant Manual will be very useful as a reference for available Ant tasks.
General customization guidelines
The following guidelines apply customizing the Build and Deployment Tool to improve reusability and serviceability:
- Always check the configuration files from the Build and Deployment Tool first to see if the customization can be done with default functionality. The configuration files are designed to handle most configuration/customization such as changing directories and changing the settings of various tools. This will avoid duplicated work.
- The Build and Deployment tool provides helper assets that are reusable and serves as examples for customization. Such assets are generally marked using -common in the file name and are very well documented within the file. Always examine these files before customization to understand what can be reused.
- Template files have sections identified by the string CUSTOMIZATION which provides details and tips on customizing files created from them.
- Use a prefix project-, where project is an identifier of the project, for any new files created as part of the customization. For example, if the customization project is called "abc" and a customized version of wcbd-build.xml is required, the suggested name of the new file is abc-build.xml.
- When new helper Ant build files and properties files are introduced, ensure that they are loaded in the main Ant build file using the import and property Ant tasks respectively. For helper Ant build files, do not add a default target to the project.
- Ensure that any new targets and properties do not share the same name as existing ones in the out-of-the-box helper Ant build files and configuration files.
- If optional Ant tasks are used, ensure that all dependent libraries are added to the WCBD_INSTALL/lib directory and are included in the classpath in the setenv* files.
Non-customizable files
All files that start with the prefix wcbd- are deemed non-customizable for serviceability reasons. Under no circumstances should these files be modified or removed by users of the Build and Deployment tool.
- Customize the build process
Advanced users can customize the build process using the Apache Ant scripting language. This task guides you through creating the customization files for use with the WebSphere Commerce Build and Deployment tool.
- Customize the server deployment process
Advanced users can customize the server deployment process using the Apache Ant scripting language. This task guides you through creating the customization files for use with the WebSphere Commerce Build and Deployment tool.
- Customize the toolkit deployment process
Advanced users can customize the toolkit deployment process using the Apache Ant scripting language. This task guides you through creating the customization files for use with the WebSphere Commerce Build and Deployment tool.
- Custom Ant tasks
The Ant tasks and conditions listed on this page can be used with the Build and Deployment tool, in both the build and the deployment processes.