v0.7.1

👋 Waves to everybody 👋

This release makes pattern matching in the Download File behave the same way as GOPROXY and friends. In other words, you can set a path to *.my_company/go/* to match both a sub domain and a path suffix. For more info see #1408

The GO_ENV=production line was removed from the Dockerfile, this was done because the Env Var always overrode whatever the user has put in the Config TOML file.

If you were relying on the Dockerfile having this set automatically, you must now explicitly pass it either through an Env Var or through the Config TOML file.

There was also a lot of documentation updates since the last release and if you see there's anything missing, don't hesitate to open an issue!

As always, THANK YOU to all of the users and contributors. Athens is purely developed and maintained by the Go community so give it up to yourselves 👏

v0.7.0

Hi Athenians!

This release brings 🤞more stability 🤞 to Athens through documentation and bug fixes.

Most notably, the DownloadFile will follow the same exact rules as our NoSumPatterns config which follows the same exact rules for GONOSUMDB and friends: matches will be based on path.Match based on path prefixes.

In other words, having NoSumPatterns=["github.com/org/*"] will match all repositories, sub-packages, and sub-modules such as "github.com/org/repo" and "github.com/org/repo/v2". This is especially important if you run a vanity import server so you can match the whole organization such as NoSumPatterns=mycompany.org

For more info see here

For a list of what has changed since the last release, check out v0.6.1...v0.7.0

As always, thank you to all of the contributors and the users that have reported issues and kept us on our toes to bring fixes and better documentation.

Athens is fully built and maintained by the open source and seeing individuals as well as companies large and small use it is a huge reward for all of us. Speaking of which, if you use Athens feel free to drop a note here: #1323

Thank you!

Fix Sum DB Errors

Hi Athenians,
The v0.6.0 had an important bug (#1390) where all private modules that were not already in storage failed to be downloaded.

This release fixes that bug. Please give it a try and let us know!

On a similar note, if you have private import paths make sure you tell Athens that through the NoSumPatterns config. Otherwise, go mod download will fail!

Furthermore, you can now pass any GO* environment variable to go mod download that Athens runs through the GoBinaryEnvVars config such as GOPROXY and GOPRIVATE

For more, see our example config file here: https://github.com/gomods/athens/blob/master/config.dev.toml

v0.6.0

Hi Athenians!

This release brings better compatibility with the newly released Go 1.13 ✌️

Athens now uses Go 1.13 under the hood to list/download Go Modules. Furthermore, you can specify the GOPROXY option from within Athens when a module is not found in storage.

Athens now also returns 404 on all list/download errors so that comma-separated GOPROXY clients can function correctly.

For all of the changes between v0.5.0 and v0.6.0 please take a look at: v0.5.0...v0.6.0

As always, a huge THANK YOU to everyone who used, contributed to, and improved on Athens and its community :)

Peace,

v0.5.0

Hi Athenians!

This release includes an exciting new feature as well as fixes and enhancements to our helm charts. All changes since v0.4.0 can be found here

The biggest part of this release is the addition of the Download Mode and a greatly improved download and filter configuration file. You can now choose from 5 different modes to configure how Athens should treat any module or module glob when that module is missing from local storage. And there are new features hidden inside these modes! For example, Athens can now download modules from upstream code hosts synchronously or asynchronously 🎉.

The new download modes features unlock Go 1.13's new feature of allowing comma-separted URLs in the GOPROXY variable.

For more information on the Download Mode see: https://docs.gomods.io/configuration/download/

As always, THANK YOU to the community members who put their own free time and love into this. We couldn't have done this without you!

If you'd like to contribute or have any questions, reach out to us on the #athens channel at https://gophers.slack.com.

If you find any bugs or difficulties, don't hesitate to open an issue on this repository!

Enjoy!

v0.4.0

Hi Athenians!

This release includes new features, patches, and better documentation. All changes since v0.3.1 can be found here

BUT our favorite part of this release is the fact that incredibly awesome people have added translations to some of our docs! Check them out here and here

Here are some more highlights for what v0.4.0 brings:

1. Added Datadog as one of the supported metrics backends 🐶
2. Many fixes and enhancements to our Helm charts 💯
3. Added the ability to proxy a Checksum DB URL, more here
4. Wrapped our Dockerfile with tini so that zombie processes are properly removed.
5. Added both GCS and Azure Blobs as a distributed lock mechanism so that concurrent persistence is synchronized.

As always, THANK YOU to the community members who put their own free time and love into this. We couldn't have done this without you!

If you'd like to contribute or have any questions, reach out to us on the #athens channel at https://gophers.slack.com.

If you find any bugs or difficulties, don't hesitate to open an issue on this repository!

Enjoy!

v0.3.1

Minio Memory Fix

This is a patch release for those who use Minio as their backend storage. Otherwise, feel free to continue using v0.3.0.

The minio-go client allocates ~700Mb of memory when the size of the blob is unknown. This is by design according to this issue and therefore this patch makes it so that we segment the stream into 8Mb sections and upload them to Minio during a module save operation.

This will avoid bloating the heap and so Athens running on smaller containers should work much better.

Thanks again and please give this a try and report back any issues!

Medusa

v0.3.0 A.K.A Medusa ✌️ 🎉

This release brings us a lot closer to a stable and mature Go Proxy.

About 104 pull requests were poured in since last release (with nothing but love and probably some hard work).

So, a gigantic THANK YOU to all of the users, contributors, and maintainers that helped make Athens a positive open source project.

Cool Stuff You Can Now do With Go Modules and Athens

Strap in, there's a lot of new stuff here since v0.2.0!!!

1. You can now run Athens in the background for your day to day workflow. Like literally on your local development machine or on a VM in the cloud. Not just in CI/CD.

2. You can run go get (and friends) outside of a module context thanks to go 1.12, and Athens can support this seamlessly. Here's an example that illustrates what we're talking about:

   $ cd ~
   $ export GO111MODULE=on
   $ export GOPROXY=http://localhost:3000
   $ go install github.com/gomods/athens/cmd/proxy

   These commands will use Athens to install an Athens binary to your $GOPATH/bin directory.

3. You can run dynamic versions such as go get github.com/pkg/errors@master where @master gets translated into the latest version in that module's repository. Athens will then store that pseudo version. In other words, you can do @master and Athens will figure it out, and things will "just work". Oh, and you can also do the same thing for dynamic versions like latest and for full commit SHAs.

4. For most storage drivers, we added a /catalog endpoint that can list the modules in your storage. This endpoint is a handy way to build a simple dashboard on top of Athens.

   Want to build one of these into Athens? Come talk to us!

5. You can now opt-in to an experimental "distributed single flight" mechanism that lets you run multiple Athens instances at once, and be sure that storage persistence is done without conflict. In other words, you can run a cluster of Athens servers now!

6. You now don't need a config.toml file to run Athens. We have the defaults equally hard-coded so that new-comers don't have to worry about setting up configuration at all. For example, if you download a new Athens binary, you can just run it anywhere on your laptop with no fuss.

7. You can now filter modules by versions and not just module paths. We'll add more docs on this shortly after the release. And look for more power in the filtering syntax soon.

Breaking Change In Go Upstream

As you might know, Go 1.11.4 introduced a breaking change that broke checksum calculations. If you've been using Athens v0.2.0 and are about to upgrade to v0.3.0, you might get a "checksum mismatch" error. Here's how to fix it:

1. Locate the module path that had the checksum mismatch .
2. Delete the two lines from go.sum so that Go can recalculate the checksums for you later.
3. Delete the module@version from your Athens Storage Backend (so Go can recalculate the checksum)

To Inifinity! And Beyonnnnd!

Go Modules is still in its experimental phase but it's getting closer to being "on" by default. Until then, things might change and break in ways you don't expect (like the checksum change above!)

We're happy with the stability of Athens (some of us run Athens as a part of our regular builds!), but as always, please proceed with caution while modules is still experimental.

One More Thing

Yup, we had to quote the Apple keynotes.

As usual, we want to especially call out the amazing community behind Athens. If you have used Athens, contributed, commented on an issue, talked to us, or anything else, you're part of our community. You are an Athenian! And we can't thank you enough for being with us.

We're excited for the awesomeness to come.

Here's to the future, Athenians and Gophers.

Keep on rockin'

❤️

BETA

First Beta Release 🎉 🚀 😃

This marks our first Beta release of the Athens proxy server!

About 173 Pull Requests got merged since our last version and we cannot give enough credit and thanks to all of those who helped get Athens to where it is today.

Here's what this release means for you:

• We have tested this proxy within our own teams of contributors and maintainers, and we are confident to call it a beta. In other words, we feel this is beta quality software and that it's ready for you to use as beta on your teams
• We are ready and eager to hear your feedback if you have it
• We have upgraded our experimental public proxy, which you can access at https://athens.azurefd.net
  • Like our previous experimental server, this may have downtime, but it will use the beta
  • Follow progress of our preview here

Highlights

Here are some highlights of what's been done:

• We have worked on docs for installing, deploying, and hacking on Athens: https://docs.gomods.io
• We now support a variety of backend storage support (AWS, GCP, MongoDB and others)
• We've added logging and tracing (Jaeger and StackDriver)
• You can now authenticate Athens with your own private repositories by just providing a Github token or a .rc file

Try it out

$ docker pull gomods/athens:v0.2.0
$ docker run -p 3000:3000 gomods/athens:v0.2.0

# from another terminal window
$ cd /my/cool/project 
$ GOPROXY=http://localhost:3000 go build

A Huge Thank You

We wouldn't have gotten to this point without everyone in our community, and we always welcome new folks. Absolutely everybody is welcome, so if you're interested, we have tons of ways you can get involved. See here for details!

Enjoy!

A working proxy!

We have an Athens proxy that works! 🎉 🎈 🍰 !

You can run GOPROXY=myproxy go get thing@version and the proxy:

• Fetches thing@version if it doesn't have it in storage
• Returns thing@version to the client
• Stores thing@version in its storage

We've verified that it works for small and medium sized projects, and we think that's pretty good 😄. Good enough for our first alpha. Yay!

A history of this release, in tweets:

• We opened a big kahuna
• We did some live pair programming (with a lot more than just a pair of people) to fix the big kahuna
• We fixed the big Kahuna and did quite a bit more
• We've been doing some awesome, awesome work to make Athens more observable, more stable, and more efficient this whole time

Each and every contributor had a massive role to play to get use from zero lines of code to this point, so thank you all!

There's some super rad stuff coming up next, including wayyyy more docs (we're even gonna have a docs site!), publishing Docker images, and of course way more features and improvements. And, oh yea, look out for a registry coming to a cloud near you 😄