Deploying 3scale API Management to ROSA and OSD

This document will take you through deploying 3scale in any OSD or ROSA cluster. Review the official documentation here for more information or how to further customize or use 3scale.

Prerequisites

• An existing ROSA or OSD cluster
• Access to an AWS account with permissions to create S3 buckets, IAM users, and IAM policies
• A subscription for 3scale API Management
• A wildcard domain configured with a CNAME to your cluster’s ingress controller

Prepare AWS Account

1. Set environment variables (ensuring you update the variables appropriately!)

2. Create an S3 bucket

3. Apply the proper S3 bucket CORS configuration

4. Create an IAM policy for access to the S3 bucket

5. Create an IAM user to access the S3 bucket

6. Generate an access key for the newly created S3 user

7. Apply the IAM policy to the newly created S3 user

Install the 3Scale API Management Operator

8. Create a new project to install 3Scale API Management into.

9. Inside of the OpenShift Web Console, navigate to Operators -> OperatorHub.

10. Search for “3scale” and select the “Red Hat Integration - 3scale” Operator.

    

11. Click “Install” and select the project you wish to install the operator into.

    For this example, I’m deploying into the “3scale-example” project that I have just created.

    

12. Once the 3Scale operator successfully installs, return to your terminal.

Deploy 3Scale API Management

12. Create a secret that contains the Amazon S3 configuration.

13. Create an APIManager custom resource

14. Once the APIManager instance becomes available, you can login to the 3Scale Admin (located at https://3scale-admin.$WILDCARD_DOMAIN) using the credentials from the below commands:

15. Congratulations! You’ve successfully deployed 3Scale API Management to ROSA/OSD.