Skip to content

Latest commit

 

History

History
160 lines (132 loc) · 10.1 KB

gate-configuration.md

File metadata and controls

160 lines (132 loc) · 10.1 KB

NeoFS REST Gateway configuration file

This section contains detailed NeoFS REST Gateway configuration file description including default config values and some tips to set up configurable values.

There are some custom types used for brevity:

  • duration -- string consisting of a number and a suffix. Suffix examples include s (seconds), m (minutes), ms ( milliseconds).

Structure

Section Description
server Server configuration
wallet Wallet configuration
pool Pool configuration
logger Logger configuration
pprof Pprof configuration
prometheus Prometheus configuration

server section

server:
  endpoints:
    - address: localhost:8080
      external-address: localhost:8090
      tls:
        enabled: false
        certificate: /path/to/tls/cert
        key: /path/to/tls/key
        ca-certificate: /path/to/tls/ca
      keep-alive: 3m
      read-timeout: 60s
      write-timeout: 60s
  cleanup-timeout: 10s
  graceful-timeout: 15s
  max-header-size: 1000000
  listen-limit: 0
Parameter Type Default value Description
cleanup-timeout duration 10s Grace period for which to wait before killing idle connections.
graceful-timeout duration 15s Grace period for which to wait before shutting down the server.
max-header-size int 1000000 Controls the maximum number of bytes the server will read parsing the request header's keys and values, including the request line. It does not limit the size of the request body.
listen-limit int 0 Limit the number of outstanding requests. 0 means no limit
endpoint.[0].address string localhost:8080 The IP and port to listen on.
endpoint.[0].keep-alive duration 3m Sets the TCP keep-alive timeouts on accepted connections.
endpoint.[0].read-timeout duration 60s Maximum duration before timing out read of the request. It prunes dead TCP connections (e.g. closing laptop mid-download).
endpoint.[0].write-timeout duration 60s Maximum duration before timing out write of the response.
endpoint.[0].tls.enabled bool false Use TLS for a gRPC connection (min version is TLS 1.2).
endpoint.[0].tls.certificate string The certificate file to use for secure connections.
endpoint.[0].tls.key string The private key file to use for secure connections (without passphrase).
endpoint.[0].tls.ca string The certificate authority certificate file to be used with mutual tls auth.
endpoint.[0].external-address string The full URL address needs to be shown in the API documentation, including the scheme (http/https), host, and port. If not set, will be generated from address and tls.enabled.

wallet section

wallet:
  path: /path/to/wallet.json
  address: NfgHwwTi3wHAS8aFAN243C5vGbkYDpqLHP
  passphrase: pwd
Parameter Type Default value Description
path string Path to the wallet.
address string Account address to get from wallet. If omitted default one will be used.
passphrase string Passphrase to decrypt wallet.

pool section

pool:
  node-dial-timeout: 10s
  healthcheck-timeout: 15s
  rebalance-timer: 60s
  error-threshold: 100

  # Nodes configuration
  # This configuration makes the gateway use the first node (node1.neofs:8080)
  # while it's healthy. Otherwise, gateway uses the second node (node2.neofs:8080)
  # for 10% of requests and the third node (node3.neofs:8080) for 90% of requests.
  # Until nodes with the same priority level are healthy
  # nodes with other priority are not used.
  # The lower the value, the higher the priority.
  peers:
    0:
      address: node1.neofs:8080
      priority: 1
      weight: 1
    1:
      address: node2.neofs:8080
      priority: 2
      weight: 0.1
    2:
      address: node3.neofs:8080
      priority: 2
      weight: 0.9
Parameter Type Default value Description
node-dial-timeout duration 10s Timeout to connect to a node.
healthcheck-timeout duration 15s Timeout to check node health during rebalance.
rebalance-timer duration 60s Interval to check node health.
error-threshold uint32 100 The number of errors on connection after which node is considered as unhealthy.
default-timestamp bool false By default, add a Timestamp to the object upon creation.

peers section

Parameter Type Default value Description
address string Address of storage node.
priority int 1 It allows to group nodes and don't switch group until all nodes with the same priority will be unhealthy. The lower the value, the higher the priority.
weight float 1 Weight of node in the group with the same priority. Distribute requests to nodes proportionally to these values.

logger section

logger:
  level: debug
Parameter Type Default value Description
level string debug Logging level.
Possible values: debug, info, warn, error, dpanic, panic, fatal.

pprof section

Contains configuration for the pprof profiler.

pprof:
  enabled: true
  address: localhost:8091
Parameter Type Default value Description
enabled bool false Flag to enable the service.
address string localhost:8091 Address that service listener binds to.

prometheus section

Contains configuration for the prometheus metrics service.

prometheus:
  enabled: true
  address: localhost:8092
Parameter Type Default value Description
enabled bool false Flag to enable the service.
address string localhost:8092 Address that service listener binds to.