WALinuxAgent

ตัวแทน Microsoft Azure Linux

เครื่องมือแก้ไข Downcodes จะแนะนำให้คุณรู้จักกับ Microsoft Azure Linux Agent (waagent) ซึ่งเป็นเครื่องมือที่จัดการการจัดเตรียม Linux และการโต้ตอบของเครื่องเสมือนกับ Azure Fabric Controller โดยมีความสามารถต่อไปนี้สำหรับการปรับใช้ Linux IaaS:

การทำงาน

1. การจัดเตรียมอิมเมจ: waagent รับผิดชอบในการจัดการกระบวนการจัดเตรียมเริ่มต้นของเครื่องเสมือน Linux รวมถึงการกำหนดค่าเครือข่าย การติดตั้งไดรเวอร์ และการตั้งค่าบัญชีผู้ใช้เริ่มต้น

2. การจัดการเครือข่าย: Waagent ประสานงานกับ Azure Fabric Controller เพื่อกำหนดการตั้งค่าเครือข่ายของเครื่องเสมือน เช่น ที่อยู่ IP ซับเน็ตมาสก์ และเกตเวย์

3. การจัดการเคอร์เนล: waagent สามารถจัดการการอัปเดตเคอร์เนลของเครื่องเสมือนเพื่อให้แน่ใจว่าเคอร์เนลเวอร์ชันล่าสุดและปลอดภัยอยู่เสมอ

4. การวินิจฉัย: waagent สามารถรวบรวมและรายงานข้อมูลสภาพเครื่องเสมือนเพื่อช่วยวินิจฉัยปัญหาและแก้ไขข้อบกพร่อง

5. การปรับใช้ SCVMM: waagent รองรับการทำงานร่วมกับ System Center Virtual Machine Manager (SCVMM) เพื่อจัดการและจัดเตรียมเครื่องเสมือน

6. ส่วนขยายเครื่องเสมือน: waagent รองรับการรันส่วนขยายเครื่องเสมือนที่ให้ฟังก์ชันการทำงานและการปรับแต่งเพิ่มเติม เช่น การติดตั้งซอฟต์แวร์หรือตัววัดการตรวจสอบ

7. การสื่อสาร: waagent สื่อสารกับ Azure Fabric Controller ผ่านสองช่องทาง:

* DVD ต่อท้ายเวลาบูต: สำหรับการปรับใช้ IaaS แผ่น DVD ต่อท้ายเวลาบูตที่มีไฟล์การกำหนดค่าที่เข้ากันได้กับ OVF จะให้ข้อมูลการจัดเตรียม (นอกเหนือจากคู่คีย์ SSH)

* REST API: ตำแหน่งข้อมูล TCP เปิดเผย REST API สำหรับรับการกำหนดค่าการปรับใช้และโทโพโลยี

พร็อกซี HTTP

waagent สามารถใช้พร็อกซี HTTP ผ่านตัวแปรสภาพแวดล้อม httpproxy (สำหรับคำขอ HTTP) หรือ httpsproxy (สำหรับคำขอ HTTPS) เนื่องจากข้อจำกัดของ Python waagent จึงไม่รองรับพร็อกซี HTTP ที่ต้องมีการตรวจสอบสิทธิ์

ในทำนองเดียวกัน หากมีการตั้งค่าตัวแปรสภาพแวดล้อม no_proxy waagent จะข้ามพร็อกซี

โปรดทราบว่าวิธีกำหนดตัวแปรสภาพแวดล้อมเหล่านี้สำหรับบริการ waagent จะแตกต่างกันไปตามการแจกแจง สำหรับการแจกจ่ายโดยใช้ systemd วิธีการทั่วไปคือการใช้ Environment หรือ EnvironmentFile ในส่วน [บริการ] ของคำจำกัดความของบริการ เช่น การใช้การแทนที่หรือการแทรกไฟล์ (ดูการแก้ไข systemctl สำหรับการแทนที่)

ตัวอย่าง

-

แมว /etc/systemd/system/walinuxagent.service.d/http-proxy.conf

[บริการ]

สภาพแวดล้อม = "http_proxy=http://proxy.example.com:80/"

สภาพแวดล้อม = "https_proxy=http://proxy.example.com:80/"

-

-

waagent ส่งผ่านสภาพแวดล้อมไปยังส่วนขยายเครื่องเสมือนที่เรียกใช้งาน รวมถึง httpproxy และ httpsproxy ดังนั้นการกำหนดพร็อกซีสำหรับ waagent จะกำหนดพร็อกซีสำหรับส่วนขยายเครื่องเสมือนด้วย

หากคุณใช้ตัวแปรการกำหนดค่า HttpProxy.Host และ HttpProxy.Port ตัวแปรเหล่านี้จะแทนที่การตั้งค่าสภาพแวดล้อม โปรดทราบว่าตัวแปรการกำหนดค่าเหล่านี้อยู่ในกระบวนการ waagent และไม่ได้ส่งผ่านไปยังส่วนขยายเครื่องเสมือน

ความต้องการ

waagent ต้องการแพ็คเกจระบบบางอย่างเพื่อให้ทำงานได้อย่างถูกต้อง แพ็คเกจเหล่านี้แตกต่างกันไปตามการจำหน่าย

ติดตั้ง

การติดตั้งผ่านที่เก็บแพ็กเกจการแจกจ่ายเป็นวิธีการติดตั้งเดียวที่ได้รับการสนับสนุน

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

หากต้องการติดตั้งจากแหล่งที่มา คุณสามารถใช้ setuptools:

-

sudo python setup.py ติดตั้ง --register-service

-

สำหรับ Python 3 ให้ใช้:

-

sudo python3 setup.py ติดตั้ง --register-service

-

คุณสามารถดูตัวเลือกการติดตั้งเพิ่มเติมได้โดยการรันคำสั่งต่อไปนี้:

-

sudo python setup.py ติดตั้ง --help

-

ไฟล์บันทึกของ waagent จะถูกบันทึกไว้ใน /var/log/waagent.log

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

อัพเกรด

การอัพเกรดผ่านที่เก็บแพ็คเกจการแจกจ่ายหรือใช้การอัพเดตอัตโนมัติเป็นวิธีเดียวที่สนับสนุน คุณสามารถค้นหาข้อมูลเพิ่มเติมได้ที่นี่: การอัพเดต Linux Agent

หากต้องการอัปเกรด waagent จากซอร์สโค้ด คุณสามารถใช้ setuptools การอัปเกรดจากแหล่งที่มามีไว้สำหรับผู้ใช้ขั้นสูงเท่านั้น และเรามีการสนับสนุนที่จำกัดมากสำหรับวิธีนี้

-

sudo python setup.py ติดตั้ง --force

-

เริ่มบริการ waagent ใหม่:

-

sudo service waagent รีสตาร์ท

-

สำหรับ Ubuntu ให้ใช้:

-

บริการ sudo walinuxagent รีสตาร์ท

-

สำหรับ CoreOS ให้ใช้:

-

sudo systemctl รีสตาร์ท waagent

-

ตัวเลือกบรรทัดคำสั่ง

โลโก้

-verbose: เพิ่มการใช้คำฟุ่มเฟือยของคำสั่งที่ระบุ

-force: ข้ามการยืนยันแบบโต้ตอบสำหรับบางคำสั่ง

คำสั่ง

-help: แสดงรายการคำสั่งและแฟล็กที่รองรับ

-ยกเลิกการจัดเตรียม: ความพยายามในการทำความสะอาดระบบและทำให้เหมาะสำหรับการจัดเตรียมใหม่โดยการลบสิ่งต่อไปนี้:

* คีย์โฮสต์ SSH ทั้งหมด (หาก Provisioning.RegenerateSshHostKeyPair ในไฟล์การกำหนดค่าคือ 'y')

* การกำหนดค่าเนมเซิร์ฟเวอร์ใน /etc/resolv.conf

* รหัสผ่านรูทใน /etc/shadow (หาก Provisioning.DeleteRootPassword ในไฟล์คอนฟิกูเรชันคือ 'y')

* การเช่าไคลเอนต์ DHCP แคช

* รีเซ็ตชื่อโฮสต์เป็น localhost.localdomain

เตือน! การยกเลิกการจัดเตรียมไม่สามารถรับประกันได้ว่ารูปภาพจะได้รับการกำจัดข้อมูลที่ละเอียดอ่อนทั้งหมดแล้ว และเหมาะสำหรับการแจกจ่ายซ้ำ

-deprovision+user: ดำเนินการทั้งหมดภายใต้การยกเลิกการจัดสรร (ตามที่อธิบายไว้ข้างต้น) รวมถึงลบบัญชีผู้ใช้ที่จัดเตรียมครั้งล่าสุดและข้อมูลที่เกี่ยวข้อง

-version: แสดงเวอร์ชัน waagent

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

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

-start: รัน waagent เป็นกระบวนการเบื้องหลัง

-collect-logs [-full]: รันยูทิลิตี้การรวบรวมบันทึก ซึ่งจะรวบรวมบันทึกที่เกี่ยวข้องกับเอเจนต์เพื่อวัตถุประสงค์ในการแก้ไขจุดบกพร่อง และจัดเก็บไว้ในโฟลเดอร์ตัวแทนบนดิสก์ ตำแหน่งที่แน่นอนจะปรากฏขึ้นเมื่อเรียกใช้ ใช้แฟล็ก -full เพื่อการรวบรวมบันทึกที่ครอบคลุมมากขึ้น

