SoftwareONE AWS Marketplace Extension

swo-aws-extension is a SoftwareOne Marketplace extension for AWS Marketplace workflows.

The repository contains:

• a Django-based extension runtime
• Marketplace order validation and fulfillment flows
• AWS, CCP, CRM, FinOps, and Marketplace integration clients
• operational commands for querying, synchronization, reporting, and billing journals
• Helm deployment charts for API and worker workloads

Documentation

Start here:

• AGENTS.md: entry point for AI agents
• docs/deployment.md: runtime configuration and deployment model
• docs/contributing.md: repository-specific development workflow
• docs/testing.md: testing strategy and commands
• docs/migrations.md: migration workflow and migration-specific constraints
• docs/documentation.md: repository documentation rules

Quick Start

Prerequisites:

• Docker with the docker compose plugin
• make

Recommended setup:

cp .env.sample .env
make build
make test
make run

The application runs on http://localhost:8080.

See docs/deployment.md for runtime parameters and the Docker-based local execution context.

Repository Layout

• swo_aws_extension/: extension package and business flows
• tests/: pytest suite
• make/: modular make targets
• migrations/: mpt-service-cli migration scripts
• helm/swo-extension-aws/: Helm charts for deployment

Common Commands

make build
make run
make test
make check
make check-all
make shell