Deploying integration servers with App Connect Dashboard

The App Connect Dashboard capability provides an IBM® App Connect runtime environment for integrations, and is intended to host production workloads.

From your App Connect Dashboard instance, you can deploy the following types of integrations:

  • Integrations that were developed as an integration solution in the IBM App Connect Enterprise Toolkit (the toolkit). An integration solution is the container for the resources (for example, message flows, message flow nodes, and message models) that you develop to process your business messages and data.
  • Integrations that were authored as flows in an instance of App Connect Designer or App Connect on IBM Cloud.
  • Hybrid integrations that were developed by using the toolkit, and App Connect Designer or App Connect on IBM Cloud.

You can deploy any of these integrations as follows:

  1. From the toolkit, package the message flows and other development resources for an integration solution into a broker archive (BAR) file. Or from your App Connect Designer or App Connect on IBM Cloud instance, export a flow definition as a BAR file.
  2. Upload the BAR file to your App Connect Dashboard instance.
  3. Deploy the BAR file to an integration server to expose the underlying integration that runs in your production system.

You can also use your App Connect Dashboard instance to store and manage BAR files.

Considerations for deploying integration servers

  • To deploy BAR files that contain flow definitions from App Connect Designer or App Connect on IBM Cloud, take note of the following considerations:
    • If you want to export a flow from App Connect on IBM Cloud as a BAR file, that flow must meet the requirements for export. Certain actions or nodes in App Connect on IBM Cloud are not supported for BAR file export, so you might need to reconfigure alternative actions in the flow before you are allowed to export.
    • While deploying the BAR file in the App Connect Dashboard, you can enable local connectors only, or enable both local and cloud-managed connectors. These connectors will be used to connect to the target applications that are referenced in the flow definition and to run the configured operations.
    • If you want to use local connectors to run one or more operations in the deployed integration server, you must set up accounts to connect to each of the applications that are referenced in those operations.
    • If you want to use cloud-managed connectors to run one or more operations in the deployed integration server, you will need access to an App Connect on IBM Cloud instance that hosts cloud connectors. You will need to specify an IBM Cloud API key that the deployed API can use to authenticate to this App Connect on IBM Cloud instance, in order to connect to the connectors and accounts that are referenced in the exported flow.
  • While deploying the BAR file for any type of integration, you can select or create one or more configuration objects that you want apply to the integration server. Various configuration types are supported, which you can use to define environment-specific settings, secrets, or data. The accounts that are required for local connectors, and the IBM Cloud API key that is required for cloud-managed connectors must be configured as configuration objects.

See Deploying Designer and Toolkit integrations to integration servers for more information.