go-fetcher

This repository contains code for a go get routing service which allows packages from multiple locations to appear to be centralized in one location. This also allows the packages to be moved to other locations without breaking imports.

Building

In order to build the package, the following dependencies must be met:

• Go should be installed and in the PATH
• GOPATH should be set as described here
• Ensure that $GOPATH/bin is in your PATH

To build the Go binary:

go get github.com/cloudfoundry/go-fetcher

Running Tests

We are using Ginkgo to run tests.

Be sure to install protobuf with go get github.com/golang/protobuf/proto.

Run ginkgo from the root of the repository to run all tests.

Configuring

You will need to create a configuration for go-fetcher:

cat > config.json << END
{
  "ImportPrefix": "example.com",
  "OrgList": [
    "https://github.com/cloudfoundry/",
    "https://github.com/cloudfoundry-incubator/",
    "https://github.com/cloudfoundry-attic/"
  ],
  "NoRedirectAgents": [
    "Go-http-client",
    "GoDocBot"
  ],
  "Overrides": {
    "stager": "https://github.com/cloudfoundry-incubator/stager"
  }
}
END

• The value of "ImportPrefix" is the DNS name of the go-fetcher service (ex: example.com).
• The value of "OrgList" is a list of go get compatible sites that are searched in order.
• The value of "Overrides" is a dictionary of packages which should not use the normal search path.

Running locally

The go-fetcher program expects environment variables to be set which indicate the port to listen on and the name of the configuration file.

./generate_local && PORT=8800 CONFIG="config.json" go run main.go

Deploying to Cloud Foundry

Deploying to Cloud Foundry is straight forward, but requires you to do so from the checked out repository so that cf can recognize and upload the package. You will need to create a manifest.yml to accompany your config.json:

cat > manifest.yml << END
application:
  - name: example
env:
  GOPACKAGENAME: github.com/cloudfoundry/go-fetcher/cmd/go-fetcher
  GOVERSION: go1.6
  CONFIG: config.json
END

Then, login to your cf instance and push the application:

cf login ...
cf push example