Enable SimpCon Consumer

simpcon consumer template the simpcon consumer template helps you consume messages from data streaming services and transform them into the format required by the receiving system how the extension works the extension runs as a container in kubernetes when you create an extension instance in the integrated aiops platform the extension performs the following actions consumes messages from data streaming services transforms the requests into the format required by the receiving system sends the transformed requests to the configured destination endpoint for local testing, ensure that your environment meets the following requirements a unix compatible terminal ubuntu docker access to the required data streaming services endpoint valid credentials for the stream endpoint familiarity with the extension codebase only developers who are familiar with the codebase should run the extension locally incorrect configuration might cause unexpected errors configure the extension when you create the extension from the integrated aiops user interface, a red asterisk ( ) identifies each required variable when you run the extension locally, define the following environment variables variable default value description dx env environment "" required specifies the integrated aiops deployment environment supported values are dev and prod dx ext batch frequency "" required specifies the sleep interval, in seconds, between status stream checks dx ext extension name "" required specifies the name of the consumer group dx ext source gsma customer codes "" required specifies the three character account codes configured in the user interface dx ext source instance codes "" required specifies the tec id configured in the user interface dx ext source url "" required specifies the netcool destination endpoint url dx ext source ip address "" required specifies the destination ip address dx ext source user "" required specifies the destination endpoint user for basic authentication dx ext source pw "" required specifies the destination endpoint password for basic authentication dx env ou key "" required specifies the organizational unit key used to authenticate with automation services dx ext source cert "" required specifies the source ssl certificate when the source uses a self signed certificate or a nonstandard certificate authority dx ext log level "" required specifies the log level deploy the extension use the integrated aiops user interface to configure and deploy the extension to an individual ou or compute zone the extension is intended for use only within the integrated aiops platform run the extension locally use the /run sh script to run the extension from a unix compatible terminal the script contains sample scenarios and can use mock servers for local unit testing to run the extension open a unix compatible terminal go to the extension repository configure the required environment variables run the following command /run sh configure local stream access the application does not automatically inject the stream url before you run it locally, specify the appropriate synapps url, user name, and password create the following file in the repository root local/ ensitive sh add the following content \#!/bin/bash eux \# optional if not set it will become \# https //098a759b1e7c 1 account dev delivery kyndryl net/streams/automations status \# export stream source="\[\[ the stream url ]]" export app synapps user=\[\[the synapps user for the stream source url]] export app synapps pw=\[\[the synapps password for the stream source url]] \# recommended turning this on will disable the internal event forwarder and \# will make logs a little cleaner export disable event forwarder=true protect the local/sensitive sh file because it contains credentials do not commit credentials to the source code repository run the test suite the extension includes a test suite that connects to mock servers to run the test suite from ubuntu with docker open a terminal go to the extension repository run the following command /tes /test sh run the extension with custom options use the /test/run sh script to run the extension locally with custom options for example /test/run sh prune interactive this command performs the following actions removes containers and images with names that begin with isg netcool automation builds an image with a tag that begins with isg netcool automation starts a container with the same prefix selects an available port near port 8943 writes the container logs directly to the terminal the interactive option displays log output synchronously in the terminal to view all supported options, run /test/run sh help execution result the extension ingests incident records from the dedicated ticketing system and publishes them to the automations status topic pull request requirements pull requests that involve production branches require at least two reviews reviews from contributors who committed code to the same pull request do not count toward this requirement