Merge pull request #27 from BrianBland/config-readme
Updates configuration README with explanations of more fields
This commit is contained in:
commit
891f6a5ba5
2 changed files with 53 additions and 1 deletions
|
@ -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).
|
||||||
|
|
|
@ -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"`
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
Loading…
Reference in a new issue