SoftwareONE FinOps for Cloud Marketplace Extension

Extension integrates FinOps for CLoud Marketplace Extension with the SoftwareONE Marketplace

Run tests

$ docker-compose build app_test
$ docker-compose run --service-ports app_test

Local run using SoftwareONE Marketplace API

Create configuration files

1. Create environment file

$ cp .env.sample .env

1. Setup parameters for .env file

MPT_PRODUCTS_IDS=PRD-1111-1111
MPT_PORTAL_BASE_URL=http://devmock:8000
MPT_API_BASE_URL=http://devmock:8000
MPT_API_TOKEN=<vendor-api-token>
MPT_ORDERS_API_POLLING_INTERVAL_SECS=120
EXT_WEBHOOKS_SECRETS={"PRD-1111-1111": "<super-jwt-secret>"}
EXT_MSTEAMS_WEBHOOK_URL=https://whatever.webhook.office.com/webhookb2/<...>
EXT_FFC_SUB=FTKN-1111-1111
EXT_FFC_OPERATIONS_API_BASE_URL=https://api.finops.s1.show/ops
EXT_FFC_OPERATIONS_SECRET=supersecret

MPT_PRODUCTS_IDS should be a comma-separated list of the SWO Marketplace Product identifiers For each of the defined product id in the MPT_PRODUCTS_IDS list define WEBHOOKS_SECRETS json variables using product ID as key.

EXT_WEBHOOKS_SECRETS={"PRD-1111-1111": "<webhook-secret-for-product>"}

Example of .env file

MPT_PRODUCTS_IDS=PRD-1111-1111
MPT_PORTAL_BASE_URL=http://devmock:8000
MPT_API_BASE_URL=http://devmock:8000
MPT_API_TOKEN=<vendor-api-token>
MPT_ORDERS_API_POLLING_INTERVAL_SECS=120
EXT_WEBHOOKS_SECRETS={"PRD-1111-1111": "<super-jwt-secret>"}
EXT_MSTEAMS_WEBHOOK_URL=https://whatever.webhook.office.com/webhookb2/<...>
EXT_FFC_SUB=FTKN-1111-1111
EXT_FFC_OPERATIONS_API_BASE_URL=https://api.finops.s1.show/ops
EXT_FFC_OPERATIONS_SECRET=supersecret

Build and run extension

1. Build and run the extension

$ docker-compose build app
$ docker-compose run --service-ports app

Configuration

Application

Environment Variable	Default	Example	Description
EXT_WEBHOOKS_SECRETS	-	{"PRD-1111-1111": "123qweasd3432234"}	Webhook secret of the Draft validation Webhook in SoftwareONE Marketplace for the product
MPT_PRODUCTS_IDS	PRD-1111-1111	PRD-1234-1234,PRD-4321-4321	Comma-separated list of SoftwareONE Marketplace Product ID
MPT_API_BASE_URL	http://localhost:8000	https://portal.softwareone.com/mpt	SoftwareONE Marketplace API URL
MPT_API_TOKEN	-	eyJhbGciOiJSUzI1N...	SoftwareONE Marketplace API Token
EXT_FFC_SUB	FTKN-1111-1111	FTKN-1111-1111	FinOps for Cloud Operation API Token ID
EXT_FFC_OPERATIONS_API_BASE_URL	https://api.finops.s1.show/ops	https://api.finops.s1.show/ops	FinOps for Cloud Operation API URL
EXT_FFC_OPERATIONS_SECRET	-	eyJhbGciOiJSUzI1N...	FinOps for CLoud Operation API Token
MPT_NOTIFY_CATEGORIES	-	{"ORDERS": "NTC-0000-0006"}	SoftwareONE Marketplace Notification Categories

Azure AppInsights

Environment Variable	Default	Example	Description
OTEL_SERVICE_NAME	Swo.Extensions.FFC	Swo.Extensions.FFC	Service name that is visible in the AppInsights logs
APPLICATIONINSIGHTS_CONNECTION_STRING	-	InstrumentationKey=cf280af3-b686-40fd-8183-ec87468c12ba;IngestionEndpoint=https://westeurope-1.in.applicationinsights.azure.com/;LiveEndpoint=https://westeurope.livediagnostics.monitor.azure.com/	Azure Application Insights connection string

Other

Environment Variable	Default	Example	Description
MPT_ORDERS_API_POLLING_INTERVAL_SECS	120	60	Orders polling interval from the Software Marketplace API in seconds