จัดเตรียมการเปลี่ยนแปลงจากการทดสอบไปเป็นการใช้งานจริงด้วยชุดเครื่องมือ OCE

หลังจากที่คุณพัฒนาเทมเพลทของไซต์ คุณสามารถใช้อินเตอร์เฟซของบรรทัดคำสั่ง (CLI) ของชุดเครื่องมือ OCE เพื่อจัดเตรียมเทมเพลทจากการพัฒนาเป็นการทดสอบเพื่อใช้งานจริงบนเซิร์ฟเวอร์ Oracle Content Management ของคุณ

ในการจัดเตรียมการเปลี่ยนแปลง คุณสามารถใช้คำสั่งของชุดเครื่องมือในการสร้างไซต์และจัดการรอบการใช้งานในเซิร์ฟเวอร์สำหรับการพัฒนา การทดสอบ และการใช้งานจริง คุณสามารถเปลี่ยนแปลงไซต์ต่างๆ ในสภาพแวดล้อมการพัฒนา และจัดเตรียมการเปลี่ยนแปลงให้กับสภาพแวดล้อมการทดสอบและการใช้งานจริงได้ นอกจากนี้ คุณยังสามารถรวมชุดยูทิลิตีบรรทัดคำสั่งนี้ไว้ในสภาพแวดล้อมการเขียนสคริปต์ของคุณ เพื่อจัดการการใช้งานของคุณได้ ด้วยยูทิลิตี CLI คุณสามารถเพิ่มเติมรายการใหม่ๆ ได้ เช่น ข้อมูลและองค์ประกอบต่างๆ ตลอดจนการอัปเดตเนื้อหาที่มีอยู่

