Preparación para desplegar nuevas aplicaciones

Antes de poder desplegar nuevas aplicaciones (como devtoolkit_docker/orderhub-code/my-custom-app), debe indicar qué aplicaciones se deben desplegar. Por ejemplo, puede estar trabajando en dos nuevas aplicaciones, pero es posible que desee desplegar sólo una.

Para desplegar personalizaciones para aplicaciones existentes, consulte Preparación para desplegar personalizaciones para aplicaciones existentes.

Procedimiento

Recupere Customization folder, Customization client ID, Customization auth key para cada uno de los arrendatarios donde desea desplegar las personalizaciones.

Es posible que tenga que ponerse en contacto con un administrador para obtener el Customization auth key si los arrendatarios ya están configurados para la personalización. Para obtener más información, consulte Habilitación del menú de personalización para un arrendatario.
Recupere el valor JSON de característica de Order Hub.
1. Inicie sesión en Order Hub.
2. Cambie al arrendatario de personalización donde ha probado las personalizaciones.
3. Vaya a Valores > Personalización.
4. Seleccione el elemento de menú personalizado que inicia la aplicación personalizada.
5. Si desea desplegar personalizaciones en el arrendatario de personalización donde ha probado las personalizaciones, asegúrese de seleccionar Alojado por IBM y borrar Entorno de desarrollo local. De lo contrario, el arrendatario continuará conectándose al servidor local.
6. En el campo URL URL , añada la vía de acceso relativa a la aplicación.
  Para buscar la vía de acceso relativa, realice los pasos siguientes:
  1. Abra el archivo <custom-module-name>/packages/<module-short-name>-root-config/src/assets/routes.json .
  2. En el elemento redirects , busque la ruta a la que se redirige la aplicación.
  3. Abra el archivo <custom-module-name>/packages/<route-name>/src/app/features/<module-short-name>/<module-short-name>-routing.module.ts .
  4. Busque la < vía_acceso> a la que apunta la ruta. El valor predeterminado es home.
  5. El URL relativo final es:/< module-name>/< route-name>/< module-short-name>/< path>
  Empiece con una barra inclinada (/). No es necesario incluir una barra inclinada final. Por ejemplo, /custom-app/custom-page1/custom/home.
7. Guarde todos los cambios.
8. Copie el JSON del campo Feature json en la interfaz de usuario.
  El JSON de la interfaz de usuario se parece al ejemplo siguiente.
```
{
    "featureId": "custom-[Id]", // must be unique
    "state": "ACTIVE",
    "sequence": 0,
    "title": "[Title to display for the custom application]",
    "iconName": "website-20",
    "link": "/[module-name]/[path to new route]",
    "path": "/[path to new route]",
    "hidden": true,
    "allowedRoles": [   //the roles that can access this customization
      "Fulfillment Manager",
      "Tenant Administrator"
    ],
    "description": [
      {
        "locale": "en_US",
        "language": "en",
        "title": "Title to display for the custom feature"
      }
    ],
    "type": "IFRAME"
  }
```
Abra features.json en el directorio raíz del módulo.
Por ejemplo, devtoolkit_docker/orderhub-code/custom-app/features.json. Si el archivo no existe, cree el archivo.
Pegue el JSON que ha copiado del paso 2.h como elemento de matriz en el archivo features.json .
En función del contenido de features.json, es posible que tenga que rodear el código con corchetes [] para añadirlo como elemento de matriz.
Añada destinos de compilación para las personalizaciones, en función del tipo de repositorio que utilice.
-Si utiliza un monorepo Order Hub para sus personalizaciones:
1. En cada ruta, para cada entorno en el que desee desplegar personalizaciones, añada un destino de compilación para crear las personalizaciones.
  1. Abra el archivo package.json de cada ruta. Por ejemplo, devtoolkit_docker/orderhub-code/custom-app/packages/custom-page1/package.json y devtoolkit_docker/orderhub-code/custom-app/packages/custom-page2/package.json.
  2. Añada el siguiente mandato de destino de compilación para los entornos en los que desea desplegar las personalizaciones.
    "build-<env>": "yarn build --deploy-url=<customization folder>/<module-name>/<route-name>/",
    El valor de <customization folder> es el valor que ha recuperado del paso 1. Cada entorno de destino tiene un valor de carpeta de personalización diferente.
    Por ejemplo, si desea realizar el despliegue en cuatro entornos: dev1, qa3, preprody prod, añada el código siguiente.
    "build-dev1": "yarn build --deploy-url=/buc-app-customization/T3R4fagafd45aadfaffasf/custom-app/custom-page1/", "build-qa3": "yarn build --deploy-url=/buc-app-customization/dbU2K1u4seqrRKwBZTyMp1lUJwqQkJ5A/custom-app/custom-page1/", "build-preprod": "yarn build --deploy-url=/buc-app-customization/zdD4uxaf8GRTbzMSg8zU2K/custom-app/custom-page1/", "build-prod": "yarn build --deploy-url=/buc-app-customization/balohTK3ang5GmXsRwOSeSidbQOKEw6N/custom-app/custom-page1/",
