ศูนย์คู่มือ Ruk-Com PaaS

คู่มือการพัฒนา Deploy และดูแล Application บนแพลตฟอร์ม

RUK-COM PAAS / DEVELOPMENT TOOLS

ภาพรวม Platform CLI

คู่มือนี้เรียบเรียงสำหรับ Ruk-Com PaaS หน้าจอและตัวเลือกอาจแตกต่างตามเวอร์ชันและสิทธิ์ของบัญชี

ตรวจสอบ Environment, Region, สิทธิ์บัญชี และสำรองค่าปัจจุบันก่อนดำเนินการกับระบบจริง

คู่มือภาษาไทย

คำสั่ง ชื่อเมนู พารามิเตอร์ และค่าตัวอย่างในกรอบ Code คงรูปแบบตามระบบเพื่อให้คัดลอกและตรวจสอบได้ถูกต้อง

อินเทอร์เฟซบรรทัดคำสั่งของแพลตฟอร์ม (คลีไอ) ได้รับการออกแบบมาเพื่อทำให้การโต้ตอบกับบัญชี Cloud Platform ของคุณง่ายขึ้นทำให้คุณสามารถดำเนินการคำสั่งที่จำเป็นผ่านทางเทอร์มินัลของเครื่องในพื้นที่ของคุณสามารถจัดการการดำเนินงานส่วนใหญ่ที่มีอยู่จากระยะไกลเสริมความสามารถมากมายที่มีให้ผ่านทางแดชบอร์ดและแพลตฟอร์ม API

Image 35: platform CLI logoประโยชน์หลักที่นี่คือเครื่องมืออัตโนมัติขั้นสูงและค่อนข้างเรียบง่ายที่ CLI มอบให้กับนักพัฒนาคำสั่งข้อความธรรมดาสามารถจัดกลุ่มเป็นสคริปต์ได้อย่างง่ายดายและในลักษณะนี้จะเป็นการสร้างกลไกอันทรงพลังเพื่อให้บรรลุวัตถุประสงค์ต่างๆตั้งแต่งานอัตโนมัติที่พบบ่อยที่สุดและบ่อยที่สุดไปจนถึงการตรวจสอบแอพและการจัดการกระบวนการ DevOps ที่ซับซ้อน

ดังนั้นเรามาเริ่มกันที่การติดตั้งแพลตฟอร์ม CLIและเปิดเผยบางส่วนประเด็นสำคัญของการใช้งานก่อนดำเนินการต่อไป

จากนั้นคุณสามารถดำดิ่งลึกลงไปด้วยบทช่วยสอน CLI ของแพลตฟอร์มในการดำเนินงานโดยเฉพาะ

การติดตั้ง CLI

ในการติดตั้งแพลตฟอร์ม CLI ที่เครื่องของคุณคุณจะต้องรันโค้ดเพียงบรรทัดเดียวผ่านเทอร์มินัลของคุณ:

สำเนา

curl -s ftp://node.example.ruk-com.cloud/pub/cli/jelastic-cli-installer.sh | bash

หมายเหตุ:

  • โปรดตรวจสอบให้แน่ใจว่าคุณมีชวาของเวอร์ชัน 8 หรือสูงกว่าติดตั้งไว้ก่อน
  • ในกรณีที่คุณใช้ Windows OS คุณจะต้องติดตั้ง Environment แบบ Unix ก่อน (เช่นซิกวิน) และรันคำสั่งที่เหมาะสมทั้งหมดภายในนั้น

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

เริ่มต้นใช้งาน

ฐานของแพลตฟอร์ม CLI แสดงด้วยไฟล์ปฏิบัติการ.ไหเก็บถาวรและคำสั่งที่กำหนดค่าไว้ล่วงหน้า (สคริปต์ทุบตี) เพื่อการใช้งานด้วยความช่วยเหลือของคำสั่งเหล่านี้คุณจะสามารถตรวจสอบควบคุมและทำให้วงจรชีวิตของ Environment ของคุณเป็นแบบอัตโนมัติได้

  1. ในการเริ่มต้นควรผ่านการรับรองความถูกต้องมันถูกเรียกโดยอัตโนมัติเมื่อใช้คำสั่ง CLI แรกเช่น:

Image 38: CLI authenticationเพียงทำตามแบบสอบถามที่ปรากฏโดยระบุค่าที่ถาม:

  • URL ของแพลตฟอร์ม- URL การติดตั้ง PaaS ในไฟล์แอป.{โฮสต์เตอร์_โดเมน}รูปแบบ
  • อีเมล- อีเมล (เข้าสู่ระบบ) เชื่อมโยงกับบัญชีของคุณ
  • รหัสผ่าน- รหัสผ่านบัญชีของคุณ

หากข้อมูลที่ป้อนถูกต้องคุณจะเห็นโลโก้และเวอร์ชันของแพลตฟอร์มที่ใช้อยู่ในปัจจุบัน

เคล็ดลับ:การรับรองความถูกต้องสามารถเริ่มต้นได้ด้วยตนเองตัวอย่างเช่นหากคุณต้องการสลับเซสชันปัจจุบันและเข้าสู่ระบบในฐานะผู้ใช้อื่นหรือที่การติดตั้ง PaaS อื่นใช้คำสั่งต่อไปนี้:

สำเนา

~/jelastic/users/authentication/signin --login  {email} --password  {password} --platformUrl  {platformUrl}

ในที่นี้ค่าในวงเล็บปีกกาควรแทนที่ด้วยพารามิเตอร์บัญชีที่เกี่ยวข้อง (อธิบายไว้ข้างต้น)

Image 39: CLI manual authenticationที่“ผลลัพธ์”: 0คุณสมบัติภายในการตอบสนองที่ได้รับ (วงกลมในภาพด้านบน) หมายความว่าการดำเนินการผ่านไปได้สำเร็จและไม่มีข้อผิดพลาดลักษณะการทำงานดังกล่าวหมายถึงคำสั่งทั้งหมดที่คุณเรียกใช้

  1. ข้อมูลเกี่ยวกับเซสชันผู้ใช้จริง (เช่นที่อยู่แพลตฟอร์มและข้อมูลประจำตัวของคุณ) จะถูกจัดเก็บไว้ในระบบที่สร้างขึ้นโดยอัตโนมัติ~/.config/Ruk-Com PaaS/Ruk-Com PaaS.propertiesไฟล์. ระบบจะดึงข้อมูลโดยอัตโนมัติเมื่อจำเป็นช่วยให้คุณมุ่งความสนใจไปที่การดำเนินการที่ดำเนินการไปแล้วโดยไม่ต้องมีขั้นตอนการตรวจสอบสิทธิ์ซ้ำๆ

ตามค่าเริ่มต้นคำสั่ง CLI จะถือว่าดำเนินการได้สำเร็จแม้ว่าเมธอด API ที่ถูกเรียกจะส่งกลับข้อผิดพลาดก็ตามคุณสามารถเปลี่ยนพฤติกรรมนี้ได้ด้วยรักคอม PaaS.non_zero_exit_codeเพิ่มพารามิเตอร์ลงในไฟล์กำหนดค่ากำหนดว่าคำสั่ง CLI ควรตอบสนองด้วยรหัสศูนย์ตามปกติหรือไม่ (เท็จ- ค่าเริ่มต้น) หรือด้วยรหัสที่ไม่ใช่ศูนย์เมื่อวิธี API ที่ดำเนินการส่งคืนข้อผิดพลาด (จริง).

  1. ในกรณีที่คุณยังใหม่กับ API ของเราและต้องการรายละเอียดเกี่ยวกับโครงสร้างอินเทอร์เฟซบรรทัดคำสั่งคุณสามารถเข้าถึงไฟล์วิธีใช้ที่ฝังไว้ได้:

สำเนา

~/jelastic/help

Image 40: CLI helpที่นี่คุณสามารถดูรายการลำดับชั้นของประเภทคำสั่ง (วิธีการ) ที่มีอยู่ได้แต่ละวิธีมีโฟลเดอร์ชื่อเดียวกันโดยเฉพาะซึ่งมีสคริปต์หลายตัว (เช่นฟังก์ชันที่ใช้ได้) อยู่ภายใน

  1. เพื่อรับรายการการดำเนินการที่เป็นไปได้ทั้งหมดสำหรับวิธีการเฉพาะคุณสามารถใช้คำสั่งรายการแบบง่ายสำหรับไดเร็กทอรีที่เหมาะสมเช่น:

สำเนา

ls ~/jelastic/environment/control

Image 41: CLI environment control listแต่ละฟังก์ชันที่นำเสนอสามารถเรียกได้อย่างง่ายดายโดยใช้เส้นทางแบบเต็ม

  1. สำหรับข้อมูลเพิ่มเติมเกี่ยวกับการดำเนินการเฉพาะให้รันโดยไม่มีพารามิเตอร์เพื่อดูรายการข้อกำหนดที่ไม่ได้รับทั้งหมด

Image 42: CLI command helpคุณยังสามารถตรวจสอบเอกสาร API ของเราเพื่อรับข้อมูลเพิ่มเติมได้

  1. ตามค่าเริ่มต้นภาพเคลื่อนไหว "กำลังโหลด" จะแสดงขึ้นในขณะที่รอการดำเนินการคำสั่งใดๆโดยจะแสดงภาพการกระทำที่กำลังดำเนินการอยู่

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

สำเนา

--silent true

ด้วยวิธีนี้สคริปต์การทำงานอัตโนมัติของคุณจะสามารถใช้เอาต์พุตที่ได้รับได้ทันทีโดยไม่ต้องแก้ไขเพิ่มเติมใดๆ

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

ตอนนี้เมื่อคุณมีความรู้พื้นฐานเกี่ยวกับแพลตฟอร์ม CLI แล้วคุณก็สามารถสำรวจมันต่อได้ด้วยตัวเอง

บทช่วยสอน CLI

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

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

คุณสามารถค้นหาข้อมูลทั้งหมดเกี่ยวกับคำสั่งและวิธีการที่มีอยู่ทั้งหมดได้ในเอกสารประกอบ API ของแพลตฟอร์ม