https://docs.gomods.io/install/index.html Recent content in Installing Athens on Athens Hugo -- gohugo.io en Sat, 27 Mar 2021 21:53:51 -0700 https://docs.gomods.io/install/build-from-source/index.html Mon, 01 Jan 0001 00:00:00 +0000 https://docs.gomods.io/install/build-from-source/index.html You can do that easily with just few commands: Bash git clone https://github.com/gomods/athens cd athens make build-ver VERSION="0.2.0"PowerShell git clone https://github.com/gomods/athens cd athens $env:GO111MODULE="on" $env:GOPROXY="https://proxy.golang.org" $version = "0.2.0" $date = (Get-Date).ToUniversalTime() go build -ldflags "-X github.com/gomods/athens/pkg/build.version=$version -X github.com/gomods/athens/pkg/build.buildDate=$date" -o athens ./cmd/proxyThis will give you a binary named athens. You can print the version and time information by running: ./athens -version which should return something like: Build Details: Version: 0.2.0 Date: 2018-12-13-20:51:06-UTC https://docs.gomods.io/install/install-on-kubernetes/index.html Mon, 01 Jan 0001 00:00:00 +0000 https://docs.gomods.io/install/install-on-kubernetes/index.html When you follow the instructions in the Walkthrough, you end up with an Athens Proxy that uses in-memory storage. This is only suitable for trying out the Athens proxy for a short period of time, as you will quickly run out of memory and Athens won’t persist modules between restarts. In order to run a more production-like proxy, you may want to run Athens on a Kubernetes cluster. To aid in deployment of the Athens proxy on Kubernetes, a Helm chart has been provided. https://docs.gomods.io/install/using-docker/index.html Mon, 01 Jan 0001 00:00:00 +0000 https://docs.gomods.io/install/using-docker/index.html Whether setting Athens up using Kubernetes or using the Walkthrough, you’ll most likely be using one of the images that the Athens project produces. This document details what images are available, and has a recap from the Walkthrough of how to use them on their own. Available Docker images The Athens project produces two docker images, available via Docker Hub A release version as gomods/athens, each tag corresponds with an Athens release, e. https://docs.gomods.io/install/shared-team-instance/index.html Mon, 01 Jan 0001 00:00:00 +0000 https://docs.gomods.io/install/shared-team-instance/index.html When you follow the instructions in the Walkthrough, you end up with an Athens Proxy that uses in-memory storage. This is only suitable for trying out the Athens proxy for a short period of time, as you will quickly run out of memory and Athens won’t persist modules between restarts. This guide will help you get Athens running in a more suitable manner for scenarios like providing an instance for your development team to share. https://docs.gomods.io/install/install-on-aws-ecs-fargate/index.html Sat, 27 Mar 2021 21:53:51 -0700 https://docs.gomods.io/install/install-on-aws-ecs-fargate/index.html In this document, we’ll show how to use AWS Fargate (ECS) to run the Athens proxy. Selecting a Storage Provider There is documentation about how to use environment variables to configure the various storage providers. However, for this particular example we will use Amazon S3 Storage (s3). Before You Begin This guide assumes you already have an AWS account as well as the necessary authentication and permissions to create resources in the account. https://docs.gomods.io/install/install-on-aci/index.html Thu, 06 Dec 2018 13:17:37 -0800 https://docs.gomods.io/install/install-on-aci/index.html When you follow the instructions in the Walkthrough, you end up with an Athens Proxy that uses in-memory storage. This is only suitable for trying out the Athens proxy for a short period of time, as you will quickly run out of memory and Athens won’t persist modules between restarts. This guide will help you get Athens running in a more suitable manner for scenarios like providing an instance for your development team to share. https://docs.gomods.io/install/install-on-google-cloud-run/index.html Thu, 10 Oct 2019 18:16:43 +1100 https://docs.gomods.io/install/install-on-google-cloud-run/index.html Google Cloud Run is a service that aims to bridge the gap between the maintainance benefits of serverless architecture and the flexibility of Kubernetes. It is built on top of the opensource Knative project. Deploying using Cloud Run is similar to deploying using Google App Engine with the benefits of a free tier and a simpler build process. Selecting a Storage Provider There is documentaion about how to use environment variables to configure a large number of storage providers; however, for this prarticular example we will use Google Cloud Storage(GCS) because it fits nicely with Cloud Run. https://docs.gomods.io/install/install-on-gae/index.html Fri, 27 Sep 2019 17:48:40 +1000 https://docs.gomods.io/install/install-on-gae/index.html Google App Engine (GAE) is a Google service allows applications to be deployed without provisioning the underlying hardware. It is similar to Azure Container Engine which is covered in a previous section. This guide will demonstrate how you can get Athens running on GAE. Selecting a Storage Provider There is documentaion about how to use environment variables to configure a large number of storage providers; however, for this prarticular example we will use Google Cloud Storage(GCS) because it fits nicely with Cloud Run. https://docs.gomods.io/install/install-on-bosh/index.html Mon, 01 Jan 0001 00:00:00 +0000 https://docs.gomods.io/install/install-on-bosh/index.html Athens can be deployed in many ways. The following guide explains how to use BOSH, a deployment and lifecycle tool, in order to deploy an Athens server on virtual machines (VMs) on any infrastructure as a service (IaaS) that is supported by BOSH. Prerequisites Install BOSH Setup the infrastructure Install BOSH Make sure to have the BOSH CLI installed and set up a BOSH Director on an infrastructure of your choice. https://docs.gomods.io/install/managing-private-repos/index.html Mon, 01 Jan 0001 00:00:00 +0000 https://docs.gomods.io/install/managing-private-repos/index.html Authenticate private repositories via .netrc Create a .netrc file that looks like the following: machine <ip or fqdn> login <username> password <user password> Tell Athens through an environment variable the location of that file ATHENS_NETRC_PATH=<location/to/.netrc> Athens will copy the file into the home directory and override whatever .netrc file is in home directory. Alternatively, if the host of the Athens server already has a .netrc file in the home directory, then authentication should work out of the box.