การกำหนดค่า

ไฟล์การกำหนดค่า (/etc/waagent.conf) ควบคุมการทำงานของ waagent บรรทัดว่างและบรรทัดที่มีอักขระตัวแรกเป็น # จะถูกละเว้น (ไม่รองรับความคิดเห็นที่ท้ายบรรทัด)

ไฟล์การกำหนดค่าตัวอย่างแสดงอยู่ด้านล่าง:

-

Extensions.Enabled=y

Extensions.GoalStatePeriod=6

Provisioning.Agent=อัตโนมัติ

การจัดเตรียม DeleteRootPassword = n

การจัดเตรียม RegenerateSshHostKeyPair=y

การจัดเตรียม SshHostKeyPairType=rsa

การจัดเตรียม MonitorHostName=y

การจัดเตรียม DecodeCustomData=n

การจัดเตรียม.ExecuteCustomData=n

การจัดเตรียมPasswordCryptId=6

การจัดเตรียมPasswordCryptSaltLength=10

ResourceDisk.Format=y

ResourceDisk.Filesystem=ext4

ResourceDisk.MountPoint=/mnt/resource

ResourceDisk.MountOptions=ไม่มี

ResourceDisk.EnableSwap=n

ResourceDisk.EnableSwapEncryption=n

ResourceDisk.SwapSizeMB=0

Logs.Verbose=n

Logs.Collect=y

Logs.CollectPeriod=3600

OS.AllowHTTP=n

OS.RootDeviceScsiTimeout=300

OS.EnableFIPS=n

OS.OpensslPath=ไม่มี

OS.SshClientAliveInterval=180

OS.SshDir=/etc/ssh

HttpProxy.Host=ไม่มี

HttpProxy.Port=ไม่มี

-

ตัวเลือกการกำหนดค่าต่างๆ มีคำอธิบายโดยละเอียดด้านล่าง ตัวเลือกการกำหนดค่าแบ่งออกเป็นสามประเภท: บูลีน สตริง และจำนวนเต็ม ตัวเลือกการกำหนดค่าบูลีนสามารถระบุเป็น "y" หรือ "n" คำสำคัญพิเศษ "ไม่มี" สามารถใช้ได้กับรายการการกำหนดค่าสตริงบางรายการ ตามที่อธิบายไว้ด้านล่าง

ตัวเลือกโปรไฟล์

ส่วนขยายเปิดใช้งานแล้ว

ประเภท: บูลีน

ค่าเริ่มต้น: y

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

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

ส่วนขยาย WaitForCloudInit

ประเภท: บูลีน

ค่าเริ่มต้น: n

รอให้ cloud-init ดำเนินการให้เสร็จสิ้นก่อนดำเนินการขยายเครื่องเสมือน (สถานะ cloud-init --wait)

ส่วนขยาย cloud-init และ virtual machine เป็นวิธีทั่วไปในการปรับแต่งเครื่องเสมือนในระหว่างการปรับใช้ครั้งแรก ตามค่าเริ่มต้น เอเจนต์จะเริ่มดำเนินการปรับขนาดในขณะที่ cloud-init อาจยังอยู่ในระยะ 'การกำหนดค่า' และจะไม่รอให้ระยะ 'สุดท้าย' เสร็จสมบูรณ์ cloud-init และส่วนขยายอาจดำเนินการที่ขัดแย้งกัน (เช่น ทั้งสองอาจพยายามติดตั้งแพ็คเกจ) การตั้งค่าตัวเลือกนี้เป็น 'y' ช่วยให้มั่นใจได้ว่าการขยายเครื่องเสมือนจะดำเนินการหลังจาก cloud-init เสร็จสิ้นทุกขั้นตอนแล้วเท่านั้น

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

ส่วนขยาย WaitForCloudInitTimeout

ประเภท: จำนวนเต็ม

ค่าเริ่มต้น: 3600

หมดเวลาเป็นวินาทีเพื่อให้ตัวแทนรอ cloud-init หากการหมดเวลาหมดลง เอเจนต์ยังคงดำเนินการขยายเครื่องเสมือนต่อไป ดู Extensions.WaitForCloudInit สำหรับรายละเอียดเพิ่มเติม

Extensions.GoalStatePeriod

ประเภท: จำนวนเต็ม

ค่าเริ่มต้น: 6

