Athens Proxy Helm Chart

What is Athens?

Athens is a repository for packages used by your go packages.

Athens provides a repository for Go Modules that you can run. It serves public code and your private code for you, so you don't have to pull directly from a version control system (VCS) like GitHub or GitLab.

Prerequisites

• Kubernetes 1.10+

Requirements

• A running Kubernetes cluster
• Kubectl installed and setup to use the cluster
• Helm installed and setup to use the cluster (helm init) or Tillerless Helm

Deploy Athens

The fastest way to install Athens using Helm is to deploy it from our public Helm chart repository. First, add the repository with this command:

$ helm repo add gomods https://athens.blob.core.windows.net/charts
$ helm repo update

Next, install the chart with default values to athens namespace:

$ helm install gomods/athens-proxy -n athens --namespace athens

This will deploy a single Athens instance in the athens namespace with disk storage enabled. Additionally, a ClusterIP service will be created.

Advanced Configuration

For more advanced configuration options please check Athens docs.

Available options:

• Replicas
• Access to private repositories via Github
• Storage Providers
• Kubernetes Service
• Ingress Resource
• Upstream module repository
• .netrc file support

Pass extra configuration environment variables

You can pass any extra environment variables supported in config.dev.toml. The example below shows how to set username/password for basic auth:

configEnvVars:
  - name: BASIC_AUTH_USER
    value: "some_user"
  - name: BASIC_AUTH_PASS
    value: "some_password"

Private git servers over ssh support

One or more of git servers can added to sshGitServers, and the corresponding config files (git config and ssh config) and ssh keys will be created. Athens then will use these configs and keys to download the source from the git servers.

sshGitServers: 
  ## Private git servers over ssh
  ## to enable uncomment lines with single hash below
  ## hostname of the git server
  - host: git.example.com
    ## ssh username
    user: git
    ## ssh private key for the user
    privateKey: |
      -----BEGIN RSA PRIVATE KEY-----
      ...
      -----END RSA PRIVATE KEY-----
    ## ssh port
    port: 22