Skip to content

About

Registry for cloud and SaaS providers for StackQL, generated from extensions to the providers OpenAPI3 specification

Topics

Resources

Contributing

Security policy

Stars

38 stars

Watchers

2 watching

Forks

Repository files navigation

GitHub Actions License

StackQL Provider Registry

A repository of provider interface documents supporting stackql (stackql GitHub repo).

Important

New and updated provider revisions published after the signing cutover use quantum-safe ML-DSA-65 signatures. Signature verification requires StackQL v0.13 or later and remains opt-in, disabled by default. Existing provider revisions gain the new signatures as they are updated or republished; legacy revisions must be republished before they can pass the new verifier. See signing and verification.

Table of Contents

Provider Catalog

The following StackQL providers are available in the public StackQL Provider Registry. Use REGISTRY LIST to discover providers and REGISTRY PULL <provider> to install one.

Icon Provider Latest Version Date First Published Date Last Published
anthropic anthropic v26.09.00461 2024-10-25 2026-09-15
anthropic_admin anthropic_admin v26.07.00416 2026-07-09 2026-07-09
aws aws v26.08.00444 2022-08-19 2026-08-20
awscc awscc v26.07.00426 2024-03-07 2026-07-28
azure azure v26.07.00420 2022-08-20 2026-07-14
azure_extras azure_extras v26.07.00420 2022-08-20 2026-07-14
azure_isv azure_isv v26.07.00420 2024-01-25 2026-07-14
azure_stack azure_stack v26.07.00420 2024-01-25 2026-07-14
clickhouse clickhouse v26.08.00442 2026-08-17 2026-08-17
cloudflare cloudflare v26.07.00424 2023-03-24 2026-07-21
confluent confluent v26.05.00403 2024-11-01 2026-05-31
databricks_account databricks_account v26.11.00490 2024-12-20 2026-11-05
databricks_workspace databricks_workspace v26.11.00490 2024-12-20 2026-11-05
datadog datadog v26.08.00455 2023-12-28 2026-08-26
deno deno v26.09.00459 2025-09-09 2026-09-15
digitalocean digitalocean v26.08.00434 2023-03-24 2026-08-03
entra_id entra_id v26.07.00412 2026-06-02 2026-07-06
firebase firebase v26.08.00446 2022-07-04 2026-08-20
fivetran fivetran v26.09.00467 2023-03-17 2026-09-28
github github v26.08.00448 2022-05-02 2026-08-20
gitlab gitlab v26.09.00465 2026-09-26 2026-09-26
godaddy godaddy v26.09.00463 2023-12-16 2026-09-16
google google v26.08.00446 2022-03-15 2026-08-20
googleadmin googleadmin v26.07.00432 2023-07-07 2026-07-31
googleworkspace googleworkspace v26.07.00432 2023-01-08 2026-07-31
homebrew homebrew v25.01.00292 2023-12-28 2025-01-27
k8s k8s v26.08.00453 2022-06-19 2026-08-24
kafka kafka v26.05.00403 2026-05-31 2026-05-31
lambda lambda v26.10.00481 2026-10-21 2026-10-21
linode linode v26.08.00440 2023-05-12 2026-08-04
netlify netlify v26.08.00457 2022-05-11 2026-08-28
nvidia nvidia v26.10.00479 2026-10-19 2026-10-19
oci oci v26.10.00475 2026-10-05 2026-10-05
okta okta v26.08.00436 2022-03-15 2026-08-04
openai openai v26.07.00422 2024-10-25 2026-07-15
openai_admin openai_admin v26.07.00422 2026-07-15 2026-07-15
pagerduty pagerduty v26.09.00459 2023-12-20 2026-09-15
railway railway v26.09.00469 2026-09-28 2026-09-28
snowflake snowflake v26.08.00438 2025-05-20 2026-08-04
sumologic sumologic v26.09.00459 2022-12-10 2026-09-15
supabase supabase v26.10.00477 2026-10-12 2026-10-12
typesafe typesafe v26.10.00473 2026-10-04 2026-10-04
vercel vercel v26.09.00459 2023-12-14 2026-09-15

Updating the Catalog

With Node.js 18 or later, internet access, and a full Git checkout, run:

git fetch origin main
node scripts/docs/update_provider_listings.js

Context

StackQL provider interface documents inform the stackql application on how to interact with a given provider (like aws, azure, google, etc), including what methods are available in the provider and how to invoke these using SQL semantics. Provider interface documents are yaml formatted, OpenAPI specifications with extensions.

The documents are versioned per provider in this repository, and built as signed and compressed packaged artifacts. The packaged artifacts are registered and published to the StackQL Provider Registry Artifact Repository in AWS S3 (the master/archive store). The full docs tree is then mirrored to Cloudflare R2 and served at the edge by a Cloudflare Worker (source in origin/), which provides the provider interface documents to the stackql application using the REGISTRY LIST and REGISTRY PULL commands.

The following diagram shows the context of the provider registry:

C4Context
    System_Ext(github_repo, "stackql-provider-registry", "GitHub Repository")
    System_Ext(github_actions, "Build and Deploy", "GitHub Actions")
    SystemDb(artifact_repo, "Artifact Repository", "AWS S3")
    SystemDb(r2_bucket, "Docs Mirror", "Cloudflare R2")
    System(cf_worker, "Provider Registry Origin", "Cloudflare Worker")
    System(stackql, "StackQL Application", "stackql")

    Rel(github_repo, github_actions, "triggers...")
    Rel(github_actions, artifact_repo, "registers and pushes to...", "signed tgz package")
    Rel(github_actions, r2_bucket, "syncs docs tree to...")
    Rel(cf_worker, r2_bucket, "reads provider docs from...")
    Rel(stackql, cf_worker, "list and pulls registry docs from...", "REGISTRY LIST | REGISTRY PULL")
    UpdateLayoutConfig($c4ShapeInRow="3", $c4BoundaryInRow="0")
Loading

The public StackQL Provider Registry is served from Cloudflare, using the following endpoints:

Endpoint Description
registry.stackql.app Production registry (built from main)
registry-dev.stackql.app Development registry (built from dev)

Contributing

Please see CONTRIBUTING.md.

Developing a Provider

StackQL providers are generated from provider OpenAPI or Swagger specifications (either supplied by the provider or constituted through other scripts - for example, google-discovery-to-openapi or stackql-azure-openapi).

Once you have an OpenAPI specification, you can use the openapisaurus utility project to generate a StackQL provider document.

Build and Deployment Workflow

The provider registry is built and deployed using GitHub Actions. Provider documents are validated and tested in workflow steps and then packaged and stored in the artifact repository. The reconstructed docs tree is mirrored to Cloudflare R2 and served by the Cloudflare Worker origin, where the provider documents are available from the stackql application using REGISTRY LIST or REGISTRY PULL. See docs/build-and-deployment.md for more information.

A separate workflow guards against providers being deleted from providers/src on any push; intentional removals require an explicit override in the commit message. See provider delete guard for details.

Testing a Provider using the dev Registry

Use the following steps to test a provider using the dev registry:

export DEV_REG="{ \"url\": \"https://registry-dev.stackql.app/providers\" }"
./stackql --registry="${DEV_REG}" shell

About

Registry for cloud and SaaS providers for StackQL, generated from extensions to the providers OpenAPI3 specification

Topics

Resources

Contributing

Security policy

Stars

38 stars

Watchers

2 watching

Forks

Releases

Sponsor this project

Used by

Contributors

Languages