Updates configuration README with explanations of more fields

Documents auth, reporting, and http
pull/27/head
Brian Bland 2015-01-06 10:59:52 -08:00
parent fdea60af05
commit dbc3ecdff5
2 changed files with 53 additions and 1 deletions

View File

@ -29,6 +29,20 @@ storage:
secretkey: SUPERSECRET secretkey: SUPERSECRET
host: ~ host: ~
port: ~ port: ~
auth:
silly:
realm: test-realm
service: my-service
reporting:
bugsnag:
apikey: mybugsnagapikey
releasestage: development
newrelic:
licensekey: mynewreliclicensekey
name: docker-distribution
http:
addr: 0.0.0.0:5000
secret: mytokensecret
``` ```
```yaml ```yaml
@ -54,6 +68,44 @@ This specifies the storage driver, and may be provided either as a string (only
The parameters map will be passed into the factory constructor of the given storage driver type. The parameters map will be passed into the factory constructor of the given storage driver type.
### auth
This specifies the authorization method the registry will use, and is provided as an auth type with a parameters map.
The parameters map will be passed into the factory constructor of the given auth type.
### reporting
This specifies metrics/error reporting systems which the registry will forward information about stats/errors to. There are currently two supported systems, which are documented below.
#### bugsnag
Reports http errors and panics to [bugsnag](https://bugsnag.com).
##### apikey
(Required for bugsnag use) Specifies the bugnsag API Key for authenticating to your account.
##### releasestage
(Optional) Tracks the stage at which the registry is deployed. For example: "production", "staging", "development".
##### endpoint
(Optional) Used for specifying an enterprise bugsnag endpoint other than https://bugsnag.com.
#### newrelic
Reports heap, goroutine, and http stats to [NewRelic](https://newrelic.com).
##### licensekey
(Required for newrelic use) Specifies the NewRelic License Key for authenticating to your account.
##### name
(Optional) Specifies the component name that is displayed in the NewRelic panel.
### http
This is used for HTTP transport-specific configuration options.
#### addr
Specifies the bind address for the registry instance. Example: 0.0.0.0:5000
#### secret
Specifies the secret key with which query-string HMAC tokens are generated.
### Notes ### Notes
All keys in the configuration file **must** be provided as a string of lowercase letters and numbers only, and values must be string-like (booleans and numerical values are fine to parse as strings). All keys in the configuration file **must** be provided as a string of lowercase letters and numbers only, and values must be string-like (booleans and numerical values are fine to parse as strings).

View File

@ -236,7 +236,7 @@ type BugsnagReporting struct {
type NewRelicReporting struct { type NewRelicReporting struct {
// LicenseKey is the NewRelic user license key // LicenseKey is the NewRelic user license key
LicenseKey string `yaml:"licensekey"` LicenseKey string `yaml:"licensekey"`
// AppName is the component name of the registry in NewRelic // Name is the component name of the registry in NewRelic
Name string `yaml:"name"` Name string `yaml:"name"`
} }