APIC for CP4I tekton Pipeline

[andrew-suh]

This section needs to be finished.

[hollisc]

Enhancement: Expand the ACE Tekton pipeline (https://github.com/ibm-cloud-architecture/gse-devops/tree/master/cloudpak-for-integration-tekton-pipelines) to include an additional Task to accomplish the following:

1. Extract the generated OpenAPI json from the deployed ACE server.
2. Import the json into APIC
3. Publish api into a target APIC Catalog to be available for subscribers.

[hollisc]

Initial path was to explore usage of APIC cli to achieve the goals mentioned above but the APIC cli can only import api in a yaml format which required a converter to be created.

An alternative is to use the APIC REST API directly and import the json. This is the path we will work with next.

Here is a sample curl call to draft a rest API:

curl --location --request POST 'https://api.9.30.166.16.xip.io/api/orgs/jps-org/drafts/draft-apis' \ --header 'Accept: application/json' \ --header 'Content-Type: application/json' \ --data-raw '{ "draft_api": { "swagger": "2.0", "info": { "title": "test-create-api-jps", "x-ibm-name": "test-create-api-jps", "version": "1.0.0" }, "host": "$(catalog.host)", "schemes": [ "https" ], "basePath": "/", "produces": [ "application/json" ], "consumes": [ "application/json" ], "security": [ { "client-id": [] } ], "securityDefinitions": { "client-secret": { "type": "apiKey", "description": "", "in": "header", "name": "X-IBM-Client-Secret" }, "client-id": { "type": "apiKey", "description": "", "in": "header", "name": "X-IBM-Client-Id" } }, "x-ibm-configuration": { "phase": "realized", "testable": true, "enforced": true, "properties": { "target-url": { "value": "http://example.com/operation-name", "description": "The URL of the target service", "encoded": false } }, "cors": { "enabled": true }, "application-authentication": { "certificate": false }, "assembly": { "execute": [ { "invoke": { "version": "2.0.0", "target-url": "https://api.us.apiconnect.ibmcloud.com/developmentoperations-apiconnect/", "title": "3 day forecast invocation", "cache-response": "time-to-live", "cache-key": "$(request.search)" } } ] }, "gateway": "datapower-api-gateway", "type": "rest" }, "tags": [ { "name": "test-jps-api", "description": "Sample API to get branches" } ], "paths": { "/jps-test": { "get": { "summary": "get all branches", "description": "get brnaches", "operationId": "jps-test", "tags": [ "Weather" ], "parameters": [ { "name": "zip", "type": "string", "in": "query", "description": "A 5 number zip code" }, { "name": "country", "type": "string", "in": "query", "description": "A 2 letter country code" } ], "responses": { "200": { "description": "Success", "schema": { "type": "integer" } }, "400": { "description": "Bad Request", "schema": { "type": "integer" } }, "408": { "description": "Request Timeout", "schema": { "type": "integer" } }, "500": { "description": "Internal Server Error", "schema": { "type": "integer" } } }, "consumes": [], "produces": [] } } } } }'

[hollisc]

APIC REST API documentation: https://openwhisk.ng.bluemix.net/api/v1/web/API%20Connect%20Native_apic-on-prem/default/index.http?_ga=2.251135503.806013163.1589782388-286288226.1587719548&cm_mc_uid=24566565861915740645097&cm_mc_sid_50200000=15836981589955998051