github.com/AcalephStorage/rudder @v0.1.0

rudder

RESTful API for Helm Repositories and the Tiller service.

Requirements

• Tiller v2.0.0

Installation

Binary

Binaries can be downloaded here.

Docker

Docker images are also available:

$ docker pull quay.io/acaleph/rudder

Running

$ rudder {{flags}}

or

$ docker run quay.io/acaleph/rudder

Configuration

Configuration can be provided via cli flags or through environment variables:

API

API docs is provided via swagger. This is available at: http://{rudder-url}/swagger.

Using the docker image already has this enabled by default. When using the binary, copy the swagger files to /opt/rudder/swagger or a different directory and set --swagger-ui-path.

Currently 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.

Notes

Helm Repositories

At 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.

Charts cache

Charts 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.

Authentication

Authentication can be enabled by providing authentication details.

Basic Auth

Providing --basic-auth-username and --basic-auth-password will enable Basic Authentication.

OIDC

Providing --oidc-issuer-url or --client-secret will enable OIDC.

TODO

This is still WIP. Some immediate TODOs are:

• [ ] implement a repo manager
• [ ] implement missing tiller functions