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.