Propagace změn z testovacího do produkčního prostředí pomocí sady nástrojů OCE

Když vyvinete šablonu webu, můžete ji pomocí rozhraní příkazového řádku (CLI) sady nástrojů OCE Toolkit šířit z vývojového do testovacího a poté do produkčního prostředí na serverech služby Oracle Content Management.

Chcete-li šířit změny, můžete pomocí příkazů sady nástrojů vytvářet weby a provádět správu jejich životních cyklů na vývojových, testovacích a produkčních serverech. Změny webů můžete provádět ve vývojovém prostředí a propagovat tyto změny do testovacích a produkčních prostředí. Tento soubor nástrojů příkazového řádku můžete také začlenit do svých skriptovacích prostředí a provádět tak správu svých nasazení. S nástroji CLI lze publikovat nové položky, například materiály a komponenty, a rovněž aktualizace stávajícího obsahu.

Následující kroky ukazují, jak používat rozhraní příkazového řádku (CLI) sady nástrojů OCE Toolkit k šíření změn z vývojového do testovacího a poté do produkčního prostředí:

  1. Nastavte vývojové, testovací a produkční servery se stejným úložištěm a stejnou zásadou lokalizace.

    Chcete-li šířit změny z vývojového serveru na testovací server a poté na produkční server, je nutné na každém z těchto tří serverů nastavit úložiště se stejným názvem a stejnou zásadu lokalizace. Výchozí zásada lokalizace pro úložiště materiálů je en-US, ale můžete použít jinou, pokud bude stejná na všech třech serverech.

    Prostudujte si téma Nastavení úložišť materiálů.

  2. Registrujte své vývojové, testovací a produkční servery pomocí služby Oracle Content Management.

    Před šířením změn na web je nutné registrovat všechny tyto servery. K registraci serveru můžete použít příkaz cec register-server ze sady nástrojů OCE Toolkit:

    cec register-server <name>

    Zadejte následující volby příkazu:

    • -e <koncový bod> pro adresu URL serveru

    • -u <uživatel> a -p <heslo> pro připojení k serveru

    • -t <typ> pro nastavení typu serveru (nepovinná volba). Výchozí hodnota je pod_ec.

      Při připojování k zákazníkovi Oracle Content Management ve veřejném cloudu Oracle použijte pouze typ pod_ec.

    Například následující příkaz registruje server, který je zákazníkem ve veřejném cloudu Oracle:

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

    Další příkaz registruje samostatnou vývojovou instanci služby Oracle Content Management:

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

    Po registraci serveru služby Oracle Content Management můžete vypsat jeho obsah pomocí příkazu cec list ze sady nástrojů.

    Následující příkaz vypíše obsah vývojového serveru:

    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. Odešlete šablonu webu na svůj vývojový server a vytvořte web z této šablony.

    Můžete vytvořit šablonu webu pomocí příkazu cec create-template a poté ji odeslat na vývojový server. Následně můžete vytvořit web ze šablony pomocí příkazu cec create-site. Následující příkazy vytvoří a poté odešlou šablonu:

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

    Další příkaz vytvoří z odeslané šablony web s názvem blog:

    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. Publikujte web a uveďte jej do stavu online na svém vývojovém serveru.

    Vytvořený web můžete pomocí příkazu cec control-site publikovat a uvést do stavu online:

    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. Chcete-li přesunout web ze serveru DEV na server UAT, musíte jej zabalit. Modelem balení pro přesun webů mezi servery je šablona. Vytvořte novou šablonu z webu, který jste vytvořili na vývojovém serveru, a šablonu stáhněte.

    Příkaz cec create-template-from-site v následujícím příkladu vytvoří šablonu webu s názvem blog2 z webu blog.

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

    Stáhněte vytvořenou šablonu ze svého vývojového serveru pomocí příkazu 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. Odešlete šablonu, a vytvořte tak typy obsahu a mapy rozvržení obsahu.

    cec upload-template blog2 --server UAT
  7. Odešlete šablonu, ale vylučte z ní položky obsahu (šablonu obsahu).

    cec upload-template blog2 --server UAT -x

    Tento krok je nutné učinit z důvodu, že chcete vytvořit web s obsahem, který má stejné identifikátory GUID jako původní web. Když vytvoříte web ze šablony, která zahrnuje obsah, veškerý obsah na novém webu bude mít nové identifikátory GUID. Vzhledem k tomu, že chceme umožnit aktualizaci obsahu místo vytváření nového obsahu, je nutné vyloučit obsah ze šablony.

  8. Vytvořte web ze šablony.

    cec create-site blog -t blog2 -r r -l "en-US" -d "end-US" --server UAT
  9. Odešlete šablonu obsahu do kanálu a kolekce webu. Tuto operaci musíte provést, protože jste v kroku 7 vyloučili šablonu obsahu z šablony webu.

    cec upload-content blog2 -t -r r -c blog -l "blog site" --server UAT 
  10. Publikujte web a uveďte jej do stavu online na svém testovacím serveru.

    Pomocí příkazu cec control-site publikujte web a uveďte jej do stavu online:

    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. Pokud poté provedete změny svého webu blog na serveru DEV, můžete tyto změny šířit na web, který jste již vytvořili na serveru UAT.

  12. Vytvořte další šablonu ze svého webu, takže tato šablona bude obsahovat provedené změny.

    cec create-template-from-site blog3 -s blog --server DEV
  13. Stáhněte šablonu.

    cec download-template blog3 -s DEV
  14. Nahrajte šablonu a vytvořte z ní web k šíření změn do testovacího prostředí.

    cec upload-template blog3 -s UAT

    Tento příkaz vytvoří nebo aktualizuje veškeré komponenty a témata, které se změnily, ale vyloučí obsah.

  15. Nyní použitím příkazu update-site vyberte obsah a aktualizujte stránky.

    cec update-site blog -t blog3 - UAT

    Například:

    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. Zkontrolujte web a ověřte, že proběhlo šíření změn.

  17. Provedením stejných kroků, kterými jste přesunuli web ze serveru DEV na server UAT, přesuňte web ze serveru UAT na server PROD.

  18. Vytvořte web na svém produkčním serveru, uveďte jej do stavu online a ověřte provedené změny.

    Pomocí příkazu cec list můžete zobrazit obsah svého produkčního webu a zkontrolovat, že obsahuje změny, které jste provedli ve vývojovém prostředí. Můžete rovněž zkontrolovat web a ověřit, že proběhlo šíření změn do produkce.