تنزيل WALinuxAgent - تنزيل كود مصدر WALinuxAgent

WALinuxAgent

شفرة المصدر الأخرى

2.11.1.12

تنزيل

وكيل مايكروسوفت أزور لينكس

سيقدم لك محرر Downcodes Microsoft Azure Linux Agent (waagent)، وهي أداة تدير توفير Linux وتفاعل الآلة الافتراضية مع Azure Fabric Controller. وهو يوفر الإمكانيات التالية لعمليات نشر Linux IaaS:

وظيفة

1. توفير الصور: waagent مسؤول عن إدارة عملية التوفير الأولية لأجهزة Linux الافتراضية، بما في ذلك تكوين الشبكة وتثبيت برامج التشغيل وإعداد حسابات المستخدمين الأولية.

2. إدارة الشبكة: يقوم waagent بالتنسيق مع وحدة تحكم Azure Fabric لتكوين إعدادات شبكة الجهاز الظاهري، مثل عنوان IP وقناع الشبكة الفرعية والبوابة.

3. إدارة Kernel: يمكن لـ waagent إدارة تحديثات kernel للجهاز الظاهري للتأكد من أنه يعمل دائمًا بأحدث إصدار kernel وآمن.

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 للتجاوزات).

مثال

`

cat /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 بواسطة التوزيع الخاص بك وهو مخصص للمستخدمين المتقدمين فقط. لدينا دعم محدود للغاية لهذه الطريقة.

للتثبيت من المصدر، يمكنك استخدام أدوات الإعداد:

`

تثبيت sudo python setup.py - خدمة التسجيل

`

بالنسبة لبيثون 3، استخدم:

`

تثبيت Sudo python3 setup.py - خدمة التسجيل

`

يمكنك عرض المزيد من خيارات التثبيت عن طريق تشغيل الأمر التالي:

`

تثبيت 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 waagent

`

بالنسبة لأوبونتو، استخدم:

`

إعادة تشغيل خدمة sudo walinuxagent

`

بالنسبة لنظام التشغيل CoreOS، استخدم:

`

سودو systemctl إعادة تشغيل waagent

`

خيارات سطر الأوامر

شعار

- مطول: زيادة إسهاب الأمر المحدد.

-force: تخطي التأكيد التفاعلي لبعض الأوامر.

طلب

-مساعدة: قائمة الأوامر والأعلام المدعومة.

-إزالة التوفير: محاولات لتنظيف النظام وجعله مناسبًا لإعادة التوفير عن طريق إزالة ما يلي:

* جميع مفاتيح مضيف SSH (إذا كان Provisioning.RegenerateSshHostKeyPair في ملف التكوين هو 'y').

* تكوين خادم الأسماء في /etc/resolv.conf.

* كلمة المرور الجذرية في /etc/shadow (إذا كان Provisioning.DeleteRootPassword في ملف التكوين هو 'y').

* تأجير عميل DHCP المخزن مؤقتًا.

* إعادة تعيين اسم المضيف إلى localhost.localdomain.

تحذير! لا يمكن أن يضمن إلغاء التوفير أن الصورة قد تم تنظيفها من كافة المعلومات الحساسة وأنها مناسبة لإعادة التوزيع.

-deprovision+user: ينفذ جميع الإجراءات بموجب إلغاء التوفير (الموضح أعلاه)، بالإضافة إلى حذف آخر حساب مستخدم تم توفيره والبيانات المرتبطة به.

-الإصدار: عرض إصدار waagent.

-serialconsole: قم بتكوين GRUB لتمييز ttyS0 (المنفذ التسلسلي الأول) كوحدة تحكم التمهيد. سيضمن هذا إرسال سجلات تمهيد kernel إلى المنفذ التسلسلي ويمكن استخدامها لتصحيح الأخطاء.

-daemon: قم بتشغيل waagent كعملية خفية لإدارة التفاعل مع النظام الأساسي. تم تحديد هذه المعلمة لـ waagent في البرنامج النصي لتهيئة waagent.

-start: قم بتشغيل waagent كعملية خلفية.

-collect-logs [-full]: يقوم بتشغيل الأداة المساعدة لجمع السجلات، والتي ستقوم بجمع السجلات المتعلقة بالوكيل لأغراض تصحيح الأخطاء وتخزينها في مجلد الوكيل على القرص. سيتم عرض الموقع الدقيق عند التشغيل. استخدم العلامة -full لجمع سجلات أكثر شمولاً.

إعدادات

يتحكم ملف التكوين (/etc/waagent.conf) في تشغيل waagent. يتم تجاهل الأسطر والأسطر الفارغة التي يكون الحرف الأول منها هو # (تعليقات نهاية السطر غير مدعومة).

يظهر مثال لملف التكوين أدناه:

`

