externalServices parametro

Usare externalServices per configurare servizi esterni come Cassandra, Elasticsearch e Kafka.

Il seguente file YAML è uno schema di esempio per i servizi esterni Cassandra, Elasticsearch e Kafka.
  externalServices:
    cassandra:
       keyspace: ""
      # contactPoints: ""
      # createDevInstance:
        # affinityAndTolerations: ""
        # resources:
          # limits:
            # cpu: '2'
            # memory:9Gi
          # requests:
            # cpu: '1'
            # memory: 3Gi        
        # storage:
          # name: ""
          # accessMode: ReadWriteMany
          # capacity: 10Gi
          # storageClassName: default
          # securityContext:
            # fsGroup: 
            # supplementalGroups: []   
    kafka:
      # contactPoints: ""
      # topicPrefix: "sip"
      # mirrorTopicPrefix: ""
      # crossDCTopicPrefix: ""     
      # zookeeperContactPoints: ""
      # loggingContactPoints: ""
      # createDevInstance:
        # affinityAndTolerations: ""
        # resources:
          # limits:
            # cpu: '1'
            # memory: 1Gi
          # requests:
            # cpu: '0.1'
            # memory: 1.5Gi
        # storage:
          # name: ""
          # accessMode: ReadWriteMany
          # capacity: 10Gi
          # storageClassName: default
          # securityContext:
            # fsGroup: 
            # supplementalGroups: []  
    elasticSearch:
      # contactPoints: ""
      # replicationEnabled: false
      # createDevInstance:
        # affinityAndTolerations: ""
        # resources:
          # limits:
            # cpu: '1'
            # memory: 1Gi
          # requests:
            # cpu: '0.1'
            # memory: 1.5Gi
        # storage:
          # name: ""
          # accessMode: ReadWriteMany
          # capacity: 10Gi
          # storageClassName: default
          # securityContext:
            # fsGroup: 
            # supplementalGroups: []
 
  
    # configuration:
      # ssl_cassandra_disable: ""
      # ssl_elasticsearch_disable: ""
      # ssl_kafka_disable: ""  
      # ssl_Logging_kafka_disable: ""
Nota: Cassandra richiede un minimo di 5000Mi di memoria e può utilizzare al massimo 9000Mi.
La seguente tabella spiega gli attributi applicabili per il parametro externalServices di SIPEnvironment.
Proprietà Valore predefinito Tipo di valore Obbligatorio Descrizione
cassandra   object Vero Configurare Cassandra per externalServices. Per ulteriori informazioni, consultare parametro cassandra.
elasticsearch   object Vero Configurare Elasticsearch per externalServices. Per informazioni, consultare parametro elasticsearch.
kafka   object Vero Configura Kafka per externalServices. Per ulteriori informazioni, vedi parametro kafka.
configuration   object N Configurare il parametro configuration per ogni servizio. Per ulteriori informazioni, consultare parametro di configurazione.

cassandra parametro

Nota:
  • Quando il pod Cassandra raggiunge lo stato unhealthy , si consiglia di aumentare le risorse per Cassandra e riavviare le distribuzioni IV-appserver e IV-backend .
  • Il pod JVM_OPTS per Cassandra viene calcolato in base alle richieste e ai limiti passati alle risorse. Pertanto, Xms deve essere uguale alle richieste e Xmx deve essere il 75% dei limiti. Per ulteriori informazioni, consultare risorse.
Proprietà Valore predefinito Tipo di valore Obbligatorio Descrizione
iv_keyspace   string Vero Specificare keyspace per Inventory Visibility.
cas_keyspace ks_cas string N Specificare il keyspace per il servizio corriere.
promising_keyspace ks_promising string N Specificare keyspace per il servizio di promessa.
createDevInstance   object N Specifica le risorse e l'archiviazione per Cassandra. Per ulteriori informazioni, vederecreateDevInstance parametro .
Nota:
  • Questo distribuisce Cassandra in modalità non SSL.
  • cassandra.createDevInstance estrae l'immagine richiesta dal repository pubblico. Assicurati che il tuo cluster sia connesso ad internet prima di distribuire IBM® Sterling Intelligent Promising.
