Overfør endringer fra test til produksjon med OCE Toolkit

Når du har utviklet en områdemal, kan du bruke kommandolinjegrensesnittet (CLI) i OCE Toolkit til å overføre malen fra utvikling til test til produksjon på Oracle Content Management-tjenerne.

Når du skal overføre endringer, kan du bruke Toolkit-kommandoer til å opprette områder og administrere livssyklusene deres på utviklings-, test- og produksjonstjenere. Du kan også utføre endringer av områder i et utviklingsmiljø og overføre disse endringene til test- og produksjonsmiljøer. Du kan også innlemme dette settet med kommandolinjeverktøy til skriptmiljøene når du skal administrere implementeringene. Med CLI-verktøyene kan du rulle ut nye elementer, for eksempel aktiva og komponenter, samt oppdateringer av eksisterende innhold.

Følgende trinn viser hvordan du bruker CLI i OCE Toolkit til å overføre endringene fra utvikling til test til produksjon:

  1. Konfigurer utviklings-, test- og produksjonstjenere med samme register og lokaliseringsretningslinjer.

    Når du skal overføre endringer fra en utviklingstjener til en testtjener og deretter til en produksjonstjener, må du konfigurere et register med samme navn og lokaliseringsretningslinjer på hver av de tre tjenerne. Standard lokaliseringsretningslinjer for aktivaregisteret er en-US, men du kan bruke noe annet hvis de er like på alle de tre tjenerne.

    Se Konfigurere aktivaregistre.

  2. Registrer utviklings-, test- og produksjonstjenerne i Oracle Content Management.

    Før du overfører endringer til et område, må du registrere hver enkelt tjener. Du kan registrere en tjener med OCE Toolkit-kommandoen cec register-server:

    cec register-server <name>

    Angi følgende kommandoalternativer:

    • -e <endpoint> for URL-adressen til tjeneren

    • -u <user> og -p <password> for tilkobling til tjeneren

    • -t <type>, som er valgfritt, angir tjenertypen. Standardverdien er pod_ec.

      Når du kobler til en Oracle Content Management-leier i Oracle Public Cloud, bruker du bare pod_ec.

    For eksempel registrerer følgende kommando en tjener som er en leier i Oracle Public Cloud:

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

    Neste kommando registrerer en frittstående utviklingsforekomst av Oracle Content Management:

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

    Når du har registrert en Oracle Content Management-tjener, kan du vise innholdet på den med Toolkit-kommandoen cec list.

    Følgende kommando viser innholdet på en utviklingstjener:

    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. Last opp en områdemal til utviklingstjeneren, og opprett et område fra malen.

    Du kan opprette en områdemal med kommandoen cec create-template og deretter laste opp malen til utviklingstjeneren. Deretter kan du opprette et område fra malen med kommandoen cec create-site. Følgende kommandoer oppretter en mal og laster opp malen:

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

    Neste kommando oppretter et område med navnet blog fra den opplastede malen:

    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. Publiser området, og gjør det tilkoblet på utviklingstjeneren.

    Når du har opprettet et område, kan du bruke kommandoen cec control-site til å publisere området og gjøre det tilkoblet:

    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. Når du skal flytte et område fra DEV til UAT, må du pakke det opp. Pakkemodellen for flytting av områder mellom tjenere finnes i malen. Opprett en ny mal fra området du opprettet på utviklingstjeneren, og last ned malen.

    Kommandoen cec create-template-from-site i følgende eksempel oppretter en områdemal med navnet blog2 fra blog.

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

    Last ned malen du opprettet fra utviklingsområdet, med kommandoen 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. Last opp malen slik at innholdstypene og innholdsoppsettskartene kan opprettes.

    cec upload-template blog2 --server UAT
  7. Last opp malen, men utelat innholdselementene (innholdsmal) fra malen.

    cec upload-template blog2 --server UAT -x

    Dette bør du gjøre hvis du ønsker å opprette et område med innhold som har samme GUID-er som det opprinnelige området. Når du oppretter et område fra en mal som inneholder innhold, får alt innholdet på det nye området nye GUID-er. Fordi vi ønsker å tillate at innhold oppdateres i stedet for at det må opprettes nytt innhold, må du ekskludere innholdet fra malen.

  8. Opprett området fra malen.

    cec create-site blog -t blog2 -r r -l "en-US" -d "end-US" --server UAT
  9. Last opp innholdsmalen til kanalen og samlingen til området. Dette må du gjøre fordi du ekskluderte det fra malen i trinn 7.

    cec upload-content blog2 -t -r r -c blog -l "blog site" --server UAT 
  10. Publiser området, og gjør det tilkoblet på testtjeneren.

    Bruk kommandoen cec control-site til å publisere området og gjøre det tilkoblet:

    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. Hvis du deretter gjør endringer i blog for området på DEV-tjeneren, kan du overføre endringene til området du allerede har opprettet på UAT-tjeneren.

  12. Opprett en annen mal fra området, slik at endringene du gjorde, lagres i malen.

    cec create-template-from-site blog3 -s blog --server DEV
  13. Last ned malen.

    cec download-template blog3 -s DEV
  14. Last opp malen, og opprett et område fra den slik at endringene overføres til testmiljøet.

    cec upload-template blog3 -s UAT

    Denne kommandoen oppretter eller oppdaterer hvilke som helst komponenter og temaer som er endret, men ekskluderer innholdet i dem.

  15. Bruk kommandoen update-site til å plukke opp innholdet og oppdatere sidene.

    cec update-site blog -t blog3 - UAT

    For eksempel:

    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. Verifiser at endringene ble overført til området.

  17. Utfør de samme trinnene for å flytte fra UAT-tjeneren til PROD-tjeneren slik du gjorde da du flyttet området fra DEV til UAT.

  18. Opprett området på produksjonstjeneren, gjør det tilkoblet, og verifiser endringene.

    Du kan bruke kommandoen cec list til å vise innholdet på produksjonsområdet og kontrollere at det omfatter endringene du gjorde i utviklingsmiljøet. Du kan også verifisere at endringene er overført til produksjon, på området.