Goal
Evaluate CI/CD systems and internal engineering platforms that lack a prebuilt connector, and choose OpenAPI, webhooks, or an enterprise integration service.Prerequisites
Confirm the platform can check out code, protect secrets, issue HTTP requests, and set run status.Common platform examples
- Jenkins, GitHub Actions, GitLab CI, and Azure Pipelines;
- Gitee and Gitee Go;
- Huawei Cloud CodeArts;
- Bitbucket Pipelines;
- TeamCity or Bamboo;
- Tekton or Argo Workflows;
- internal pipeline engines.
These platforms support a generic integration and are not part of the PawSQL prebuilt connector support list.
Platform capability checklist
Choose an integration path
Internal engineering platforms (integration service)
Large organizations route SQL through internal developer portals, approval systems, and release platforms. Wrap PawSQL OpenAPI in an integration service instead of having each business system store PawSQL credentials and implement gate logic.Recommended architecture
Integration service responsibilities
- Verify caller identity and permissions;
- Map organizations, applications, repositories, environments, workspaces, and policies;
- Extract, segment, and submit SQL;
- Manage asynchronous state, timeouts, and retries;
- Convert results into the enterprise platform’s unified risk model;
- Return approval decisions and report links;
- Preserve end-to-end correlation identifiers and audit records.
Suggested mapping
Reliability design
- Use a stable external request ID for idempotency;
- Design job creation and status queries as asynchronous flows;
- Retry transient network errors with bounded backoff;
- Do not auto-retry deterministic errors such as SQL violations or authentication failures;
- Retain the PawSQL job ID to resume an interrupted status query;
- Build compatibility tests for API version upgrades;
- Set split, size, and total processing time limits for large scripts.