Getting Started with Red Hat Managed Integration 2

Introduction to Red Hat Managed Integration

Red Hat Managed Integration is a platform for developing and deploying enterprise integration solutions. It is hosted and managed by Red Hat so you can focus on building applications, not infrastructure.

Managed Integration enables your team to develop, build, and deploy enterprise integration solutions on an OpenShift Dedicated cluster managed by Red Hat.

Managed Integration provides a simplified cloud-native experience and includes:

Solution Explorer: A web-based UI with single sign-on access to all applications.
Solution Patterns: Step-by-step instructions and best practices for common connectivity and application development tasks.
Applications: Pre-installed infrastructure components are configured for optimal performance.

All of the applications and services provided by Managed Integration are protected by your identity provider.

Red Hat Managed Integration includes the following roles:

Cluster administrators are created during the onboarding process and have the highest level of access to a cluster. To create a cluster administrator open a support case on the Red Hat Customer Portal.
Developers have access to the applications in the cluster and can deploy containerized applications. Typically, developers start by Creating cloud-native, integrated applications using Solution Patterns.

Managed Integration includes a managed instance of Red Hat Single Sign-On to enable you to protect any applications you deploy on your cluster. This application is labeled Customer Application SSO instance in the Solution Explorer.

Do not delete the admin user in the Customer Application SSO instance. This user is required by Red Hat to manage the instance.

Introduction to Solution Explorer

The Solution Explorer is a web-based UI with single sign-on access to all the applications and services available in your Managed Integration cluster:

OpenShift, the OpenShift cluster console.
API Designer, the Apicurito RESTful API visual designer.
Red Hat 3scale API Management, a platform that provides RESTful API Management.
Red Hat AMQ, a fast, lightweight, and secure messaging solution for Internet-scale applications.
Red Hat CodeReady Workspaces, a developer workspace server and cloud IDE.
Red Hat Fuse Online, a facility to obtain data from an application or service, operate on that data, and then send the data to another application or service without writing code.
Push Notifications, a service to push notifications to Android and iOS devices.
Red Hat Single Sign-On, a single sign-on solution for web apps and RESTful web services.

The Solution Explorer also provides Solution Patterns that provide step-by-step instructions and best practices for common connectivity and application development tasks that create new cloud-native, integrated applications.

Introduction to Solution Patterns

The following Solution Patterns are included within your Managed Integration cluster. They provide step-by-step instructions and best practices for common connectivity and application development tasks:

Connect applications using asynchronous messaging.
Protect applications using single sign-on.
Implement Low-code API development and SaaS integration.
Protect APIs using 3scale API Management Platform.
Add Data Sync to your application with GraphQL.

Additional resources

To learn more about using Solution Patterns, see Creating cloud-native, integrated applications using Solution Patterns.

Configuring a new Managed Integration cluster

A cluster administrator must configure the Managed Integration cluster before developers can start creating cloud-native, integrated applications.

Procedure

Log in to the Solution Explorer. The URL for the Solution Explorer is included with the email Red Hat sends you when your cluster becomes available.
Share the Solution Explorer URL with the developers in your organization.

Depending on the applications that your team plans to use, you might need to configure a GitHub OAuth app for Red Hat CodeReady Workspaces and give developers administrative privileges in Red Hat 3scale API Management.

Enabling developers to create API products in Red Hat 3scale API Management

A cluster administrator must give developers administrative privileges in 3scale before developers can create or edit API products.

Prerequisite

You are a cluster administrator.

Procedure

Log in to the Solution Explorer.
Navigate to the 3scale console.

When navigating to 3scale, choose Authenticate through Red Hat Single Sign-On when prompted to Log in to your Account.
Navigate to Account Settings by clicking the gear icon in the top right of the page.
Expand Users from the left hand menu and choose Listing.
Select the developer username you want to change.
Select the Admin (full access) option from the Role menu.

Additional resources

See Administration Guide for more information about 3scale user management in Red Hat Managed Integration.

Configuring GitHub OAuth for CodeReady Workspaces

Red Hat Managed Integration provides a full developer workspace server and cloud IDE with CodeReady Workspaces, allowing you to pull and push to GitHub projects. You must configure a GitHub OAuth app before developers can create a repository, pull, and push GitHub projects. The GitHub OAuth app allows users to import projects into CodeReady Workspaces by using SSH addresses (git@). Users can then push to repositories and use the pull request panel.

This procedure enables automatic SSH key upload to GitHub.

Prerequisites

You must have prior experience using GitHub.
You are a cluster administrator.

