Introduction

Adapter is a part of the CloudBlue Connect Extension for the CloudBlue Commerce that is required to initialize Hub object in the CloudBlue Connect Provider Portal and establish internal API connectivity.

Adapter is highlighted in the overall Extension components diagram below:

Adapter consists of the back-end (service) and front-end (package) components deployed independently as outlined in the following paragraphs.

Please refer to the following sections of this document for details on the deployment of the Adapter Package and related configuration.

Prerequisites

Deployment of the Adapter Service requires Kubernetes (k8s) Cluster component of the CloudBlue Commerce for the deployment:

And instantiation of the Adapter APS Package requires Outbound and Outbound proxies configuration:

Please refer to the above mentioned articles for the details.

1. Service Deployment

Please follow these steps to deploy Adapter Service back-end.

1.1 – Prepare Deployment File

You will need the following file to deploy the Adapter Package Service into the Kubernetes Cluster:

This file describes desired state of a Deployment as described in the Kubernetes Concepts – Deployment.

Please download the file above and modify the following values to match your specific configuration:

  • RPC_HOST – must be replaced with the IP address of the CloudBlue Commerce Management Node
  • OAUTH_KEY – must be replaced with any random generated string
  • OAUTH_SECRET – must be replaced with any random generated string

You can use the Online Random Strings Generator to get 2 values for the OAUTH_KEY and OAUTH_SECRET respectively or use any other way to generate random values with the following constraints in mind:

  1. String must be 32 symbols length
  2. Only lower case characters and numbers are allowed
  3. No special symbols are allowed

Users can even enter random string manually as long as it conforms to the requirements above.

1.2 – Execute Deployment File

In order to execute the deployment instructions from the file using the kubectl utility, you need to upload the connect-adapter-deployment.yml file prepared in the previous step to some folder in your k8s cluster (e.g. /root).

Once file is uploaded to the cluster, access k8s node using SSH and execute the following command:

$ kubectl apply -f connect-adapter-deployment.yml

Using the file uploaded in the previous step. See kubectl reference guide for more details.

1.3 – Check that Container is Running

Before going forward, please make sure that Container is up and running as it might take some time for it to become ready. The simplest way to check container status is by running the following command:

$ kubectl get pods

See technical details for more information related to the technical aspects of service operations.

2. Package Deployment

Once Adapter Service is up and running, it is required to deploy Adapter Package into the CloudBlue Commerce following instructions below.

2.1 Import APS Package

Open Provider Control Panel of the CloudBlue Commerce, navigate too the Services > Applications screen and click Import Package:

and, assuming service names were not modified during deployment, specify the following URL pointing to the Adapter Service running in the Kubernetes Cluster:

  • https://connect-cbc-adapter:8180/apspackage

as illustrated in the following diagram:

As a result of this operation you should see the “Package successfully scheduled for import” notification. Please wait a few seconds.

In case the CloudBlue Commerce fails to import using the URL above, please download the APS package below and upload it using the “local file” option

Upon completion of the importing process, you will be able to proceed to the next step of the configuration process and create APS Application Instance.

2.2 Create APS Application Instance

Once APS Package is imported, please navigate to the System Applications tab, locate the “CloudBlue Connect Adapter” package:

Once clicked at the package in the list, you will navigate to the APS Application Instances list:

Click “Add Instance” to navigate to the Instance Creation screen:

And provide the following values:

ParameterValue
Application API end-point URIhttps://connect-cbc-adapter:8180
Authentication TypeOAuth
Network AccessBacknet
OAuth Keyvalue written to the Deployment file’s OAUTH_KEY variable while deploying Adapter Service
OAuth Secretvalue written to the Deployment file’s OAUTH_SECRET variable while deploying Adapter Service
Impersonation LevelYes

Click “Next” and create APS Application Instance.

If everything was done correctly, you should see your new instance with the status “Ready” in the System Applications list as illustrated below:

And by clicking at the Instance you should be able to navigate to the Adapter Package screen to retrieve the Hub Instance ID configuration value:

The value of the Hub Instance ID is required to initialize Hub object and establish API connectivity with the CloudBlue Connect.

3. Hub Registration

Once both Adapter Service and Adapter Package are deployed, you will be able to instantiate Hub object referring to this instance of the CloudBlue Commerce in the Provider Portal of the CloudBlue Connect.

To do that, please navigate to the Hubs Management module and click “Register Hub”:

Choose Type “CloudBlue Commerce and use Instance ID acquired during creation of the Adapter APS Application Instance in the previous step of this tutorial:

Once registered, you should be able to see the Hub in the list:

And Adapter is completely configured.

Is this page helpful?
Translate with Google
Copied to clipboard