Application Definition

Version: 1.0
Last Modified: 12/30/2020

The Apps page lets you create application definitions for any applications deploying to our registry. Doing this creates an 'inventory' of your applications that are part of the registry. Creating an application definition also prepares it for deployment. Refer to our Tutorial: Deploying an application to the MobiledgeX platform for steps on how to deploy a sample application.

You can mark each application as Trusted if you wish to deploy and configure your outbound connections as prohibited. Upon deployment of your application, the security policy is applied and thus, making your deployment fully private. For more information, refer to the section on Security. Note that this is only supported for Dedicated IP access.

The following actions may be performed on this page:

  • Filter your apps by region
  • To filter by group, simply drag and drop the Region, Organization, or Deployment header into the Drag header here to group by option
  • Use the Search bar to search for specific Apps. Type in a few letters to auto-populate your search results
  • Create a new app definition
  • Access the quick access menu under Actions to either Update, Delete, or Create Instance.

To specify your application definition:

  1. Navigate to the submenu Apps and click the + sign.
  2. Once the Create App page opens, populate all required fields. When typing in an application name, do not use underscores.
  3. Click Create.

When specifying the port, you are limited to the following:

  • For TCP ports, the maximum number of ports supported is currently 1000.
  • For UDP ports, the maximum number of ports supported is currently 10000.

Warning: Validation between ports/names are not performed automatically. Therefore, when specifying your ports/names, you must ensure that there are no conflicts between them. Otherwise, your deployment will not succeed.

Create Apps screen
Create Apps screen

Once you have defined your application, it will appear on the Apps page.

Application Definition list
Application Definition list

Application Versioning

Application version is used as a key within the MobiledgeX platform. This means a given application is identified by the following:

  1. Region
  2. Organization
  3. Application Name
  4. Application Version

Although it is a key, the application version is not checked or parsed by the MobiledgeX platform; this is purely provided as a reference for the developer. Any versioning scheme can be used to identify the app version, for example, you can use a github commit ID, an image tag name, or even a string description to identify the app version.

Upgrade Prompt

When a new version of an application is created, the MobiledgeX platform will prompt you to upgrade any Application Instances that are on a version of the application that is older than the most recently deployed version. Note that this does not perform any check of the data entered into the version field; it simply checks to see if there is an updated Application with a new version key.

To set up application versioning:

  1. Create a new application version from the Applications screen.
  2. Within the Application Instances screen, you will see the option to upgrade an application in the Actions menu. Additionally, you will see an up-arrow next to the Application Region column. You may upgrade each application instances on this screen by clicking Upgrade on the application instance. Upgrading allows you to upgrade each application instance at your own pace.
  3. To perform a bulk upgrade to all application instances in a specific region, click Upgrade from the Applications screen. The platform will upgrade all the application instances that have been launched from that application.

Note: The platform does not enforce any versioning standards; any value may be added in this field.