Building the App

After you have created your app, you have the option to either export the app (without building it) or build it. Exporting an app allows you to import it elsewhere, for example in TIBCO Cloud™ Integration - Flogo®. When you build the app, its deployable artifact gets created and downloaded to your local machine. Each operating system has its own build target. You must select the right target for your operating system when building the app. You can use the built artifact to run the app in TIBCO Cloud Integration - Flogo (PAYG).

Note: Be sure that you have Docker installed on your machine. Refer to the product Readme for the supported versions of Docker.

Follow these steps to build an app:

Important: For app binaries that were created in TIBCO Cloud Integration - Flogo (PAYG) 2.5 or older versions, if the app binary was created using an <app>.json file and contains a flow starting with a trigger and the app binary was created from the CLI using the build tool, the app gets successfully built but throws an error at runtime.

Procedure

  1. Open the Apps page in TIBCO Cloud Integration - Flogo (PAYG).
  2. Click the app that you want to build to open the page for that app.
  3. Click the Validate button to explicitly validate the flows and activities in the app. Fix any errors before pushing the app.
  4. Click Build.
  5. Click the build target option that is compatible with your operating system.
    The app begins to build and when done, the deployable artifact gets downloaded to your local machine. In the case of Docker, a Docker image gets created in your Docker storage area.
    Note: Any uppercase letters in your app name get converted to lowercase in the Docker image name. For instance, if your app is named MyApp, the Docker image that gets generated will be named myapp.
  6. To run the app:
    On Linux
    1. Open a terminal.
    2. Run: chmod +x <app-file-name>
    3. Run: ./<app-file-name>

    For Docker Image

    Note: Any uppercase letters in your app name get converted to lowercase in the Docker image name. For instance, if your app is named MyApp, the Docker image that gets generated will be named myapp. So be sure to use all lowercase letters in the app-file-name in the command below.
    1. Open a terminal.
    2. Run: docker run -p <<host-port-number>>:<port-on-docker> flogo/<app-file-name>