History

Valentin Brandl 5ffb7aff6e Move docker-compose setup		2019-07-27 20:25:00 +02:00
..
src	Make GH auth query static	2019-07-27 17:14:08 +02:00
static	Move everything to backend folder	2019-07-27 16:22:57 +02:00
.dockerignore	Move everything to backend folder	2019-07-27 16:22:57 +02:00
.drone.yml	Move everything to backend folder	2019-07-27 16:22:57 +02:00
.gitignore	Move everything to backend folder	2019-07-27 16:22:57 +02:00
Cargo.lock	Add structopt	2019-07-27 17:13:01 +02:00
Cargo.toml	Add structopt	2019-07-27 17:13:01 +02:00
Dockerfile	Don't strip	2019-07-27 16:44:46 +02:00
README.md	Move everything to backend folder	2019-07-27 16:22:57 +02:00

README.md

Gitache

Gitache is a web service that serves raw files from GitHub, GitLab and Bitbucket with the proper Content-Type headers. Requests to a branch will be redirected to the branches HEAD. Requests to a specific commit will also set long time cache headers, so the service can be put behind a CDN like Cloudflare.

The endpoints follow the pattern /<service>/<user>/<repo>/<gitref>/<file> where <service> is one of github, gitlab or bitbucket, <gitref> is the name of the branch or a commit hash.

Building and Running

The code can be built natively using cargo build --release or as a Docker image using docker build .

The easiest way to run the service is by using docker-compose up -d and exposing port 8080.

API Limits

To get the HEAD of a requested branch, Gitache sends a request to the requested service's API. To prevent running into rate limiting issues with the GitHub API, an OAuth2 App should be created and the client ID and secret can be set via the GITHUB_CLIENT_ID and GITHUB_CLIENT_SECRET environment variables.