src/chart-repo-handler/README.md

   1 # Chart Repo Handler - a swift http frontend for helm
   2 This project aims to let unmodified http clients to access Openstack Swift object store.
   3 Furthermore it acts as a helm chart repo with storage capabilities.
   4
   5 ## Motivation
   6 The motivation is that usually object stores (like S3) has API for static HTTP content hosting for standard HTTP clients (like web browsers). As Swift uses custom HTTP headers for authentication, it is not working OOTB.
   7 This swift behavior makes impossible to use swift directly with helm so this project is a middle layer between them.
   8
   9 ## Usage
  10 The frontend is configured through environment variables. These are the credentials for the object store and the targeted container in it.
  11 To enable TLS for Swift backend, use https in AUTHURL and set the location of RootCA pem file in the TLSCAPATH variable.
  12 See env.sh for a sample.
  13
  14
  15 ## Details
  16 * Written in go, targeted to be a 12 factor app
  17 * Uses ncw/swift as the most mature client API towards the Swift object store
  18 * Uses gorilla/mux to decode HTTP requests
  19 * Borrows some of the helm packages to maintain index.yaml file for the charts
  20
  21
  22 This work is licensed under a Creative Commons Attribution 4.0 International License.