Services Anbindung beim Betrieb der Archivierung mit Elasticsearch

Übersicht

Die Anbindung an den Elasticsearch Archiv-Index wird durch zwei Microservices realisiert, dem archive-index-writer und dem archive-index-searcher. Beide dieser Microservices sind in der Lage mit oder ohne SSL und/oder BasicAuth mit der Elasticsearch-Instanz zu kommunizieren.

Archiv-Index-Writer

Der Microservice konsumiert die Nachrichten aus der Index Queue und indiziert die Nachrichten in Archiv-Index. Danach sendet dieser die Nachricht in die Finish Queue.

Die Konfiguration des Microservices geschieht über die im “docker-compose”-Datei angegebene “application.yml”.

Hierbei unterstützen wir aktuell einen Elasticsearch Archiv-Index.

Konfiguration

Für die Konfiguration der Placeholder siehe Installation.

# Queues for RabbitMQ messaging
# Name of the queue from which messages are consumed
consumer-queue: index_queue
production-queue:
  success:
    # Name of the queue to which successfully processed messages are sent
    name: success_queue
    # Supported values: ALL (default - mark message as completely successfully archived, currently for SFTP archive), INDEX (mark message as successfully archive-indexed, currently for Nscale archive)
    type: ALL
  # Name of the queue to which error messages are sent
  error: error_queue

# Elasticsearch index name
index:
  # Name of the Elasticsearch index used for archiving
  name: ${INDEX_NAME}
# Elasticsearch connection
elasticsearch:
  rest:
    # Hostname of the Elasticsearch server
    host: ${ELASTICSEARCH_HOST}
    # HTTP port of the Elasticsearch server
    port: ${ELASTICSEARCH_HTTP_PORT}
    # Connection timeout in milliseconds for Elasticsearch operations. Default 60000
    timeout-in-millis: 10000
    # Enable HTTPS for the Elasticsearch connection. Default true
    ssl-enabled: true
    # Username for Basic-Auth against Elasticsearch, optional
    user: ${ELASTICSEARCH_USERNAME}
    # Password for Basic-Auth against Elasticsearch, optional
    password: ${ELASTICSEARCH_PASSWORD}
    # Path to a PKCS12 truststore, nur erforderlich bei selbstsigniertem/internem Zertifikat
    trust-store: ${ELASTICSEARCH_TRUSTSTORE_PATH}
    # Passwort des Truststores
    trust-store-password: ${ELASTICSEARCH_TRUSTSTORE_PASSWORD}

# RabbitMQ connection
spring:
  rabbitmq:
    # Hostname of the RabbitMQ server
    host: ${RABBITMQ_HOST}
    # Port of the RabbitMQ server
    port: ${RABBITMQ_PORT}
    # Username for RabbitMQ authentication
    username: ${RABBITMQ_USER}
    # Password for RabbitMQ authentication
    password: ${RABBITMQ_PASSWORD}

trust-store und trust-store-password werden nur benötigt, wenn Elasticsearch mit einem selbstsignierten oder sonst nicht öffentlich vertrauenswürdigen Zertifikat betrieben wird. Ist das Zertifikat von einer öffentlichen CA ausgestellt (im JVM-Default-Truststore bereits enthalten), können beide Werte leer bleiben – die Verbindung wird dann automatisch über den JVM-Default-Truststore validiert. Ist ssl-enabled auf false gesetzt, werden user/password weiterhin für Basic-Auth verwendet, trust-store/trust-store-password werden dann ignoriert.

Releases

Der Service wird in den folgenden Versionen als Docker Container aus dem Repo docker-nob-erp.next-level-apps.com/archive-index-writer bereitgestellt.

2026-11-04

Ticket Beschreibung
BTOB-14473 HTTPS und Basic Auth für die Verbindung zum Elasticsearch-Archivindex.

2024-05-27

Ticket Beschreibung
BTOB-12037 Timeout-Probleme beim Löschen bestehender Einträge durch eine konfigurierbare Timeout-Einstellung für die Elasticsearch-Verbindung behoben.

2023-11-20

Ticket Beschreibung
BTOB-11746 Beim erneuten Archivieren einer Nachricht wird der vorherige Eintrag im Archivindex überschrieben und aktualisiert.

2023-02-09

Ticket Beschreibung
BTOB-8952 Erweiterung des Finish Services für parallele Archiv-Indizierung und Archivierung.

2021-06-28

Ticket Beschreibung
BTOB-7498 Initiale Entwicklung zur Elasticsearch-Archiv-Indizierung.

Archive-Index-Searcher

Der Microservice nimmt Anfragen von der B2B für die Suche im Archiv entgegen und gegen den Archiv-Index aus.

Die Konfiguration des Microservices geschieht über die im “docker-compose”-Datei angegebene “application.yml”.

Hierbei unterstützen wir aktuell einen Elasticsearch Archiv-Index.

Konfiguration

Für die Konfiguration der Placeholder siehe Installation.

index:
  # Name of the Elasticsearch index used for archiving
  name: ${INDEX_NAME}
# Elasticsearch connection
elasticsearch:
  rest:
    # Hostname of the Elasticsearch server
    host: ${ELASTICSEARCH_HOST}
    # HTTP port of the Elasticsearch server
    port: ${ELASTICSEARCH_HTTP_PORT}
    # Enable HTTPS for the Elasticsearch connection. Default true
    ssl-enabled: true
    # Username for Basic-Auth against Elasticsearch, optional
    user: ${ELASTICSEARCH_USER}
    # Password for Basic-Auth against Elasticsearch, optional
    password: ${ELASTICSEARCH_PASSWORD}
    # Path to a PKCS12 truststore, nur erforderlich bei selbstsigniertem/internem Zertifikat
    trust-store: ${ELASTICSEARCH_TRUSTSTORE_PATH}
    # Passwort des Truststores
    trust-store-password: ${ELASTICSEARCH_TRUSTSTORE_PASSWORD}

trust-store und trust-store-password werden nur benötigt, wenn Elasticsearch mit einem selbstsignierten oder sonst nicht öffentlich vertrauenswürdigen Zertifikat betrieben wird. Ist das Zertifikat von einer öffentlichen CA ausgestellt (im JVM-Default-Truststore bereits enthalten), können beide Werte leer bleiben – die Verbindung wird dann automatisch über den JVM-Default-Truststore validiert. Ist ssl-enabled auf false gesetzt, werden user/password weiterhin für Basic-Auth verwendet, trust-store/trust-store-password werden dann ignoriert.

Releases

Der Service wird in den folgenden Versionen als Docker Container aus dem Repo docker-nob-erp.next-level-apps.com/archive-index-searcher bereitgestellt.

2026-11-04

Ticket Beschreibung
BTOB-14473 HTTPS und Basic Auth für die Verbindung zum Elasticsearch-Archivindex.

2021-06-28-02

Ticket Beschreibung
BTOB-7505 Initiale Entwicklung zur Suche im File-System-Archiv via SFTP.
View Me   Edit Me