https://docs.gomods.io/intro/index.html Recent content in Introduction to Athens on Athens Hugo -- gohugo.io en Tue, 06 Nov 2018 13:58:58 -0700 https://docs.gomods.io/intro/first-content/index.html Sun, 11 Feb 2018 16:59:56 -0500 https://docs.gomods.io/intro/first-content/index.html What is Athens? Shortly: Athens is a project building on top of vgo (or go1.11+) trying to bring dependencies closer to you so you can count on repeatable builds even at a time when VCS is down. The big goal of Athens is to provide a new place where dependencies — not code — live. Dependencies are immutable blobs of code and associated metadata that come from Github. They live in storage that Athens controls. https://docs.gomods.io/intro/protocol/index.html Sun, 11 Feb 2018 16:58:56 -0500 https://docs.gomods.io/intro/protocol/index.html Athens builds on top of Go CLI which specifies a set of endpoints with which it communicates with external proxies providing modules. This set of endpoints we call Download Protocol The original vgo research paper on Download protocol can be found here: https://research.swtch.com/vgo-module Each of these endpoints sits on top of a module. Let’s assume module htp authored by acidburn. So for each of the endpoints mentioned below we will assume address acidburn/htp/@v/{endpoint} (e. https://docs.gomods.io/intro/why/index.html Tue, 06 Nov 2018 13:58:58 -0700 https://docs.gomods.io/intro/why/index.html Immutability The Go community has had lots of problems with libraries disappearing or changing without warning. It’s easy for package maintainers to make changes to their code that can break yours - and much of the time it’s an accident! Could your build break if one of your dependencies did this? Commit abdef was deleted Tag v0.1.0 was force pushed The repository was deleted altogether Since your app’s dependencies come directly from a VCS (Version Control System, such as GitHub), any of those above cases can happen to you and your builds can break when they do - oh no! https://docs.gomods.io/intro/components/index.html Sun, 11 Feb 2018 16:57:56 -0500 https://docs.gomods.io/intro/components/index.html From a very high-level view, there are 3 major components of the system. Client The client is a user, powered by go binary with module support. At the moment of writing this document, it is Go v1.12+. VCS VCS is an external source of data for Athens. Athens scans various VCSs such as github.com and fetches sources from there. Proxy We intend proxies to be deployed primarily inside of enterprises to: