Distribuzione automatizzata di Z Understand e Refactor su IBM Software Hub

Questa sezione descrive il processo di implementazione automatizzata di Z Understand e Refactor su IBM Software Hub.

Nota: questa sezione si applica alla versione 5.4, Patch 3 e successive.

Prerequisiti

Prima di iniziare, completa i seguenti requisiti:

  • Installa la CLI di OpenShift (oc)
  • Distribuire lo spazio dei nomi con WCA4Z Capire

Procedura

  1. Accedi a OpenShift
    oc login --token=<your-token> --server=<your-server-url>
  2. Imposta spazio dei nomi
    export namespace=<namespace>
  3. Estrai lo script di distribuzione. È archiviato nel file wca-z-understand-scripts ` ConfigMap `.
    oc get configmap wca-z-understand-scripts -n $namespace \
  -o jsonpath='{.data.post-deploy-setup\.sh}' > post-deploy-setup.sh

chmod +x post-deploy-setup.sh

Comandi

Lo post-deploy-setup.sh script supporta i seguenti comandi:

Comando Descrizione
implementazione-comprensione Crea percorsi, applica le patch alla risorsa personalizzata (CR) ed esporta i file di configurazione del database.
configurazione-comprensione Importa la configurazione del database ed esegue lo script di configurazione.
configurazione-rifattorizzazione Configura l'integrazione con Refactor, inclusi i segreti e i certificati necessari.
crea-spazio-di-distribuzione Crea lo spazio di distribuzione " Cloud Pak for Data " (CPD) e le connessioni alle risorse necessarie utilizzando le API CPD.
convalidare Verifica la distribuzione e la configurazione.
stato Visualizza lo stato dei pod e le informazioni sulla disponibilità dei container.

Flusso di lavoro

step 1: Deploy Z Understand
 ./post-deploy-setup.sh -n $namespace deploy-understand

Step 2: Edit the appropriate database configuration file
  vi setup-sqlserver.json (for SQL Server)
     or 
  vi setup-db2.json (for DB2)

Step 3: Import and apply database configuration
  ./post-deploy-setup.sh -n $namespace configure-understand -d sqlserver -f setup-sqlserver.json
     or
  ./post-deploy-setup.sh -n $namespace configure-understand -d db2 -f setup-db2.json

Step 4: Configure Refactor integration
 ./post-deploy-setup.sh -n $namespace configure-refactor

Step 5: Create the deployment space
 ./post-deploy-setup.sh -n $namespace -u <cpd_username> -p <cpd_password> create-deployment-space

Step 6: Validate the deployment
 ./post-deploy-setup.sh -n $namespace validate

Risoluzione dei problemi

Script di distribuzione non trovato
  • Verificare che esista il file “ ConfigMap ”
    oc get configmap wca-z-understand-scripts -n $NAMESPACE

    Questo verifica se il wca-z-understand-scripts nome " ConfigMap " è presente nello spazio dei nomi.

  • Elenca i contenuti di " ConfigMap "
    oc get configmap wca-z-understand-scripts -n $NAMESPACE -o jsonpath='{.data}' | jq 'keys'

    Verificare che post-deploy-setup.sh sia presente nell'elenco delle chiavi di ConfigMap.

  • Controlla l' ConfigMap
    oc describe configmap wca-z-understand-scripts -n $NAMESPACE

    Verificare che il contenuto dello script sia compilato correttamente.

Errori di autorizzazione
  • Verifica i permessi per la creazione di percorsi
    oc auth can-i create routes -n $NAMESPACE

    Questo permette di verificare se è possibile creare percorsi " OpenShift ".

  • Verifica i permessi di applicazione delle patch CR
    oc auth can-i patch understandagentorchestrators -n $NAMESPACE

    Questo permette di verificare se è possibile applicare una patch alla UnderstandAgentOrchestrator risorsa personalizzata.

  • Verifica i permessi per la creazione dei segreti
    oc auth can-i create secret -n $NAMESPACE

    Assicurarsi che l'account utente disponga delle autorizzazioni necessarie prima di eseguire lo script di distribuzione.

I pod non si avviano
  • Controlla i log dei pod
    oc logs -n $NAMESPACE -l app=ibm-wca-z-understand

    Cerca errori quali errori di connessione al database, chiavi segrete mancanti o cicli di crash.

  • Aumentare il timeout di avvio

    Se l'inizializzazione richiede più tempo del previsto, aumentare il valore del timeout:

    ./post-deploy-setup.sh -n $NAMESPACE deploy-understand -t 600
  • Controlla gli eventi dei pod
    oc describe pod -n $NAMESPACE <pod-name>

    Controlla la sezione "Eventi" per verificare eventuali problemi di pianificazione, errori di recupero delle immagini o problemi relativi al modello RBAC.

  • Verifica l' ConfigMaps e e le chiavi segrete

    Assicurarsi che wca-z-understand-scripts i file ` ConfigMap ` e wca-z-understand-setup `secret` esistano e contengano dati validi:

    oc get configmap wca-z-understand-scripts -n $NAMESPACE
oc get secret wca-z-understand-setup -n $NAMESPACE
Le modifiche alla configurazione non vengono sincronizzate
  • Verifica il timeout di sincronizzazione

    Lo script attende fino a due minuti affinché le modifiche alla configurazione vengano sincronizzate. Se scade il tempo di attesa, verificare manualmente:

    POD_NAME=$(oc get pods -n $NAMESPACE -l app=ibm-wca-z-understand -o jsonpath='{.items[0].metadata.name}')
oc exec -n $NAMESPACE $POD_NAME -c wca4z-understand -- ls -la /wca4z-understand/setup/

    Verifica che il file JSON di configurazione sia presente nel container.

  • Verifica il contenuto del segreto

    Assicurati che il file JSON di configurazione sia stato importato correttamente nel segreto:

    oc get secret wca-z-understand-setup -n $NAMESPACE -o jsonpath='{.data}' | jq 'keys'
  • Controllare i log del container
    oc logs -n $NAMESPACE $POD_NAME -c wca4z-understand

    Verificare la presenza di errori di configurazione o di sincronizzazione.

Problemi di riconfigurazione
  • Elimina la risorsa personalizzata:
    oc delete understandagentorchestrator -n $NAMESPACE <cr-name>
  • Ricrea i segreti utilizzando il file JSON di configurazione:
    ./post-deploy-setup.sh -n $NAMESPACE configure-understand -d sqlserver -f setup-sqlserver.json
  • Verificare il contenuto del segreto prima di rieseguire la configurazione:
    oc get secret wca-z-understand-setup -n $NAMESPACE -o jsonpath='{.data}' | jq 'keys'
  • Verifica le autorizzazioni:
    oc auth can-i create secret -n $NAMESPACE
    Assicurarsi che l'utente disponga dei permessi necessari per creare e aggiornare i segreti prima di rieseguire la procedura di configurazione.