الاتصال الأجهزة المختلطة إلى Azure باستخدام برنامج نصي للنشر

يمكنك تمكين الخوادم التي تدعم Azure Arc لجهاز واحد أو عدد صغير من أجهزة Windows أو Linux في بيئتك من خلال تنفيذ مجموعة من الخطوات يدويا. أو يمكنك استخدام طريقة تلقائية عن طريق تشغيل برنامج نصي للقالب نقدمه. يعمل هذا البرنامج النصي على أتمتة تنزيل وتثبيت كلا الوكيلين.

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

قبل البدء، تأكد من مراجعة المتطلبات الأساسية والتحقق من أن اشتراكك ومواردك تفي بالمتطلبات. للحصول على معلومات حول المناطق المدعومة والاعتبارات الأخرى ذات الصلة، راجع مناطق Azure المدعومة.

إذا لم يكن لديك اشتراك Azure، فأنشئ حساباً مجانياً قبل أن تبدأ.

إنشاء البرنامج النصي للتثبيت من مدخل Azure

يتوفر البرنامج النصي لأتمتة التنزيل والتثبيت، وإنشاء الاتصال ب Azure Arc، من مدخل Azure. لإكمال العملية، قم بتنفيذ الخطوات التالية:

  1. من المتصفح، انتقل إلى مدخل Azure.

  2. في صفحة ⁧⁩الخوادم - Azure Arc⁧⁩، حدد ⁧⁩إضافة⁧⁩ في أعلى اليمين.

  3. في الصفحة ⁧⁩تحديد أسلوب⁧⁩، حدد الجزء ⁧⁩إضافة خوادم باستخدام البرنامج النصي التفاعلي⁧⁩، ثم حدد ⁧⁩إنشاء برنامج نصي⁧⁩.

  4. في الصفحة ⁧⁩إنشاء برنامج نصي⁧⁩، حدد مجموعة الموارد والاشتراك التي تريد أن تتم إدارة الجهاز داخل Azure فيها. حدد موقع Azure حيث سيتم تخزين بيانات تعريف الجهاز. يمكن أن يكون هذا الموقع هو نفسه أو مختلفًا، حسب موقع مجموعة الموارد.

  5. في صفحة ⁧⁩المتطلبات الأساسية⁧⁩، راجع المعلومات ثم حدد ⁧⁩التالي: تفاصيل المورد⁧⁩.

  6. في الصفحة ⁧⁩تفاصيل الموارد⁧⁩، قم بتوفير ما يلي:

    1. في القائمة المنسدلة ⁧⁩مجموعة الموارد⁧⁩، حدد مجموعة الموارد التي ستتم إدارة الجهاز منها.
    2. في القائمة المنسدلة ⁧⁩المنطقة⁧⁩، حدد منطقة Azure المطلوب تخزين بيانات تعريف الخوادم فيها.
    3. في القائمة المنسدلة نظام التشغيل، حدد نظام التشغيل الذي تم تكوين البرنامج النصي لتشغيله عليه.
    4. إذا كان الجهاز متصلاً من خلال خادم وكيل للاتصال بالإنترنت، فحدد عنوان IP للخادم الوكيل أو الاسم ورقم المنفذ اللذين سيستخدمهما الجهاز للاتصال بالخادم الوكيل. أدخل القيمة في التنسيق ⁧http://<proxyURL>:<proxyport>⁩.
    5. حدد ⁧⁩التالي: العلامات⁧⁩.
  7. في صفحة ⁧⁩العلامات⁧⁩، راجع ⁧⁩علامات الموقع الفعلية⁧⁩ الافتراضية المقترحة وأدخل قيمة، أو حدد ⁧⁩علامة مخصصة⁧⁩ واحدة أو أكثر لدعم معاييرك.

  8. حدد ⁧⁩التالي: تنزيل وتشغيل البرنامج النصي⁧⁩.

  9. في الصفحة ⁧⁩تنزيل وتشغيل البرنامج النصي⁧⁩، راجع معلومات الملخص، ثم حدد ⁧⁩تنزيل⁧⁩. إذا كنت لا تزال بحاجة إلى إجراء تغييرات، فحدد ⁧⁩السابق⁧⁩.

تثبيت الوكيل والتحقق من صحته على Windows

التثبيت يدويًا

يمكنك تثبيت عامل الجهاز المتصل يدويا عن طريق تشغيل حزمة Windows Installer AzureConnectedMachineAgent.msi. يمكنك تنزيل أحدث إصدار من حزمة عامل Windows Windows Installer من "مركز التنزيل ل Microsoft".

ملاحظة

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

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

إذا لم تكن معتادا على خيارات سطر الأوامر لحزم Windows Installer، فراجع خيارات سطر الأوامر القياسية Msiexec وخيارات سطر الأوامر Msiexec.

على سبيل المثال، قم بتشغيل برنامج التثبيت باستخدام المعلمة /? لمراجعة خيار التعليمات والمرجع السريع.

