Example
const config = require('@mimik/configuration');-
configuration
-
~isProd() ⇒
boolean -
~setConfig(pack, options) ⇒
object
-
~isProd() ⇒
Indicates if the environment is prod
Kind: inner method of configuration
Returns: boolean - true if the environment is prod or production.
The following environment variables are used
| Env variable name | Description | Value | Comments |
|---|---|---|---|
| NODE_ENV | environnment of the microservice | ||
| Category: sync | |||
Set the configuration of the micro-service.
Kind: inner method of configuration
Returns: object - The configuration.
Category: sync
Throws:
-
configuration.serverSettings.typeWill trow an error if a mandatory value is missing.
The following environment variables are being setup:
| Env variable name | Description | Value | Comments |
|---|---|---|---|
| SERVER_VERSION | version of the software for the micro-service | package.version | serverSettings.version |
| SERVER_NAME | name of the micro-service | package.name | serverSettings.name |
| SERVER_TYPE | type of the micro-service | package.mimik.type | serverSettings.type |
| SWAGGER_FILE_VERSION | version of the swagger file for the API | package.swaggerFile.version | serverSettings.swaggerFile.version |
| SWAGGER_FILE_ACCOUNT | account associated with the API | package.swaggerFile.account | serverSettings.swaggerFile.account |
| SWAGGER_FILE_NAME | name of the API | package.swaggerFile.name | serverSettings.swaggerFile.name |
| SWAGGER_FILE_PROVIDER | provider of the API file | package.swaggerFile.provider | serverSettings.swaggerFile.provider, if not present the default is bitbucket
|
| SERVER_LOCAL_IPV4 | IP address of the micro-service | ip.address() | serverSettings.ip.local |
| CONSOLE_LEVEL | log level for console output | debug | logInfo.consoleLevel |
| LOG_LEVEL | log level for console output | debug | logInfo.logLevel |
| AWS_LOCAL_PROPERTIES | internal ip address to access aws instance properties | 169.254.169.254 | |
| MST_SET | to setup configuration without mST and oauth token setup | on | on/off |
The following environement variables are being used for the configuration:
| Env variable name | Description | Default | Config property | Comments |
|---|---|---|---|---|
| NODE_ENV | running environment | local | nodeEnvironment | |
| LOCATION_PROVIDER | location provider URL to use for ip location or noPublic or environment
|
noPublic | locationProvider.url or locationProvider | see public-helper |
| LOCATION_PROVIDER_KEY | location provider key to use to access the location provider | null | locationProvider.key | see public-helper
|
| CLOUD_PROVIDER | cloud provider running the service | noCloud | cloudProvider | see public-helper
|
| SERVER_ID | service id | uuid.v4() | serverSettings.id | |
| CUSTOMER_CODE | customer code associated with the service instance | '' | serverSettings.customerCode | empty string |
| SWAGGER_FILE_DIRECTORY | directory where the api definition is located | ./api | serverSettings.api | [1] |
| BITBUCKET_USERNAME | username to access bitbucket read access on the swagger repos | ' ' | serverSettings.apiBasicAuth.username | |
| BITBUCKET_PASSWORD | password to access bitbucket read access on the swagger repos | ' ' | serverSettings.apiBasicAuth.password | |
| SWAGGERHUB_API_KEY | apiKey to access swaggerhub | serverSettings.apiApiKey | ||
| SERVER_SECURITY_SET | switch to enable or disable the token interpretation | on | serverSettings.securitySet | only active if environment is local
|
| INTERCEPT_ERROR | switch to use or not the errorIntercept option | on | serverSettings.interceptError | must be set to off for mID |
| SERVER_PORT | port of the server | serverSettings.port | ||
| SERVER_PUBLIC_PROTOCOL | protocol used to defined the domain address of the sevice | http: | serverSettings.public.protocol | |
| SERVER_PUBLIC_DOMAIN_NAME | domain name used to define the domain address of the service | null | serverSettings.public.domainName | |
| ADMIN_EXTERNAL_ID | external id of the admin role to be chacked in the token | admin | security.admin.externalId | |
| OAUTH_CLIENT_ID | security id of the service | security.server.id | [2] | |
| OAUTH_CLIENT_SECRET | secret of the service | security.server.secret | [2] | |
| OAUTH_CLIENT_ACCESS_KEY | key for token signature | security.server.accessKey | [2] | |
| OAUTH_CLIENT_AUDIENCE | url representing the server to mST | security.server.audience | [2] | |
| OAUTH_ISSUER | token url of mST | security.server.issuer | [2] | |
| OAUTH_GENERIC_KEY | key for token signature provided when a generic for this service type is defined | noGeneric | security.generic.key | [2] |
| OAUTH_GENERIC_PREVIOUS_KEY | key for the token signature before change the public key | security.generic.previousKey | [2] | |
| OAUTH_GENERIC_AUDIENCE | url representing the generic of the service type to mST | noGeneric | security.generic.audience | [2] |
| API_KEYS | list of API Keys which a test against in case of APIKey security | [] | ||
| LOG_MODE | collector the be used to log events | sumologic | logInfo.mode | can be sumologic, awsS3, all, 'awsKinesis' |
| NO_STACK | disable the inclusion of a the stack in all logs | yes | logInfo.noStack | |
| FILTER_FILE | path for the filter file definition | null | logInfo.filterFile | |
| USER_DEFINITIONS_FILE | path for the custom user definitions | null | userDefinitions.file | |
| EXIT_DELAY | delay to allow the log transports to flush | 2000 | logInfo.exitDelay | in milliseconds |
| CLUSTER_MANAGEMENT | switch to enable cluster communication | off | cluster.management | can be on or off
|
| REQUEST_TIMEOUT | timeout for intra cluster http request | 10000 | cluster.timeout | in milliseconds |
| CACHE_SET | switch to enable use of cache | off | cache.set | can be on, off
|
| TOPIC_SET | switch to enable use of event topic | off | topic.set | can be on, off, mock
|
| SET_SNS_TOPIC_FIFO | set to yes if fifo topic | no | topic.isFifoTopic | can be yes, no
|
| SET_SNS_CONTENT_DEDUPLICATION | set to yes, to use content based deduplication | no | contentBasedDeduplication | when fifo topic is used and set to no, MessageDeduplicationId must be provided in message. |
| ENCRYPTION_SET | switch to enable use of mongodb encryption | off | encryption.set | can be on, or off
|
| MIT_URL | url for reaching mIT | dependencies.mIT.url | ||
| MIT_AUDIENCE | audience of mIT | dependencies.mIT.audience | [2] | |
| REGISTRATION_SET | swicht to enable user of registration | on | registration.set | can be on or off
|
| REGISTRATION_RETRY | retry time for registering to mIT | 3000 | registration.retry | in milliseconds |
$_URL.toUpperCase() |
cluster information | self | dependencies.(SERVER_TYPE).url |
should not be used |
${configuration.serverSettings.type}_AUDIENCE.toUpperCase() |
cluster information | dependencies.(SERVER_TYPE).audience |
[2], but should not be used |
[1]: /(SWAGGER_FILE_ACCOUNT)_(SERVER_TYPE)_(SWAGGER_FILE_VERSION)_swagger.json is added to the serverSettings.api property
[2]: defined when registering to mST
When MST_SET is off, registration and cluster should not be enabled, so configuration.cluster.management and configuration.registration.set will be set to `off``
When sumologic or all is used for LOG_MODE the following environment variables are used for the configuration:
| Env variable name | Description | Default | Comments |
|---|---|---|---|
| SUMO_LOGIC_ENDPOINT | endpoint of the sumologic collector to used for logs | ||
| SUMO_LOGIC_COLLECTOR_CODE | id of the collector in sumologic |
When awsS3 or all is used for LOG_MODE the following environment variables are used for the configuration:
| Env variable name | Description | Default | Comments |
|---|---|---|---|
| S3_AWS_ACCESS_KEY_ID | access key id for AWS S3 | ||
| S3_AWS_SECRET_ACCESS_KEY | secret access key for AWS S3 | ||
| S3_AWS_BUCKET_NAME | name of the bucket used in S3 | ||
| S3_AWS_REGION | region where the bucket is | ||
| S3_AWS_TIMEOUT | maximum time a log can stay before being sent to S3 | 5 | in minutes |
| S3_AWS_MAX_SIZE | maximum size of the block of logs before being sent to S3 | 5 | in mB |
| S3_AWS_MAX_EVENTS | maximum number of logs to be in the block before being sent to S3 | 1000 |
When on is used for TOPIC_SET the following environment variables are used for the configuration:
| Env variable name | Description | Default | Comments |
|---|---|---|---|
| SNS_AWS_ACCESS_KEY_ID | access key id for AWS SNS | ||
| SNS_AWS_SECRET_ACCESS_KEY | secret access key for AWS SNS | ||
| SNS_AWS_REGION | region where the topic is | ----noRegion---- |
When a database is involved | Env variable name | Description | Default | Comments | | DATABASE_CONNECTION_TIMEOUT | the time to connect to the database before error is generated | 30 | in seconds | DATABASE_VALIDATION_CHECK | the delay before checking for connection | 1000 | in ms | DATABASE_RECONNECTION_OFFSET | offset for the time to reconnect to the database before error is generated | 5 | in seconds
When mongodb is used the following environment variables are used for the configuration:
| Env variable name | Description | Default | Comments |
|---|---|---|---|
| DATABASE_NAME | name of the database to store the information | ||
| DATABASE_IP | ip address of the database | localhost | |
| DATABASE_USER | user to access the database | null | if missing no user/password will be used |
| DATABASE_PASSWORD | password to access the database | null | if missing no user/password will be used |
| MONGO_USE_SRV | to use srv connection url set to yes
|
no |
|
| MONGO_AUTH_DATABASE | the auth database where users exists | ||
| MONGO_MAX_POOL_SIZE | the minimum number of connections in the connection pool | 5 | |
| MONGO_MIN_POOL_SIZE | the maximum number of connections in the connection pool | 10 | |
| MONGO_MAX_IDLE_TIME | the maximum number of milliseconds that a connection can remain idle in the pool before being removed and closed | 3000 | in milliseconds |
| MONGO_RETRY_WRITES | defines if the transaction should be tried again to write set to true or false | ||
| MONGO_WRITE_CONCERN | accepts a number or majority
|
||
| MONGO_SSL | uses ssl connection if yes
|
no |
|
| MONGO_SSL_VALIDATE | validates mongod server certificate against ca if set to yes
|
yes |
yes if MONGO_SSL is also yes
|
| MONGO_SSL_ALLOW_INVALID_HOSTNAMES | set to yes to allows invalid hostnames | ||
| MONGO_REPLICAT_SET | specifies the name of the replica set, if the mongod is a member of a replica set | not mandatory | |
| MONGO_WAIT_QUEUE_MULTIPLE | a number that the driver multiples the maxPoolSize value to, to provide the maximum number of threads allowed to wait for a connection to become available from the pool | no mandatory | |
| MONGO_WAIT_QUEUE_TIMEOUT | the maximum time in milliseconds that a thread can wait for a connection to become available | not mandatory | |
| MONGO_SOCKET_TIMEOUT | The time in milliseconds to attempt a send or receive on a socket before the attempt times out | 20000 | in milliseconds |
| MONGO_FAMILY | IP address family | 4 | 4 -> IPV4, 6 -> IPV6 |
| MONGO_SERVER_SELECTION_TIMEOUT | the MongoDB driver will try to find a server to send any given operation to, and keep retrying for serverSelectionTimeoutMS milliseconds | 30000 | in milliseconds |
| MONGO_HEARTBEAT_FREQUENCY | the MongoDB driver sends a heartbeat every heartbeatFrequencyMS to check on the status of the connection | 10000 | in milliseconds |
When on is used for ENCRYPTION_SET the following environment variables are used for the configuration:
| Env variable name | Description | Default | Comments |
|---|---|---|---|
| ENCRYPTION_DATABASE | database name where data encryption keyvault exists | admin | |
| KEY_VAULT_TABLE | collection name which has data encryption keys | keystore | |
| KMS_PROVIDER | Key Management service provider for master key | local | |
| MASTER_KEY_AWS_REGION | if KMS is aws region where master key exists | ----noRegion---- | |
| MASTER_KEY_ARN | if KMS is aws ARN of master key | ||
| ENCRYPTION_ACCESS_KEY_ID | if KMS is aws, accessKeyId to connect KMS | ||
| ENCRYPTION_SECRET_ACCESS_KEY | if KMS is aws, secretAccessKey to connect KMS | ||
| LOCAL_MASTER_KEY | if KMS is local, masterkey to encrypt data keys |
When dynamodb is used the following environement variables are used for the configuration:
| Env variable name | Description | Default | Comments |
|---|---|---|---|
| DYNAMODB_AWS_ACCESS_KEY_ID | access key id for AWS dynamodb | ||
| DYNAMODB_AWS_SECRET_ACCESS_KEY | secret access key for AWS dynamodb | ||
| DYNAMODB_AWS_REGION | region where dynamodb is | ----noRegion---- | |
| DYNAMODB_LOCAL_URL | url access the locally deploy dynamodb | http://localhost:8000 | |
| DYNAMO_THROUGHPUT_READ | throughput read for dynamodb index | 1 | |
| DYNAMO_THROUGHPUT_WRITE | throughput write for dynamodb index | 1 | |
| DYNAMO_SCHEMA_THROUGHPUT_READ | throughput read for dynamodb schema | 1 | |
| DYNAMO_SCHEMA_THROUGHPUT_WRITE | throughput write for dynamodb schema | 1 | |
| DYNAMO_SCHEMA_THROUGHPUT | throughput for dynamodb schema |
DYNAMO_SCHEMA_THROUGHPUT takes precedence over DYNAMO_SCHEMA_THROUGHPUT_READ and DYNAMO_SCHEMA_THROUGHPUT_WRITE. If DYNAMO_SCHEMA_THROUGHPUT is set to ON_DEMAND then index throughput wont apply, and if DYNAMO_SCHEMA_THROUGHPUT is not set to a number the value will be 1.
When redis is used the following environement variables are used for the configuration:
| Env variable name | Description | Default | Comments |
|---|---|---|---|
| CACHE_IP | domain of the redis server to use with port, a comma seperated list if using cluster | localhost:6379 | |
| CACHE_USER | redis user if the redis service is auth protected | null | |
| CACHE_PASSWORD | redis password for the user if the redis service is auth protected | null | |
| CACHE_CLUSTER_SET | set on, when using redis in a cluster. | off | |
| CACHE_CLUSTER_USE_REPLICAS | When set on, distribute load by executing readonly commands (such as GET) across all cluster nodes. When false, only use master nodes | off | |
| CACHE_CLUSTER_MINIMIZE_CONNECTION | When set on, .connect() will only discover the cluster topology, without actually connecting to all the nodes. Useful for short-term or Pub/Sub-only connections. | off | |
| CACHE_CONNECTION_TIMEOUT | time the server will wait at start to connect to the cache | 30 | in seconds |
| CACHE_VALIDATION_CHECK | the delay before checking for connection | 1000 | in ms |
| CACHE_RECONNECTION_OFFSET | offset for the time to reconnect to the database before error is generated | 5 | in seconds |
| CACHE_REQUEST_TTL | request time to live in cache | 10 | in seconds |
| CACHE_API_ID_TTL | API request time to live for main resource | 20 | in seconds |
| CACHE_API_OPTION_TTL | API request time to live for option | 5 | in seconds |
| REDIS_RECONNECT_TRIES | number of tries to restablish a connection | 100 | |
| REDIS_RECONNECT_INTERVAL | time to wait before retry | 500 | in milliseconds |
| REDIS_REQUEST_MAX_MEMORY | maximum memory size of the request cache | 10 | in megabytes |
| REDIS_REQUEST_MAX_MEMORY_POLICY | eviction policy of the request cache | allkeys-lru | |
| REDIS_SOCKET_KEEPALIVE | keep long running connections alive for x seconds | 5000 | in seconds |
| REDIS_DISABLE_OFFLINE_QUEUE | queuing event when not connected | no |
Requires: module:@mimik/sumologic-winston-logger
| Param | Type | Description |
|---|---|---|
| pack | string |
Package.json object to use for the configuration. |
| options | object |
Options to add to the config. |