Archived docs. ESS 2.0 has reached end of life.

Use an External Service#

You may want to refer to an external service rather than the small-scale services running in the cluster from a reference deployment.

Examples include:

  • PostgreSQL

  • MongoDB

  • Elasticsearch

Example Customization for Events#

In the example below, the ESS uses kafka-credentials as its store for secrets, and the customization provides a replacement set of secrets.

  1. Go to your ESS installation directory:

    cd ${HOME}/ess
    
  2. Add a file kafka-credentials.env that contains the new value for the environment variable(s) you want to override, in this case KAFKA_BOOTSTRAP_SERVERS:

    #kafka-credentials.env
    
    KAFKA_BOOTSTRAP_SERVERS=remotehost-1:9092,remotehost-2:9092
    
  3. Modify the kustomization.yaml (i.e., step 3 of the Applying Your Customizations procedure).

    # kustomization.yaml in your ESS installation directory
    
    # ...  Preceding content omitted for brevity
    # ...
    
    
    secretGenerator:
       -  name: kafka-credentials
          behavior: replace
          envs:
             - kafka-credentials.env
    
  4. Continue with the rest of the Applying Your Customizations procedure.

Example Customization for Pod Storage#

In the example below, the ESS deployment uses postgres-credentials as its store for secrets, and the customization provides a set of secrets which replaces the defaults. In addition, the customization also changes the POSTGRES_DB.

  1. Go to your ESS installation directory:

    cd ${HOME}/ess
    
  2. Add a file postgres-credentials.env that contains the new value for the environment variable(s) you want to override:

    #postgres-credentials.env
    
    POSTGRES_USER=user-224239c3-a492-4589-a58e-4329a0e51cad
    POSTGRES_PASSWORD=password=b248e58c-392d-463b-b6a2-79725ee34614
    
    POSTGRES_HOST="remote-postgres"
    POSTGRES_PORT="5432"
    
    POSTGRES_DB=pods
    
    JDBC_URL=jdbc:postgresql://remote-postgres:5432/pods
    
    #Special format for postgres-metrics to consume
    METRICS_STYLE_URL=remote-postgres:5432/pods?sslmode=enable
    
  3. Modify the kustomization.yaml (i.e., step 3 of the Applying Your Customizations procedure).

    # kustomization.yaml in your ESS installation directory
    
    # ...  Preceding content omitted for brevity
    # ...
    
    secretGenerator:
       -  name: postgres-credentials
          behavior: replace
          envs:
             - postgres-credentials.env
    
  4. Continue with the rest of the Applying Your Customizations procedure.