contactPoints   string N Punti di contatto per Cassandra. Se createDevInstance non è abilitato per Cassandra, contactPoints è obbligatorio. È necessario creare i seguenti keyspace:
  • <cassandra.iv_keyspace>
  • <cassandra.promising_keyspace>
  • <cassandra.cas_keyspace>
SeCassandra è esterno su SSL, quindi aggiungi i certificati al truststore. Per ulteriori informazioni, vedere Parametro di sicurezza.
Nota: non includere http o https nella tua istanza contactPoints .
datacenter   stringa N Specificare il centro dati per Cassandra.

elasticsearch parametro

Proprietà Valore predefinito Tipo di valore Obbligatorio Descrizione
createDevInstance   object N Specifica le risorse e l'archiviazione per Elasticsearch.
Per ulteriori informazioni, vederecreateDevInstance parametro .
Nota:
  • Questo distribuisce Elasticsearch solo in modalità non SSL.
  • elasticsearch.createDevInstance estrae l'immagine richiesta dal repository pubblico. Assicurati che il tuo cluster sia connesso ad internet prima di distribuire IBM Sterling Intelligent Promising.
contactPoints   string N Punti di contatto perElasticsearch . SecreateDevInstance non è abilitato perElasticsearch , PoicontactPoints è obbligatorio. SeElasticsearch è esterno su SSL, quindi aggiungi i certificati al truststore. Per ulteriori informazioni, vedere Parametro di sicurezza.
Nota: non includere http o https nella tua istanza contactPoints .
replicationEnabled No booleano N Specificare questa proprietà per abilitare o disabilitare la replica dei dati di Elasticsearch per la configurazione multicluster.

kafka parametro

Proprietà Valore predefinito Tipo di valore Obbligatorio Descrizione
contactPoints   stringa N Punti di contatto perKafka . SecreateDevInstance non è abilitato perKafka , PoicontactPoints è obbligatorio. SeKafka è esterno su SSL, quindi aggiungi i certificati al truststore. Per ulteriori informazioni, vedere Parametro di sicurezza.
Nota: non includere http o https nella tua istanza contactPoints .
topicPrefix sip stringa N Definire il prefisso che si vuole impostare per gli argomenti Kafka. Per ulteriori informazioni sugli argomenti di Kafka, vedere l' elenco degli argomenti di Kafka per i servizi.
mirrorTopicPrefix   stringa N Definire questo prefisso per identificare gli argomenti in mirroring aggiungendo un prefisso specificato ai loro nomi durante la replica. Questo prefisso è usato in Kafka MirrorMaker per etichettare gli argomenti replicati nei cluster di destinazione.
crossDCTopicPrefix   stringa N Definire questo prefisso per gli argomenti Kafka in altri centri dati. Se non viene specificato, topicPrefix viene utilizzato per gli argomenti speculari.
createDevInstance   object N Specifica le risorse e l'archiviazione per Kafka. Imposta questo oggetto solo quando stai distribuendo l'istanza di sviluppo di Kafka. Se createDevInstance è abilitato per Kafka, contactPoints non è richiesto. Per ulteriori informazioni, vederecreateDevInstance parametro .
Nota:
  • Questo distribuisce Kafka solo in modalità non SSL.
  • kafka.createDevInstance estrae l'immagine richiesta dal repository pubblico. Quindi, se stai distribuendo IBM Sterling Intelligent Promising in un cluster che non ha accesso a Internet, ti consigliamo di utilizzare la tua propria istanza di Kafka.
  • Assicurarsi di creare l'argomento {topic_prefix}-iv-supply-sync prima di avviare Sync Supply API. Eseguire il seguente comando per creare l'argomento:
    ./kafka-topics.sh --bootstrap-server <hostname>:<port> --create --topic {topicPrefix}-inventory-supply-sync --partitions 1 --replication-factor 1
