Propagar Alterações de Teste para Produção com o Kit de Ferramentas do OCE

Após o desenvolvimento de um modelo de site, você pode usar a interface de linha de comando (CLI) do Kit de Ferramentas do OCE para propagar o modelo do desenvolvimento para teste e depois para produção nos servidores do Oracle Content Management.

Para propagar alterações, você pode usar os comandos do Kit de Ferramentas para criar sites e gerenciar seus ciclos de vida nos servidores de desenvolvimento, teste e produção. Você pode fazer alterações nos sites em um ambiente de desenvolvimento e propagá-las para ambientes de teste e produção. Pode também incorporar esse conjunto de utilitários de linha de comando nos ambientes de script para gerenciar implantações. Com os utilitários de CLI, é possível implantar novos itens, como ativos e componentes, bem como atualizações de conteúdo existente.

As seguintes etapas mostram como usar a CLI do Kit de Ferramentas do OCE para propagar suas alterações do desenvolvimento para o teste até a produção:

  1. Configure os servidores de desenvolvimento, teste e produção com a mesma política de repositório e localização.

    Para propagar as alterações de um servidor de desenvolvimento para um servidor de teste e, em seguida, para um servidor de produção, configure um repositório com o mesmo nome e a mesma política de localização para os três servidores. A política de localização padrão para o repositório de ativos está em inglês dos EUA, mas você pode usar outro idioma se for o mesmo nos três servidores.

    Consulte Configure Repositórios de Ativos.

  2. Registre seus servidores de desenvolvimento, teste e produção no Oracle Content Management.

    Antes de propagar as alterações para um site, registre cada um dos servidores. Você pode registrar um servidor com o comando cec register-server fornecido pelo Kit de Ferramentas do OCE:

    cec register-server <name>

    Especifique as seguintes opções de comando:

    • -e <endpoint> for the server URL

    • -u <user> e -p <password> para conexão com o servidor

    • -t <type>, que é opcional, para definir o tipo de servidor. O valor padrão é pod_ec.

      Ao estabelecer conexão com um tenant do Oracle Content Management no Oracle Public Cloud, use somente pod_ec.

    Por exemplo, o comando a seguir registra um servidor que é um tenant no Oracle Public Cloud:

    cec register-server DEV -e https://DEV.example.com -u user1 -p <password>
    

    O próximo comando registra uma instância de desenvolvimento independente do Oracle Content Management:

    cec register-server DEV -e https://DEV.git.oraclecorp.example.com -u user1 -p <password>

    Depois de registrar um servidor do Oracle Content Management, você pode listar conteúdo dele com o comando cec list do Kit de Ferramentas.

    O seguinte comando lista o conteúdo de um servidor de desenvolvimento:

    cec-compontents> cec list -s DEV
     - Logged in to remote server: <host:port>
    Channels:
      Name                           Token
      StarterSite                    <site-id>
    
    Components:
      Name                           Type                       Published
      FooterBar                      Component group
      StarterComponent               Local component
      StarterFooter                  Component group
      StarterNavMenu                 Local component
    
    Localization policies:
      Name                           Required languages         Optional Languages
      en-US                          en-US
    
    Repositories:
      Name
      r
    
    Sites:                           Theme                      Type        Published   Online
      Name                           StarterSiteTheme           Enterprise
    
    Templates:
      Name                           Theme                      Type
      StarterTemplate                StarterTheme               Standard
  3. Faça upload de um modelo de site para o servidor de desenvolvimento e crie um site com base no modelo.

    Você pode criar um modelo de site com o comando cec create-template e depois fazer upload do modelo para o servidor de desenvolvimento. Em seguida, poderá criar um site usando o modelo com o comando cec create-site. Os seguintes comandos criam um modelo e fazem upload dele:

    - cec create-template blog -f BlogTemplate
    - cec upload-template blog -s DEV

    O próximo comando cria um site chamado blog com base no modelo de upload:

    cec-components> cec create-site blog -t blog -r r -l "en-US" -d "en-US" --server DEV
     - Logged in to remote server: <https:<host:<port>
     - establish user session
     - get template
     - get repository
     - get localization policy
     - creating enterprise site . . .
       name                 blog
       template             blog
       site prefix          blog
       repository           r
       localization policy  en-US
       default language     en-US
     - submit create site site
     - create site in process: percentage 95
     - create site in process: percentage 95
     - create site in process: percentage 95
     - create site in process: percentage 95
     - create site in process: percentage 95
     - site created
  4. Publique o site e coloque-o on-line no servidor de desenvolvimento.

    Depois de criar um site, você pode usar o comando cec control-site para publicá-lo e colocá-lo on-line:

    cec-components> cec control-site
    Usage: cec contrl-site <action>
    Perform <action> on site in CEC server. Specify the site with -s <site> Specify the server with -r <server>.
    
      publish
      unpublish
      bring-online
      take-offline
    
    Options: 
      --site, -s    <site> Site
      --server, -r  <server> The registered CEC server
      --help, -h    Show help
    
    Examples:
      cec control-site publish -s Site1              Publish site Site1 on the server
      cec control-site publish -s Site1 -r UAT       Publish site Site1 on the registered server UAT
      cec control-site unpublish -s Site1 -r UAT     Inpublish site Site1 on the registered server UAT
      cec control-site bring-online -s Site1 -r UAT  Bring site Site1 online on the registered server UAT
      cec control-site take-offline -s Site1 -r UAT  Take site Site1 offline on the registered server UAT
    
    Not enough non-option arguments: got 0, need at least 1
    cec-components> cec control-site publish --site blog --server DEV
     - Logged in to the remote server: https://<host>:<port>
     - establish user session
     - get site: runtimeStatus: offline publishStatus: unpublished
     - submit publish site
     - publish in process: percentage 20
     - publish in process: percentage 40
     - publish in process: percentage 49
     - publish in process: percentage 49
     - publish in process: percentage 50
     - publish in process: percentage 50
    
  5. Para mover um site de DEV para UAT, crie o pacote do site. O tipo de pacote para mover os sites entre os servidores é o modelo. Crie um novo modelo com base no site que você criou no servidor de desenvolvimento e faça download do modelo.

    O comando cec create-template-from-site no exemplo a seguir cria um modelo de site chamado blog2 com base no blog.

    cec create-template-from-site blog2 -s blog

    Faça download do modelo que você criou utilizando o site de desenvolvimento com o comando cec download-template:

    cec-components: cec download-template blog2 --server DEV
     - Logged in to remote server: https://<host>:<port>
     - establish user session
     - export template
     - template download to /Users/<user-name>/devenv/git/webclient/developer/sites-toolkit/cec-components/dist/blog2.zip
     - the template will be at /Users/<user-name>/devenv/git/webclient/developer/sites-toolkit/cec-components/src/main/templates/blog2
     - the theme for the template will be at /Users/<user-name>/devenv/git/webclient/developer/sites-toolkit/cec-components/src/main/themes/blogTheme
     - create link _scs_theme_root_
     - create link _scs_design_name_
     - override component /Users/<user-name>devenv/git/webclient/developer/sites-toolkit/cec-components/src/main/components/Starter-Blog-Author-Summary
     - override component /Users/<user-name>devenv/git/webclient/developer/sites-toolkit/cec-components/src/main/components/Starter-Blog-Post-Content
     - override component /Users/<user-name>devenv/git/webclient/developer/sites-toolkit/cec-components/src/main/components/Starter-Blog-Post-Header
     - override component /Users/<user-name>devenv/git/webclient/developer/sites-toolkit/cec-components/src/main/components/Starter-Blog-Post-Search-Result
     - override component /Users/<user-name>devenv/git/webclient/developer/sites-toolkit/cec-components/src/main/components/Starter-Blog-Post-Post-Sidebar
     - override component /Users/<user-name>devenv/git/webclient/developer/sites-toolkit/cec-components/src/main/components/Starter-Blog-Post-Summary
     - set themeName to blogTheme in siteinfo.json
     - unzip tmplate content file
     *** template is ready to test: https://localhost:8085/templates/blog2
    cec upload-template blog2 --server UAT
  6. Faça upload do modelo para criar os tipos de conteúdo e os mapas de layout de conteúdo.

    cec upload-template blog2 --server UAT
  7. Faça upload do modelo, mas exclua os itens de conteúdo (modelo de conteúdo) do modelo.

    cec upload-template blog2 --server UAT -x

    Você quer fazer isso para criar um site com conteúdo que tenha os mesmos GUIDs do site original. Ao criar um site com base em um modelo que tem conteúdo, todo o conteúdo do novo site terá novos GUIDs. Como queremos permitir a atualização do conteúdo em vez de criar um novo, exclua o conteúdo do modelo.

  8. Crie o site usando o modelo.

    cec create-site blog -t blog2 -r r -l "en-US" -d "end-US" --server UAT
  9. Faça upload do modelo de conteúdo para o canal e a coleção do site. Você precisará fazer isso porque o excluiu do modelo na etapa 7.

    cec upload-content blog2 -t -r r -c blog -l "blog site" --server UAT 
  10. Publique o site e coloque-o on-line no servidor de teste.

    Use o comando cec control-site para publicá-lo e colocá-lo on-line:

    cec-components> cec control-site publish --site blog --server UAT
     - Logged in to the remote server: https://<host>:<port>
     - establish user session
     - get site: runtimeStatus: offline publishStatus: unpublished
     - submit publish site
     - publish in process: percentage 20
     - publish in process: percentage 40
     - publish in process: percentage 49
     - publish in process: percentage 49
     - publish in process: percentage 50
     - publish in process: percentage 50
     - publish blob finished
  11. Se você depois fizer alterações no site blog, no servidor DEV, poderá propagar as alterações para o site que já tiver criado no servidor UAT.

  12. Crie outro modelo com base no seu site para que ele tenha suas alterações.

    cec create-template-from-site blog3 -s blog --server DEV
  13. Faça download do modelo.

    cec download-template blog3 -s DEV
  14. Faça upload do modelo e crie um site com base nele para propagar as alterações para o ambiente de teste.

    cec upload-template blog3 -s UAT

    Esse comando cria ou atualiza qualquer componente e tema que foi alterado, mas exclui o conteúdo.

  15. Agora use o comando update-site para selecionar o conteúdo e atualizar as páginas.

    cec update-site blog -t blog3 - UAT

    Por exemplo:

    cec-components> cec update-site blog -t blog3 --server UAT
    Updating site: blog3
     - Logged in to remote server: https://<host>:<port>
     - pages               : updating file# 6    of 6    files
     - content             : updating file# 3    of 3    files
     - System Files        : updating file# 5    of 5    files
     - controller          : no files in update, removing files on server
     - favicons            : no files in update, removing files on server
     - misc                : no files in update, removing files on server
     - seo                 : no files in update, removing files on server
     - system              : no files in update, removing files on server
     - created content file /Users/<user-name>/devenv/git/webclient/developer/sites-toolkit/cec-compnents/dist/blog3_export.zip
     - upload content file
     - get CSRF token
     - submit import job, updating content
     - import job in progress. . .
     - import job in progress. . .
     - import job in progress. . .
     - content imported:
    Update Site Results:
     - Site Pages          : completed with 0 errors.
     - Embedded Content    : completed with 0 errors.
     - System Files        : completed with 0 errors.
     - Settings Files      : completed with 0 errors.
     - Content Update      : completed with 0 errors.
  16. Verifique o site para confirmar se as alterações foram propagadas.

  17. Execute as mesmas etapas para mover do servidor UAT para o servidor PROD como você fez para mover o site de DEV para UAT.

  18. Crie o site no servidor de produção, coloque-o on-line e verifique as alterações.

    Você pode usar o comando cec list para exibir o conteúdo do site de produção e certificar-se de que ele inclua as alterações feitas no ambiente de desenvolvimento. Além disso, você pode verificar o site para confirmar se as alterações foram propagadas para produção.