Skip to content
Permalink
Branch: master
Find file Copy path
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
115 lines (100 sloc) 3.13 KB
project:
name: "Gomods"
state: "beta" # unstable, beta, stable are supported
image: ""
website: "https://gomods.okkur.org"
oneLiner: "Caddy plugin that provides a caching Go modules proxy with your own domain."
description: |
Gomods is a Caddy plugin that provides a caching Go modules proxy with your own domain.
It supports all the hosting services and VCS` that are supported by Go tools. It also provides local caching
and parallel workers to fetch and store Go modules.
version: "v0.1.1"
mainLicense: "Apachev2"
docsLicense: "CCBySa"
vision:
type: ""
overview: |
Provide an easy to use but full featured proxy server for Go modules with Caddy's features.
items:
- "Easy to setup and use"
- "Local caching, which can optionally be backed by mounting persistent volumes"
- "Parallel workers for fetching and storing modules"
concept: "Gomods' core concept is to make setting up a Go modules proxy server easier and faster."
aim: "Gomods accelerates starting a Go modules proxy process with its easy to understand config and features like parallel workers and caching"
readme:
usageExample: |
Gomods uses Go tools in the background for fetching the modules so there needs to be an installed version of Go on your machine.
For installing Gomods run the following command:
```
go get go.okkur.org/gomods/cmd/gomods
```
Then you should create a config file like this example:
```
gomods.test {
gomods
}
```
The example above uses the default values for Go binary and number of parallel workers.
To customize these values add these fields to your config file:
```
gomods.test {
gomods {
gobinary /usr/bin/go
workers 2
}
}
```
To enable caching you should also add the `cache` field to the config:
```
gomods.test {
gomods {
cache
}
}
```
Just like `gomods` itself, cache also uses its default values when not provided.
You can specify fields like `type` and `path` to customize caching:
```
gomods.test {
gomods {
cache {
type local
path /home/user/gomods_cache
}
}
}
```
To run Gomods use the following command:
```
$ gomods -conf PATH_TO_CONFIG
```
contributionLinks:
issueTemplate: "/.github/ISSUE_TEMPLATE.md"
starterIssues: "https://github.com/okkur/gomods/labels/starter%20issue"
emails:
commercialSupport: "support@okkur.org"
security: "security@okkur.org"
coc: "coc@okkur.org"
copyright:
owner: "The Gomods authors"
year: "2019"
cla:
copyrightHolder: "nzt.ventures GmbH"
mail: "legal@nzt.ventures"
maintainers:
- name: "Michael Grosser"
nick: "stp-ip"
repo:
link: "https://gomods.okkur.org/repo"
type: "Github"
badges:
- image: "https://img.shields.io/badge/state-beta-blue.svg"
alt: "state"
- image: "https://img.shields.io/github/release/okkur/gomods.svg"
link: "https://gomods.okkur.org/releases"
alt: "release"
- image: "https://img.shields.io/github/license/okkur/gomods.svg"
link: "LICENSE"
alt: "license"
reposeed:
configVersion: "v1"
You can’t perform that action at this time.