Skip to content

feat(connectors): ship connector plugins in the iggy-connect docker image#3658

Open
kriti-sc wants to merge 8 commits into
apache:masterfrom
kriti-sc:#3614-add-connectors-to-docker-image
Open

feat(connectors): ship connector plugins in the iggy-connect docker image#3658
kriti-sc wants to merge 8 commits into
apache:masterfrom
kriti-sc:#3614-add-connectors-to-docker-image

Conversation

@kriti-sc

@kriti-sc kriti-sc commented Jul 12, 2026

Copy link
Copy Markdown
Contributor

Closes #3614

Rationale

Dynamically inject plugins to the apache/iggy-connect image to reduce friction for testing out connectors.

What changed?

This change publishes the image in two flavors:

Fat (edge, x.y.z, latest): the runtime plus every connector plugin baked into /usr/local/lib, which is already on the runtime's plugin search path. A config can load a bundled plugin by file name with no path. This is the new default.
Slim (edge-slim, x.y.z-slim, latest-slim): the runtime binary only, i.e. today's image, for deployments that bring their own plugins.

To this end:

  1. Single source of truth for the plugin set. scripts/ci/connector-plugins.sh derives the plugin list from cargo metadata (every cdylib under core/connectors/). The edge tarball build, the Docker fat stage, the license gate, and the release notes all consume it, so a newly added connector is picked up everywhere with no hand-edited list.
  2. Dockerfile. The planner derives the plugin set; cook and build compile the plugin cdylibs alongside the runtime; a new runtime-fat stage copies the .so files in. The slim runtime stage is unchanged.
  3. Publish pipeline. The docker-buildx action gained a target input, and components can declare flavors in publish.yml. Each flavor keeps its own per-arch digest artifacts so the manifest step never merges flavors into one image, and only the default flavor creates the git release tag.
  4. Licensing. The third-party license gate now validates the runtime plus every plugin dependency closure (derived list), so a new connector is license-validated on the PR that adds it. The fat image ships a LICENSE-binary-fat covering the plugins; slim keeps the runtime-only manifest.
  5. Edge gate. The connectors image now refreshes :edge on any change under core/connectors/.
  6. Docs. Connectors README documents the flavors and zero-config plugin loading with a docker run quickstart; edge release notes derive the plugin list.

Local Execution

  • Built images locally. The fat image is 357 MB, and the build took 20 mins on a 4 CPU/12 GB Docker VM. Slim image is 163 MB. This validates that image will build comfortably on Github CI runners which are 4 CPU/16 GB.
  • Pre-commit hooks ran.

AI Usage

  1. Which tools? (e.g., GitHub Copilot, Claude, ChatGPT) Claude
  2. Scope of usage? (e.g., autocomplete, generated functions, entire implementation) First developed the design and pass criteria. Then, generated functions and debugging with Claude.
  3. How did you verify the generated code works correctly? Built the image locally and checked if all plugins present in the image.
  4. Can you explain every line of the code if asked? Yes.

@codecov

codecov Bot commented Jul 12, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 15.99%. Comparing base (6f1d548) to head (dd6f794).

Additional details and impacted files
@@              Coverage Diff              @@
##             master    #3658       +/-   ##
=============================================
- Coverage     73.99%   15.99%   -58.00%     
  Complexity      937      937               
=============================================
  Files          1301     1299        -2     
  Lines        147393   128363    -19030     
  Branches     122945   103990    -18955     
=============================================
- Hits         109063    20538    -88525     
- Misses        34858   107325    +72467     
+ Partials       3472      500     -2972     
Components Coverage Δ
Rust Core 2.08% <ø> (-72.21%) ⬇️
Java SDK 62.44% <ø> (ø)
C# SDK 71.07% <ø> (-1.11%) ⬇️
Python SDK 92.17% <ø> (ø)
PHP SDK 84.29% <ø> (ø)
Node SDK 91.26% <ø> (ø)
Go SDK 42.87% <ø> (ø)
see 797 files with indirect coverage changes
🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

@kriti-sc kriti-sc changed the title #3614 add connectors to docker image feat(connectors): ship connector plugins in the iggy-connect docker image Jul 12, 2026
@kriti-sc
kriti-sc marked this pull request as ready for review July 19, 2026 18:18
@github-actions github-actions Bot added the S-waiting-on-review PR is waiting on a reviewer label Jul 19, 2026
@kriti-sc

Copy link
Copy Markdown
Contributor Author

/ready

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

S-waiting-on-review PR is waiting on a reviewer

Projects

None yet

Development

Successfully merging this pull request may close these issues.

CI: ship connector plugins in the apache/iggy-connect docker image

1 participant