rakyll / goproxy-s3

Go proxy that serves from S3

goproxy-s3

A Go module proxy that serves modules from S3.

Note: The project is not yet stable, there could be breaking changes.

Guide

$ docker run -p 8080:8080 -p 9999:9999 \
      -e AWS_PROFILE=default \
      -v ~/.aws:/root/.aws \
      public.ecr.aws/q1p8v8z2/goproxy-s3:latest \
      -bucket=my-bucket -region=us-west-2;
goproxy-s3: 2022/03/29 09:43:32 Proxy server is starting at ":8080"; set GOPROXY
goproxy-s3: 2022/03/29 09:43:32 Admin server is starting at ":9999"

To copy a package and its transient dependencies to S3:

$ curl -X POST http://localhost:9999/golang.org/x/text@v0.3.7

To force replace a package and its transient dependencies:

$ curl -X POST http://localhost:9999/golang.org/x/text@v0.3.7?f=true

Set the GOPROXY to the goproxy-s3 endpoint and your modules will be served from S3.

$ GOPROXY=http://localhost:8080 go get golang.org/x/text@v0.3.7

Versions that are not available at S3 won't be served:

GOPROXY=http://localhost:8080 go get golang.org/x/text@v0.3.1
go get: golang.org/x/text@v0.3.1: reading http://localhost:8080/golang.org/x/text/@v/v0.3.1.info: 404 Not Found