GoogleCloudPlatform/govanityurls

Name: govanityurls

Owner: Google Cloud Platform

Description: Use a custom domain in your Go import path

Created: 2017-06-26 17:56:30.0

Updated: 2018-05-09 20:45:30.0

Pushed: 2018-05-06 20:46:43.0

Homepage:

Size: 25

Language: Go

GitHub Committers

User	Most Recent Commit	# Commits

Other Committers

User	Email	Most Recent Commit	# Commits

README

Go Vanity URLs

Go Vanity URLs is a simple App Engine Go app that allows you to set custom import paths for your Go packages.

Quickstart

Install gcloud and install Go App Engine component:

loud components install app-engine-go

Setup a custom domain for your app.

Get the application:

et -u -d github.com/GoogleCloudPlatform/govanityurls
(go env GOPATH)/src/github.com/GoogleCloudPlatform/govanityurls

Edit vanity.yaml to add any number of git repos. E.g., customdomain.com/portmidi will serve the https://github.com/rakyll/portmidi repo.

s:
ortmidi:
repo: https://github.com/rakyll/portmidi

You can add as many rules as you wish.

Deploy the app:

loud app deploy

That's it! You can use go get to get the package from your custom domain.

 get customdomain.com/portmidi

Running in other environments

You can also deploy this as an App Engine Flexible app by changing the app.yaml file:

ime: go
 flex

This project is a normal Go HTTP server, so you can also incorporate the handler into larger Go servers.

Configuration File

: example.com
e_max_age: 3600
s:
oo:
repo: https://github.com/example/foo
display: "https://github.com/example/foo https://github.com/example/foo/tree/master{/dir} https://github.com/example/foo/blob/master{/dir}/{file}#L{line}"
vcs: git

Key	Required	Description
cache_max_age	optional	The amount of time to cache package pages in seconds. Controls the max-age directive sent in the Cache-Control HTTP header.
host	optional	Host name to use in meta tags. If omitted, uses the App Engine default version host or the Host header on non-App Engine Standard environments. You can use this option to fix the host when using this service behind a reverse proxy or a custom dispatch file.
paths	required	Map of paths to path configurations. Each key is a path that will point to the root of a repository hosted elsewhere. The fields are documented in the Path Configuration section below.

Path Configuration

Key	Required	Description
display	optional	The last three fields of the go-source meta tag. If omitted, it is inferred from the code hosting service if possible.
repo	required	Root URL of the repository as it would appear in go-import meta tag.
vcs	required if ambiguous	If the version control system cannot be inferred (e.g. for Bitbucket or a custom domain), then this specifies the version control system as it would appear in go-import meta tag. This can be one of git, hg, svn, or bzr.