mirror of
https://github.com/octoleo/syncthing.git
synced 2025-01-30 02:18:25 +00:00
916ec63af6
This is a new revision of the discovery server. Relevant changes and non-changes: - Protocol towards clients is unchanged. - Recommended large scale design is still to be deployed nehind nginx (I tested, and it's still a lot faster at terminating TLS). - Database backend is leveldb again, only. It scales enough, is easy to setup, and we don't need any backend to take care of. - Server supports replication. This is a simple TCP channel - protect it with a firewall when deploying over the internet. (We deploy this within the same datacenter, and with firewall.) Any incoming client announces are sent over the replication channel(s) to other peer discosrvs. Incoming replication changes are applied to the database as if they came from clients, but without the TLS/certificate overhead. - Metrics are exposed using the prometheus library, when enabled. - The database values and replication protocol is protobuf, because JSON was quite CPU intensive when I tried that and benchmarked it. - The "Retry-After" value for failed lookups gets slowly increased from a default of 120 seconds, by 5 seconds for each failed lookup, independently by each discosrv. This lowers the query load over time for clients that are never seen. The Retry-After maxes out at 3600 after a couple of weeks of this increase. The number of failed lookups is stored in the database, now and then (avoiding making each lookup a database put). All in all this means clients can be pointed towards a cluster using just multiple A / AAAA records to gain both load sharing and redundancy (if one is down, clients will talk to the remaining ones). GitHub-Pull-Request: https://github.com/syncthing/syncthing/pull/4648
63 lines
2.3 KiB
Go
63 lines
2.3 KiB
Go
/*
|
|
* Minio Go Library for Amazon S3 Compatible Cloud Storage
|
|
* Copyright 2017 Minio, Inc.
|
|
*
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
* you may not use this file except in compliance with the License.
|
|
* You may obtain a copy of the License at
|
|
*
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
* See the License for the specific language governing permissions and
|
|
* limitations under the License.
|
|
*/
|
|
|
|
// Package credentials provides credential retrieval and management
|
|
// for S3 compatible object storage.
|
|
//
|
|
// By default the Credentials.Get() will cache the successful result of a
|
|
// Provider's Retrieve() until Provider.IsExpired() returns true. At which
|
|
// point Credentials will call Provider's Retrieve() to get new credential Value.
|
|
//
|
|
// The Provider is responsible for determining when credentials have expired.
|
|
// It is also important to note that Credentials will always call Retrieve the
|
|
// first time Credentials.Get() is called.
|
|
//
|
|
// Example of using the environment variable credentials.
|
|
//
|
|
// creds := NewFromEnv()
|
|
// // Retrieve the credentials value
|
|
// credValue, err := creds.Get()
|
|
// if err != nil {
|
|
// // handle error
|
|
// }
|
|
//
|
|
// Example of forcing credentials to expire and be refreshed on the next Get().
|
|
// This may be helpful to proactively expire credentials and refresh them sooner
|
|
// than they would naturally expire on their own.
|
|
//
|
|
// creds := NewFromIAM("")
|
|
// creds.Expire()
|
|
// credsValue, err := creds.Get()
|
|
// // New credentials will be retrieved instead of from cache.
|
|
//
|
|
//
|
|
// Custom Provider
|
|
//
|
|
// Each Provider built into this package also provides a helper method to generate
|
|
// a Credentials pointer setup with the provider. To use a custom Provider just
|
|
// create a type which satisfies the Provider interface and pass it to the
|
|
// NewCredentials method.
|
|
//
|
|
// type MyProvider struct{}
|
|
// func (m *MyProvider) Retrieve() (Value, error) {...}
|
|
// func (m *MyProvider) IsExpired() bool {...}
|
|
//
|
|
// creds := NewCredentials(&MyProvider{})
|
|
// credValue, err := creds.Get()
|
|
//
|
|
package credentials
|