{"id":19076141,"url":"https://github.com/acalephstorage/rudder","last_synced_at":"2025-08-21T02:05:00.527Z","repository":{"id":50230239,"uuid":"72007732","full_name":"AcalephStorage/rudder","owner":"AcalephStorage","description":"RESTful API Proxy for Helm","archived":false,"fork":false,"pushed_at":"2019-04-30T14:28:01.000Z","size":827,"stargazers_count":60,"open_issues_count":10,"forks_count":23,"subscribers_count":10,"default_branch":"develop","last_synced_at":"2025-07-31T22:51:45.067Z","etag":null,"topics":["api-server","helm","kubernetes","proxy","restful"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AcalephStorage.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-10-26T13:48:36.000Z","updated_at":"2024-07-23T16:34:07.000Z","dependencies_parsed_at":"2022-08-17T22:40:42.712Z","dependency_job_id":null,"html_url":"https://github.com/AcalephStorage/rudder","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/AcalephStorage/rudder","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AcalephStorage%2Frudder","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AcalephStorage%2Frudder/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AcalephStorage%2Frudder/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AcalephStorage%2Frudder/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AcalephStorage","download_url":"https://codeload.github.com/AcalephStorage/rudder/tar.gz/refs/heads/develop","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AcalephStorage%2Frudder/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":271415496,"owners_count":24755639,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-21T02:00:08.990Z","response_time":74,"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":["api-server","helm","kubernetes","proxy","restful"],"created_at":"2024-11-09T01:57:17.889Z","updated_at":"2025-08-21T02:05:00.509Z","avatar_url":"https://github.com/AcalephStorage.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"Rudder\n------\n\nRESTful API for Helm Repositories and the Tiller service.\n\nRequirements\n------------\n\n-\tTiller v2.0.0\n\nInstallation\n------------\n\n### Binary\n\nBinaries can be downloaded [here](https://github.com/AcalephStorage/rudder/releases).\n\nRunning\n-------\n\nLaunch in Kubernetes:\n\n```\n$ kubectl create -f kube/manifest.yaml\n```\n\nThis will create a Service for Tiller in the `kube-system` namespace, along with the Deployment and Configmap to run Rudder (in the `default` namespace). Customize as needed with Services, Secrets, etc (until the Rudder helm chart is ready)\n\nAlternatively:\n\n```\n$ docker run quay.io/acaleph/rudder\n```\n\nor\n\n```\n$ rudder {{flags}}\n```\n\nConfiguration\n-------------\n\nConfiguration can be provided via cli flags or through environment variables:\n\n| Configuration         | Flag                           | Environment Variable            | Default                              |\n|-----------------------|--------------------------------|---------------------------------|--------------------------------------|\n| Rudder address        | --address                      | RUDDER_ADDRESS                  | 0.0.0.0:5000                         |\n| Tiller address        | --tiller-address               | RUDDER_TILLER_ADDRESS           | localhost:44134                      |\n| Repo File             | --helm-repo-file               | RUDDER_HELM_REPO_FILE           | ~/.helm/repository/repositories.yaml |\n| Cache Directory       | --helm-cache-dir               | RUDDER_HELM_CACHE_DIR           | /opt/rudder/cache                    |\n| Cache Lifetime        | --helm-repo-cache-lifetime     | RUDDER_HELM_REPO_CACHE_LIFETIME | 10m                                  |\n| Swagger UI Path       | --swagger-ui-path              | RUDDER_SWAGGER_UI_PATH          | /opt/rudder/swagger                  |\n| Basic Auth Username   | --basic-auth-username          | RUDDER_BASIC_AUTH_USERNAME      |                                      |\n| Basic Auth Password   | --basic-auth-password          | RUDDER_BASIC_AUTH_PASSWORD      |                                      |\n| OIDC Issuer URL       | --oidc-issuer-url              | RUDDER_OIDC_ISSUER_URL          |                                      |\n| Client ID             | --client-id                    | RUDDER_CLIENT_ID                |                                      |\n| Client Secret         | --client-secret                | RUDDER_CLIENT_SECRET            |                                      |\n| Client Secret Encoded | --client-secret-base64-encoded | RUDDER_CLIENT_BASE64_ENCODED    |                                      |\n| Debug Mode            | --debug                        |                                 |                                      |\n\nAPI\n---\n\nAPI docs is provided via swagger. This is available at: `http://{rudder-url}/swagger`.\n\nUsing the docker image already has this enabled by default. When using the binary, copy the [swagger files](https://github.com/AcalephStorage/rudder/tree/develop/third-party/swagger) to `/opt/rudder/swagger` or a different directory and set `--swagger-ui-path`.\n\nCurrently there are read-only Helm Repository endpoints for fetching charts from repositories and Basic Release endpoints (tiller), `install` and `uninstall`. The rest is still WIP.\n\nNotes\n-----\n\n### Helm Repositories\n\nAt the moment, repositories are provided via a repo file. The format should be the same as what helm uses (`~/.helm/repository/repositories.yaml`). This may change in the future when a repo manager is implemented.\n\n### Charts cache\n\nCharts are downloaded from the helm repository and are cached at the location defined by `--helm-cache-dir` (default: ./opt/rudder/cache). This directory should exist and be writable.\n\n### Authentication\n\nAuthentication can be enabled by providing authentication details.\n\n#### Basic Auth\n\nProviding `--basic-auth-username` and `--basic-auth-password` will enable Basic Authentication.\n\n#### OIDC\n\nProviding `--oidc-issuer-url` or `--client-secret` will enable OIDC.\n\nTODO\n----\n\nThis is still WIP. Some immediate TODOs are:\n\n-\t[ ] implement a repo manager\n-\t[ ] implement missing tiller functions\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Facalephstorage%2Frudder","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Facalephstorage%2Frudder","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Facalephstorage%2Frudder/lists"}