ขั้นตอนต่อไปนี้แสดงวิธีการใช้ CLI ของชุดเครื่องมือ OCE ในการจัดเตรียมการเปลี่ยนแปลงของคุณจากการพัฒนาเป็นการทดสอบเพื่อใช้งานจริง

  1. ตั้งค่าเซิร์ฟเวอร์สำหรับการพัฒนา การทดสอบ และการใช้งานจริงด้วยพื้นที่เก็บข้อมูลและข้อกำหนดการโลคัลไลซ์เดียวกัน

    ในการจัดเตรียมการเปลี่ยนแปลงต่างๆ จากเซิร์ฟเวอร์สำหรับการพัฒนาเป็นเซิร์ฟเวอร์สำหรับการทดสอบ และเป็นเซิร์ฟเวอร์สำหรับการใช้งานจริง คุณจำเป็นต้องตั้งค่าพื้นที่เก็บข้อมูลด้วยชื่อและข้อกำหนดการโลคัลไลซ์เดียวกันในแต่ละเซิร์ฟเวอร์ทั้งสามรายการ ข้อกำหนดการโลคัลไลซ์ดีฟอลต์สำหรับพื้นที่เก็บข้อมูลเป็นภาษา en-US แต่คุณสามารถใช้ภาษาอื่นได้ หากเป็นภาษาเดียวกันในเซิร์ฟเวอร์ทั้งสามรายการ

    โปรดดู ตั้งค่าพื้นที่เก็บข้อมูล

  2. รีจิสเตอร์เซิร์ฟเวอร์สำหรับการพัฒนา การทดสอบ และการใช้งานจริงของคุณกับ Oracle Content Management

    ก่อนที่คุณจะจัดเตรียมการเปลี่ยนแปลงในไซต์ คุณจำเป็นต้องรีจิสเตอร์เซิร์ฟเวอร์แต่ละรายการก่อน คุณสามารถรีจิสเตอร์เซิร์ฟเวอร์กับคำสั่ง cec register-server ที่ชุดเครื่องมือ OCE มีให้ได้ดังนี้

    cec register-server <name>

    ระบุตัวเลือกคำสั่งต่อไปนี้

    • -e <endpoint> สำหรับ URL ของเซิร์ฟเวอร์

    • -u <user> และ -p <password> สำหรับการเชื่อมต่อกับเซิร์ฟเวอร์

    • -t <type> เพื่อตั้งค่าประเภทเซิร์ฟเวอร์ ซึ่งเป็นค่าที่เลือกระบุได้ ค่าดีฟอลต์คือ pod_ec

      เมื่อเชื่อมต่อกับรายการภายในของ Oracle Content Management บน Oracle Public Cloud ให้ใช้ pod_ec เท่านั้น

    ตัวอย่างเช่น คำสั่งต่อไปนี้จะรีจิสเตอร์เซิร์ฟเวอร์ที่เป็นรายการภายในบน Oracle Public Cloud

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

    คำสั่งถัดไปจะรีจิสเตอร์อินสแตนซ์การพัฒนาแบบสแตนด์อโลนของ Oracle Content Management ดังนี้

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

    หลังจากที่คุณรีจิสเตอร์เซิร์ฟเวอร์ Oracle Content Management แล้ว คุณจะสามารถแสดงรายการเนื้อหาของเซิร์ฟเวอร์ด้วยคำสั่งของชุดเครื่องมือ cec list ได้

    คำสั่งต่อไปนี้แสดงรายการเนื้อหาของเซิร์ฟเวอร์สำหรับการพัฒนา

    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. อัปโหลดเทมเพลทของไซต์ไปยังเซิร์ฟเวอร์สำหรับการพัฒนาของคุณ และสร้างไซต์จากเทมเพลท

    คุณสามารถสร้างเทมเพลทของไซต์ด้วยคำสั่ง cec create-template และอัปโหลดเทมเพลทไปยังเซิร์ฟเวอร์สำหรับการพัฒนาได้ จากนั้น คุณสามารถสร้างไซต์จากเทมเพลทด้วยคำสั่ง cec create-site คำสั่งต่อไปนี้ใช้สร้างและอัปโหลดเทมเพลท

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

    คำสั่งถัดไปจะสร้างไซต์ที่ชื่อ 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. เผยแพร่ไซต์และเปิดใช้งานแบบออนไลน์บนเซิร์ฟเวอร์สำหรับการพัฒนาของคุณ

    หลังจากที่คุณสร้างไซต์ คุณสามารถใช้คำสั่ง cec control-site เพื่อเผยแพร่ไซต์และเปิดใช้งานแบบออนไลน์ได้ ดังนี้

    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. ในการย้ายไซต์จาก DEV ไปยัง UAT คุณต้องจัดแพ็คเกจไซต์ โมเดลการจัดแพ็คเกจสำหรับการย้ายไซต์ระหว่างเซิร์ฟเวอร์คือ เทมเพลท สร้างเทมเพลทใหม่จากไซต์ที่คุณสร้างบนเซิร์ฟเวอร์สำหรับการพัฒนาของคุณ และดาวน์โหลดเทมเพลท

    คำสั่ง cec create-template-from-site ในตัวอย่างต่อไปนี้สร้างเทมเพลทของไซต์ที่ชื่อ blog2 จาก blog

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

    ดาวน์โหลดเทมเพลทที่คุณสร้างขึ้นจากไซต์การพัฒนาของคุณด้วยคำสั่ง 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. อัปโหลดเทมเพลทเพื่อสร้างประเภทเนื้อหาและการแมปเลย์เอาต์ของเนื้อหา

    cec upload-template blog2 --server UAT
  7. อัปโหลดเทมเพลท แต่แยกรายการเนื้อหา (เทมเพลทเนื้อหา) ออกจากเทมเพลท

    cec upload-template blog2 --server UAT -x

    คุณต้องการดำเนินการดังนี้เพื่อสร้างไซต์ด้วยเนื้อหาที่มี GUID เดียวกับไซต์เดิม เมื่อคุณสร้างไซต์จากเทมเพลทที่มีเนื้อหา เนื้อหาทั้งหมดในไซต์ใหม่จะมี GUID ใหม่ด้วย คุณจำเป็นต้องแยกเนื้อหาออกจากเทมเพลท เนื่องจากเราต้องการให้สามารถอัปเดตเนื้อหาแทนการสร้างเนื้อหาใหม่

  8. สร้างไซต์จากเทมเพลท

    cec create-site blog -t blog2 -r r -l "en-US" -d "end-US" --server UAT
  9. อัปโหลดเทมเพลทเนื้อหาไปยังช่องทางและคอลเล็คชันของไซต์ คุณจำเป็นต้องดำเนินการดังนี้ เนื่องจากคุณได้แยกเนื้อหาออกจากเทมเพลทแล้วในขั้นตอนที่ 7

    cec upload-content blog2 -t -r r -c blog -l "blog site" --server UAT 
  10. เผยแพร่ไซต์และเปิดใช้งานแบบออนไลน์บนเซิร์ฟเวอร์สำหรับการทดสอบของคุณ

    ใช้คำสั่ง cec control-site เพื่อเผยแพร่ไซต์และเปิดใช้งานแบบออนไลน์ได้ ดังนี้

    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. หากคุณดำเนินการเปลี่ยนแปลงใน blog ของไซต์ของคุณบนเซิร์ฟเวอร์ DEV คุณจะสามารถจัดเตรียมการเปลี่ยนแปลงในไซต์ที่คุณได้สร้างไว้บนเซิร์ฟเวอร์ UAT แล้ว

  12. สร้างเทมเพลทอื่นจากไซต์ของคุณ เพื่อให้เทมเพลทมีการเปลี่ยนแปลงของคุณ

    cec create-template-from-site blog3 -s blog --server DEV
  13. ดาวน์โหลดเทมเพลท

    cec download-template blog3 -s DEV
  14. อัปโหลดเทมเพลทและสร้างไซต์จากเทมเพลท เพื่อจัดเตรียมการเปลี่ยนแปลงไปยังสภาพแวดล้อมสำหรับการทดสอบของคุณ

    cec upload-template blog3 -s UAT

    คำสั่งนี้จะสร้างหรืออัปเดตองค์ประกอบและธีมใดๆ ที่มีการเปลี่ยนแปลง แต่จะแยกเนื้อหาออกจากกัน

  15. ในขั้นตอนนี้ ใช้คำสั่ง update-site เพื่อเลือกเนื้อหาและอัปเดตเพจ

    cec update-site blog -t blog3 - UAT

    ตัวอย่างเช่น:

    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. ตรวจสอบไซต์เพื่อยืนยันว่ามีการจัดเตรียมการเปลี่ยนแปลงต่างๆ แล้ว

  17. ทำตามขั้นตอนเดียวกันเพื่อย้ายจากเซิร์ฟเวอร์ UAT ไปยังเซิร์ฟเวอร์ PROD เช่นเดียวกับที่คุณดำเนินการเพื่อย้ายไซต์จาก DEV ไปยัง UAT

  18. สร้างไซต์บนเซิร์ฟเวอร์สำหรับการใช้งานจริงของคุณ เปิดใช้งานแบบออนไลน์ และตรวจสอบการเปลี่ยนแปลง

    คุณสามารถใช้คำสั่ง cec list เพื่อดูเนื้อหาของไซต์การใช้งานจริงของคุณ และตรวจสอบให้แน่ใจว่าได้รวมการเปลี่ยนแปลงต่างๆ ที่คุณทำไว้ในสภาพแวดล้อมสำหรับการพัฒนาแล้ว นอกจากนี้ คุณยังสามารถตรวจสอบไซต์เพื่อยืนยันว่าการเปลี่ยนแปลงต่างๆ ได้รับการจัดเตรียมไว้สำหรับการใช้งานจริงแล้ว