# Platform-Specific Setup

KushoAI provides Docker-based CI/CD integration that works with all major platforms. Each platform has specific configuration requirements and best practices for Docker execution.

## Supported Platforms

All platforms use the same Docker image: `public.ecr.aws/y5g4u6y7/kusho-test-runner:latest`

### Cloud Platforms

- **[GitHub Actions](gh-actions.md)** - Native GitHub workflow integration with Ubuntu runners
- **[GitLab CI/CD](gitlab.md)** - GitLab pipeline integration with Docker-in-Docker support
- **[Azure DevOps](azure-devops.md)** - Azure pipeline integration with Docker tasks
- **[AWS CodeBuild](aws-codebuild.md)** - Amazon CodeBuild integration with managed Docker environments

### Self-Hosted Platforms

- **[Jenkins](jenkins.md)** - Jenkins pipeline integration with Docker support

## Platform Comparison

| Platform | Docker Support | Secrets Management | Commit Variables | Best For |
|----------|-----------------|-------------------|------------------|-----------|
| **GitHub Actions** | Native | GitHub Secrets | Built-in | Open source, GitHub repos |
| **GitLab CI/CD** | Docker-in-Docker | GitLab Variables | Built-in | GitLab repos, self-hosted |
| **Azure DevOps** | Docker Tasks | Azure Key Vault | Built-in | Enterprise, Microsoft stack |
| **AWS CodeBuild** | Managed Docker | Parameter Store | Built-in | AWS ecosystem |
| **Jenkins** | Plugin/Agent | Credentials Store | Manual setup | Self-hosted, enterprise |

## Quick Start Guide

1. **Choose Your Platform** - Select the platform that matches your current CI/CD setup
2. **Configure Docker Access** - Ensure your runners/agents can pull Docker images
3. **Set Up Secrets** - Add your Kusho API key as a secure secret
4. **Copy Configuration** - Use our platform-specific templates as starting points
5. **Customize** - Adapt the configuration for your specific test suites and environments

## Common Requirements

All platforms require:
- Docker runtime environment
- Access to pull from public ECR registry
- Secure storage for API keys and sensitive data
- Network access to KushoAI APIs

## Getting Help

Each platform guide includes:
- Prerequisites and setup instructions
- Complete configuration examples
- Best practices and troubleshooting
- Integration with platform-specific features