ความถี่ (เป็นวินาที) ในการสำรวจสถานะเป้าหมายใหม่และรายงานสถานะของเครื่องเสมือนและส่วนขยาย สถานะเป้าหมายอธิบายสถานะที่ต้องการของส่วนขยายบนเครื่องเสมือน

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

AutoUpdate.UpdateToLatestVersion

ประเภท: บูลีน

ค่าเริ่มต้น: y

เปิดใช้งานการอัปเดตตัวจัดการส่วนขยายอัตโนมัติ ตัวจัดการส่วนขยายมีหน้าที่จัดการส่วนขยายและรายงานสถานะของเครื่องเสมือน ฟังก์ชันการทำงานหลักของเอเจนต์มีอยู่ในตัวจัดการส่วนขยาย และขอแนะนำให้ผู้ใช้เปิดใช้งานตัวเลือกนี้เพื่อรักษาเวอร์ชันล่าสุด

เมื่อเปิดใช้งานตัวเลือกนี้ ตัวแทนจะติดตั้งเวอร์ชันใหม่เมื่อพร้อมใช้งาน เมื่อปิดใช้งาน เอเจนต์จะไม่ติดตั้งเวอร์ชันใหม่ใดๆ แต่จะใช้เวอร์ชันล่าสุดที่ติดตั้งไว้แล้วบนเครื่องเสมือน

แสดงให้เห็น:

สำหรับข้อมูลเพิ่มเติมเกี่ยวกับเวอร์ชันตัวแทน โปรดดูคำถามที่พบบ่อยของเรา

สำหรับข้อมูลเพิ่มเติมเกี่ยวกับการอัพเดตตัวแทน โปรดดูคำถามที่พบบ่อยของเรา

สำหรับข้อมูลเพิ่มเติมเกี่ยวกับ AutoUpdate.UpdateToLatestVersion และ AutoUpdate.Enabled โปรดดูคำถามที่พบบ่อยของเรา

อัปเดตอัตโนมัติเปิดใช้งานแล้ว

ประเภท: บูลีน

ค่าเริ่มต้น: y

เปิดใช้งานการอัปเดตตัวจัดการส่วนขยายอัตโนมัติ การตั้งค่าสถานะนี้ได้รับการสนับสนุนด้วยเหตุผลดั้งเดิม และเราขอแนะนำอย่างยิ่งให้ใช้ AutoUpdate.UpdateToLatestVersion แทนการตั้งค่าสถานะนี้

ความแตกต่างระหว่างแฟล็กทั้งสองนี้คือเมื่อตั้งค่าเป็น 'n' AutoUpdate.Enabled จะใช้เวอร์ชันตัวจัดการส่วนขยายที่ติดตั้งไว้ล่วงหน้าบนอิมเมจ ในขณะที่ AutoUpdate.UpdateToLatestVersion จะใช้เวอร์ชันล่าสุดที่ติดตั้งบนเครื่องเสมือน (ผ่านการอัปเดตอัตโนมัติ) .

ในการแจกแจงส่วนใหญ่ ค่าเริ่มต้นคือ 'y'

การจัดเตรียมตัวแทน

ประเภท: สตริง

ค่าเริ่มต้น: อัตโนมัติ

เลือกตัวแทนการเตรียมใช้งานที่จะใช้ (หรืออนุญาตให้ Waagent ระบุสิ่งนี้โดยระบุ "อัตโนมัติ") ตัวเลือกที่เป็นไปได้คือ "อัตโนมัติ" (ค่าเริ่มต้น), "waagent", "cloud-init" หรือ "disabled"

การจัดเตรียมเปิดใช้งานแล้ว (ลบออกใน 2.2.45)

ประเภท: บูลีน

ค่าเริ่มต้น: y

ตัวเลือกนี้อนุญาตให้ผู้ใช้สามารถเปิดหรือปิดใช้งานฟังก์ชันการจัดเตรียมในตัวแทนได้ ค่าที่ถูกต้องคือ "y" หรือ "n" หากปิดใช้งานการจัดเตรียม โฮสต์ SSH และคีย์ผู้ใช้ในรูปภาพจะยังคงอยู่ และการกำหนดค่าใดๆ ที่ระบุใน Azure Provisioning API จะถูกละเว้น

หมายเหตุ: ตัวเลือกการกำหนดค่านี้ได้ถูกลบออกแล้วและไม่มีผลกระทบใดๆ อีกต่อไป ขณะนี้ waagent ตรวจพบ cloud-init ในฐานะเอเจนต์การจัดเตรียมโดยอัตโนมัติ (สามารถเลือกแทนที่ได้โดยใช้ Provisioning.Agent)

การจัดเตรียม MonitorHostName

ประเภท: บูลีน

ค่าเริ่มต้น: n

