إنشاء وإدارة مواقع مخصصة على Kubernetes التي تدعم Azure Arc

  • مقالة
  • قراءة خلال 5 دقائق

توفر المواقع المخصصة طريقة لمسؤولي المستأجرين أو المجموعات لتكوين مجموعات Kubernetes التي تدعم Azure Arc كمواقع مستهدفة لنشر مثيلات عروض Azure. تتضمن أمثلة عروض Azure التي يمكن نشرها أعلى المواقع المخصصة قواعد بيانات مثل SQL Managed Instance التي تدعم Azure Arc وPostgreSQL Hyperscale الممكنة ل Azure Arc أو مثيلات التطبيقات مثل خدمات التطبيقات والوظائف وشبكة الأحداث والتطبيقات المنطقية Gestione API. يحتوي الموقع المخصص على تعيين فردي إلى مساحة اسم داخل مجموعة Kubernetes التي تدعم Azure Arc. يمكن استخدام مورد Azure المخصص للموقع مع Azure RBAC لمنح مطوري التطبيقات أو مسؤولي قواعد البيانات أذونات دقيقة لنشر موارد مختلفة مثل قواعد البيانات أو مثيلات التطبيقات أعلى مجموعة Kubernetes التي تم تمكين Arc لها بطريقة متعددة المستأجرين.

تتوفر نظرة عامة مفاهيمية لهذه الميزة في المواقع المخصصة - مقالة Kubernetes التي تدعم Azure Arc .

ستتعلم في هذا المقال طريقة إجراء ما يلي:

  • قم بتمكين المواقع المخصصة على مجموعة Kubernetes التي تدعم Azure Arc.
  • إنشاء موقع مخصص.

المتطلبات الأساسية

  • قم بتثبيت Azure CLI أو ترقيته إلى الإصدار >= 2.16.0.

  • قم بتثبيت ملحقات Azure CLI التالية:

    • connectedk8s (الإصدار 1.2.0 أو أحدث)
    • k8s-extension (الإصدار 1.0.0 أو أحدث)
    • customlocation (الإصدار 0.1.3 أو أحدث)
    az extension add --name connectedk8s
az extension add --name k8s-extension
az extension add --name customlocation

    إذا قمت بالفعل بتثبيت ، و ، وملحقاتها customlocation ، k8s-extensionفقم بالتحديث connectedk8sإلى أحدث إصدار باستخدام الأمر التالي:

    az extension update --name connectedk8s
az extension update --name k8s-extension
az extension update --name customlocation

  • تحقق من اكتمال تسجيل مقدم الخدمة ل Microsoft.ExtendedLocation.

    1. أدخل الأوامر التالية:

      az provider register --namespace Microsoft.ExtendedLocation

    2. راقب عملية التسجيل. يمكن أن يستمر التسجيل لأكثر من 10 دقائق.

      az provider show -n Microsoft.ExtendedLocation -o table

      بمجرد التسجيل ، سيكون للدولة القيمة RegistrationStateRegistered .

  • تحقق من أن لديك مجموعة Kubernetes متصلة قائمة تدعم Azure Arc.

تمكين المواقع المخصصة على المجموعة

إذا قمت بتسجيل الدخول إلى Azure CLI كمستخدم Azure AD، لتمكين هذه الميزة على نظام المجموعة الخاص بك، قم بتنفيذ الأمر التالي:

az connectedk8s enable-features -n <clusterName> -g <resourceGroupName> --features cluster-connect custom-locations

إذا قمت بتسجيل الدخول إلى Azure CLI باستخدام مبدأ خدمة، لتمكين هذه الميزة على مجموعتك، قم بتنفيذ الخطوات التالية:

  1. جلب معرف الكائن لتطبيق Azure AD المستخدم بواسطة خدمة Azure Arc:

    az ad sp show --id 'bc313c14-388c-4e7d-a58e-70017303ee3b' --query objectId -o tsv

  2. <objectId> استخدم القيمة من الخطوة أعلاه لتمكين ميزة المواقع المخصصة على المجموعة:

    az connectedk8s enable-features -n <cluster-name> -g <resource-group-name> --custom-locations-oid <objectId> --features cluster-connect custom-locations

ملاحظة

  1. تعتمد ميزة "المواقع المخصصة" على ميزة "الاتصال الكتلة". لذلك يجب تمكين كلتا الميزتين حتى تعمل المواقع المخصصة.
  2. az connectedk8s enable-features يجب تشغيله على جهاز حيث kubeconfig يشير الملف إلى الكتلة التي سيتم تمكين الميزات عليها.

إنشاء موقع مخصص

  1. نشر ملحق مجموعة خدمة Azure لمثيل خدمة Azure الذي تريد تثبيته على مجموعتك:

  2. احصل على معرف Azure Resource Manager الخاص بمجموعة Kubernetes التي تدعم Azure Arc، والمشار إليها في الخطوات اللاحقة على النحو التاليconnectedClusterId:

    az connectedk8s show -n <clusterName> -g <resourceGroupName>  --query id -o tsv

  3. احصل على معرف Azure Resource Manager لملحق الكتلة الذي تم نشره أعلى مجموعة Kubernetes التي تم تمكين Azure Arc لها، والمشار إليها في الخطوات اللاحقة على النحو التاليextensionId:

    az k8s-extension show --name <extensionInstanceName> --cluster-type connectedClusters -c <clusterName> -g <resourceGroupName>  --query id -o tsv

  4. قم بإنشاء موقع مخصص عن طريق الرجوع إلى مجموعة Kubernetes التي تم تمكين Azure Arc وامتدادها:

    az customlocation create -n <customLocationName> -g <resourceGroupName> --namespace <name of namespace> --host-resource-id <connectedClusterId> --cluster-extension-ids <extensionIds>

