Módosítások terjesztése a fejlesztésből az éles környezetbe az OCE Toolkit segítségével

Webhelysablon kialakítása után az OCE Toolkit parancssori felületét (CLI) használhatja a sablon fejlesztési környezetből a tesztelési és az éles környezetbe való terjesztéséhez az Oracle Content Management kiszolgálóin.

A módosítások terjesztéséhez a Toolkit parancsait használhatja webhelyek létrehozásához és életciklusuk kezeléséhez a fejlesztési, tesztelési és éles környezeti kiszolgálókon. Változtatásokat hajthat végre a webhelyeken a fejlesztési környezetben, és ezeket a módosításokat továbbíthatja a tesztelési és az éles környezetbe. A parancssori segédprogramok ezen készletét a parancsfájlkezelési környezeteiben is alkalmazhatja a telepítések kezeléséhez. A CLI segédprogramjaival új elemeket alakíthat ki, például forrásanyagokat és összetevőket, valamint létrehozhatja ezeket meglévő tartalom frissítéseként is.

A következő lépések az OCE Toolkit parancssori felületének használatát mutatják be a módosítások terjesztéséhez a fejlesztési környezetből a tesztelési és az éles környezetbe:

  1. Állítson be fejlesztési, tesztelési és éles környezeti kiszolgálót ugyanazzal az adattárral és honosítási alapszabállyal.

    A módosítások fejlesztési kiszolgálóról tesztelési kiszolgálóra, majd éles környezeti kiszolgálóra terjesztéséhez azonos nevű és azonos honosítási alapszabállyal rendelkező adattárat kell beállítania mindhárom kiszolgálón. A forrásanyag-adattár alapértelmezett honosítási alapszabálya az en-US, de másikat használhat, ha ez azonos mindhárom kiszolgálón.

    Lásd: Forrásanyag-adattárak beállítása.

  2. Regisztrálja fejlesztési, tesztelési és éles környezeti kiszolgálóját az Oracle Content Management szolgáltatásban.

    A módosítások webhelyre való terjesztése előtt regisztrálnia kell mindegyik kiszolgálót. A kiszolgálókat az OCE Toolkit cec register-server parancsával regisztrálhatja:

    cec register-server <name>

    Adja meg a parancs következő beállításait:

    • -e <végpont> a kiszolgáló URL-címéhez

    • -u <felhasználó> és -p <jelszó> a kiszolgálóhoz való kapcsolódáshoz

    • -t <típus>, amely választható a kiszolgáló típusának beállításához. Az alapértelmezett érték pod_ec.

      Az Oracle Public Cloud rendszeren az Oracle Content Management bérlőjéhez való csatlakozáskor csak a pod_ec beállítást használja.

    Például a következő parancs olyan kiszolgálót regisztrál, amely az Oracle Public Cloud bérlője:

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

    A következő parancs az Oracle Content Management önálló fejlesztési példányát regisztrálja:

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

    Az Oracle Content Management kiszolgálójának regisztrálása után tartalmát listázhatja a Toolkit cec list parancsával.

    A következő parancsok egy fejlesztői kiszolgáló tartalmát sorolják fel:

    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. Töltsön fel egy webhelysablont fejlesztői kiszolgálójára, és hozzon létre webhelyet a sablonból.

    Webhelysablont létrehozhat a cec create-template paranccsal, majd azt feltöltheti a fejlesztői kiszolgálóra. Ezután webhelyet hozhat létre a sablonból a cec create-site paranccsal. A következő parancsok sablont hoznak létre, majd feltöltik a sablont:

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

    A következő parancs a blog nevű sablont hozza létre a feltöltött sablonból:

    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. Tegye közzé a webhelyet, és helyezze online állapotba a fejlesztői kiszolgálón.

    Webhely létrehozása után a cec control-site parancsot használhatja közzétételéhez és online állapotba helyezéséhez:

    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. Webhely DEV állapotból UAT környezetbe való áthelyezéséhez be kell csomagolnia a webhelyet. Webhelyek kiszolgálók közötti áthelyezésénél a csomagolási modell a sablon. Hozzon létre egy új sablont a fejlesztői kiszolgálón elkészített webhelyből, és töltse le a sablont.

    A cec create-template-from-site parancs a következő példában a blog2 nevű webhelysablont hozza létre a blog webhelyből.

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

    Töltse le a fejlesztési webhelyből létrehozott sablont a cec download-template paranccsal:

    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. Töltse fel a sablont tartalomtípusok és tartalomelrendezési leképezések létrehozásához.

    cec upload-template blog2 --server UAT
  7. Töltse fel a sablont, de zárja ki a tartalomelemeket (tartalomsablont) a sablonból.

    cec upload-template blog2 --server UAT -x

    Ez azért szükséges, mert olyan tartalommal kívánja létrehozni a webhelyet, amelynél a GUID azonosítók ugyanazok, mint az eredeti webhelynél. Amikor tartalommal rendelkező sablonból hoz létre webhelyet, az új webhely teljes tartalma új GUID azonosítókkal fog rendelkezni. Mivel célunk nem új tartalom létrehozása, hanem a tartalom módosításának engedélyezése, a tartalmat ki kell zárni a sablonból.

  8. Hozza létre a webhelyet a sablonból.

    cec create-site blog -t blog2 -r r -l "en-US" -d "end-US" --server UAT
  9. Töltse fel a tartalomsablont a webhely csatornájára és gyűjteményébe. Ez azért szükséges, mert ezt kizárta a sablonból a 7. lépésben.

    cec upload-content blog2 -t -r r -c blog -l "blog site" --server UAT 
  10. Tegye közzé a webhelyet, és helyezze online állapotba a tesztelési kiszolgálón.

    Használja a cec control-site parancsot a webhely közzétételéhez és online állapotba helyezéséhez:

    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. Ha ezután változtatásokat hajt végre a blog nevű webhelyen a DEV kiszolgálón,a módosításokat terjesztheti az UAT kiszolgálón már létrehozott webhelyre.

  12. Hozzon létre egy újabb sablont a webhelyből, így a sablon tartalmazni fogja a módosításokat.

    cec create-template-from-site blog3 -s blog --server DEV
  13. Töltse le a sablont.

    cec download-template blog3 -s DEV
  14. Töltse fel a sablont, és hozzon létre ebből egy webhelyet a módosítások terjesztéséhez a tesztelési környezetbe.

    cec upload-template blog3 -s UAT

    Ez a parancs létrehozza vagy módosítja a megváltozott összetevőket és témákat, de kizárja a tartalmat.

  15. Ezután használja az update-site parancsot a tartalom átvételéhez és az oldalak frissítéséhez.

    cec update-site blog -t blog3 - UAT

    Például:

    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. Ellenőrizze a webhelyen a módosítások megfelelő terjesztését.

  17. Hajtsa végre ugyanazokat a lépéseket az UAT kiszolgálóról a PROD kiszolgálóra való áthelyezéshez, mint amelyeket a DEV és az UAT kiszolgáló között használt.

  18. Hozza létre a webhelyet az éles környezeti kiszolgálón, helyezze online állapotba, és ellenőrizze a módosításokat.

    A cec list parancsot használhatja éles környezeti webhelye tartalmának megtekintéséhez, és ellenőrizze a fejlesztési környezetben végrehajtott módosítások meglétét. Ugyanígy ellenőrizheti a webhelyen a módosítások megfelelő terjesztését az éles környezetben.