ตรวจสอบการเปลี่ยนแปลงชื่อโฮสต์และเผยแพร่การเปลี่ยนแปลงผ่านคำขอ DHCP

การจัดเตรียม MonitorHostNamePeriod

ประเภท: จำนวนเต็ม

ค่าเริ่มต้น: 30

บ่อยแค่ไหน (เป็นวินาที) ในการตรวจสอบการเปลี่ยนแปลงชื่อโฮสต์ หากไม่ได้ตั้งค่า MonitorHostName การตั้งค่านี้จะถูกละเว้น

การจัดเตรียม UseCloudInit

ประเภท: บูลีน

ค่าเริ่มต้น: n

ตัวเลือกนี้เปิด/ปิดการสนับสนุนสำหรับการจัดเตรียมผ่าน cloud-init

หากเป็นจริง ("y") เอเจนต์จะรอให้ cloud-init ดำเนินการให้เสร็จสิ้นก่อนที่จะติดตั้งส่วนขยายและประมวลผลสถานะเป้าหมายล่าสุด Provisioning.Enabled ต้องปิดการใช้งาน ("n") เพื่อให้ตัวเลือกนี้มีผล การตั้งค่า Provisioning.Enabled เป็นจริง ("y") จะแทนที่ตัวเลือกนี้ และรันโค้ดการจัดเตรียมเอเจนต์ในตัว

หมายเหตุ: ตัวเลือกการกำหนดค่านี้ได้ถูกลบออกแล้วและไม่มีผลกระทบใดๆ อีกต่อไป ขณะนี้ waagent ตรวจพบ cloud-init ในฐานะเอเจนต์การจัดเตรียมโดยอัตโนมัติ (สามารถเลือกแทนที่ได้โดยใช้ Provisioning.Agent)

การจัดเตรียม ลบรหัสผ่านรูท

ประเภท: บูลีน

ค่าเริ่มต้น: n

หากตั้งค่าตัวเลือกนี้ รหัสผ่านรูทในไฟล์ /etc/shadow จะถูกลบออกในระหว่างการจัดเตรียม

การจัดเตรียม สร้าง SshHostKeyPair ใหม่

ประเภท: บูลีน

ค่าเริ่มต้น: y

หากตั้งค่าตัวเลือกนี้ คู่คีย์โฮสต์ SSH ทั้งหมด (ecdsa, dsa และ rsa) ใน /etc/ssh/ จะถูกลบระหว่างการจัดเตรียม และสร้างคู่คีย์ใหม่

ประเภทการเข้ารหัสของคู่คีย์ใหม่สามารถกำหนดค่าได้ผ่านรายการ Provisioning.SshHostKeyPairType โปรดทราบว่าการแจกแจงบางส่วนจะสร้างคู่คีย์ SSH ขึ้นมาใหม่สำหรับประเภทการเข้ารหัสที่ขาดหายไปเมื่อรีสตาร์ท SSH daemon (เช่น หลังจากรีบูต)

การจัดเตรียม SshHostKeyPairType

ประเภท: สตริง

ค่าเริ่มต้น: rsa

สามารถตั้งค่าเป็นประเภทของอัลกอริธึมการเข้ารหัสที่รองรับโดย SSH daemon บนเครื่องเสมือน ค่าที่รองรับโดยทั่วไป ได้แก่ "rsa", "dsa" และ "ecdsa"

โปรดทราบว่า "ecdsa" ไม่ได้รับการสนับสนุนโดย "putty.exe" บน Windows ดังนั้น หากคุณวางแผนที่จะใช้ putty.exe บน Windows เพื่อเชื่อมต่อกับการปรับใช้ Linux ให้ใช้ "rsa" หรือ "dsa"

การจัดเตรียม MonitorHostName

ประเภท: บูลีน

ค่าเริ่มต้น: y

หากตั้งค่าตัวเลือกนี้ waagent จะตรวจสอบเครื่องเสมือน Linux สำหรับการเปลี่ยนชื่อโฮสต์ (ตามที่ส่งคืนโดยคำสั่ง "ชื่อโฮสต์") และอัปเดตการกำหนดค่าเครือข่ายในอิมเมจโดยอัตโนมัติเพื่อแสดงการเปลี่ยนแปลง เพื่อผลักดันการเปลี่ยนชื่อไปยังเซิร์ฟเวอร์ DNS เครือข่ายในเครื่องเสมือนจะเริ่มต้นใหม่ ซึ่งจะทำให้การเชื่อมต่ออินเทอร์เน็ตขาดหายในช่วงสั้นๆ

การจัดเตรียม DecodeCustomData

ประเภท: บูลีน

ค่าเริ่มต้น: n

หากตั้งค่าตัวเลือกนี้ waagent จะถอดรหัส CustomData จาก Base64

