Review and uploading a new version of an Edge App

Requirement

The version has at least one service.

Procedure

To review a version of an Edge App and upload that version, proceed as follow:

1. Click on the Review button.
   You can review the content of the YAML file.

2. Click on the Create button for Standalone Applications or on the Validate & Create button for App Projects apps.

Proceed with Add Version popup as follow:

1. To use a default redirect URL, activate the Default option field and select a URL from the drop-down menu.
   To use a custom redirect URL, activate the Custom option field and enter your custom URL in the input field.
   The redirect URL determines where the app is stored on the devices on which the app is installed.

2. Enter a numeric value in the input fields Major, Minor, Patch and Metadata.
   The version has the designation Major.Minor.Patch and, optional, Pre-release (-) or Metadata (+) or both of them. For example, if Major = 1, Minor = 2, Patch = 2 and Metadata = 4, the version designation would be 1.2.2+4.
   The version has the designation Major.Minor.Patch and, optional, Pre-release (-) or Metadata (+) or both of them. For example, if Major = 1, Minor = 2, Patch = 2 and Metadata = 4, the version designation would be 1.2.2+4.
   All valid Semantic Versioning (Major Minor Patch Pre-release+Metadata) is being supported. Pre-release is followed by a -, Metadata is followed by a +, for example 1.0.0-alpha or 1.0.0+001.

3. Select Device Features: For example - Device Shutdown this allows applications to trigger a shutdown operation on supporting devices. The device will gracefully shut down when triggered by releasing the resources to avoid damaging the integrity of the system. Particularly useful for power failure detection applications to trigger a shutdown in the event of a power failure.

4. Add Discovery Information - Services want to register their information (e.g. API endpoints) that can be searched/discovered by other services that want to consume the information. To achieve this - select a json file containing information such as dns_domainname, grpc_ip_port_number, app_instance_id, app_types, driver_schema_uris to add discovery information (service metadata) for the application.

5. Architecture type supported by the application version, which ensures that the application version can be installed on arm64 or x86-64 devices. The docker image used in docker-compose.yaml should be of the same architecture to ensure that the application runs on the selected architecture type.
   Supported architectures: x86-64 & arm64.
   For supporting different architectures, app builder must create separate applications.

6. To allow access to the Edge App without login, activate the Allow application access without login check box.
   This option is only usable for SIMATIC HMI panels and has no usage in Industrial Edge.

7. Click on the Create button.

8. To start the upload, click on the Start Upload button of this version in the Versions screen.