Propagarea modificărilor de la testare la producţie cu OCE Toolkit

După ce dezvoltaţi un şablon de site, puteţi utiliza interfaţa în linia de comandă (CLI) din OCE Toolkit pentru a propaga şablonul de la dezvoltare la testare la producţie pe serverele dvs. Oracle Content Management.

Pt. a propaga modificările, puteţi utiliza comenzi din setul de instrumente pt. a crea site-uri şi a le administra ciclurile de viaţă pe serverele de dezvoltare, testare şi producţie. Puteţi aduce modificări site-urilor într-un mediu de dezvoltare şi puteţi propaga aceste modificări la mediile de testare şi de producţie. De asemenea, puteţi încorpora acest set de utilitare linie de comandă în mediile dvs. de scripting pentru a vă administra implementările. Folosind utilitarele CLI, puteţi lansa atât elemente noi, cum ar fi resurse şi componente, cât şi actualizări ale conţinutului existent.

Paşii următori arată modul de utilizare a OCE Toolkit CLI pt. a vă propaga modificările din dezvoltare în testare şi în producţie:

  1. Configuraţi servere de dezvoltare, de testare şi de producţie cu acelaşi repository şi aceeaşi politică de localizare.

    Pt. a propaga modificările dintr-un server de dezvoltare într-un server de testare şi apoi într-un server de producţie, trebuie să configuraţi un repository cu acelaşi nume şi aceeaşi politică de localizare pe fiecare dintre cele trei servere. Politica de localizare prestabilită pt. repository-ul de resurse este en-US, dar puteţi utiliza alta dacă este aceeaşi pe toate cele trei servere.

    Consultaţi Configurarea repository-urilor de resurse.

  2. Înregistraţi-vă serverele de dezvoltare, testare şi producţie cu Oracle Content Management.

    Înainte de a propaga modificările pe un site, trebuie să înregistraţi fiecare server. Puteţi înregistra un server cu comanda cec register-server oferită de OCE Toolkit:

    cec register-server <name>

    Specificaţi următoarele opţiuni de comandă:

    • -e <endpoint> pt. URL-ul serverului

    • -u <user> şi -p <password> pt. conectarea la server

    • -t <type>, opţional, pt. a seta tipul de server. Valoarea prestabilită este pod_ec.

      La conectarea la un tenant Oracle Content Management pe Oracle Public Cloud, utilizaţi numai pod_ec.

    De exemplu, comanda următoare înregistrează un server care este tenant pe un cloud Oracle public:

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

    Următoarea comandă înregistrează o instanţă de dezvoltare individuală de Oracle Content Management:

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

    După ce înregistraţi un server Oracle Content Management, îi puteţi lista conţinutul cu comanda cec list din setul de instrumente.

    Următoarea comandă listează conţinutul unui server de dezvoltare:

    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. Încărcaţi un şablon de site pe serverul dvs. de dezvoltare şi creaţi un site din şablon.

    Puteţi crea un şablon de site cu comanda cec create-template şi apoi puteţi încărca şablonul pe serverul de dezvoltare. Apoi puteţi crea un site din şablon cu comanda cec create-site. Următoarele comenzi creează un şablon şi încarcă şablonul:

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

    Următoarea comandă creează din şablonul încărcat un site cu numele 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. Publicaţi site-ul şi aduceţi-l online pe serverul de dezvoltare.

    După ce creaţi un site, puteţi utiliza comanda cec control-site pt. a publica site-ul şi pt. a-l aduce 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. Pt. a muta un site de pe DEV pe UAT, trebuie să împachetaţi site-ul. Modelul de împachetare pt. mutarea de site-uri între servere este şablonul. Creaţi un şablon nou din site-ul pe care l-aţi creat pe serverul de dezvoltare şi descărcaţi şablonul.

    Comanda cec create-template-from-site din exemplul următor creează un şablon de site cu numele blog2, din blog.

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

    Descărcaţi şablonul pe care l-aţi creat din site-ul de dezvoltare, cu comanda 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. Încărcaţi şablonul pt. a crea tipurile de conţinut şi hărţile de machete de conţinut.

    cec upload-template blog2 --server UAT
  7. Încărcaţi şablonul dar excludeţi elementele de conţinut (conţinutul şablonului) din şablon.

    cec upload-template blog2 --server UAT -x

    Faceţi acest lucru pt. a crea un site cu conţinut cu aceleaşi GUID-uri ca şi site-ul original. Atunci când creaţi un site dintr-un şablon care conţine conţinut, tot conţinutul din noul site va avea GUID-uri noi. Deoarece dorim să permitem actualizarea de conţinut, mai degrabă decât să creăm conţinut nou, trebuie să excludeţi conţinutul din şablon.

  8. Creaţi site-ul din şablon.

    cec create-site blog -t blog2 -r r -l "en-US" -d "end-US" --server UAT
  9. Încărcaţi şablonul de conţinut pe canalul şi colecţia site-ului. Trebuie să faceţi acest lucru deoarece l-aţi exclus din şablon la pasul 7.

    cec upload-content blog2 -t -r r -c blog -l "blog site" --server UAT 
  10. Publicaţi site-ul şi aduceţi-l online pe serverul de testare.

    Utilizaţi comanda cec control-site pt. a publica site-ul şi pt. a-l aduce 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. Dacă ulterior faceţi modificări la site-ul blog pe serverul DEV, puteţi propaga modificările pe site-ul deja creat pe serverul UAT.

  12. Creaţi un alt şablon de la site-ul dvs., pt. ca şablonul să vă includă modificările.

    cec create-template-from-site blog3 -s blog --server DEV
  13. Descărcaţi şablonul.

    cec download-template blog3 -s DEV
  14. Încărcaţi şablonul şi creaţi un site pornind de la el, pt. a propaga modificările în mediul de testare.

    cec upload-template blog3 -s UAT

    Această comandă creează sau actualizează orice componente sau teme care s-au modificat, dar exclude conţinutul.

  15. Acum utilizaţi comanda update-site pt. a culege conţinutul şi pt. a actualiza paginile.

    cec update-site blog -t blog3 - UAT

    De exemplu:

    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. Verificaţi site-ul pt. a verifica dacă s-au propagat modificările.

  17. Pt. a muta din serverul UAT pe serverul PROD, faceţi aceiaşi paşi pe care i-aţi făcut pt. a muta site-ul de pe DEV pe UAT.

  18. Creaţi site-ul pe serverul de producţie, aduceţi-l online şi verificaţi modificările.

    Puteţi utiliza comanda cec list pt. a vedea conţinutul site-ului de producţie şi pt. a vă asigura că include modificările pe care le-aţi făcut în mediul de dezvoltare. Puteţi de asemenea să verificaţi site-ul, pt. a verifica dacă modificările au fost propagate în producţie.