{"id":49045229,"url":"https://github.com/fosrl/pangolin-kube-controller","last_synced_at":"2026-04-19T16:05:14.271Z","repository":{"id":351085845,"uuid":"1054401056","full_name":"fosrl/pangolin-kube-controller","owner":"fosrl","description":null,"archived":false,"fork":false,"pushed_at":"2026-04-13T11:34:32.000Z","size":402,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-13T15:40:34.573Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fosrl.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":".github/SECURITY.md","support":".github/SUPPORT.md","governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":"MAINTAINERS.md","copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2025-09-10T19:26:59.000Z","updated_at":"2026-04-13T11:38:20.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/fosrl/pangolin-kube-controller","commit_stats":null,"previous_names":["fosrl/pangolin-kube-controller"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/fosrl/pangolin-kube-controller","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fosrl%2Fpangolin-kube-controller","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fosrl%2Fpangolin-kube-controller/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fosrl%2Fpangolin-kube-controller/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fosrl%2Fpangolin-kube-controller/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fosrl","download_url":"https://codeload.github.com/fosrl/pangolin-kube-controller/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fosrl%2Fpangolin-kube-controller/sbom","scorecard":{"id":1245986,"data":{"date":"2026-04-07T14:18:12Z","repo":{"name":"github.com/fosrl/pangolin-kube-controller","commit":"ea2c1181896ffbebf5b1b355c0f7c01d0ecd03e1"},"scorecard":{"version":"v5.3.0","commit":"c22063e786c11f9dd714d777a687ff7c4599b600"},"score":7.1,"checks":[{"name":"CI-Tests","score":-1,"reason":"no pull request found","details":null,"documentation":{"short":"Determines if the project runs tests before pull requests are merged.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#ci-tests"}},{"name":"Maintained","score":2,"reason":"3 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 2","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#maintained"}},{"name":"Dangerous-Workflow","score":10,"reason":"no dangerous workflow patterns detected","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#dangerous-workflow"}},{"name":"Dependency-Update-Tool","score":10,"reason":"update tool detected","details":["Info: detected update tool: RenovateBot: .github/renovate.json:1"],"documentation":{"short":"Determines if the project uses a dependency update tool.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#dependency-update-tool"}},{"name":"Code-Review","score":0,"reason":"Found 0/3 approved changesets -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#code-review"}},{"name":"Security-Policy","score":10,"reason":"security policy file detected","details":["Info: security policy file detected: .github/SECURITY.md:1","Info: Found linked content: .github/SECURITY.md:1","Info: Found disclosure, vulnerability, and/or timelines in security policy: .github/SECURITY.md:1","Info: Found text in security policy: .github/SECURITY.md:1"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#security-policy"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#binary-artifacts"}},{"name":"SAST","score":10,"reason":"SAST tool detected","details":["Info: SAST configuration detected: CodeQL","Info: SAST configuration detected: Hadolint","Warn: no pull requests merged into dev branch"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#sast"}},{"name":"Pinned-Dependencies","score":10,"reason":"all dependencies are pinned","details":["Info:  42 out of  42 GitHub-owned GitHubAction dependencies pinned","Info:  32 out of  32 third-party GitHubAction dependencies pinned","Info:   3 out of   3 containerImage dependencies pinned","Info:   3 out of   3 goCommand dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#pinned-dependencies"}},{"name":"Token-Permissions","score":9,"reason":"detected GitHub workflow tokens with excessive permissions","details":["Warn: jobLevel 'contents' permission set to 'write': .github/workflows/build-publish.yml:43","Warn: jobLevel 'packages' permission set to 'write': .github/workflows/build-publish.yml:44","Info: jobLevel 'contents' permission set to 'read': .github/workflows/ci.yml:24","Info: jobLevel 'pull-requests' permission set to 'read': .github/workflows/ci.yml:25","Warn: jobLevel 'checks' permission set to 'write': .github/workflows/ci.yml:26","Info: jobLevel 'contents' permission set to 'read': .github/workflows/ci.yml:161","Info: jobLevel 'pull-requests' permission set to 'read': .github/workflows/ci.yml:162","Info: jobLevel 'actions' permission set to 'read': .github/workflows/ci.yml:283","Info: jobLevel 'contents' permission set to 'read': .github/workflows/ci.yml:284","Info: jobLevel 'contents' permission set to 'read': .github/workflows/codeql.yml:32","Info: jobLevel 'actions' permission set to 'read': .github/workflows/codeql.yml:33","Info: jobLevel 'contents' permission set to 'read': .github/workflows/continuous-security.yml:21","Info: jobLevel 'actions' permission set to 'read': .github/workflows/continuous-security.yml:22","Info: jobLevel 'contents' permission set to 'read': .github/workflows/opencode.yml:22","Info: jobLevel 'pull-requests' permission set to 'read': .github/workflows/opencode.yml:23","Info: jobLevel 'issues' permission set to 'read': .github/workflows/opencode.yml:24","Warn: jobLevel 'contents' permission set to 'write': .github/workflows/release.yml:61","Warn: jobLevel 'security-events' permission set to 'write': .github/workflows/release.yml:118","Warn: jobLevel 'contents' permission set to 'write': .github/workflows/release.yml:115","Warn: jobLevel 'packages' permission set to 'write': .github/workflows/release.yml:116","Warn: jobLevel 'contents' permission set to 'write': .github/workflows/release.yml:134","Warn: jobLevel 'packages' permission set to 'write': .github/workflows/release.yml:135","Warn: jobLevel 'security-events' permission set to 'write': .github/workflows/release.yml:137","Warn: jobLevel 'security-events' permission set to 'write': .github/workflows/release.yml:154","Warn: jobLevel 'contents' permission set to 'write': .github/workflows/release.yml:151","Warn: jobLevel 'packages' permission set to 'write': .github/workflows/release.yml:152","Info: jobLevel 'contents' permission set to 'read': .github/workflows/renovate-validate.yml:15","Info: jobLevel 'checks' permission set to 'read': .github/workflows/scorecard.yml:30","Info: jobLevel 'actions' permission set to 'read': .github/workflows/scorecard.yml:31","Info: jobLevel 'statuses' permission set to 'read': .github/workflows/scorecard.yml:32","Info: jobLevel 'contents' permission set to 'read': .github/workflows/scorecard.yml:27","Info: jobLevel 'issues' permission set to 'read': .github/workflows/scorecard.yml:28","Info: jobLevel 'pull-requests' permission set to 'read': .github/workflows/scorecard.yml:29","Info: topLevel 'contents' permission set to 'read': .github/workflows/build-publish.yml:36","Info: topLevel 'contents' permission set to 'read': .github/workflows/ci.yml:12","Info: topLevel 'pull-requests' permission set to 'read': .github/workflows/ci.yml:13","Info: topLevel 'contents' permission set to 'read': .github/workflows/codeql.yml:12","Info: topLevel 'contents' permission set to 'read': .github/workflows/commitlint.yml:4","Info: topLevel 'contents' permission set to 'read': .github/workflows/continuous-security.yml:9","Info: topLevel 'contents' permission set to 'read': .github/workflows/deepsource-coverage.yml:14","Info: topLevel 'pull-requests' permission set to 'read': .github/workflows/deepsource-coverage.yml:15","Info: topLevel 'contents' permission set to 'read': .github/workflows/deploy-dev.yml:13","Info: topLevel 'contents' permission set to 'read': .github/workflows/deprecation-check.yml:14","Info: topLevel 'contents' permission set to 'read': .github/workflows/labels-sync.yml:13","Warn: no topLevel permission defined: .github/workflows/opencode.yml:1","Info: topLevel 'pull-requests' permission set to 'read': .github/workflows/pr-metadata.yml:13","Info: topLevel 'contents' permission set to 'read': .github/workflows/release.yml:50","Info: topLevel 'contents' permission set to 'read': .github/workflows/renovate-validate.yml:10","Info: topLevel 'contents' permission set to 'read': .github/workflows/scorecard.yml:11"],"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#token-permissions"}},{"name":"CII-Best-Practices","score":2,"reason":"badge detected: InProgress","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#cii-best-practices"}},{"name":"Vulnerabilities","score":10,"reason":"0 existing vulnerabilities detected","details":null,"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#vulnerabilities"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'main'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#branch-protection"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#signed-releases"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: GNU Affero General Public License v3.0: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#license"}},{"name":"Fuzzing","score":10,"reason":"project is fuzzed","details":["Info: GoBuiltInFuzzer integration found: internal/transform/sanitize/sanitize_test.go:262"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#fuzzing"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#packaging"}},{"name":"Contributors","score":0,"reason":"project has 0 contributing companies or organizations -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project has a set of contributors from multiple organizations (e.g., companies).","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#contributors"}}]},"last_synced_at":"2026-04-13T15:42:10.649Z","repository_id":351085845,"created_at":"2026-04-13T15:42:10.649Z","updated_at":"2026-04-13T15:42:10.649Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32012797,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-18T20:23:30.271Z","status":"online","status_checked_at":"2026-04-19T02:00:07.110Z","response_time":55,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-04-19T16:05:13.431Z","updated_at":"2026-04-19T16:05:14.263Z","avatar_url":"https://github.com/fosrl.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Pangolin Kubernetes Controller\n\n[![CI](https://github.com/fosrl/pangolin-kube-controller/actions/workflows/ci.yml/badge.svg)](https://github.com/fosrl/pangolin-kube-controller/actions/workflows/ci.yml)\n[![Security Scans](https://github.com/fosrl/pangolin-kube-controller/actions/workflows/continuous-security.yml/badge.svg)](https://github.com/fosrl/pangolin-kube-controller/actions/workflows/continuous-security.yml)\n[![OpenSSF Scorecard](https://api.securityscorecards.dev/projects/github.com/fosrl/pangolin-kube-controller/badge)](https://securityscorecards.dev/viewer/?uri=github.com/fosrl/pangolin-kube-controller)\n[![OpenSSF Best Practices](https://www.bestpractices.dev/projects/11206/badge)](https://www.bestpractices.dev/projects/11206)\n[![Go Report Card](https://goreportcard.com/badge/github.com/fosrl/pangolin-kube-controller)](https://goreportcard.com/report/github.com/fosrl/pangolin-kube-controller)\n[![GitHub release (latest SemVer)](https://img.shields.io/github/v/release/fosrl/pangolin-kube-controller?logo=github\u0026sort=semver)](https://github.com/fosrl/pangolin-kube-controller/releases/latest)\n![GitHub go.mod Go version](https://img.shields.io/github/go-mod/go-version/fosrl/pangolin-kube-controller?logo=go)\n[![Artifact Hub](https://img.shields.io/endpoint?url=https://artifacthub.io/badge/repository/fosrl)](https://artifacthub.io/packages/search?org=fosrl)\n[![Docker Pulls](https://img.shields.io/docker/pulls/fosrl/pangolin-kube-controller?logo=docker\u0026logoColor=white)](https://hub.docker.com/r/fosrl/pangolin-kube-controller)\n![Docker Image Size (latest semver)](https://img.shields.io/docker/image-size/fosrl/pangolin-kube-controller?logo=docker\u0026logoColor=white\u0026sort=semver)\n[![Project Status: Active](https://www.repostatus.org/badges/latest/active.svg)](https://www.repostatus.org/#active)\n\n## Overview\n\nThe Pangolin Kubernetes Controller synchronizes Traefik dynamic configuration from [Pangolin](https://github.com/fosrl/pangolin) into Kubernetes native resources. It polls Pangolin for the desired state, performs safe updates using Server-Side-Apply, and exposes operational metrics for observability.\n\nPart of the [Pangolin](https://github.com/fosrl/pangolin) ecosystem - an open-source, identity-aware VPN and proxy platform.\n\n## Architecture\n\n```mermaid\nflowchart TB\n    subgraph \"Pangolin\"\n        P[(\"Pangolin API\u003cbr/\u003e:3001\")]\n    end\n\n    subgraph \"Kubernetes Cluster\"\n        K[(\"Kubernetes API\")]\n        CRDs[(\"Traefik CRDs\u003cbr/\u003eIngressRoute, Middleware,\u003cbr/\u003eTraefikService, etc.\")]\n        Lease[(\"Lease Lock\u003cbr/\u003e(Leader Election)\")]\n    end\n\n    subgraph \"pangolin-kube-controller\"\n        Fetch[(\"Fetch Config\")]\n        Transform[(\"Transform\")]\n        Apply[(\"Server-Side-Apply\")]\n        GC[(\"Garbage Collection\")]\n        Metrics[(\"/metrics\")]\n    end\n\n    P --\u003e Fetch\n    Fetch --\u003e Transform\n    Transform --\u003e Apply\n    Apply --\u003e K\n    Apply --\u003e GC\n    GC -.-\u003e K\n    Metrics -.-\u003e K\n```\n\n## Features\n\n- **Server-Side-Apply**: Safe, collaborative resource updates using Kubernetes Server-Side-Apply\n- **Leader Election**: High-availability deployments with Kubernetes Lease-based leader election\n- **Garbage Collection**: Automatic cleanup of orphaned Traefik resources\n- **TLS/mTLS Support**: Secure communication with Pangolin API including certificate-based auth\n- **Observability**: Prometheus metrics and OpenTelemetry support for monitoring\n- **Health Probes**: Liveness and readiness endpoints for Kubernetes integration\n- **Read-Only Mode**: Optional non-mutating mode for validation and inspection\n\n## Prerequisites\n\n- Kubernetes cluster 1.29+\n- A running [Pangolin](https://github.com/fosrl/pangolin) instance\n- Helm 3.x (for installation) or Kustomize\n\n## Installation\n\n### Helm (Recommended)\n\n```bash\n# Add Fossorial Helm repository\nhelm repo add fossorial https://charts.fossorial.io\nhelm repo update fossorial\n\n# Install the controller\nhelm install pangolin fossorial/pangolin\n```\n\nFor configuration options, see the [controller documentation](docs/controller/controller.md).\n\n### Container Images\n\nPre-built images are available:\n\n- Docker Hub: [`fosrl/pangolin-kube-controller`](https://hub.docker.com/r/fosrl/pangolin-kube-controller)\n- GitHub Container Registry: [`ghcr.io/fosrl/pangolin-kube-controller`](https://github.com/fosrl/pangolin-kube-controller/pkgs/container/pangolin-kube-controller)\n\n## Configuration\n\nConfiguration is provided via environment variables:\n\n| Flag / Environment Variable | Default | Description |\n| --- | --- | --- |\n| `METRICS_ADDR` | `:9090` | Address for the health/metrics server |\n| `CONFIG_ENDPOINT` | `https://pangolin:3001/api/v1/traefik-config` | Pangolin API endpoint |\n| `TARGET_NAMESPACE` | `pangolin` | Namespace where Traefik resources live |\n| `ENABLE_LEADER_ELECTION` | `false` | Enable Kubernetes Lease-based leader election |\n| `LEASE_LOCK_NAMESPACE` | `$TARGET_NAMESPACE` | Namespace for the leader election Lease |\n| `READ_ONLY` | `false` | Disable mutating operations when set |\n| `LOG_TRAEFIK_CONFIG` | `false` | DEBUG ONLY. Do not enable in production |\n| `CONFIG_TLS_SKIP_VERIFY` | `false` | SECURITY: disable TLS verification for Pangolin fetch |\n\nSee [controller documentation](docs/controller/controller.md) for a complete configuration reference.\n\n## Metrics \u0026 Probes\n\n### Health Endpoints\n\n- `GET /healthz` – returns `200 OK` when the process is running\n- `GET /readyz` – returns `200 OK` when the controller is connected to Kubernetes and holds the leader lease (if enabled)\n- `GET /metrics` – Prometheus metrics endpoint\n\n### Prometheus Metrics\n\n- `pangolin_controller_reconcile_seconds` – duration of full reconcile loops\n- `pangolin_controller_reconcile_errors_total` – count of reconcile errors\n- `pangolin_controller_objects_applied_total` – objects applied by kind and action\n- `pangolin_controller_objects_deleted_total` – objects deleted by kind\n- `pangolin_controller_ready` – readiness state (1 ready, 0 not ready)\n- `pangolin_controller_last_fetch_success_timestamp_seconds` – timestamp of the last successful fetch\n\n## Documentation\n\n- [Controller Documentation](docs/controller/controller.md) – Architecture, configuration, and reconciliation flow\n- [Pangolin Docs](https://docs.pangolin.net/) – Full Pangolin platform documentation\n\n## Contributing\n\nContributions are welcome! See [CONTRIBUTING](CONTRIBUTING.md) for workflow and branch protection information.\n\n### Development Setup\n\n```bash\n# Install dependencies\ngo mod download\n\n# Run validation (lint, fmt, vet, test)\ntask ci\n\n# Build the controller\ntask build\n```\n\nFor architectural overview and reconciliation flow diagrams, see [controller documentation](docs/controller/controller.md).\n\n## Community\n\nFor support, discussions, and contributions to the broader Pangolin ecosystem:\n\n- [Pangolin GitHub](https://github.com/fosrl/pangolin) – Main Pangolin project\n- [Pangolin Discord](https://discord.gg/HCJR8Xhme4) – Community chat\n- [Pangolin Slack](https://pangolin.net/slack) – Alternative community channel\n\n## Security\n\nFor security issues, please review our [SECURITY](SECURITY.md) policy.\n\n## License\n\n[License](LICENSE) – See project license for terms.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffosrl%2Fpangolin-kube-controller","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffosrl%2Fpangolin-kube-controller","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffosrl%2Fpangolin-kube-controller/lists"}