Despliegue de nuevas aplicaciones

Despliegue nuevas aplicaciones para que otros usuarios puedan utilizar la aplicación. Este procedimiento explica cómo desplegar aplicaciones desde la estación de trabajo local.

Para desplegar personalizaciones en una aplicación existente, consulte Despliegue de personalizaciones para aplicaciones existentes.

Nota: Este tema sólo es aplicable a la versión de SaaS de Order Hub .

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 /< module-name>/< route-name> que ha definido en el archivo app-config.json. Empiece con una barra inclinada (/). No es necesario incluir una barra inclinada final.
  
  Por ejemplo, /custom-app/custom-page1.
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.
En cada ruta, para cada entorno en el que desee desplegar personalizaciones, añada un destino de compilación para crear sus 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/",
```

Añadir destinos de compilación al archivo package.json root-config.

Abra la carpeta de configuración raíz de devtoolkit_docker/orderhub-code/<custom-module-name>/<custom-short-name>-root-config/package.json .

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/",

Ejecute el mandato siguiente para crear el paquete de personalización para cada entorno de destino.
```
yarn build-<env>
```
Por ejemplo:
- Para compilar para el entorno de dev1 :
```
yarn build-dev1
```
- Para compilar para el entorno de qa3 :
```
yarn build-qa3
```
Ejecute el mandato siguiente para publicar las personalizaciones en el entorno de destino.
El entorno de destino está determinado por client-id y client-secret. Cada entorno tiene un par de id-secreto de cliente exclusivo.
```
yarn orderhub-cli publish-customization --client-id=<clientId> --client-secret=<clientSecret> --package-name=<module-name>
```
Required Parameters:
- --client-id -El ID de cliente de personalización. Para obtener más información sobre cómo obtener el ID y el secreto, consulte Habilitación del menú de personalización para un arrendatario.
- --client-secret -El secreto de cliente de personalización.
- --package-name -La carpeta de módulo bajo el directorio de compilación que contiene los archivos a cargar. Este valor corresponde al nombre del módulo, como por ejemplo custom-app.
Optional Parameters:
- --orderhub-hostname -El nombre de host del servidor de API de Order Hub. El valor predeterminado es app.omsbusinessusercontrols.ibm.com.
- --proxy-host -El nombre de host y el puerto del proxy en caso de que la máquina de compilación no tenga acceso a orderhub-hostname directamente.
- --package-only -Indica si se debe crear sólo el zip del activo de personalización. El valor predeterminado es false
- --publish-only -Indica si se debe cargar un paquete de personalización precompilado. El valor predeterminado es false. Si se establece en true, también debe especificar el paquete a publicar utilizando el parámetro -- package-name . Para -- package-name, especifique la vía de acceso a <build-dir>/<package-name>.zip. Por ejemplo:
```
--publish-only=true --package-name=./dist/custom-app.zip
```
- --build-dir -El directorio que contiene el activo de personalización compilado. El valor predeterminado es dist
Nota: las configuraciones del menú personalizado tendrán prioridad sobre el despliegue. Si ha realizado cambios en la pantalla de menú personalizada para una característica desplegada, suprima el elemento de menú para volver a lo que se ha publicado.

Qué hacer a continuación

Creando personalizaciones. Para obtener más información, consulte Creación de las personalizaciones.