msiexec.exe /i AzureConnectedMachineAgent.msi /?
  1. لتثبيت العامل بصمت وإنشاء ملف سجل إعداد في المجلد الموجود C:\Support\Logs ، قم بتشغيل الأمر التالي.

    msiexec.exe /i AzureConnectedMachineAgent.msi /qn /l*v "C:\Support\Logs\Azcmagentsetup.log"
    

    إذا فشل العامل في بدء التشغيل بعد الانتهاء من الإعداد، فتحقق من السجلات للحصول على معلومات مفصلة عن الخطأ. دليل السجل هو ٪ ProgramData٪\AzureConnectedMachineAgent\log.

  2. إذا كان الجهاز بحاجة إلى الاتصال من خلال خادم وكيل، لتعيين متغير بيئة الخادم الوكيل، قم بتشغيل الأمر التالي:

    [Environment]::SetEnvironmentVariable("https_proxy", "http://{proxy-url}:{proxy-port}", "Machine")
    $env:https_proxy = [System.Environment]::GetEnvironmentVariable("https_proxy","Machine")
    # For the changes to take effect, the agent service needs to be restarted after the proxy environment variable is set.
    Restart-Service -Name himds
    

    ملاحظة

    لا يدعم الوكيل إعداد مصادقة الوكيل.

  3. بعد تثبيت الوكيل، تحتاج إلى تكوينه للاتصال بخدمة Azure Arc عن طريق تشغيل الأمر التالي:

    "%ProgramFiles%\AzureConnectedMachineAgent\azcmagent.exe" connect --resource-group "resourceGroupName" --tenant-id "tenantID" --location "regionName" --subscription-id "subscriptionID"
    

التثبيت باستخدام الطريقة النصية

  1. قم بتسجيل الدخول إلى الخادم.

  2. فتح موجه أوامر PowerShell غير مُقيَّدة.

    ملاحظة

    لا يدعم البرنامج النصي إلا تشغيل من إصدار 64 بت من Windows PowerShell.

  3. قم بالتغيير إلى المجلد أو نسخ البرنامج النصي الذي شاركته وتنفيذه على الخادم عن طريق تشغيل البرنامج النصي ⁧./OnboardingScript.ps1⁩.

إذا فشل العامل في بدء التشغيل بعد الانتهاء من الإعداد، فتحقق من السجلات للحصول على معلومات مفصلة عن الخطأ. دليل السجل هو ٪ ProgramData٪\AzureConnectedMachineAgent\log.

تثبيت الوكيل والتحقق من صحته على Linux

يتم توفير وكيل الجهاز المتصل لنظام التشغيل Linux بتنسيق الحزمة المفضل للتوزيع (. دورة في الدقيقة أو . DEB) التي تتم استضافتها في مستودع حزم Microsoft. تقوم حزمة Install_linux_azcmagent.shالبرنامج النصي shell بتنفيذ الإجراءات التالية:

  • يقوم بتكوين الجهاز المضيف لتنزيل حزمة الوكيل من packages.microsoft.com.

  • تثبيت حزمة موفر الموارد المختلطة.

اختياريا، يمكنك تكوين العامل باستخدام معلومات الوكيل الخاصة بك عن طريق تضمين المعلمة --proxy "{proxy-url}:{proxy-port}" . باستخدام هذا التكوين، يتصل العامل من خلال الخادم الوكيل باستخدام بروتوكول HTTP.

يحتوي البرنامج النصي أيضا على منطق لتحديد التوزيعات المدعومة وغير المعتمدة، ويتحقق من الأذونات المطلوبة لإجراء التثبيت.

يقوم المثال التالي بتنزيل العامل وتثبيته:

# Download the installation package.
wget https://aka.ms/azcmagent -O ~/Install_linux_azcmagent.sh

# Install the Azure Connected Machine agent.
bash ~/Install_linux_azcmagent.sh
  1. لتنزيل العامل وتثبيته، قم بتشغيل الأوامر التالية. إذا كان جهازك بحاجة إلى الاتصال عبر خادم وكيل للاتصال بالإنترنت، فقم بتضمين المعلمة --proxy .

    # Download the installation package.
    wget https://aka.ms/azcmagent -O ~/Install_linux_azcmagent.sh
    
    # Install the AZure Connected Machine agent.
    bash ~/Install_linux_azcmagent.sh --proxy "{proxy-url}:{proxy-port}"
    
  2. بعد تثبيت الوكيل، تحتاج إلى تكوينه للاتصال بخدمة Azure Arc عن طريق تشغيل الأمر التالي:

    azcmagent connect --resource-group "resourceGroupName" --tenant-id "tenantID" --location "regionName" --subscription-id "subscriptionID" --cloud "cloudName"
    if [ $? = 0 ]; then echo "\033[33mTo view your onboarded server(s), navigate to https://portal.azure.com/#blade/HubsExtension/BrowseResource/resourceType/Microsoft.HybridCompute%2Fmachines\033[m"; fi
    

التثبيت باستخدام الطريقة النصية

  1. قم بتسجيل الدخول إلى الخادم باستخدام حساب لديه حق الوصول إلى الجذر.

  2. قم بالتغيير إلى المجلد أو نسخ البرنامج النصي الذي شاركته وتنفيذه على الخادم عن طريق تشغيل البرنامج النصي ⁧./OnboardingScript.sh⁩.

إذا فشل العامل في بدء التشغيل بعد الانتهاء من الإعداد، فتحقق من السجلات للحصول على معلومات مفصلة عن الخطأ. دليل السجل هو var/ opt/azcmagent/log.

تحقق من الاتصال بـ Azure Arc

بعد تثبيت العامل وتكوينه للاتصال بخوادم ممكنة في Azure Arc، انتقل إلى مدخل Azure للتحقق من اتصال الخادم بنجاح. عرض الأجهزة في مدخل Azure.

A successful server connection

الخطوات التالية