Subscribe here to follow Infinitic's development. Please ⭐️ us on Github!

Pulsar installation

To install Pulsar, refer to the Pulsar documentation.

Infinitic can run on managed Pulsar cluster. It has been tested on StreamNative, Datastax and CleverCloud. We recommend using them if you are new to Pulsar.

Pulsar setup

Infinitic does not require specific settings, nevertheless, it's recommended to set up retention policies to avoid losing messages when workers are not connected.

We recommend using Infinitic using a dedicated Pulsar tenant and using namespaces to distinguish the production environment from dev or staging. For example, we may want to create one namespace per developer, plus one for staging and one for production.

If they do not exist already, tenant and namespace are automatically created by Infinitic workers at launch time.

Connecting to a Pulsar cluster

Infinitic clients and workers need to know how to connect to our Pulsar cluster. This is done through a pulsar entry within their configuration file.

Minimal configuration

The minimal configuration - typically needed for development - contains:

  brokerServiceUrl: pulsar://localhost:6650
  webServiceUrl: http://localhost:8080
  tenant: infinitic
  namespace: dev

Transport encryption

Transport Encryption using TLS can be configured with those additional parameters:

  useTls: true
  tlsAllowInsecureConnection: false
  tlsTrustCertsFilePath: /path/to/ca.cert.pem
  tlsEnableHostnameVerification: false

If we use a KeyStore, it can be configured with:

  useKeyStoreTls: true
  tlsTrustStoreType: JKS
  tlsTrustStorePath: /var/private/tls/client.truststore.jks
  tlsTrustStorePassword: clientpw


Using Json Web Token:

    token: our_token

Using Athen:

    tenantDomain: shopping
    tenantService: some_app
    providerDomain: pulsar
    privateKey: file:///path/to/private.pem
    keyId: v1

Using OAuth2

    privateKey: file:///path/to/key/file.json
    issuerUrl: https://dev-kt-aa9ne.us.auth0.com
    audience: https://dev-kt-aa9ne.us.auth0.com/api/v2/
Edit this page on GitHub Updated at Sat, Sep 10, 2022