Self-Managed API Gateway On OpenShift

Steps

1. Create Access Token For API Gateway (APIcast)

From main dashboard, select Account Settings from dropdown list menu.
self-manage gw
Select Personal -> Tokens menu from left panel, then click Add Access Token link.
self-manage gw
Enter following details, then click Create Access token button.
- Name: Local Gateway
- Scopes: Select Account Management API
- Permission: Read Only
self-manage gw
Copy the token to somewhere you can recall later. Then click I have copied the token button.
self-manage gw
A new access token should be created.
self-manage gw

2. Install 3scale APIcast Operator

Login to OpenShift web console, and switch to Administrator perspective. Select Home -> Projects menu from left panel, then click Create Project button.
self-manage gw
Enter following details, then click Create button.
- Name: api-gateway
- Display name: API Gateway
self-manage gw
The project should be created. Then Select Workloads -> Secrets menu from left panel.
self-manage gw
Make sure the current project is api-gateway you've just created. Then click on Create button.
self-manage gw
Enter following details, then click Create button.
- Secret name: apicast-secret
- Key: AdminPortalURL
- Value: Enter 3scale admin portal URL in this format: https://<ACCESS_TOKEN>@3scale-admin.apps.<DOMAIN> where the ACCESS_TOKEN is the access token you've created in 3scale. And DOMAIN is the OpenShift cluster domain (You can use oc whoami --show-console|awk -F'apps.' '{print $2}' command to get the domain value. Or just copy from the URL in web browser.)
self-manage gw
The secret should be created.
self-manage gw
Select Operators -> OperatorHub menu from left panel.
self-manage gw
Enter gateway in search box then select Red Hat Integration - 3scale APIcast gateway...
self-manage gw
A panel will be show on the right side, click Install button.
self-manage gw
Select follwing options, then click Install button.
- Update channel: threescale-2.12
- Installation mode: A specific namespace on the cluster
- Installed Namespace: api-gateway
self-manage gw
Wait until the operator get installed successfully. Then click View Operator button.
self-manage gw

3. Setup APIcast API Gateway

Click Create instance link to create APIcast (API Gateway) instance.
self-manage gw

Switch to YAML view then replace the existing code snippet with the snippet below. DO NOT forget to replace CLUSTER_DOMAIN with the OpenShift cluster domain (just copy from the URL in web browser.) Then click Create button.

apiVersion: apps.3scale.net/v1alpha1
kind: APIcast
metadata:
name: prod-gateway
namespace: api-gateway
spec:
adminPortalCredentialsRef:
    name: apicast-secret
deploymentEnvironment: production
exposedHost:
    host: api-gateway.apps.<CLUSTER_DOMAIN>
    tls:
    - {}

A new instance of APIcast should be created. Select Networking -> Routes to see the API Gateway route.
self-manage gw
A new route should be created as per the .exposedHost.host value in the YAML configuration above. Copy the route URL clipboard or somewhere you can recall becasue you'll need this to configure 3scale.
self-manage gw

4. Promote 3scale Configuration to Self-Managed API Gateway

Switch to 3scale admin web console, click Human Resource Services link in the Products panel from the main dashboard.
self-manage gw
Select Integration -> Settings menu from left panel. Then replace the Production Public Base URL with the APIcast (API Gateway) route URL.
self-manage gw
Scroll down to bottom of the page then click Update Product button.
self-manage gw
Select Integaration -> Configuration menu from left panel. Then click Promote v.n to Staging APIcast button. And then click Promote v.n to Production APIcast button as well.
self-manage gw
The Production APIcast URL should be changed to the new APIcast URL now.
self-manage gw