CLOUD PAAS / DEVELOPMENT TOOLS

บทช่วยสอน CLI: ติดตั้ง JPS

คู่มือนี้เรียบเรียงและปรับรูปแบบสำหรับ Ruk-Com Cloud PaaS ภาพหน้าจออาจแตกต่างเล็กน้อยตามเวอร์ชันของระบบ

คลิกหรือแตะภาพหน้าจอเพื่อดูรายละเอียดขนาดจริง

วัตถุประสงค์

บทความนี้อธิบายการใช้งาน บทช่วยสอน CLI: ติดตั้ง JPS บน Ruk-Com Cloud PaaS โดยจัดลำดับขั้นตอนและจุดตรวจสอบสำหรับการนำไปใช้งานจริง

ก่อนเริ่มดำเนินการ

  • เข้าสู่ระบบด้วยบัญชีที่มีสิทธิ์จัดการ Environment ที่เกี่ยวข้อง
  • ตรวจสอบชื่อ Environment, Region และทรัพยากรเป้าหมายก่อนบันทึกการเปลี่ยนแปลง
  • สำรองข้อมูลหรือกำหนดแผนย้อนกลับก่อนแก้ไขระบบ Production

บทความนี้เราจะแสดงวิธีติดตั้งแพ็คเกจ JPSผ่าน CLI ขั้นตอนดังกล่าวอาจมีการสร้าง environment ใหม่พร้อมกับการกำหนดค่าไว้ล่วงหน้าแล้ว (เช่น การ deploy และการกำหนดค่าแอปพลิเคชัน) หรือดำเนินการบางอย่างกับอินสแตนซ์ที่มีอยู่

เริ่มต้นโดยการติดตั้งแพ็กเกจที่เหมาะสมโดยการรันแพ็คเกจ JPS และพารามิเตอร์ทั้งหมด:

~/jelastic/marketplace/jps/install --jps {jps} [--envName {envName}] [--settings {settings}] [--nodeGroup {nodeGroup}] [--displayName {displayName}] [--region {region}] [--envGroups {envGroups}] [--ownerUid {ownerUid}] [--logsPath {logsPath}] [--loggerName {loggerName}] [--skipNodeEmails {skipNodeEmails}]

พารามิเตอร์ในวงเล็บเหลี่ยม [ ] เป็นทางเลือก:

  • เจพีเอส- ลิงก์ไปยังไฟล์ Manifestหรือเนื้อหาของคุณ
  • การตั้งค่าเฉพาะสำหรับjpsType: ติดตั้งmanifest (environment ใหม่)
  • [ชื่อที่แสดง] - นามแฝงสำหรับการสร้าง environment
  • [ภูมิภาค] -ชื่อเฉพาะของแต่ละภูมิภาค(เช่น รับด้วยเมธอด GetRegions) ที่จะสร้าง environment
  • [envGroups]- รายการของกลุ่ม envenvironment ที่สร้างขึ้นควรรวมอยู่ด้วย (ระบุเป็นอาร์เรย์ JSON เช่น["กลุ่มของฉัน", "กลุ่ม/กลุ่มย่อย"])
  • การตั้งค่าเฉพาะสำหรับjpsType: อัปเดตmanifest (add-ons สำหรับ environment ที่มีอยู่)
  • [กลุ่มโหนด]- environment layer ที่ควรใช้ add-ons กับ (bl, cp, cache, sqldb, nosqldb, storage, vps, สร้างหรือกำหนดคอนเทนเนอร์ Dockerด้วยตนเอง)
  • envName- ชื่อ env ที่สร้างขึ้นใหม่/เป้าหมายสำหรับการติดตั้งแอปพลิเคชัน/ส่วนเสริมตามลำดับ
  • [การตั้งค่า]- รายการการตั้งค่าที่แพ็คเกจต้องการ (ระบุเป็น JSON object ที่มีคู่ key/value)
  • [เจ้าของ UID]- User ID ของบัญชีที่ใช้ร่วมกันซึ่งควรติดตั้งแพ็คเกจ JPS
  • [ชื่อคนตัดไม้]- ชื่อที่แสดงถัดจากการประทับเวลาของการดำเนินการแต่ละครั้งในไฟล์ log การติดตั้ง JPS (เรียนรู้เพิ่มเติมเกี่ยวกับคนตัดไม้ชื่อ)
  • [บันทึกเส้นทาง]- เส้นทางไปยังไฟล์ log เพื่อบันทึกการติดตั้ง JPS (cs.log โดยค่าเริ่มต้น)
  • [ข้ามNodeอีเมล]- เปิดใช้งาน (จริงโดยค่าเริ่มต้น) หรือปิดใช้งาน (เท็จ) การแจ้งเตือนทางอีเมลเกี่ยวกับการสร้างโหนดใหม่สำหรับแพ็คเกจนี้ (เรียนรู้เพิ่มเติมเกี่ยวกับข้ามNodeEmails)

ตอนนี้คุณสามารถดำเนินการกับตัวอย่างกรณีจริง:

  • การติดตั้งส่วนเสริม TimeZone Change ผ่าน URL
  • การติดตั้ง JPS โดยใช้ไฟล์กำหนดค่าพร้อมกับพารามิเตอร์

การติดตั้งส่วนเสริม TimeZone Change ผ่าน URL

โปรแกรมเสริม TimeZone Change จะช่วยเปลี่ยนเวลาบนคอนเทนเนอร์ให้เป็นโซนที่ต้องการได้อย่างง่ายดาย ข้อมูลต้นทางและไฟล์ manifest ของ add-on สามารถพบได้ที่จัดเก็บJelastic เจพีเอส คอลเลคชั่นใน GitHub

1. ติดตั้ง Jelastic CLI และลงชื่อเข้าใช้บัญชีของคุณ สามารถดูวิธีการได้ที่คู่มือนี้

2. เรียกวิธีการติดตั้งด้วยพารามิเตอร์ที่จำเป็น:

~/jelastic/marketplace/jps/install --jps {jps} --envName {envName} --settings {settings} --nodeGroup {nodeGroup}

โดยที่:

  • {เจพีเอส}- ลิงก์ไปยังไฟล์โปรแกรมเสริม TimeZone Change manifest เช่นhttps://raw.githubusercontent.com/jelastic-jps/time-zone-change/master/manifest.jps
  • {ชื่อ env}- ชื่อของ environment ที่มีอยู่ เช่นแอปของฉัน
  • {การตั้งค่า}- ตามรายการที่แสดงโปรแกรมเสริมนี้จำเป็นต้องระบุพารามิเตอร์เพิ่มเติมหนึ่งตัว -เขตเวลาที่ต้องการ เช่น{“dashoard_URL”:"อเมริกา/นิว_ยอร์ค"}
  • {กลุ่มโหนด}- เลเยอร์เป้าหมายของ environment
  • หากไม่มีปัญหาใดๆ สคริปต์จะตอบกลับด้วย "result": 0 (การดำเนินการสำเร็จ)

3. สำหรับโปรแกรมเสริมนี้ คุณสามารถตรวจสอบรายละเอียดผลลัพธ์ที่ไฟล์/var/log/jpsaddon.logโดยพิมพ์คำสั่ง:

~/jelastic/environment/file/read --envName {envName} --path "/var/log/jpsaddon.log" --nodeGroup {nodeGroup}

คุณจะเห็น timezone ถูกตั้งค่าแล้วตามที่ระบุไว้ในขั้นตอนก่อนหน้า America/New_York เวลาท้องถิ่นบนคอนเทนเนอร์ที่เกี่ยวข้องจะได้รับการปรับตามเขตเวลาใหม่นี้

การติดตั้ง JPS โดยใช้ไฟล์กำหนดค่าพร้อมกับพารามิเตอร์

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

โดยการสร้างไฟล์ JSON (ใช้ editor ที่ต้องการ) ด้วยพารามิเตอร์ที่จำเป็น ในกรณีของเรา เราจะเรียกใช้ JPS แบบง่าย ซึ่งจะบันทึกค่าของพารามิเตอร์ที่ให้มา

{
  "jps": {
    "type": "update",
    "name": "JPS Example",
    "onInstall": {
      "log": "${settings.param1}"
    }
  },
  "envName": "my-app",
  "settings": {
    "param1": "value1"
  },
  "nodeGroup": "cp"
}

เคล็ดลับ:คุณสามารถระบุ URL ไปยังไฟล์รายการของคุณแทนที่จะระบุให้ชัดเจนในพารามิเตอร์ jps (คล้ายกับตัวอย่าง TimeZone)

2. ขั้นตอนถัดไปเรียกวิธีการติดตั้งโดยใช้ไฟล์การกำหนดค่าที่สร้างขึ้น

~/jelastic/marketplace/jps/install --myparams {myparams.json}

เคล็ดลับ:คุณสามารถระบุพารามิเตอร์ให้ชัดเจนเพื่อกำหนดค่าภายในไฟล์ใหม่ได้ ตัวอย่างเช่น การเปลี่ยนชื่อ environment โดยไม่ต้องปรับไฟล์การกำหนดค่าเอง:

~/jelastic/marketplace/jps/install --myparams {myparams.json} --envName {envName}

3. คุณสามารถตรวจสอบค่าของพารามิเตอร์ที่ระบุได้ถูกบันทึกผ่านคอนโซลของแพลตฟอร์มแล้วโดยคลิกที่ลิงก์https://app.manage.ruk-com.cloud/consoleเพื่อดู log

การใช้ไฟล์ กำหนดค่าuration พร้อมรายการพารามิเตอร์ที่กำหนดไว้ล่วงหน้าเป็นวิธีที่ดีในการลดความยุ่งยากและทำให้การเรียกบ่อยโดยอัตโนมัติ