การจัดเตรียม ExecuteCustomData

ประเภท: บูลีน

ค่าเริ่มต้น: n

หากตั้งค่าตัวเลือกนี้ waagent จะดำเนินการ CustomData หลังจากการจัดเตรียม

การจัดเตรียมรหัสผ่านCryptId

ประเภท: สตริง

ค่าเริ่มต้น: 6

อัลกอริทึมที่ใช้โดยฝังศพใต้ถุนโบสถ์เมื่อสร้างแฮชรหัสผ่าน

การจัดเตรียมรหัสผ่านCryptSaltLength

ประเภท: สตริง

ค่าเริ่มต้น: 10

ความยาวของเกลือสุ่มที่ใช้ในการสร้างแฮชรหัสผ่าน

ResourceDisk รูปแบบ

ประเภท: บูลีน

ค่าเริ่มต้น: y

หากตั้งค่าตัวเลือกนี้ ดิสก์ทรัพยากรที่แพลตฟอร์มจัดเตรียมไว้จะถูกฟอร์แมตและติดตั้งโดย waagent โดยมีเงื่อนไขว่าประเภทระบบไฟล์ที่ผู้ใช้ร้องขอใน "ResourceDisk.Filesystem" ไม่ใช่ "ntfs" พาร์ติชั่นเดียวประเภท Linux (83) จะถูกจัดเตรียมไว้บนดิสก์ โปรดทราบว่าหากสามารถติดตั้งพาร์ติชันนี้ได้สำเร็จ พาร์ติชันนั้นจะไม่ได้รับการฟอร์แมต

ResourceDisk.ระบบไฟล์

ประเภท: สตริง

ค่าเริ่มต้น: ext4

นี่เป็นการระบุประเภทระบบไฟล์ของดิสก์ทรัพยากร ค่าที่รองรับจะแตกต่างกันไปตามการกระจาย Linux หากสตริงคือ X mkfs.X ควรจะปรากฏในอิมเมจ Linux โดยทั่วไปรูปภาพ SLES 11 ควรใช้ 'ext3' รูปภาพ BSD ควรใช้ 'ufs2' ที่นี่

ResourceDisk.MountPoint

ประเภท: สตริง

ค่าเริ่มต้น: /mnt/resource

นี่เป็นการระบุเส้นทางเพื่อเมานต์ดิสก์ทรัพยากร

ResourceDisk.MountOptions

ประเภท: สตริง

ค่าเริ่มต้น: ไม่มี

ระบุอ็อพชันการเมาต์ดิสก์ที่จะส่งผ่านไปยังคำสั่ง mount -o นี่คือรายการค่าที่คั่นด้วยเครื่องหมายจุลภาค เช่น 'nodev,nosuid' ดูเมานท์ (8) สำหรับรายละเอียด

ResourceDisk.EnableSwap

ประเภท: บูลีน

ค่าเริ่มต้น: n

หากตั้งค่าตัวเลือกนี้ ไฟล์สลับ (/swapfile) จะถูกสร้างขึ้นบนดิสก์ทรัพยากรและเพิ่มลงในพื้นที่สว็อปของระบบ

ResourceDisk.EnableSwapEncryption

ประเภท: บูลีน

ค่าเริ่มต้น: n

หากตั้งค่าตัวเลือกนี้ ไฟล์สลับ (/swapfile) จะถูกเมาท์เป็นระบบไฟล์ที่เข้ารหัส (แฟล็กรองรับบน FreeBSD เท่านั้น)

ResourceDisk.SwapSizeMB

ประเภท: จำนวนเต็ม

ค่าเริ่มต้น: 0

ขนาดของไฟล์สว็อปเป็นเมกะไบต์

Logs.รายละเอียด

ประเภท: บูลีน

ค่าเริ่มต้น: n

หากตั้งค่าตัวเลือกนี้ รายละเอียดบันทึกจะเพิ่มขึ้น waagent บันทึกไปที่ /var/log/waagent.log และใช้ฟังก์ชัน logrotate ของระบบเพื่อหมุนบันทึก

บันทึก.รวบรวม

ประเภท: บูลีน

ค่าเริ่มต้น: y

หากตั้งค่าตัวเลือกนี้ บันทึกของตัวแทนจะถูกรวบรวมเป็นระยะและอัปโหลดไปยังตำแหน่งที่ปลอดภัยเพื่อปรับปรุงการสนับสนุน

หมายเหตุ: คุณลักษณะนี้ขึ้นอยู่กับความสามารถในการใช้ทรัพยากรของตัวแทน (cgroups) การตั้งค่าสถานะนี้จะไม่ส่งผลต่อการกระจายใดๆ ที่ไม่รองรับ

