Recents
GXcloud MSBuild TasksUnofficial Content

These are the tasks that, as part of the GeneXus Cloud Tools, let you deploy to a production environment.

DeployNewApp

Parameters

  • *KBPath: Path of the KB to deploy. 
    Note: Active Version / Environment is deployed.
  • *CloudUserName: GeneXus Account
  • *CloudPassword: GeneXus Account
  • CloudUri: GXcloud Manager services URI. By default https://cloudmanager.genexus.com/services
  • *CloudName: Name of provided target cloud.
  • *TargetName: Name of provided deploy target environment in the cloud.
  • *AppName: Name of the new app in cloud/target
  • DatabaseGuid: Guid of the database you wish to connect to
  • **GamPackageFile: Full path of GAM Package File
  • **GamManagerUser: GAM Manager login (Ref. GAM Manager Repository), which is the login used in the GAMDeployTool in order to create the GAM Package File.
  • **GamManagerPassword: GAM Manager password, which is the password used in the GAMDeployTool in order to create the GAM Package File.
  • **GamAdminUser: GAM Administrator login. Eg: admin. (Ref. Administrator User Name property. )
  • **GamAdminPassword: GAM Administrator password to be set in deployed application.
  • FlowPackageFile: Full path of GXflow Package File (Business Process Deploy File)
  • GXInstallation: Full path of GeneXus Installation
  • AllowUnsafeCertifictes: Set it true only if GXcloud Manager is installed in an on premises testing environment without SSL

Example

You may create a simple .bat file with the following, or download the file associated to the advanced example mentioned at the end of this article.

C:\Windows\Microsoft.NET\Framework\v3.5\msbuild.exe "C:\gxwxev3u3\GxCloud.msbuild" /t:DeployNewApp ^
    /p:CloudName="Sandbox" ^
    /p:TargetName="Sandbox" ^
    /p:KBPath="C:\Models\MyApp" ^
    /p:CloudUserName="MyGeneXusAccount" ^
    /p:CloudPassword="MyPass" ^
    /p:AppName="MyApp" ^
    /p:CloudUri="https://cloudmanager.genexus.com/services" ^
    /p:GXInstallation="C:\GxwXEv3U3"

DeployNewVersion

Parameters

  • *KBPath: Path of the KB to deploy
    Note: Active Version / Environment is deployed.
  • *CloudUserName: GeneXus Account
  • *CloudPassword: GeneXus Account
  • CloudUri: GXcloud Manager services URI. By default https://cloudmanager.genexus.com/services
  • **GamPackageFile: Full path of GAM Package File
  • ***GamManagerUser: GAM Manager login (Ref. GAM Manager Repository), which is the login used in the GAMDeployTool in order to create the GAM Package File.
  • ***GamManagerPassword: GAM Manager password, which is the password used in the GAMDeployTool in order to create the GAM Package File.
  • ***GamAdminUser: GAM Administrator login. Eg: admin. (Ref. Administrator User Name property. )
  • ***GamAdminPassword: GAM Administrator password to be set in deployed application.
  • FlowPackageFile: Full path of GXflow Package File
  • DuplicateDb: Set it true if new version needs to point to a copy of the current Database, and this needs to remain unchanged.
  • DeployNewUrl: Set it true if new version needs to be deployed in new services URL, and this needs to remain unchanged.
  • GXInstallation: Full path of GeneXus Installation
  • AllowUnsafeCertifictes:  Set it true if GXcloud Manager is installed in an on premises testing environment without SSL
  • BackupDB: Set it false if GXcloud Manager must not backup databases before executing the reorganization or impacting GAM or GXflow Engine

 

Example

You may create a simple .bat file with the following, or download the file associated to the advanced example mentioned at the end of this article.

C:\Windows\Microsoft.NET\Framework\v3.5\msbuild.exe "C:\gxwxev3u3\GxCloud.msbuild" /t:DeployNewVersion ^

    /p:CloudName="Sandbox" ^
    /p:TargetName="Sandbox" ^
    /p:KBPath="C:\Models\MyApp" ^
    /p:CloudUserName="MyGeneXusAccount" ^
    /p:CloudPassword="MyPass" ^
    /p:AppName="MyApp" ^
    /p:CloudUri="https://cloudmanager.genexus.com/services" ^
    /p:GXInstallation="C:\GxwXEv3U3"
    /p:GamPackageFile="c:\gxcloud\GAM_package.gpkg"

Notes

  • Parameters marked with an * are mandatory.
  • Parameters marked with ** are mandatory when the app uses GeneXus Access Manager (GAM)
  • Parameters marked with *** are mandatory only when the app uses GeneXus Access Manager (GAM) and these parameters have not been set in previous deploys, otherwise these parameters are optionals.
  • The tasks are defined at GXcloud.msbuild, under your GeneXus installation.
  • If you want to connect to an existing database with GAM and you want to keep it updated, you need to set your environment property Keep GAM database updated property to True and include all the GAM parameters. If you don't want to impact the GAM database, set the property to False and don't iclude any of the GAM parameters. Further info: Deployment with GXcloud Deployment Services.

Advanced example

The following file contains a batch file which makes it easier to work with the GXcloud MSbuild tasks. You only need to edit the .bat file and set the parameters you want, such as the KBPath, AppName, among others.

GXcloud MSBuild Tasks .bat Sample