Procedure

Register an application on GitHub:
- To add a new application, log in to GitHub and go to OAuth applications in your developer settings. Click Settings → Developer settings → OAuth Apps → Register a new OAuth application.
- For GitHub Enterprise, go to your GitHub Enterprise homepage and then click Settings → Developer settings → Register a new application.
Enter an application name, for example, CodeReady Workspaces.
For the homepage URL, enter the CodeReady Workspaces URL.
```
https://codeready-redhat-rhmi-codeready-workspaces.apps.<cluster-suffix>
```
where <cluster-suffix> is the unique sub-domain for your cluster. For example, example.u7y2.s1.openshift.com
Enter the authorization callback URL:
```
https://keycloak-edge-redhat-rhmi-rhsso.apps.<cluster-suffix>/auth/realms/openshift/broker/github/endpoint
```
where <cluster-suffix> is the unique sub-domain for your cluster. For example, example.u7y2.s1.openshift.com
Click Register application.
Note the GitHub Client ID and GitHub Client Secret. You require these values later in the procedure.
Log in to the OpenShift console as a cluster administrator.
Navigate to the following URL in your browser:
```
https://console-openshift-console.apps.<cluster-suffix>/k8s/ns/redhat-rhmi-operator/secrets/github-oauth-secret
```
where <cluster-suffix> is the unique sub-domain for your cluster. For example, example.u7y2.s1.openshift.com
Select the Edit Secret option from the Actions menu.
Enter the GitHub Client ID and Client Secret that you previously noted:
1. Enter the GitHub Client ID for the value of Client ID.
2. Enter the GitHub Client Secret for the value of Secret.
Click Save.
To validate, request that a developer creates a workspace and connects to GitHub:
1. Log in to Solution Explorer.
2. Navigate to CodeReady Workspaces.
3. Create a workspace as described in Creating and configuring a new CodeReady Workspaces 2.0 workspace.
4. Click Add or Import Project → GitHub → Connect your GitHub account → Authorize.
5. Check that a list of projects is displayed in the Import Projects panel. If projects are not displayed, verify that you followed each step in this procedure.

Additional resources

See the Managed Integration Administration Guide for more information on administering your cluster.

As a cluster administrator you can perform all the tasks described in Administering an OpenShift Dedicated cluster.

This release of Red Hat Managed Integration does not support the tasks described in the Getting started with OpenShift Dedicated 4. If you would like to request a change to your cluster that is described in that guide, open a support case on the Red Hat Customer Portal.

A cluster administrator is also an administrator of 3scale and can perform the tasks described in the Admin Portal Guide.

Creating cloud-native, integrated applications using Solution Patterns

As a developer with access to a Managed Integration cluster, you can learn about developing cloud-native, integrated applications using Solution Patterns.

Prerequisites

You are a developer.
You have the Solution Explorer URL.

Procedure

Log in to the Solution Explorer.
Select the All Solution Patterns tab. The default Solution Patterns are displayed.

See Adding Solution Patterns for information about how to subscribe your cluster to a Git repository that contains more Solution Patterns.
Perform the 1 - Connecting applications using asynchronous messaging Solution Pattern to learn about using AMQ Online and Fuse Online.
Perform the 2 - Protecting applications using single sign-on Solution Pattern to learn about using the Customer Application SSO instance to protect end-user applications.

You must complete the 1 - Connecting applications using asynchronous messaging Solution Pattern before performing this Solution Pattern.
Perform the 3 - Low-code API development and SaaS integration Solution Pattern to learn more about using Fuse Online with external services.
Perform the 4 - Protecting APIs using 3scale API Management Platform Solution Pattern to learn about protecting APIs with Red Hat 3scale API Management. When navigating to 3scale, choose Authenticate through Red Hat Single Sign-On when prompted to Log in to your Account.

To complete this Solution Pattern, a cluster administrator must give you 3scale administrative privileges as described in the 3scale Admin Portal Guide.
Perform the 5 - Adding Data Sync to your application with GraphQL Solution Pattern to learn about building a Node.js application using a GraphQL API. This Solution Pattern also shows how to integrate applications with Red Hat Single-Sign On and AMQ Online.
If you do not intend to use the resources created by completing Solution Patterns, delete those resources to preserve cluster capacity. For example:
1. Delete OpenShift projects.
2. Delete Fuse Online integrations.
3. Delete AMQ address spaces.
4. Delete 3scale products.

Additional resources

See the Developer Guide for more information about what developers can do in a cluster.