2. Añada destinos de compilación al archivo package.json root-config.
  1. Abra la carpeta de configuración raíz devtoolkit_docker/orderhub-code/<custom-module-name>/<custom-short-name>-root-config/package.json .
  2. Para cada entorno en el que desee desplegar personalizaciones, añada destinos de compilación similares al código siguiente.
    "build-<env>": "yarn build --env baseHref=<customization folder>/<module-name>/ --env deploy-url=<customization folder>/<module-name>/<route-name>/",
    Donde < nombre-dirección> es la ruta predeterminada.
    Por ejemplo, si desea desplegar en cuatro entornos; dev1, qa3, preprody prod, añada un código similar al ejemplo siguiente:
    "build-dev1": "yarn build --env baseHref=/buc-app-customization/T3R4fagafd45aadfaffasf/custom-app --env deploy-url=/buc-app-customization/T3R4fagafd45aadfaffasf/custom-app/custom-page1/", "build-qa3": "yarn build --env baseHref=/buc-app-customization/dbU2K1u4seqrRKwBZTyMp1lUJwqQkJ5A/custom-app --env deploy-url=/buc-app-customization/dbU2K1u4seqrRKwBZTyMp1lUJwqQkJ5A/custom-app/custom-page1/", "build-preprod": "yarn build --env baseHref=/buc-app-customization/zdD4uxaf8GRTbzMSg8zU2K/custom-app --env deploy-url=/buc-app-customization/zdD4uxaf8GRTbzMSg8zU2K/custom-app/custom-page1/", "build-prod": "yarn build --env baseHref=/buc-app-customization/balohTK3ang5GmXsRwOSeSidbQOKEw6N/custom-app --env deploy-url=/buc-app-customization/balohTK3ang5GmXsRwOSeSidbQOKEw6N/custom-app/custom-page1/",
3. Para cada entorno en el que desee desplegar personalizaciones, añada un destino de compilación en el archivo <module-name>/package.json .
  1. Abra el archivo <custom-module-name>/package.json . Por ejemplo, custom-app/package.json.
  2. Haga una copia de la línea de compilación para cada entorno de destino.
    Por ejemplo, supongamos que desea desplegar en cuatro entornos: dev1, qa3, preprody prod. Pegue la línea cuatro veces.
    
    Sustituya build por build-<environment> en cada línea copiada. Por ejemplo:
    "build": "lerna run build --stream", "build-dev1": "lerna run build-dev1 --stream", "build-qa3": "lerna run build-qa3 --stream", "build-preprod": "lerna run build-preprod --stream", "build-prod": "lerna run build-prod --stream",
-Si utiliza un repositorio Angular básico de Order Hub para las personalizaciones:
Para cada entorno en el que desee desplegar personalizaciones, añada un destino de compilación en el archivo <module-name>/package.json .
1. Abra el archivo <module-name>/package.json . Por ejemplo, custom-app/package.json.
2. Haga una copia de la línea de compilación para cada entorno de destino.
  Por ejemplo, supongamos que desea desplegar en cuatro entornos: dev1, qa3, preprody prod. Pegue la línea cuatro veces.
  
  Sustituya build por build-<environment> en cada línea copiada y añada --deploy-url=<customization folder>/<module-name>/, donde el valor de <customization folder> es el valor que ha recuperado del paso 1.
  Cada entorno de destino tiene un valor de carpeta de personalización diferente. Por ejemplo:
  "build": "node --max_old_space_size=8192 ./node_modules/@angular/cli/bin/ng build --aot --configuration production", "build-dev1": "node --max_old_space_size=8192 ./node_modules/@angular/cli/bin/ng build --aot --configuration production --deploy-url=/buc-app-customization/T3R4fagafd45aadfaffasf/custom-app/", "build-qa3": "node --max_old_space_size=8192 ./node_modules/@angular/cli/bin/ng build --aot --configuration production --deploy-url=/buc-app-customization/dbU2K1u4seqrRKwBZTyMp1lUJwqQkJ5A/custom-app/", "build-preprod": "node --max_old_space_size=8192 ./node_modules/@angular/cli/bin/ng build --aot --configuration production --deploy-url=/buc-app-customization/zdD4uxaf8GRTbzMSg8zU2K/custom-app/", "build-prod": "node --max_old_space_size=8192 ./node_modules/@angular/cli/bin/ng build --aot --configuration production --deploy-url=/buc-app-customization/balohTK3ang5GmXsRwOSeSidbQOKEw6N/custom-app/",
Si utiliza un conducto CI/CD para desplegar personalizaciones, incorpore todos los cambios de personalización en el repositorio.

Qué hacer a continuación

Desplegar personalizaciones.

Si está desplegando aplicaciones personalizadas manualmente desde la estación de trabajo local, consulte Despliegue de nuevas aplicaciones.
Si desea configurar un conducto CI/CD para desplegar nuevas aplicaciones, consulte Despliegue de personalizaciones con un conducto CI/CD.