تتمثل المعلمات المطلوبة في الآتي

اسم المعلمة الوصف
--name, --n اسم الموقع المخصص
--resource-group, --g مجموعة موارد الموقع المخصص
--namespace مساحة الاسم في الكتلة المرتبطة بالموقع المخصص الذي يتم إنشاؤه
--host-resource-id Azure Resource Manager identifier of the Azure Arc-enabled Kubernetes cluster (connected cluster)
--cluster-extension-ids Azure Resource Manager معرفات مثيلات ملحق الكتلة المثبتة على الكتلة المتصلة. توفير قائمة مفصولة بمسافة لمعرفات ملحقات نظام المجموعة

تتمثل المعلمات الاختيارية في الآتي

اسم المعلمة الوصف
--location, --l موقع الموقع المخصص Azure Resource Manager المورد في Azure. بشكل افتراضي ، سيتم تعيينه على موقع المجموعة المتصلة
--tags قائمة العلامات المفصولة بمسافات: key[=value] [key[=value] ...]. استخدم '' لمسح العلامات الموجودة
--kubeconfig مشرف kubeconfig المجموعة

عرض تفاصيل موقع مخصص

عرض تفاصيل موقع مخصص

az customlocation show -n <customLocationName> -g <resourceGroupName>

تتمثل المعلمات المطلوبة في الآتي

اسم المعلمة الوصف
--name, --n اسم الموقع المخصص
--resource-group, --g مجموعة موارد الموقع المخصص

قائمة المواقع المخصصة

يسرد جميع المواقع المخصصة في مجموعة موارد

az customlocation show -g <resourceGroupName>

تتمثل المعلمات المطلوبة في الآتي

اسم المعلمة الوصف
--resource-group, --g مجموعة موارد الموقع المخصص

تحديث موقع مخصص

استخدم update الأمر عندما تريد إضافة علامات تمييز جديدة، وقم بإقران معرفات ملحقات الكتلة الجديدة بالموقع المخصص مع الاحتفاظ بالعلامات الموجودة وملحقات المجموعات المقترنة. --cluster-extension-idsassign-identity، --tags، يمكن تحديثها.

az customlocation update -n <customLocationName> -g <resourceGroupName> --namespace <name of namespace> --host-resource-id <connectedClusterId> --cluster-extension-ids <extensionIds>

تتمثل المعلمات المطلوبة في الآتي

اسم المعلمة الوصف
--name, --n اسم الموقع المخصص
--resource-group, --g مجموعة موارد الموقع المخصص
--namespace مساحة الاسم في الكتلة المرتبطة بالموقع المخصص الذي يتم إنشاؤه
--host-resource-id Azure Resource Manager identifier of the Azure Arc-enabled Kubernetes cluster (connected cluster)

تتمثل المعلمات الاختيارية في الآتي

اسم المعلمة الوصف
--cluster-extension-ids قم بإقران ملحقات الكتلة الجديدة بهذا الموقع المخصص من خلال توفير معرفات Azure Resource Manager لمثيلات ملحق نظام المجموعة المثبتة على المجموعة المتصلة. توفير قائمة مفصولة بمسافة لمعرفات ملحقات نظام المجموعة
--tags إضافة علامات جديدة بالإضافة إلى العلامات الموجودة. قائمة العلامات المفصولة بمسافات: key[=value] [key[=value] ...].

تصحيح موقع مخصص

استخدم patch الأمر عندما تريد استبدال العلامات الموجودة، ومعرفات امتداد الكتلة بعلامات جديدة، ومعرفات ملحقات الكتلة. --cluster-extension-ids--tags، ، assign-identityيمكن تصحيحها.

az customlocation patch -n <customLocationName> -g <resourceGroupName> --namespace <name of namespace> --host-resource-id <connectedClusterId> --cluster-extension-ids <extensionIds>

تتمثل المعلمات المطلوبة في الآتي

اسم المعلمة الوصف
--name, --n اسم الموقع المخصص
--resource-group, --g مجموعة موارد الموقع المخصص

تتمثل المعلمات الاختيارية في الآتي

اسم المعلمة الوصف
--cluster-extension-ids قم بإقران ملحقات الكتلة الجديدة بهذا الموقع المخصص من خلال توفير معرفات Azure Resource Manager لمثيلات ملحق نظام المجموعة المثبتة على المجموعة المتصلة. توفير قائمة مفصولة بمسافة لمعرفات ملحقات نظام المجموعة
--tags إضافة علامات جديدة بالإضافة إلى العلامات الموجودة. قائمة العلامات المفصولة بمسافات: key[=value] [key[=value] ...].

حذف موقع جغرافي مخصص

az customlocation delete -n <customLocationName> -g <resourceGroupName> --namespace <name of namespace> --host-resource-id <connectedClusterId> --cluster-extension-ids <extensionIds>

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