Logs.CollectPeriod

ประเภท: จำนวนเต็ม

ค่าเริ่มต้น: 3600

วิธีนี้จะกำหนดค่าความถี่ในการรวบรวมและอัปโหลดบันทึก ค่าเริ่มต้นคือรายชั่วโมง

หมายเหตุ: สิ่งนี้จะมีผลเมื่อเปิดใช้งานตัวเลือก Logs.Collect เท่านั้น

OS.AllowHTTP

ประเภท: บูลีน

ค่าเริ่มต้น: n

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

หมายเหตุ: การอนุญาต HTTP อาจเปิดเผยข้อมูลที่ปลอดภัยโดยไม่ได้ตั้งใจ

OS.EnableRDMA

ประเภท: บูลีน

ค่าเริ่มต้น: n

หากตั้งค่าตัวเลือกนี้ เอเจนต์จะพยายามติดตั้งและโหลดไดรเวอร์เคอร์เนล RDMA ที่ตรงกับเวอร์ชันเฟิร์มแวร์บนฮาร์ดแวร์พื้นฐาน

OS.เปิดใช้งาน FIPS

ประเภท: บูลีน

ค่าเริ่มต้น: n

หากตั้งค่าตัวเลือกนี้ เอเจนต์จะปล่อย "OPENSSL_FIPS=1" ไปยังสภาพแวดล้อมเมื่อดำเนินการคำสั่ง OpenSSL สิ่งนี้จะสั่งให้ OpenSSL ใช้ไลบรารีที่สอดคล้องกับ FIPS ที่ติดตั้งไว้

โปรดทราบว่าตัวแทนเองไม่มีรหัสที่เกี่ยวข้องกับ FIPS หากไม่ได้ติดตั้งใบรับรองที่สอดคล้องกับ FIPS การเปิดใช้งานตัวเลือกนี้จะทำให้คำสั่ง OpenSSL ทั้งหมดล้มเหลว

OS.MonitorDhcpClientRestartPeriod

ประเภท: จำนวนเต็ม

ค่าเริ่มต้น: 30

เอเจนต์จะตรวจสอบการรีสตาร์ทไคลเอ็นต์ DHCP และกู้คืนกฎเครือข่ายเมื่อการรีสตาร์ทเกิดขึ้น การตั้งค่านี้กำหนดความถี่ในการรีสตาร์ทการตรวจสอบ

OS.RootDeviceScsiTimeout

ประเภท: จำนวนเต็ม

ค่าเริ่มต้น: 300

ซึ่งจะกำหนดค่าการหมดเวลา SCSI ในหน่วยวินาทีบนอุปกรณ์รูท หากไม่ได้ตั้งค่า ระบบจะใช้ค่าเริ่มต้น

OS.RootDeviceScsiTimeoutPeriod

ประเภท: จำนวนเต็ม

ค่าเริ่มต้น: 30

ความถี่ (เป็นวินาที) ในการตั้งค่าการหมดเวลา SCSI บนอุปกรณ์รูท หากไม่ได้ตั้งค่า RootDeviceScsiTimeout การตั้งค่านี้จะถูกละเว้น

OS.OpensslPath

ประเภท: สตริง

ค่าเริ่มต้น: ไม่มี

ซึ่งสามารถใช้เพื่อระบุเส้นทางอื่นไปยังไบนารี openssl ที่ใช้สำหรับการดำเนินการเข้ารหัส

OS.RemovePersistentNetRulesPeriod

ประเภท: จำนวนเต็ม

ค่าเริ่มต้น: 30

ความถี่ (เป็นวินาที) กฎ udev (75-persistent-net-generator.rules และ /etc/udev/rules.d/70-persistent-net.rules) ถูกลบสำหรับชื่ออินเทอร์เฟซเครือข่ายถาวร

OS.SshClientAliveInterval

ประเภท: จำนวนเต็ม

ค่าเริ่มต้น: 180

ค่านี้จะกำหนดจำนวนวินาทีที่เอเจนต์ใช้สำหรับตัวเลือกการกำหนดค่า SSH ClientAliveInterval

OS.SshDir

ประเภท: สตริง

ค่าเริ่มต้น: /etc/ssh

ตัวเลือกนี้สามารถใช้เพื่อแทนที่ตำแหน่งเริ่มต้นของไดเร็กทอรีการกำหนดค่า SSH

HttpProxy.Host, HttpProxy.พอร์ต

ประเภท: สตริง

ค่าเริ่มต้น: ไม่มี

