Implementando customizações com um pipeline CI/CD

Implementar customizações usando uma abordagem de integração contínua e entrega contínua (CI/CD).

Conclua as seguintes etapas para configurar uma máquina de construção com as ferramentas necessárias para construir e implementar customizações.

1. Instalar Docker.
   O Docker é usado para instalar os componentes e dependências necessários para configurar o contêiner Order Hub apenas. Você não desenvolve customizações do Order Hub no contêiner. Você desenvolve na estação de trabalho local.
2. Instale uma versão do Node.js compatível com o Angular v18 ou v20. Para obter mais informações, consulte a página do Angular Compatibilidade de versões. Se forem necessárias várias versões de nós, considere usar o nvm (para Mac ou Linux ) ou o nvm-windows (para Windows).
3. Instale Yarn.
4. Instale a CLI do Angular globalmente executando um dos seguintes comandos em um terminal.
   Para o Angular v18, execute o seguinte comando.

   npm install -g @angular/cli@18

   Para o Angular v20, execute o seguinte comando.

   npm install -g @angular/cli@20

5. Na máquina de construção, configure uma pasta de destino com o código-fonte Order Hub .
   É possível obter o código-fonte usando vários métodos Por exemplo,

   • Faça download do kit de ferramentas do desenvolvedor e extraia o código fonte. Para obter mais informações, consulte a etapa 6.j.
   • Tenha o arquivo tar do código de origem Order Hub (da versão que foi usada para executar a customização) disponível em um repositório. Em seguida, clone e extraia o arquivo tar para a sua máquina de construção

Configure pipelines para fazer download, empacotar e implementar customizações.

6. Faça download ou extraia todas as customizações de seu repositório.
7. Sobreponha as customizações na pasta de destino que inclui o código-fonte do Order Hub .
8. Recupere o Customization folder, Customization client ID, Customization auth key para cada um dos locatários nos quais você deseja implementar as customizações Para obter mais informações, consulte Ativação do menu de personalização para um locatário.
9. Configure os pipelines para empacotar as customizações
   Para cada aplicativo customizado, configure pipelines para executar o comando a seguir na pasta raiz do módulo aplicativo customizado (devtoolkit_docker/orderhub-code/<module-name>). Configure um pipeline para cada ambiente de destino no qual você deseja implementar as customizações Se você planeja implementar em 4 ambientes, configure 4 pipelines

   • Para implementar customizações para aplicativos existentes, configure pipelines para executar o seguinte comando. Passe os parâmetros build-target e customization-context-root correspondentes na chamada yarn a seguir.

     yarn package-customization --build-target=build-merged-<environment> --customization-context-root=<customization_folder>

     Por exemplo,
     • Para empacotar o módulo buc-app-order para implementação no ambiente do dev1 :

       c:\devtoolkit_docker\orderhub-code\buc-app-order> yarn package-customization --build-target=build-merged-dev1 --customization-context-root=/buc-app-customization/T3R4fagafd45aadfaffasf
       

     • Para empacotar o módulo buc-app-inventory para implementação no ambiente do qa3 :

       c:\devtoolkit_docker\orderhub-code\buc-app-inventory> yarn package-customization --build-target=build-merged-qa3 --customization-context-root=/buc-app-customization/dbU2K1u4seqrRKwBZTyMp1lUJwqQkJ5A
       

   • Para implementar novos aplicativos, configure os pipelines para executar o comando a seguir:

     yarn build-<env>

     Por exemplo,
     • Para empacotar o módulo my-custom-app1 para implementação no ambiente do dev1 :

       c:\devtoolkit_docker\orderhub-code\my-custom-app1> yarn build-dev1

     • Para empacotar o módulo special-custom-app2 para implementação no ambiente do qa3 :

       c:\devtoolkit_docker\orderhub-code\special-custom-app2> yarn build-qa3

10. Configure pipelines para implementar as customizações.
    Para cada aplicativo customizado, configure pipelines para executar o seguinte comando dentro da pasta raiz do módulo aplicativo customizado (devtoolkit_docker/orderhub-code/<module-name>. Configure um pipeline para cada ambiente de destino no qual você deseja implementar as customizações Se você planeja implementar em 4 ambientes, configure 4 pipelines O ambiente de destino é determinado pelo client-id e pelo client-secret Cada ambiente tem um par de ID de cliente-segredo exclusivo..

    yarn orderhub-cli publish-customization --client-id=<clientId> --client-secret=<clientSecret> --package-name=<module-name>

    Required Parameters:

    • --client-id -O ID do cliente de customização Para obter mais informações sobre como obter o ID e o segredo, consulte Ativação do menu de personalização para um locatário.
    • --client-secret -O segredo do cliente de customização
    • --package-name -A pasta do módulo sob o diretório de construção que contém os arquivos para fazer upload. Esse valor corresponde ao nome do módulo, como buc-app-order.

    Optional Parameters:

    • --orderhub-hostname -o nome do host para o servidor da API do Order Hub O padrão é app.omsbusinessusercontrols.ibm.com.
    • --proxy-host - O nome do host e a porta do proxy, caso o computador de compilação não tenha acesso direto a orderhub-hostname .
    • --package-only -Indica se o zip do ativo de customização deve ser construído apenas O padrão é false.
    • --publish-only -Indica se deve ser feito upload de um pacote de customização pré-construído O padrão é false. Se configurado como true, deve-se também especificar o pacote a ser publicado usando o parâmetro -- package-name Para -- package-name, especifique o caminho para <build-dir>/<package-name>.zip. Por exemplo,

      --publish-only=true --package-name=./dist/buc-app-order.zip

    • --build-dir -O diretório que contém o ativo de customização compilado O padrão é dist.