Extensions.Enabled=y

Extensions.GoalStatePeriod=6

Provisioning.Agent=auto

Provisioning.DeleteRootPassword=n

Provisioning.RegenerateSshHostKeyPair=y

Provisioning.SshHostKeyPairType=rsa

Provisioning.MonitorHostName=y

Provisioning.DecodeCustomData=n

Provisioning.ExecuteCustomData=n

Provisioning.PasswordCryptId=6

Provisioning.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" أو "n". إذا تم تعطيل المعالجة الموسعة، فستستمر معالجة الحالة المستهدفة وسيتم الإبلاغ عن حالة الجهاز الظاهري، ولكن كل 5 دقائق فقط. سيتم تجاهل التكوين الموسع في الحالة المستهدفة. لاحظ أن ميزات مثل إعادة تعيين كلمة المرور وتحديثات مفاتيح SSH والنسخ الاحتياطية تعتمد على الامتدادات. قم بتعطيل هذا الخيار فقط إذا كنت لا تحتاج إلى الامتداد على الإطلاق.

ملحوظة: تعطيل الامتداد بهذه الطريقة لا يعني عدم استخدام الوكيل على الإطلاق. للقيام بذلك، يجب تعيين علامةprovidingVMAgent في وقت التوفير من خلال أي واجهة برمجة تطبيقات يتم استخدامها. سنقدم المزيد من التفاصيل حول هذا الأمر على الويكي الخاص بنا، لكنه غير متوفر بعد.

Extensions.WaitForCloudInit

النوع: منطقي

القيمة الافتراضية: ن

انتظر حتى اكتمال cloud-init قبل تنفيذ توسيع الجهاز الظاهري (حالة cloud-init --انتظار).

تعد امتدادات cloud-init و Virtual Machine من الطرق الشائعة لتخصيص جهاز ظاهري أثناء النشر الأولي. افتراضيًا، سيبدأ الوكيل في تنفيذ القياس بينما قد يظل cloud-init في مرحلة "التكوين"، ولن ينتظر حتى تكتمل المرحلة "النهائية". قد يقوم cloud-init والملحقات بتنفيذ عمليات تتعارض مع بعضها البعض (على سبيل المثال، قد يحاول كل منهما تثبيت حزمة). يؤدي تعيين هذا الخيار إلى "y" إلى ضمان عدم تنفيذ توسيع الجهاز الظاهري إلا بعد اكتمال cloud-init لجميع المراحل.

لاحظ أن استخدام هذا الخيار يتطلب إنشاء صورة مخصصة وتعيين قيمة هذا الخيار على "y" لضمان تنفيذ عملية الانتظار أثناء النشر الأولي للجهاز الظاهري.

Extensions.WaitForCloudInitTimeout

النوع: عدد صحيح

القيمة الافتراضية: 3600

المهلة بالثواني حتى ينتظر الوكيل Cloud-init. إذا انتهت المهلة، يستمر الوكيل في تنفيذ توسيع الجهاز الظاهري. راجع Extensions.WaitForCloudInit لمزيد من التفاصيل.

Extensions.GoalStatePeriod

النوع: عدد صحيح

القيمة الافتراضية: 6

عدد المرات (بالثواني) لاستطلاع حالة الهدف الجديد والإبلاغ عن حالة الأجهزة الافتراضية والملحقات. تصف الحالة المستهدفة الحالة المطلوبة للامتداد على الجهاز الظاهري.

ملاحظة: قد يؤدي تعيين هذه المعلمة لأكثر من بضع دقائق إلى الإبلاغ عن حالة الجهاز الظاهري على أنها غير مستجيبة/غير متاحة على مدخل Azure. بالإضافة إلى ذلك، يؤثر هذا الإعداد على مدى سرعة بدء الوكيل في إجراء القياس.

AutoUpdate.UpdateToLatestVersion

النوع: منطقي

القيمة الافتراضية: ص

تمكين التحديث التلقائي لمعالجات الامتداد. معالجات الامتدادات مسؤولة عن إدارة الامتدادات والإبلاغ عن حالة الجهاز الظاهري. يتم تضمين الوظيفة الأساسية للوكيل في معالج الامتداد، ويتم تشجيع المستخدمين على تمكين هذا الخيار للحفاظ على الإصدار الأحدث.

عند تمكين هذا الخيار، سيقوم الوكيل بتثبيت الإصدارات الجديدة عندما تصبح متاحة. عند التعطيل، لن يقوم الوكيل بتثبيت أي إصدارات جديدة، ولكنه سيستخدم الإصدار الأحدث المثبت بالفعل على الجهاز الظاهري.

يوضح:

لمزيد من المعلومات حول إصدارات الوكيل، راجع الأسئلة الشائعة.

لمزيد من المعلومات حول تحديثات الوكيل، راجع الأسئلة الشائعة.

لمزيد من المعلومات حول AutoUpdate.UpdateToLatestVersion وAutoUpdate.Enabled، راجع الأسئلة الشائعة.

التحديث التلقائي. ممكّن

النوع: منطقي

القيمة الافتراضية: ص

تمكين التحديث التلقائي لمعالجات الامتداد. هذه العلامة مدعومة لأسباب قديمة ونوصي بشدة باستخدام AutoUpdate.UpdateToLatestVersion بدلاً من هذه العلامة.

الفرق بين هاتين العلامتين هو أنه عند التعيين على 'n'، سيستخدم AutoUpdate.Enabled إصدار معالج الامتداد المثبت مسبقًا على الصورة، بينما سيستخدم AutoUpdate.UpdateToLatestVersion أحدث إصدار مثبت على الجهاز الظاهري (عبر التحديثات التلقائية) .

في معظم التوزيعات، القيمة الافتراضية هي "y".

التزويد. وكيل

النوع: سلسلة

القيمة الافتراضية: تلقائي

حدد وكيل التوفير المطلوب استخدامه (أو اسمح لـ waagent بتحديد ذلك عن طريق تحديد "تلقائي"). الخيارات الممكنة هي "تلقائي" (افتراضي) أو "waagent" أو "cloud-init" أو "معطل".

التزويد.ممكّن (تمت إزالته في 2.2.45)

النوع: منطقي

القيمة الافتراضية: ص

يسمح هذا الخيار للمستخدم بتمكين أو تعطيل وظيفة التوفير في الوكيل. القيم الصالحة هي "y" أو "n". إذا تم تعطيل التزويد، فسيتم الاحتفاظ بمضيف SSH ومفاتيح المستخدم في الصورة، وسيتم تجاهل أي تكوين محدد في Azure Provisioning API.

ملاحظة: تمت إزالة خيار التكوين هذا ولم يعد له أي تأثير. يكتشف waagent الآن تلقائيًا cloud-init كوكيل توفير (يتم تجاوزه اختياريًا باستخدام Provisioning.Agent).

Provisioning.MonitorHostName

النوع: منطقي

القيمة الافتراضية: ن

مراقبة تغييرات اسم المضيف ونشر التغييرات عبر طلبات DHCP.

Provisioning.MonitorHostNamePeriod

النوع: عدد صحيح

القيمة الافتراضية: 30

كم مرة (بالثواني) لمراقبة تغييرات اسم المضيف. إذا لم يتم تعيين MonitorHostName، فسيتم تجاهل هذا الإعداد.

Provisioning.UseCloudInit

النوع: منطقي

القيمة الافتراضية: ن

يعمل هذا الخيار على تمكين/تعطيل دعم التزويد عبر cloud-init.

إذا كان صحيحًا ("y")، فسينتظر الوكيل حتى يكتمل cloud-init قبل تثبيت الملحقات ومعالجة أحدث حالة مستهدفة. Provisioning.Enabled يجب تعطيله ("n") حتى يصبح هذا الخيار ساري المفعول. يؤدي تعيين Provisioning.Enabled إلى true ("y") إلى تجاوز هذا الخيار وتشغيل رمز توفير الوكيل المدمج.

ملاحظة: تمت إزالة خيار التكوين هذا ولم يعد له أي تأثير. يكتشف waagent الآن تلقائيًا cloud-init كوكيل توفير (يتم تجاوزه اختياريًا باستخدام Provisioning.Agent).

التزويد.DeleteRootPassword

النوع: منطقي

القيمة الافتراضية: ن

إذا تم تعيين هذا الخيار، فستتم إزالة كلمة مرور الجذر في ملف /etc/shadow أثناء التزويد.