หากตั้งค่าตัวเลือกนี้ เอเจนต์จะใช้พร็อกซีเซิร์ฟเวอร์นี้สำหรับคำขอ HTTP/HTTPS ค่าเหล่านี้จะแทนที่ตัวแปรสภาพแวดล้อม httpproxy หรือ httpsproxy สุดท้ายนี้ จำเป็นต้องใช้ HttpProxy.Host หากใช้ และ HttpProxy.Port เป็นทางเลือก

Cgroups.EnforceLimits

ประเภท: บูลีน

ค่าเริ่มต้น: y

หากตั้งค่าอ็อพชันนี้ เอเจนต์จะพยายามตั้งค่าขีดจำกัด cgroups สำหรับ CPU และหน่วยความจำสำหรับกระบวนการเอเจนต์เองตลอดจนสำหรับกระบวนการขยาย ดูวิกิสำหรับรายละเอียดเพิ่มเติมเกี่ยวกับเรื่องนี้

CGgroups ไม่รวม

ประเภท: สตริง

ค่าเริ่มต้น: customscript, runcommand

รายการส่วนขยายที่จะแยกออกจากข้อจำกัดของ cgroups ควรคั่นด้วยเครื่องหมายจุลภาค

การวัดและส่งข้อมูลทางไกล

WALinuxAgent รวบรวมและส่งข้อมูลการใช้งานไปยัง Microsoft เพื่อช่วยเราปรับปรุงผลิตภัณฑ์และบริการของเรา ข้อมูลที่รวบรวมจะใช้ในการติดตามความสมบูรณ์ของบริการและช่วยเหลือตามคำขอการสนับสนุนของ Azure ข้อมูลที่รวบรวมไม่มีข้อมูลที่สามารถระบุตัวบุคคลได้ อ่านคำชี้แจงสิทธิ์ส่วนบุคคลของเราเพื่อเรียนรู้เพิ่มเติม

ขณะนี้ WALinuxAgent ไม่รองรับการปิดใช้งานการวัดและส่งข้อมูลทางไกล หากต้องการปิดใช้งานการรวบรวมการวัดและส่งข้อมูลทางไกล ต้องลบ WALinuxAgent ออก หากคุณต้องการฟังก์ชันนี้ โปรดเปิดปัญหาบน GitHub และอธิบายความต้องการของคุณ

ภาคผนวก

เราไม่ได้เก็บข้อมูลบรรจุภัณฑ์ไว้ในที่เก็บข้อมูลนี้ แต่ตัวอย่างบางส่วนแสดงไว้ด้านล่างเพื่อใช้อ้างอิง สำหรับบรรจุภัณฑ์ที่ได้รับการบำรุงรักษาอย่างเป็นทางการ โปรดดูที่เก็บข้อมูลการเผยแพร่ขั้นปลาย

แพ็คเกจดีบี

สามารถดูแพ็คเกจ Ubuntu WALinuxAgent อย่างเป็นทางการได้ที่นี่

ดำเนินการครั้งเดียว:

ติดตั้งแพ็คเกจที่จำเป็น

-

sudo apt-get -y ติดตั้ง ubuntu-dev-tools pbuilder python-all debhelper

-

สร้างสภาพแวดล้อมของตัวสร้าง pbuilder

-

sudo pbuilder สร้าง --debootstrapopts --variant=buildd

-

รับ waagent.dsc จากที่เก็บแพ็กเกจดาวน์สตรีม

หากต้องการคอมไพล์แพ็คเกจ ให้ทำดังต่อไปนี้จากไดเร็กทอรีบนสุด:

สร้างแพ็คเกจซอร์สโค้ด

-

dpkg-buildpackage -S

-

สร้างแพ็คเกจ

-

sudo pbuilder สร้าง waagent.dsc

-

รับแพ็คเกจที่สร้างขึ้น ซึ่งโดยปกติจะอยู่ใน /var/cache/pbuilder/result

แพ็คเกจรอบต่อนาที

คำแนะนำต่อไปนี้อธิบายวิธีสร้างแพ็คเกจ rpm

ติดตั้งเครื่องมือตั้งค่า

-

ขด https://bootstrap.pypa.io/ez_setup.py -o - | หลาม

-

คำสั่งต่อไปนี้จะสร้าง RPM ไบนารีและต้นทาง:

-

หลาม setup.py bdist_rpm

-

โครงการนี้ได้นำหลักจรรยาบรรณของ Microsoft สำหรับโค้ดโอเพ่นซอร์สมาใช้ สำหรับข้อมูลเพิ่มเติม โปรดดูคำถามที่พบบ่อยเกี่ยวกับหลักจรรยาบรรณ หรือติดต่อ [email protected] หากมีคำถามหรือความคิดเห็นเพิ่มเติม

ตัวอย่าง:

ใบอนุญาต Apache-2.0