devops connectors¶
DevOps and CI/CD tool integrations. After the 2026-06-19 SDK migration,
the five highest-traffic connectors (github, gitlab, jenkins,
docker, git) all run on official Go SDKs instead of hand-rolled
HTTP or shell-out. The remaining 7 are still on REST (none ship a
canonical Go client upstream).
Connectors in this category¶
| Connector | URI / type | Native SDK | One-line description |
|---|---|---|---|
ansible |
connector://<name>/send |
REST | Ansible Tower / AWX job-template launch. |
argocd |
connector://<name>/send |
REST | Argo CD GitOps application sync + rollout. |
bitbucket |
connector://<name>/send |
REST | Bitbucket Cloud + Server (repos, PRs, pipelines). |
docker-connector |
connector://<name>/send |
✅ docker/docker/client v28 |
Docker Engine API — containers, images, networks, volumes, exec. |
exec |
connector://<name>/send |
stdlib os/exec |
Local process execution. |
git |
connector://<name>/send |
✅ go-git/go-git/v5 |
Pure-Go clone / commit / push / log / branches (no shell-out). |
github |
connector://<name>/send |
✅ google/go-github/v66 |
Issues, PRs, releases, commits, contents, webhooks. |
gitlab |
connector://<name>/send |
✅ gitlab.com/gitlab-org/api/client-go v1.46 |
Projects, pipelines, MRs, branches, issues. |
jenkins |
connector://<name>/send |
✅ bndr/gojenkins v1.2 |
Jobs, builds, build-logs, nodes, queue. |
sonarqube |
connector://<name>/send |
REST | SonarQube quality-gate + project + issues. |
ssh-exec |
connector://<name>/send |
stdlib golang.org/x/crypto/ssh |
SSH remote command execution. |
terraform |
connector://<name>/send |
REST | Terraform Cloud / Enterprise workspace runs + state. |
Deep notes — SDK-backed connectors¶
github://¶
Source: pkg/connector/connectors/devops/github.go · SDK: github.com/google/go-github/v66
Ops (12): list-repos, get-repo, list-issues, create-issue,
list-prs, get-pr, create-pr, list-commits, list-releases,
create-release, get-contents, create-webhook.
connectors:
gh:
type: github
config:
token: ${GITHUB_TOKEN}
owner: your-org
repo: helix
# base_url: https://github.example.com/api/v3/ # for GitHub Enterprise
gitlab://¶
Source: pkg/connector/connectors/devops/gitlab.go · SDK: gitlab.com/gitlab-org/api/client-go (GitLab's own; xanzy/go-gitlab is deprecated and migrated here)
Ops (12): list-projects, get-project, create-project,
list-pipelines, trigger-pipeline, get-pipeline,
list-merge-requests, create-merge-request, list-branches,
create-branch, list-issues, create-issue.
connectors:
gl:
type: gitlab
config:
base_url: https://gitlab.com
token: ${GITLAB_TOKEN}
project: your-group/your-project # or numeric ID
jenkins://¶
Source: pkg/connector/connectors/devops/jenkins.go · SDK: github.com/bndr/gojenkins
Ops (9): list-jobs, get-job, build-job, get-build,
get-build-log, create-job, delete-job, list-nodes,
get-queue-item.
connectors:
j:
type: jenkins
config:
base_url: http://jenkins.example.com
username: ${JENKINS_USER}
password: ${JENKINS_API_TOKEN}
docker-connector://¶
Source: pkg/connector/connectors/devops/docker.go · SDK: github.com/docker/docker/client (Moby v28)
Ops (15): list-containers, create-container, start-container,
stop-container, remove-container, inspect-container,
container-logs, list-images, pull-image, remove-image,
list-networks, list-volumes, ping, info.
git://¶
Source: pkg/connector/connectors/devops/git.go · SDK: github.com/go-git/go-git/v5 (pure-Go, no git CLI required)
Ops (9): clone, pull, commit, push, log, status,
checkout, branches, fetch.
connectors:
g:
type: git
config:
clone_dir: /tmp/helix-git
default_branch: main
# username/password used for HTTPS basic-auth on private repos:
# username: git
# password: ${GITHUB_PAT}
Runnable bundle¶
A complete, validatable bundle that exercises every SDK-backed
connector lives at examples/esb/devops.yaml:
bin/helix validate examples/esb/devops.yaml
# Validation passed: 0 workflow(s), 5 connector(s), 0 starlang block(s)
See also¶
- kubernetes — Kubernetes-native deploy / rollout primitives.
- workflow — Temporal, Camunda Zeebe for long-running workflow engines.