Muutosten välittäminen testauksesta tuotantoon OCE Toolkitia käyttäen

Kun olet kehittänyt sivuston mallipohjan, voit välittää mallipohjan OCE Toolkitin komentoliittymää käyttäen kehitysympäristöstä testiympäristöön ja sieltä tuotantoympäristöön Oracle Content Management -palvelimissa.

Voit käyttää muutosten välittämisessä Toolkitin komentoja ja luoda sivustoja sekä hallita niiden elinkaaria kehitys-, testaus- ja tuotantopalvelimissa. Voit tehdä sivustoihin muutoksia kehitysympäristössä ja välittää kyseiset muutokset testaus- ja tuotantoympäristöihin. Voit myös sisällyttää tämän komentoriviapuohjelmien joukon komentosarjaympäristöihin käyttöönottojen hallintaa varten. CLI-apuohjelmien avulla voit ottaa käyttöön uusia kohteita, kuten sisältöä ja komponentteja, sekä olemassa olevan sisällön päivityksiä.

Seuraavissa vaiheissa näytetään, kuinka voit välittää tekemäsi muutokset OCE Toolkit CLI:n avulla kehitysympäristöstä testiympäristöön ja sieltä tuotantoympäristöön:

  1. Määritä kehitys-, testaus- ja tuotantopalvelimet, joilla on sama tietovarasto ja lokalisointikäytäntö.

    Jotta voisit välittää muutokset kehityspalvelimesta testauspalvelimeen ja sieltä tuotantopalvelimeen, sinun on määritettävä tietovarasto, jolla on sama nimi ja lokalisointikäytäntö kaikissa kolmessa palvelimessa. Sisällön tietovaraston oletusarvoinen lokalisointikäytäntö on määritetty kielellä en-US, mutta voit käyttää jotakin muutakin käytäntöä, kunhan se on sama kaikissa kolmessa palvelimessa.

    Katso kohta Sisällön tietovarastojen määritys.

  2. Rekisteröi kehitys-, testaus- ja tuotantopalvelimet Oracle Content Management -palvelussa.

    Ennen kuin välität muutokset sivustoon, sinun on rekisteröitävä kaikki palvelimet. Voit rekisteröidä palvelimen käyttämällä OCE Toolkitin cec register-server -komentoa:

    cec register-server <name>

    Määritä seuraavat komentovalinnat:

    • -e <endpoint> palvelimen URL-osoitteelle

    • -u <user> ja -p <password> palvelinyhteyden muodostamista varten

    • -t <type> (valinnainen) palvelintyypin määrittämistä varten. Oletusarvo on pod_ec.

      Kun luot yhteyden Oracle Content Management -asiakkaaseen Oracle Public Cloudissa, käytä vain arvoa pod_ec.

    Esimerkiksi seuraava komento rekisteröi palvelimen, joka on asiakas Oracle Public Cloudissa:

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

    Seuraava komento rekisteröi erillisen Oracle Content Management -palvelun kehitysinstanssin:

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

    Kun olet rekisteröinyt Oracle Content Management -palvelimen, voit listata sen sisällön Toolkit-komennolla cec list.

    Seuraava komento listaa kehityspalvelimen sisällön:

    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. Lataa sivuston mallipohja kehityspalvelimeen ja luo sivusto mallipohjasta.

    Voit luoda sivuston mallipohjan cec create-template -komennolla ja ladata sitten mallipohjan kehityspalvelimeen. Sen jälkeen voit luoda sivuston mallipohjasta cec create-site -komennolla. Seuraavilla komennoilla luodaan ja ladataan mallipohja:

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

    Seuraava komento luo sivuston nimeltä blog ladatusta mallipohjasta:

    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. Julkaise sivusto ja siirrä se online-tilaan kehityspalvelimessa.

    Kun olet luonut sivuston, voit julkaista sen ja siirtää sen online-tilaan cec control-site -komennolla:

    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. Jos haluat siirtää sivuston DEV-palvelimesta UAT-palvelimeen, sinun on pakattava sivusto. Pakkausmalli, jota käytetään siirrettäessä sivustoja palvelinten välillä, on mallipohja. Luo uusi mallipohja kehityspalvelimessa luomastasi sivustosta ja nouda mallipohja.

    Seuraavan esimerkin cec create-template-from-site -komento luo sivuston mallipohjan nimeltä blog2 kohteesta blog.

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

    Nouda kehityssivustossasi luomasi mallipohja cec download-template -komennolla:

    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. Lataa mallipohja sisältötyyppien ja sisällön asettelukarttojen luontia varten.

    cec upload-template blog2 --server UAT
  7. Lataa mallipohja, mutta sulje pois sisältökohteet (sisällön mallipohja).

    cec upload-template blog2 --server UAT -x

    Tällä tavoin voit luoda sivuston, jonka sisällöllä on samat GUID-tunnukset kuin alkuperäisellä sivustolla. Kun luot sivuston mallipohjasta, joka sisältää sisältöä, kaikilla uuden sivuston sisällöillä on uudet GUID-tunnukset. Koska halutaan sallia sisällön päivittäminen uuden sisällön luonnin sijaan, sisältö on jätettävä pois mallipohjasta.

  8. Luo sivusto mallipohjasta.

    cec create-site blog -t blog2 -r r -l "en-US" -d "end-US" --server UAT
  9. Lataa sisällön mallipohja sivuston kanavaan ja kokoelmaan. Sinun on tehtävä tämä, koska suljit sen pois mallipohjasta vaiheessa 7.

    cec upload-content blog2 -t -r r -c blog -l "blog site" --server UAT 
  10. Julkaise sivusto ja siirrä se online-tilaan testauspalvelimessa.

    Julkaise sivusto ja siirrä sen online-tilaan cec control-site -komennolla:

    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. Jos teet muutoksia sivustosi blog-kohteeseen DEV-palvelimessa, voit välittää muutokset sivustoon, jonka olet jo luonut UAT-palvelimessa.

  12. Luo toinen mallipohja sivustostasi, jotta mallipohja saa tekemäsi muutokset.

    cec create-template-from-site blog3 -s blog --server DEV
  13. Nouda mallipohja.

    cec download-template blog3 -s DEV
  14. Lataa mallipohja ja luo siitä sivusto, jotta voit välittää muutokset testiympäristöön.

    cec upload-template blog3 -s UAT

    Tämä komento luo tai päivittää kaikki muuttuneet komponentit ja teemat, mutta jättää sisällön pois.

  15. Käytä seuraavaksi update-site-komentoa sisällön poimimiseen ja sivujen päivitykseen.

    cec update-site blog -t blog3 - UAT

    Esimerkki:

    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. Tarkista sivusto ja varmista, että muutokset on välitetty.

  17. Siirrä sivusto UAT-palvelimesta PROD-palvelimeen käyttämällä samoja vaiheita kuin käytit siirtäessäsi sivuston DEV-palvelimesta UAT-palvelimeen.

  18. Luo sivusto tuotantopalvelimessa, siirrä se online-tilaan ja tarkista muutokset.

    cec list -komennolla voit katsella tuotantosivuston sisältöä ja varmistaa, että se sisältää kehitysympäristössä tekemäsi muutokset. Voit myös tarkistaa sivuston ja varmistaa, että muutokset on välitetty tuotantoon.