Criando Hub de pedidos de próxima geração aplicativos usando um monorepo

O uso de uma estratégia Angular monorepo usa Lerna para hospedar vários aplicativos em um único repositório. Essa configuração fornece meios para reutilizar o código, compartilhar entre aplicativos sem precisar duplicar o código ou criar repositórios de bibliotecas e compilações menores por rota, o que economiza tempo. A estratégia monorepo é usada por todos IBM® oferecido Centro de pedidos repositórios. Esta estratégia fornece uma abordagem de personalização limpa, onde você pode personalizar rotas em um ambiente existente. IBM repositório sem assumir todas as rotas inalteradas.

1. Extraia o Hub de pedidos de próxima geração código. Para mais informações, veja Introdução à personalização Hub de pedidos de próxima geração.
   Observação: O parâmetro de versão para oom-compose.sh extract-orderhub-code comando deve seroms para extrair o Hub de pedidos de próxima geração código. O parâmetro de versãoomoc não é aplicável a Hub de pedidos de próxima geração.
2. Abra um console e vá para o Hub de pedidos de próxima geração diretório de código. O local padrão édevtoolkit_docker/orderhub-code .
3. Para ignorar a verificação SSL para interações com registros, defina strict-ssl como falso executando o seguinte comando.

   npm config set "strict-ssl" false

4. Execute um dos comandos a seguir para reinstalar a versão mais recente do @buc/schematics e acessar os esquemas fornecidos pelo IBM. Para o Angular v18, execute o seguinte comando.

npm uninstall -g @buc/schematics
npm install -g ./lib/buc/schematics/schematics-v4latest.tgz

npm uninstall -g @buc/schematics
npm install -g ./lib/buc/schematics/schematics-v5latest.tgz

5. Crie uma pasta para seu novo aplicativo. O nome da pasta é o nome do módulo. Na pasta, crie umapp-config.json arquivo que descreve as rotas no módulo. O valor para nome deve ser o nome do módulo. Veja o exemplo a seguir.

{
  "name": "custom-monorepo",
  "devServerConfig": {
      "port": 9300,
      "contextRoot": "/custom-monorepo"
  },
  "prodServerConfig": {
      "hostName": "static.omsbusinessusercontrols.ibm.com"
  },
  "routes": {
      "custom-page1": {
          "devServerConfig": {
              "port": 9301,
              "contextRoot": "/custom-page1"
          }
      },
      "custom-page2": {
          "devServerConfig": {
              "port": 9302,
              "contextRoot": "/custom-page2"
          }
      }
  }
}

6. No console, vá para a pasta que você criou.
7. Crie um espaço de trabalho e inicialize um novo aplicativo Angular executando o comando a seguir.

ng new --collection=@buc/schematics \
--app-config-json=<app-config.json-file-name> \
--module-short-name=<short-name-for-the-module> \
--prefix=<selector-prefix> \
--mode=on-prem

--skip-git

Esta opção não inicializa um GitHub repositório. O padrão é false.

--commit

Esta opção inclui o inicial GitHub informações de commit do repositório. O padrão é true.

--app-config-json

Esta opção é obrigatória. Use oapp-config.json arquivo que você criou na etapa 5.

--module-short-name

O nome abreviado do módulo. Se o nome do módulo tiver travessões, o nome abreviado deverá ser o texto após o último travessão. Por exemplo, se o nome do módulo for configurações do aplicativo buc, o nome abreviado do módulo deve ser configurações.

Nota: O pacote root-config é gerado com base no module-short-name. Não renomeie nem adicione um prefixo ao module-short-name ou você não conseguirá implementar as personalizações.

--prefix

O seletor HTML a ser usado para componentes gerados. O padrão é cara.

--shared-library-name

O nome da biblioteca compartilhada. O nome padrão é<module-short-name>-shared . O nome do pacote é @<prefixo>/<module-short-name>-compartilhado.

--generate-root-config

Indica se deve ser gerado um projeto de roteador root-config. O padrão é true.

--skip-install

Indica se os pacotes devem ser instalados. O padrão é false.

--mode

Defina esta opção como local para gerar código que seja aplicável para Hub de pedidos de próxima geração.

Veja o exemplo a seguir.

ng new --collection=@buc/schematics  --app-config-json=app-config.json
      --module-short-name=monorepo  --prefix=monorepo --mode=on-prem

Erro: Falha ao compilar o ponto de entrada @carbon/icons-angular/

8. Se Hub de pedidos de próxima geração contêineres não estão em execução no momento, vá para odevtoolkit_docker/compose diretório e execute o seguinte comando.

./om-compose.sh start orderhub

9. Crie a versão de desenvolvimento local dofeatures.json arquivo. Para obter mais informações, consulte Criação dos arquivos features.json.
10. Para testar seu novo aplicativo localmente, copie o arquivofeatures.json arquivo noom-orderhub-base contêiner executando os seguintes comandos.

docker exec om-orderhub-base bash -c 'mkdir -p /opt/app-root/src/shell-ui/assets/custom'

docker cp <orderhub-code>/shell-ui/assets/dev/. om-orderhub-base:/opt/app-root/src/shell-ui/assets/custom/

11. Inicie o servidor digitando o seguinte comando.

yarn start-app

"** Angular Live Development Server está escutando em localhost:<porta>, 
abra seu navegador em https://localhost:<porta>/<módulo>/<rota> **"

O comando de erro falhou com o código existente 134.
lerna ERRA! início da corrida do fio.... saiu 134

12. Para aceitar o certificado autoassinado no navegador da web, em um navegador, abra uma guia parahttps://localhost:9300 e aceite o certificado. O Porto 9300 é o valor usado emdevServerConfig noapp-config.json arquivo.

13. Começar Hub de pedidos de próxima geração abrindo uma guia em um navegador parahttps://localhost:7443/order-management .
    Observação: A porta padrão é 7443. Se você definir oOH_BASE_HTTPS_PORT propriedade nodevtoolkit_docker/compose/om-compose.properties arquivo, use esse número de porta.
14. Clique no seu novo item de menu na navegação do menu esquerdo.