Implantação automatizada do Z Understand and Refactor no IBM Software Hub

Esta seção descreve o processo de implantação automatizada do Z Understand and Refactor no site IBM Software Hub.

Observação: esta seção se aplica à versão 5.4 Patch 3 e versões posteriores.

Pré-requisitos

Antes de começar, cumpra os seguintes pré-requisitos:

  • Instalar a CLI do OpenShift (oc)
  • Implantar namespace com o WCA4Z Entenda

Procedimento

  1. Faça login em OpenShift
    oc login --token=<your-token> --server=<your-server-url>
  2. Definir namespace
    export namespace=<namespace>
  3. Extraia o script de implantação. Ele está armazenado no ` wca-z-understand-scriptsConfigMap `.
    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

Comandos

O post-deploy-setup.sh script suporta os seguintes comandos:

Comando Descrição
implementar-compreender Cria rotas, aplica patches no recurso personalizado (CR) e exporta arquivos de configuração do banco de dados.
configurar-compreender Importa a configuração do banco de dados e executa o script de configuração.
configurar-refatorar Configura a integração com o Refactor, incluindo os segredos e certificados necessários.
criar-espaço-de-implantação Cria o espaço de implantação do CPD ( Cloud Pak for Data ) e as conexões de ativos necessárias por meio das APIs do CPD.
validar Verifica a implantação e a configuração.
status Exibe informações sobre o status do pod e a disponibilidade do contêiner.

Fluxo de trabalho

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

Resolução de problemas

Script de implantação não encontrado
  • Verifique se o arquivo ` ConfigMap ` existe
    oc get configmap wca-z-understand-scripts -n $NAMESPACE

    Isso confirma se o wca-z-understand-scriptsConfigMap está presente no namespace.

  • Listar o conteúdo de “ ConfigMap ”
    oc get configmap wca-z-understand-scripts -n $NAMESPACE -o jsonpath='{.data}' | jq 'keys'

    Verifique se post-deploy-setup.sh está listado entre as chaves de ` ConfigMap `.

  • Verifique o site ConfigMap
    oc describe configmap wca-z-understand-scripts -n $NAMESPACE

    Verifique se o conteúdo do script está preenchido corretamente.

Erros de permissão
  • Verificar permissões para criação de rotas
    oc auth can-i create routes -n $NAMESPACE

    Isso confirma se é possível criar rotas d OpenShift.

  • Verificar as permissões de aplicação de patches no CR
    oc auth can-i patch understandagentorchestrators -n $NAMESPACE

    Isso confirma se é possível aplicar um patch no UnderstandAgentOrchestrator Recurso Personalizado.

  • Verificar as permissões para criação de segredos
    oc auth can-i create secret -n $NAMESPACE

    Certifique-se de que a conta do usuário tenha as permissões necessárias antes de executar o script de implantação.

Os pods não iniciam
  • Verificar os registros do pod
    oc logs -n $NAMESPACE -l app=ibm-wca-z-understand

    Procure por erros como falhas na conexão com o banco de dados, ausência de segredos ou loops de travamento.

  • Aumentar o tempo limite de inicialização

    Se a inicialização demorar mais do que o esperado, aumente o valor do tempo limite:

    ./post-deploy-setup.sh -n $NAMESPACE deploy-understand -t 600
  • Inspecionar eventos do pod
    oc describe pod -n $NAMESPACE <pod-name>

    Verifique a seção de eventos para identificar problemas de agendamento, erros na obtenção de imagens ou problemas relacionados ao RBAC.

  • Verificar o ` ConfigMaps ` e os segredos

    Verifique se os wca-z-understand-scripts arquivos ` ConfigMap ` e wca-z-understand-setup `secret` existem e contêm dados válidos:

    oc get configmap wca-z-understand-scripts -n $NAMESPACE
oc get secret wca-z-understand-setup -n $NAMESPACE
As alterações de configuração não são sincronizadas
  • Verificar tempo limite de sincronização

    O script aguarda até dois minutos para que as alterações de configuração sejam sincronizadas. Se ocorrer um tempo limite, verifique 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/

    Verifique se o arquivo JSON de configuração existe no contêiner.

  • Verificar o conteúdo do segredo

    Verifique se o JSON de configuração foi importado corretamente para o segredo:

    oc get secret wca-z-understand-setup -n $NAMESPACE -o jsonpath='{.data}' | jq 'keys'
  • Analisar os logs do contêiner
    oc logs -n $NAMESPACE $POD_NAME -c wca4z-understand

    Verifique se há erros de configuração ou sincronização.

Problemas de reconfiguração
  • Exclua o recurso customizado:
    oc delete understandagentorchestrator -n $NAMESPACE <cr-name>
  • Recrie os segredos usando o arquivo JSON de configuração:
    ./post-deploy-setup.sh -n $NAMESPACE configure-understand -d sqlserver -f setup-sqlserver.json
  • Verifique o conteúdo dos segredos antes de executar novamente a configuração:
    oc get secret wca-z-understand-setup -n $NAMESPACE -o jsonpath='{.data}' | jq 'keys'
  • Verifique as permissões:
    oc auth can-i create secret -n $NAMESPACE
    Certifique-se de que o usuário tenha permissão para criar e atualizar segredos antes de executar novamente o processo de configuração.