Skip to content

Latest commit

 

History

History
139 lines (118 loc) · 5.24 KB

config-file.md

File metadata and controls

139 lines (118 loc) · 5.24 KB
Raw

Configuring Glee

Glee comes with sensible defaults so you don't have to worry about configuration. However, sometimes you may want to change the behavior or customize Glee in different ways. For that purpose, you can use the glee.config.js file.

The configuration file

Glee's config file is a JavaScript file that exports an async function. Something like this:

export default async function () {
  // More stuff here...
}

This function must return an object with the following shape:

export default async function () {
  return {
    glee: {},
    kafka: {},
    websocket: {},
    mqtt: {},
    cluster: {}
  }
}

Here is an example of a glee.config.js file for reference:

export default async function () {
  return {
    glee: { // Glee core configurations
      lifecycleDir: './lifecycle',
      functionsDir: './functions',
      asyncapiFilePath: './asyncapi.json'
    docs: {
      enabled: true, // Enable/Disable documentation generation
      folder: 'docs', // Folder where you want the output of your docs to reside.
      template: '@asyncapi/markdown-template' // Type of template you want to use.
    }
    websocket: {
      server: {
        httpServer: customServer, // A custom HTTP server of your own.
        adapter: "native", // Default. Can also be 'socket.io' or a reference to a custom adapter.
        port: process.env.PORT,
      },
      client: {
        authentication: {
          token: process.env.TOKEN
        },
        query: {
          foo: 'bar'
        }
      }
    },
    cluster: {
      adapter: "redis",
      name: "cluster", // Default. Name of your cluster.
      url: "redis://localhost:6379", // Server URL used by adapter for clustering
    },
    mqtt: {
      authentication: {
        cert: async () => fs.readFileSync('./cert')
        clientId: '123',
        userPassword: {
          username: 'user1',
          password: 'pass12'
        }
      }
    }
  };
}

Inside the return statement, you can specify the following options:

Glee Core Configurations

These configurations apply to Glee itself, rather than any specific protocol.

Field Default Description
glee.gleeDir .glee Sets the Glee directory. Your sources will be compiled here.
glee.lifecycleDir lifecycle Path to the directory that stores your lifecycle events.
glee.functionsDir functions Path to the directory that stores your functions.
glee.asyncapiFilePath asyncapi.(yaml | yml | json) Path to your AsyncAPI file.

Generating Documentation

Field Description
docs.enabled This flag enables/disables the docs generation functionality.
docs.folder The dedicated folder you want your generated docs to reside.
docs.template The AsyncAPI template you wanna use for generating your documentation.

Websocket Server

Field Description
websocket.server Websocket server-specific configurations
websocekt.client Websocket client-specific configurations
websocket.server.adapter The Glee adapter to use for the WebSocket server. Defaults to a "native" WebSocket implementation. Other allowed values are socket.io (to use the Socket.IO Glee adapter) or a reference to a custom adapter.
websocket.server.httpServer A custom HTTP server of your own. E.g., an Express server or any object that implements the http.Server interface.
websocket.server.port The port to use when binding the WebSocket server. This is useful when your server is behind a proxy and the port exposed for consumption is not the same as the port your application should be bound to. Defaults to the port specified in the selected AsyncAPI server.
websocket.client.authetication Authentication variables for client
websocket.client.authentication.token HTTP Authentication header
websocket.client.query Query object for the client to send

Cluster

Field Description
cluster.adapter The Glee cluster adapter to use for communication between instances. Defaults to Redis Pub/Sub ("redis"). Can be a reference to a custom adapter.
cluster.name The name of the cluster. Defaults to "cluster".
cluster.url The url of the server to be used by the adapter. In case of "redis" adapter, it's the url of the Redis server.

MQTT

Field Description
mqtt.authentication MQTT authentication configuration
mqtt.authentication.cert Client certificate
mqtt.authentication.clientId MQTT client Id for authentication
mqtt.authentication.userPassword username and password parameters for authentication
mqtt.authentication.userPassword.username username parameter
mqtt.authentication.userPassword.password password parameter

Kafka

Field Description
kafka.authentication Kafka authentication configuration
kafka.authentication.key Kafka Broker Key
kafka.authentication.cert Client certificate
kafka.authentication.clientId Kafka client Id for authentication
kafka.authentication.rejectUnauthorized Boolean flag for accepting the valid SSL certificates
kafka.authentication.username The username to use during authentication.
kafka.authentication.password The password to use during authentication.