Provisioning.RegenerateSshHostKeyPair

النوع: منطقي

القيمة الافتراضية: ص

إذا تم تعيين هذا الخيار، فسيتم حذف جميع أزواج مفاتيح مضيف SSH (ecdsa، وdsa، وrsa) في /etc/ssh/ أثناء التزويد. وإنشاء زوج مفاتيح جديد.

يمكن تكوين نوع التشفير لزوج المفاتيح الجديد من خلال إدخال Provisioning.SshHostKeyPairType. لاحظ أن بعض التوزيعات ستعيد إنشاء أزواج مفاتيح SSH لأي أنواع تشفير مفقودة عند إعادة تشغيل البرنامج الخفي SSH (على سبيل المثال، بعد إعادة التشغيل).

Provisioning.SshHostKeyPairType

ملاحظة: تعتمد هذه الميزة على إمكانيات استخدام الموارد الخاصة بالوكيل (مجموعات cgroup)؛ ولن تسري هذه العلامة على أي توزيع غير مدعوم.

Logs.CollectPeriod

النوع: عدد صحيح

القيمة الافتراضية: 3600

يؤدي هذا إلى تكوين عدد مرات جمع السجلات وتحميلها. القيمة الافتراضية هي كل ساعة.

ملاحظة: يسري هذا فقط عند تمكين خيار Logs.Collect.

OS.AllowHTTP

النوع: منطقي

القيمة الافتراضية: ن

إذا لم يتم تجميع دعم SSL في Python، فسيفشل الوكيل في جميع طلبات HTTPS. يمكنك ضبط هذا الخيار على "y" لإرجاع الوكيل إلى HTTP بدلاً من فشل الطلب.

ملاحظة: قد يؤدي السماح بـ HTTP إلى كشف البيانات الآمنة عن غير قصد.

OS.EnableRDMA

النوع: منطقي

القيمة الافتراضية: ن

إذا تم تعيين هذا الخيار، فسيحاول الوكيل تثبيت وتحميل برنامج تشغيل RDMA kernel الذي يطابق إصدار البرنامج الثابت على الجهاز الأساسي.

OS.EnableFIPS

النوع: منطقي

النوع: سلسلة

القيمة الافتراضية: customscript، runcommand

قائمة الملحقات التي سيتم استبعادها من قيود مجموعات التحكم. يجب فصل هذا بفواصل.

القياس عن بعد

يقوم WALinuxAgent بجمع بيانات الاستخدام وإرسالها إلى Microsoft لمساعدتنا في تحسين منتجاتنا وخدماتنا. يتم استخدام البيانات التي تم جمعها لتتبع حالة الخدمة والمساعدة في طلبات دعم Azure. البيانات التي تم جمعها لا تحتوي على أي معلومات شخصية. اقرأ بيان الخصوصية الخاص بنا لمعرفة المزيد.

لا يدعم WALinuxAgent حاليًا تعطيل القياس عن بعد. لتعطيل مجموعة القياس عن بعد، يجب إزالة WALinuxAgent. إذا كنت بحاجة إلى هذه الوظيفة، يرجى فتح مشكلة على GitHub ووصف احتياجاتك.

زائدة

نحن لا نحتفظ بمعلومات التعبئة والتغليف في هذا المستودع، ولكن بعض الأمثلة موضحة أدناه كمرجع. للحصول على التغليف الذي تم صيانته رسميًا، راجع مستودع الإصدار النهائي.

حزمة ديب

يمكن العثور على حزمة Ubuntu WALinuxAgent الرسمية هنا.

تنفيذ مرة واحدة:

تثبيت الحزم المطلوبة

`

Sudo apt-get -y install ubuntu-dev-tools pbuilder python-all debhelper

`

إنشاء بيئة pbuilder

`

sudo pbuilder create --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 - |

`

ستقوم الأوامر التالية بإنشاء RPMs الثنائية والمصدرية:

`

بيثون setup.py bdist_rpm

`

اعتمد هذا المشروع قواعد سلوك Microsoft للتعليمات البرمجية مفتوحة المصدر. لمزيد من المعلومات، راجع الأسئلة المتداولة حول قواعد السلوك، أو اتصل بـ [email protected] لطرح أي أسئلة أو تعليقات إضافية.

مثال:

ترخيص أباتشي-2.0

يوسع

معلومات إضافية