go-import-redirect

A thing that tells go get where to get Go packages and redirects users to https://godoc.org.

systemd Configuration

go-import-redirect takes the following flags:

• -addr for the address on which go-import-redirect should listen. It can either be a normal IP:PORT address or an absolute path to a UNIX socket that will be created. Defaults to localhost:8080. See https://golang.org/pkg/net/#Dial for more details.
• -from for the regular expression that the import path must match, including any capturing group, e.g. go\\.example\\.com/(.+).
• -to for the URL that will be used to build the repository URL. Capturing groups can be used, e.g. https://git.example.com/$1.
• -vcs for the type of VCS you are using, e.g. git. Defaults to git.

Additionally, a configuration file can be passed with -c. See archlinux/go-import-redirect.conf for an example.

It is recommended to enable the companion systemd socket and customize it so systemd can start the service when needed and pass the socket to go-import-redirect.

If you do not want to use socket activation, you must override the IPAddressDeny and RestrictAddressFamilies unit settings to appropriate values.

Likewise, you must customize the service definition to pass the right flag values.

AWS Lambda Configuration

The AWS Lambda version requires the use of the following environment variables: FROM, TO, and VCS. Those have the same semantics as the flags described above.

Note that this version needs to be compiled as a Linux binary and with the aws build tag set.

Docker Configuration

You can build the Docker image as usual, and pass the -from, -to, and -vcs flags when you invoke docker run. The -addr flag is already set to an appropriate value in the Dockerfile.