https://docs.gomods.io/design/index.html Recent content in The Design of Athens on Athens Hugo -- gohugo.io en Sun, 11 Feb 2018 15:59:56 -0500 https://docs.gomods.io/design/proxy/index.html Sun, 11 Feb 2018 15:59:56 -0500 https://docs.gomods.io/design/proxy/index.html The Athens Proxy The Athens proxy has two primary use cases: Internal deployments Public mirror deployments This document details features of the Athens proxy that you can use to achieve either use case. The Role of the Athens proxy We intend proxies to be deployed primarily inside of enterprises to: Host private modules Exclude access to public modules Store public modules Importantly, a proxy is not intended to be a complete mirror of an upstream proxy. https://docs.gomods.io/design/communication/index.html Sun, 11 Feb 2018 15:57:56 -0500 https://docs.gomods.io/design/communication/index.html Communication flow This is the story of a time long ago. A time of myth and legend when the ancient Gods were petty and cruel and they plagued build with irreproducibility. Only one project dared to challenge their power…Athens. Athens possessed a strength the world had never seen. Filling its storage. Clean plate At the beginning, there’s theoretical state when a storage of the Athens proxy is empty. When User makes a request at this ancient time, it works as described on the flow below. https://docs.gomods.io/design/from-vcs2user/index.html Sun, 11 Feb 2018 15:56:56 -0500 https://docs.gomods.io/design/from-vcs2user/index.html You read about proxy, communication and then opened a codebase and thought to yourself: This is not as simple as described in the docs. Athens has a set of architectural components that handle Go modules from their journey from the VCS into storage and down to the user. If you feel lost on how all these pieces work, read on my friend! From communication, you know that when a module is not backed up in the storage it gets downloaded from VCS (such as github.