Application Deployment MSBuild tasks

Official Content
This documentation is valid for:

The  Application Deployment tool is based on MSBuild tasks, which allow you to easily extend and/or customize your deployments. Using those tasks, you can automate deployment.

The following document lists those tasks and details how to use them in order to either extend what GeneXus does or automate your deployments.


The CreateDeployProject task will analyze what GeneXus objects must be included in the deployment based on the call tree of every selected object (or every main object if none). The output of this task is an MSBuild script with the extension .gxdproj that will hold every environment property and object (with its properties) needed for a successful deployment.

GeneXus provides a script called Deploy.msbuild which is used by GeneXus itself and it's a great starting point for automating your calls. Use the following command to create a deployment project of every main in your Knowledge Base.

msbuild.exe deploy.msbuild /p:KBPath=<Path to your Knowledge Base>

This will create the deploy project file for the trunk version of the mentioned Knowledge Base for every main object in that version. There a few properties you can add to change this behavior.

KBVersion: The name of the version to set as active

KBEnvironment: The name of the environment in that version

ProjectName: It will be the name of the generated .gxdproj file

ObjectNames: The names (with their types) of the objects to deploy (deployment units can also be selected) (ref.: How to specify an object list in a MSBuild task)

APPLICATION_KEY: The new encryption key to set for your deployed application

ApplicationServer: Take a look at the supported Deploy Application Servers for each platform

TARGET_JRE: (Java only) the version of the Java runtime where the deployed app will run. (Default is 9)

PACKAGE_FORMAT: (Java only) whether the engine must create a WAR or an EAR. (Default is 'Automatic', the engine decides based on the selected objects)

SelectedObjectsOnly: When set to true the deploy engine will not calculate the call tree of selected objects. Only the selected ones will be deployed.

The generated .gxdproj file is another MSBuild script which contains the needed info to create the packaged application. It can be a zip file in case of C# and .NET Core or a war/jar/ear in case of Java.


To generate the package you need to execute the generated script as follows:

msbuild.exe <Full path>\MSBuildDeployment_20190123103151.gxdproj

In this case, you can also set properties to tell the engine where the generated package will be deployed.

TargetId: Default will be "Local", but you can set any of the supported Deploy Application Targets.

DeployFileFullPath: Full path to where you want the packaged app to be copied to.

DeployFullPath: Full path to which a copy of packaged files will be copied to. You can use this path to compare different deployments.



MSbuild.exe /nologo /verbosity:minimal /ToolsVersion:14.0 "c:\fullgx\gxsaltostable\deploy.msbuild" /p:KBPath="c:\fullgx\kbaux" /p:KBEnvironment=NetEnvironment /p:KBVersion=kbaux /p:ProjectName=DeployNet16 /p:ObjectNames="TestDeployUnit1" /p:GX_PROGRAM_DIR="c:\fullgx\gxsaltostable" /p:TimeStamp=DeployNet16 /p:Application_Key=863B7BE7A26B4276942E2C50FA1E0EAC /p:ApplicationServer="IIS8" /p:TargetId="Local" /p:SourcePath="c:\fullgx\kbaux\CSharpModel" /p:AppName="DeployNet16" /t:CreateDeploy /p:SelectedObjectsOnly="false" /l:FileLogger,Microsoft.Build.Engine;logfile=c:\fullgx\temp\CreateDeploy.log

See Also

Was this page helpful?
What Is This?
Your feedback about this content is important. Let us know what you think.