Pushing an app from TIBCO Cloud - Command Line Interface

You can push apps to TIBCO Cloud Integration using the TIBCO Cloud - Command Line Interface (tibcli).

When you push a Flogo app from TIBCO Cloud - Command Line Interface (tibcli) to TIBCO Cloud Integration, you can see the app and its implementation in the UI but the app appears in read-only mode. This feature is useful for users who, like testers or operators, want to see the implementation but are not supposed to make any changes in the implementation.

Keep the following in mind:
  • You can see the app and its implementation on the UI but you cannot edit anything in the app even if you are the owner of the original app.
  • The pushed app is visible only to the users in the same organization as the person pushing the app.
  • If you make a copy of the pushed app, the copy is in read-only mode.
  • If the UI is open when pushing the app, you must refresh the UI in order for the pushed app to display.
  • If the connection configured in your app that you want to push using tibcli is already present on the Connections page, you can view the connection in the Activity Settings tab. If the connection does not exist, you cannot see the connection in Activity Settings tab.

  • If your TIBCO Cloud Integration environment to which the app was pushed has an existing similar connection as the connection used in the app, the pushed app uses the connection ID of the existing connection. For instance, if your environment has an existing Salesforce connection, and the app you push also uses a Salesforce connection, when the app gets pushed to TIBCO Cloud Integration, the Salesforce connection in the app uses the ID of the existing Salesforce connection in TIBCO Cloud Integration. Hence, in your Connections tab, the number of apps using the existing Salesforce connection gets incremented by one count.
  • If your app has app properties configured, you cannot edit their default values, but you can override the properties while pushing the app from tibcli or from Environment Controls tab.
  • If you push an app by using tibcli or platform API, the Change Owner option is not displayed on the UI. However, you can change the owner using the platform API. For more information on the platform API, see TIBCO Cloud™ Integration API.

Before you begin You must have the TIBCO Cloud CLI installed on your local machine before you follow this procedure. For more details, refer to the "Using the CLI" section under "Using TIBCO Cloud™ Integration".
Note: For REST apps, be sure to change the port to 9999 before downloading the artifacts.

To push the app using the TIBCO Cloud CLI, follow this procedure:

    Procedure
  1. Open the app details page.
  2. For the app, click .
  3. Select Export app and then select TIBCO Cloud Integration artifacts.
    The manifest.json and flogo.json get downloaded. The manifest.json contains the manifest details such as the endpoints, memory resource details, and so on. The flogo.json contains the app itself. These are the artifacts needed to push the app directly using TIBCO Cloud CLI.
  4. Create a temporary directory on your machine.
  5. Move the downloaded flogo.json and the manifest.json files into the temporary directory.
    Note: The tibcli or tibcli.exe executable must not be in the same directory (the temporary directory you created) as the app you are pushing.
  6. Open a terminal or command prompt and cd to the temporary directory.
  7. Run the following command to push the app:
    tibcli app push <app-name>
    Important: If there is an existing app with an identical name as the app that you are trying to push to the cloud, the existing app gets overwritten with the newly pushed app. You do not get a warning about it.