Empaquetado de la personalización

En esta lección, empaquetará la personalización para prepararla para el despliegue. Puede empaquetar y desplegar su margen de beneficio relacionado con la personalización de los archivos en el entorno de producción con la herramienta de compilación y despliegue de HCL Commerce.

Por qué y cuándo se efectúa esta tarea

La herramienta de compilación y despliegue de HCL Commerce se ha diseñado para resolver el despliegue susceptible de errores y que requiere tiempo de los elementos personalizados. La herramienta proporciona un punto inicial para que se automaticen los procesos de compilación y despliegue de una forma estandarizada y controlada. Para obtener más información, consulte Empaquetado del código personalizado para el despliegue.

Importante: El proceso de empaquetado y despliegue sustituye los archivos del servidor de destino de despliegue. Asegúrese de que no se elimine ni sustituya ninguna personalización anterior por los cambios de personalización que haya realizado en esta guía de aprendizaje.

Procedimiento

Prepare el paquete de origen tanto para la personalización del EAR de HCL Commerce como para la personalización del EAR de búsqueda de HCL Commerce.
  1. Paquete del EAR de HCL Commerce:
    1. Cree el repositorio de código fuente para que incluya los archivos del programa de utilidad de carga de datos y los paquetes de código del código de personalización del widget de recomendación de producto actualizado.
      1. Copie la carpeta WCDE_installdir\wcbd en una ubicación temporal, por ejemplo, en C:\.
      2. Cambie el nombre del directorio por wcbd-deploy-server-local-profit_margin_wc.

        En esta tarea, este directorio se conoce como el directorio wcbd_wc.

      3. Cree la siguiente estructura de directorios: wcbd_wc/source/workspace.
    2. Añada los archivos del programa de utilidad de carga de datos, que cargan los datos personalizados en el lado del servidor, en el repositorio de código fuente de la herramienta de compilación y despliegue de HCL Commerce.
      1. Cree la estructura de archivos wcbd_wc/source/workspace/dataload/dataload/common para los archivos del programa de utilidad de carga de datos.
      2. Añada los archivos del programa de utilidad de carga de datos correspondientes al widget personalizado en el repositorio de código fuente de la herramienta de compilación y despliegue. El nuevo directorio debe parecerse a la estructura siguiente en el directorio wcbd_wc/source/workspace/dataload/dataload/common:
        • dataload_cost_price directory
        • dataload_price_list directory
        • wc-dataload-env.xml archivo
        Los archivos dataload_cost_price y dataload_price_list deben incluir la lista de precios y los datos de precios de coste que haya cargado previamente. Para obtener más información sobre la creación de los archivos wc-dataload-env.xml, consulte Configurar los valores de entorno de carga de datos. Los valores de entorno de este archivo deben coincidir con los valores de entorno del entorno de destino donde esté desplegando la personalización.
    3. Copie todas las carpetas y archivos de personalización en el directorio wcbd_wc/source/workspace.
      1. Cree la estructura de directorios: wcbd_wc/source/workspace/Stores
      2. Copie los siguientes archivos desde el directorio workspace_dir/Stores al directorio wcbd_wc/source/workspace/Stores:
        • WebContent/widgetdir/com.ibm.commerce.store.widgets.CatalogEntryRecommendation/CatalogEntryRecommendation_Data.jspf
        • WebContent/widgetdir/Common/PriceDisplay/PriceDisplay_Data.jspf
        • WebContent/widgetdir/Common/PriceDisplay/PriceDisplay_UI.jspf
        El nuevo directorio debe parecerse a la estructura siguiente en el directorio wcbd_wc/source/workspace:
        • dataload directory
        • Stores directory
    El contenido de los elementos de wcbd_wc empaquetados puede parecerse al contenido del archivo de ejemplo siguiente.
  2. Consulte las siguientes propiedades de extracción de ejemplo y propiedades de compilación en el archivo comprimido de paquete de ejemplo:
    • build-local-search.properties
    • extract-local-search.properties
  3. Copie todo el proyecto de búsqueda personalizado en wcbd_wc\search\workspace
    Nota: Debe copiar todos los archivos bajo search-config-ext y search-logic-ext en esta carpeta. Se incluyen todos los archivos bajo estos dos proyectos.
  4. Copie el proyecto HCL Commerce personalizado en wcbd_wc\ts\workspace

    Copie las configuraciones de preproceso personalizadas en WC\xml\search\dataImport\v3\db2. En el ejemplo 1, copie c-dataimport-preprocess-custom.xml y wc-dataimport-preprocess-x-finalbuild.xml en W:\Build_Local_Repository\ts\workspace\ WC\xml\search\dataImport\v3\db2. Copie todos los archivos en el proyecto WebSphereCommerceServerExtensionsLogic para incluir todas las personalizaciones.

  5. Empaquete el código de personalización de búsqueda:
    ejecuciónwcbd_wc\wcbd>wcbd-ant.bat -buildfile wcbd-build.xml -Dbuild.label=test -Dbuild.type=local -Dapp.type=search
  6. Empaquete el código de personalización del servidor de transacciones:
    ejecuciónwcbd_wc\wcbd>wcbd-ant.bat -buildfile wcbd-build.xml -Dbuild.label=test -Dbuild.type=local -Dapp.type=ts

Resultados

Los paquetes se crean en el directorio wcbd_wc\wcbd\dist de la siguiente manera:
  • wcbd-deploy-server-local-search-search.zip
  • wcbd-deploy-server-local-ts.zip

El código de personalización de búsqueda en los ejemplos está incorporado en el paquetesearch-logic-ext.jar search-config-ext.jar

El código de personalización del servidor de transacciones en los ejemplos se crea como:
  • xml
  • ejb
  • WebSphereCommerceServerExtensionsLogic.jar

Qué hacer a continuación

Utilice su propia canalización CI/CD para crear el paquete de personalización en la imagen del Docker y desplegar en el entorno de ejecución.

Verifique el código de personalización en el entorno del Docker.
  1. Especifique el contenedor de búsqueda:
    1. Ejecute docker ps para verificar que los contenedores están en ejecución.
    2. Localice el nombre del contenedor de búsqueda en la columna NAMES.
    3. Inicie un shell bash al ejecutar el mandato docker exec -it search_container_name bash.
    La personalización aparece en el directorio /opt/WebSphere/Liberty/usr/servers/default/apps/search-ear.ear.
  2. Especifique el contenedor TS (transacción). La personalización aparece en el directorio /opt/WebSphere/AppServer/profiles/default/installedApps/localhost/ts.ear.