Deprecated featurezookeeperContactPoints   stringa N Punti di contatto per Zookeeper.
Nota: non includere http o https nella tua istanza contactPoints .
loggingContactPoints   stringa N Se stai utilizzando un appender Log4j2 Kafka , per la registrazione, specifica loggingContactPoints. Per impostazione predefinita, kafka.contactPoints viene considerato per eseguire il push dei log a un argomento Kafka .

Per ulteriori informazioni su Log4j2 Kafka appender, vedere il parametro log.

createDevInstance parametro

Proprietà Valore predefinito Tipo di valore Obbligatorio Descrizione
affinityAndTolerations stringa N Utilizzare il nome del affinityAndTolerations definito in SIPEnvironment.
resources   oggetto N Specificare i limiti e le richieste di risorse di memoria e CPU. Per ulteriori informazioni, vedere Gestione delle risorse per pod e container.
storage   oggetto N Specifica il volume persistente per l'archiviazione. Per ulteriori informazioni, vedere il parametro di memorizzazione.

configuration parametro

Proprietà Valore predefinito Tipo di valore Obbligatorio Descrizione
ssl_cassandra_disable "falso" stringa N Se sono stati specificati dei punti di contatto per un'istanza Cassandra che si trova su un server non SSL, configurare questa proprietà su "true".
ssl_kafka_disable "falso" stringa N Se sono stati specificati dei punti di contatto per un'istanza Kafka che si trova su un server non SSL, configurare questa proprietà su "true".
ssl_elasticsearch_disable "falso" stringa N Se sono stati specificati punti di contatto per un'istanza Elasticsearch che si trova su un server non SSL, configurare questa proprietà su "true".
ssl_Logging_kafka_disable "falso" stringa N Se hai specificato loggingContactPoints per un'istanza Kafka di registrazione non SSL, configura questa proprietà su "true".

Annotazioni utilizzate per convalidare le connessioni a servizi esterni

Per impostazione predefinita, l'Operatore non controlla le connessioni dei servizi esterni. Impostare le seguenti annotazioni per convalidare o saltare il controllo della connessione delle istanze esterne prima della distribuzione.
Annotazione Descrizione
apps.sip.ibm.com/validate-external-services-connections Impostare questa annotazione su true per attivare un lavoro. L'operatore attiva il lavoro per verificare le connessioni delle istanze esterne per gli ambienti di sviluppo e di produzione. Se una connessione fallisce, il processo si arresta e la gestione degli errori garantisce che gli errori siano registrati nei log del pod, consentendo un debug accurato.
apps.sip.ibm.com/skip-external-services-connection-validation Impostare questa annotazione a true per saltare una connessione fallita.

Passare i valori separati da virgole per i servizi esterni di cui si vuole saltare la verifica della connettività. I valori validi sono cassandra, kafka, elasticsearch, kafka-logging.

Se si sceglie di inviare i registri a un Kafka separato, l'annotazione controlla la connettività di questo Kafka.

Esempio: La seguente annotazione salta il controllo della connessione per Cassandra e Kafka.

apps.sip.ibm.com/skip-external-services-connection-validation:`cassandra, kafka`

Controlli di pre-connettività per l'implementazione di Sterling Intelligent Promising e Optimizer
Dopo aver distribuito Sterling Intelligent Promising, viene eseguito il lavoro sip-pre-connectivity-check che controlla le connessioni per Cassandra, Elasticsearch e Kafka. Se si sceglie di distribuire l'ottimizzatore in modalità indipendente e lo si imposta per attivare il lavoro sip-optimizer-pre-connectivity-check , esso controlla le connessioni per Elasticsearch e Kafka.