Microsoft.Kubernetesملحقات التكوين 2023-05-01

تعريف مورد Bicep

يمكن نشر نوع مورد الملحقات مع العمليات التي تستهدف:

للحصول على قائمة بالخصائص التي تم تغييرها في كل إصدار من إصدارات واجهة برمجة التطبيقات، راجع سجل التغيير .

أمثلة الاستخدام

عينات Bicep

مثال أساسي على نشر ملحق نظام مجموعة Kubernetes.

param resourceName string = 'acctest0001'
param location string = 'westeurope'

resource managedCluster 'Microsoft.ContainerService/managedClusters@2023-04-02-preview' = {
  name: resourceName
  location: location
  properties: {
    agentPoolProfiles: [
      {
        count: 1
        mode: 'System'
        name: 'default'
        vmSize: 'Standard_DS2_v2'
      }
    ]
    dnsPrefix: resourceName
  }
}

resource extension 'Microsoft.KubernetesConfiguration/extensions@2022-11-01' = {
  name: resourceName
  scope: managedCluster
  properties: {
    autoUpgradeMinorVersion: true
    extensionType: 'microsoft.flux'
  }
}

الوحدات النمطية التي تم التحقق منها من Azure

يمكن استخدام الوحدات النمطية Azure Verified لنشر نوع المورد هذا.

الوحده النمطيه وصف
ملحق تكوين Kubernetes وحدة موارد AVM لملحق تكوين Kubernetes

تنسيق المورد

لإنشاء مورد Microsoft.KubernetesConfiguration/extensions، أضف Bicep التالي إلى القالب الخاص بك.

resource symbolicname 'Microsoft.KubernetesConfiguration/extensions@2023-05-01' = {
  scope: resourceSymbolicName or scope
  identity: {
    type: 'SystemAssigned'
  }
  name: 'string'
  plan: {
    name: 'string'
    product: 'string'
    promotionCode: 'string'
    publisher: 'string'
    version: 'string'
  }
  properties: {
    aksAssignedIdentity: {
      type: 'string'
    }
    autoUpgradeMinorVersion: bool
    configurationProtectedSettings: {
      {customized property}: 'string'
    }
    configurationSettings: {
      {customized property}: 'string'
    }
    extensionType: 'string'
    releaseTrain: 'string'
    scope: {
      cluster: {
        releaseNamespace: 'string'
      }
      namespace: {
        targetNamespace: 'string'
      }
    }
    statuses: [
      {
        code: 'string'
        displayStatus: 'string'
        level: 'string'
        message: 'string'
        time: 'string'
      }
    ]
    version: 'string'
  }
}

قيم الخصائص

Microsoft.KubernetesConfiguration/extensions

اسم وصف قيمة
الهوية هوية مورد الملحق الهوية
اسم اسم المورد سلسلة (مطلوب)
خطة معلومات الخطة. خطة
خصائص خصائص مورد ملحق ExtensionProperties
نطاق استخدم عند إنشاء مورد في نطاق مختلف عن نطاق النشر. قم بتعيين هذه الخاصية إلى الاسم الرمزي لمورد لتطبيق مورد ملحق .

خصائص الملحقات

اسم وصف قيمة
aksAssignedIdentity هوية مورد الملحق في نظام مجموعة AKS ExtensionPropertiesAksAssignedIdentity
AutoUpgradeMinorVersion ضع علامة لملاحظة ما إذا كان هذا الملحق يشارك في الترقية التلقائية للإصدار الثانوي، أم لا. قيمة منطقية
إعدادات التكوين المحمية إعدادات التكوين الحساسة، كأزواج قيمة الاسم لتكوين هذا الملحق. ExtensionPropertiesConfigurationProtectedSettings
إعدادات التكوين إعدادات التكوين، كأزواج اسم-قيمة لتكوين هذا الملحق. إعدادات تكوين خصائص الملحقات
نوع الملحق نوع الملحق، الذي يمثل هذا المورد مثيلا له. يجب أن يكون أحد أنواع الملحقات المسجلة مع Microsoft.KubernetesConfiguration بواسطة ناشر الملحق. خيط
إصدار التدريب ReleaseTrain يشارك هذا الملحق للترقية التلقائية (على سبيل المثال، ثابت، معاينة، وما إلى ذلك) - فقط إذا كان autoUpgradeMinorVersion هو "صحيح". خيط
نطاق النطاق الذي تم تثبيت الملحق فيه. نطاق
حالات الحالة من هذا الملحق. ExtensionStatus []
الإصدار الإصدار المحدد من قبل المستخدم من الملحق لهذا الملحق إلى "pin". لاستخدام 'version'، يجب أن يكون autoUpgradeMinorVersion 'false'. خيط

ExtensionPropertiesAksAssignedIdentity

اسم وصف قيمة
نوع نوع الهوية. "تم تعيين النظام"
"تعيين المستخدم"

ExtensionPropertiesConfigurationProtectedSettings

اسم وصف قيمة

إعدادات تكوين خصائص الملحقات

اسم وصف قيمة

إحصائيات الملحقات

اسم وصف قيمة
رمز رمز الحالة الذي يوفره الملحق خيط
displayStatus وصف مختصر لحالة الملحق. خيط
مستوى مستوى الحالة. "خطأ"
"معلومات"
"تحذير"
رسالة رسالة مفصلة للحالة من الملحق. خيط
الوقت DateLiteral (لكل ISO8601) يشير إلى وقت حالة التثبيت. خيط

الهوية

اسم وصف قيمة
نوع نوع الهوية. "تم تعيين النظام"

خطة

اسم وصف قيمة
اسم اسم معرف من قبل المستخدم لأداة الطرف الثالث التي يتم شراؤها. سلسلة (مطلوب)
حاصل الضرب أداة الطرف الثالث التي يتم شراؤها. على سبيل المثال NewRelic. يتم تعيين المنتج إلى OfferID المحدد للبيانات الاصطناعية في وقت إلحاق سوق البيانات. سلسلة (مطلوب)
رمز الترقية قدم ناشر رمز الترويج كما هو متوفر في سوق البيانات للمنتج/البيانات الاصطناعية المذكورة. خيط
ناشر ناشر أداة الطرف الثالث التي يتم شراؤها. على سبيل المثال NewRelic سلسلة (مطلوب)
الإصدار إصدار المنتج/البيانات الاصطناعية المطلوبة. خيط

نطاق

اسم وصف قيمة
عنقود تحديد أن نطاق الملحق هو نظام المجموعة ScopeCluster
Namespace تحديد أن نطاق الملحق هو Namespace ScopeNamespace

ScopeCluster

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

مساحة اسم النطاق

اسم وصف قيمة
targetNamespace مساحة الاسم حيث سيتم إنشاء الملحق لملحق نطاق مساحة الاسم. إذا لم تكن مساحة الاسم هذه موجودة، إنشاؤها خيط

تعريف مورد قالب ARM

يمكن نشر نوع مورد الملحقات مع العمليات التي تستهدف:

للحصول على قائمة بالخصائص التي تم تغييرها في كل إصدار من إصدارات واجهة برمجة التطبيقات، راجع سجل التغيير .

أمثلة الاستخدام

تنسيق المورد

لإنشاء مورد Microsoft.KubernetesConfiguration/extensions، أضف JSON التالي إلى القالب الخاص بك.

{
  "type": "Microsoft.KubernetesConfiguration/extensions",
  "apiVersion": "2023-05-01",
  "name": "string",
  "identity": {
    "type": "SystemAssigned"
  },
  "plan": {
    "name": "string",
    "product": "string",
    "promotionCode": "string",
    "publisher": "string",
    "version": "string"
  },
  "properties": {
    "aksAssignedIdentity": {
      "type": "string"
    },
    "autoUpgradeMinorVersion": "bool",
    "configurationProtectedSettings": {
      "{customized property}": "string"
    },
    "configurationSettings": {
      "{customized property}": "string"
    },
    "extensionType": "string",
    "releaseTrain": "string",
    "scope": {
      "cluster": {
        "releaseNamespace": "string"
      },
      "namespace": {
        "targetNamespace": "string"
      }
    },
    "statuses": [
      {
        "code": "string",
        "displayStatus": "string",
        "level": "string",
        "message": "string",
        "time": "string"
      }
    ],
    "version": "string"
  }
}

قيم الخصائص

Microsoft.KubernetesConfiguration/extensions

اسم وصف قيمة
apiVersion إصدار واجهة برمجة التطبيقات '2023-05-01'
الهوية هوية مورد الملحق الهوية
اسم اسم المورد سلسلة (مطلوب)
خطة معلومات الخطة. خطة
خصائص خصائص مورد ملحق ExtensionProperties
نوع نوع المورد "Microsoft.KubernetesConfiguration/extensions"

خصائص الملحقات

اسم وصف قيمة
aksAssignedIdentity هوية مورد الملحق في نظام مجموعة AKS ExtensionPropertiesAksAssignedIdentity
AutoUpgradeMinorVersion ضع علامة لملاحظة ما إذا كان هذا الملحق يشارك في الترقية التلقائية للإصدار الثانوي، أم لا. قيمة منطقية
إعدادات التكوين المحمية إعدادات التكوين الحساسة، كأزواج قيمة الاسم لتكوين هذا الملحق. ExtensionPropertiesConfigurationProtectedSettings
إعدادات التكوين إعدادات التكوين، كأزواج اسم-قيمة لتكوين هذا الملحق. إعدادات تكوين خصائص الملحقات
نوع الملحق نوع الملحق، الذي يمثل هذا المورد مثيلا له. يجب أن يكون أحد أنواع الملحقات المسجلة مع Microsoft.KubernetesConfiguration بواسطة ناشر الملحق. خيط
إصدار التدريب ReleaseTrain يشارك هذا الملحق للترقية التلقائية (على سبيل المثال، ثابت، معاينة، وما إلى ذلك) - فقط إذا كان autoUpgradeMinorVersion هو "صحيح". خيط
نطاق النطاق الذي تم تثبيت الملحق فيه. نطاق
حالات الحالة من هذا الملحق. ExtensionStatus []
الإصدار الإصدار المحدد من قبل المستخدم من الملحق لهذا الملحق إلى "pin". لاستخدام 'version'، يجب أن يكون autoUpgradeMinorVersion 'false'. خيط

ExtensionPropertiesAksAssignedIdentity

اسم وصف قيمة
نوع نوع الهوية. "تم تعيين النظام"
"تعيين المستخدم"

ExtensionPropertiesConfigurationProtectedSettings

اسم وصف قيمة

إعدادات تكوين خصائص الملحقات

اسم وصف قيمة

إحصائيات الملحقات

اسم وصف قيمة
رمز رمز الحالة الذي يوفره الملحق خيط
displayStatus وصف مختصر لحالة الملحق. خيط
مستوى مستوى الحالة. "خطأ"
"معلومات"
"تحذير"
رسالة رسالة مفصلة للحالة من الملحق. خيط
الوقت DateLiteral (لكل ISO8601) يشير إلى وقت حالة التثبيت. خيط

الهوية

اسم وصف قيمة
نوع نوع الهوية. "تم تعيين النظام"

خطة

اسم وصف قيمة
اسم اسم معرف من قبل المستخدم لأداة الطرف الثالث التي يتم شراؤها. سلسلة (مطلوب)
حاصل الضرب أداة الطرف الثالث التي يتم شراؤها. على سبيل المثال NewRelic. يتم تعيين المنتج إلى OfferID المحدد للبيانات الاصطناعية في وقت إلحاق سوق البيانات. سلسلة (مطلوب)
رمز الترقية قدم ناشر رمز الترويج كما هو متوفر في سوق البيانات للمنتج/البيانات الاصطناعية المذكورة. خيط
ناشر ناشر أداة الطرف الثالث التي يتم شراؤها. على سبيل المثال NewRelic سلسلة (مطلوب)
الإصدار إصدار المنتج/البيانات الاصطناعية المطلوبة. خيط

نطاق

اسم وصف قيمة
عنقود تحديد أن نطاق الملحق هو نظام المجموعة ScopeCluster
Namespace تحديد أن نطاق الملحق هو Namespace ScopeNamespace

ScopeCluster

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

مساحة اسم النطاق

اسم وصف قيمة
targetNamespace مساحة الاسم حيث سيتم إنشاء الملحق لملحق نطاق مساحة الاسم. إذا لم تكن مساحة الاسم هذه موجودة، إنشاؤها خيط

تعريف مورد Terraform (موفر AzAPI)

يمكن نشر نوع مورد الملحقات مع العمليات التي تستهدف:

للحصول على قائمة بالخصائص التي تم تغييرها في كل إصدار من إصدارات واجهة برمجة التطبيقات، راجع سجل التغيير .

أمثلة الاستخدام

عينات Terraform

مثال أساسي على نشر ملحق نظام مجموعة Kubernetes.

terraform {
  required_providers {
    azapi = {
      source = "Azure/azapi"
    }
  }
}

provider "azapi" {
  skip_provider_registration = false
}

variable "resource_name" {
  type    = string
  default = "acctest0001"
}

variable "location" {
  type    = string
  default = "westeurope"
}

resource "azapi_resource" "resourceGroup" {
  type     = "Microsoft.Resources/resourceGroups@2020-06-01"
  name     = var.resource_name
  location = var.location
}

resource "azapi_resource" "managedCluster" {
  type      = "Microsoft.ContainerService/managedClusters@2023-04-02-preview"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  identity {
    type         = "SystemAssigned"
    identity_ids = []
  }
  body = {
    properties = {
      agentPoolProfiles = [
        {
          count  = 1
          mode   = "System"
          name   = "default"
          vmSize = "Standard_DS2_v2"
        },
      ]
      dnsPrefix = var.resource_name
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

resource "azapi_resource" "extension" {
  type      = "Microsoft.KubernetesConfiguration/extensions@2022-11-01"
  parent_id = azapi_resource.managedCluster.id
  name      = var.resource_name
  body = {
    properties = {
      autoUpgradeMinorVersion = true
      extensionType           = "microsoft.flux"
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

تنسيق المورد

لإنشاء مورد Microsoft.KubernetesConfiguration/extensions، أضف Terraform التالي إلى القالب الخاص بك.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.KubernetesConfiguration/extensions@2023-05-01"
  name = "string"
  parent_id = "string"
  identity {
    type = "string"
    identity_ids = [
      "string"
    ]
  }
  body = {
    plan = {
      name = "string"
      product = "string"
      promotionCode = "string"
      publisher = "string"
      version = "string"
    }
    properties = {
      aksAssignedIdentity = {
        type = "string"
      }
      autoUpgradeMinorVersion = bool
      configurationProtectedSettings = {
        {customized property} = "string"
      }
      configurationSettings = {
        {customized property} = "string"
      }
      extensionType = "string"
      releaseTrain = "string"
      scope = {
        cluster = {
          releaseNamespace = "string"
        }
        namespace = {
          targetNamespace = "string"
        }
      }
      statuses = [
        {
          code = "string"
          displayStatus = "string"
          level = "string"
          message = "string"
          time = "string"
        }
      ]
      version = "string"
    }
  }
}

قيم الخصائص

Microsoft.KubernetesConfiguration/extensions

اسم وصف قيمة
الهوية هوية مورد الملحق الهوية
اسم اسم المورد سلسلة (مطلوب)
parent_id معرف المورد لتطبيق مورد الملحق هذا عليه. سلسلة (مطلوب)
خطة معلومات الخطة. خطة
خصائص خصائص مورد ملحق ExtensionProperties
نوع نوع المورد "Microsoft.KubernetesConfiguration/extensions@2023-05-01"

خصائص الملحقات

اسم وصف قيمة
aksAssignedIdentity هوية مورد الملحق في نظام مجموعة AKS ExtensionPropertiesAksAssignedIdentity
AutoUpgradeMinorVersion ضع علامة لملاحظة ما إذا كان هذا الملحق يشارك في الترقية التلقائية للإصدار الثانوي، أم لا. قيمة منطقية
إعدادات التكوين المحمية إعدادات التكوين الحساسة، كأزواج قيمة الاسم لتكوين هذا الملحق. ExtensionPropertiesConfigurationProtectedSettings
إعدادات التكوين إعدادات التكوين، كأزواج اسم-قيمة لتكوين هذا الملحق. إعدادات تكوين خصائص الملحقات
نوع الملحق نوع الملحق، الذي يمثل هذا المورد مثيلا له. يجب أن يكون أحد أنواع الملحقات المسجلة مع Microsoft.KubernetesConfiguration بواسطة ناشر الملحق. خيط
إصدار التدريب ReleaseTrain يشارك هذا الملحق للترقية التلقائية (على سبيل المثال، ثابت، معاينة، وما إلى ذلك) - فقط إذا كان autoUpgradeMinorVersion هو "صحيح". خيط
نطاق النطاق الذي تم تثبيت الملحق فيه. نطاق
حالات الحالة من هذا الملحق. ExtensionStatus []
الإصدار الإصدار المحدد من قبل المستخدم من الملحق لهذا الملحق إلى "pin". لاستخدام 'version'، يجب أن يكون autoUpgradeMinorVersion 'false'. خيط

ExtensionPropertiesAksAssignedIdentity

اسم وصف قيمة
نوع نوع الهوية. "تم تعيين النظام"
"تعيين المستخدم"

ExtensionPropertiesConfigurationProtectedSettings

اسم وصف قيمة

إعدادات تكوين خصائص الملحقات

اسم وصف قيمة

إحصائيات الملحقات

اسم وصف قيمة
رمز رمز الحالة الذي يوفره الملحق خيط
displayStatus وصف مختصر لحالة الملحق. خيط
مستوى مستوى الحالة. "خطأ"
"معلومات"
"تحذير"
رسالة رسالة مفصلة للحالة من الملحق. خيط
الوقت DateLiteral (لكل ISO8601) يشير إلى وقت حالة التثبيت. خيط

الهوية

اسم وصف قيمة
نوع نوع الهوية. "تم تعيين النظام"

خطة

اسم وصف قيمة
اسم اسم معرف من قبل المستخدم لأداة الطرف الثالث التي يتم شراؤها. سلسلة (مطلوب)
حاصل الضرب أداة الطرف الثالث التي يتم شراؤها. على سبيل المثال NewRelic. يتم تعيين المنتج إلى OfferID المحدد للبيانات الاصطناعية في وقت إلحاق سوق البيانات. سلسلة (مطلوب)
رمز الترقية قدم ناشر رمز الترويج كما هو متوفر في سوق البيانات للمنتج/البيانات الاصطناعية المذكورة. خيط
ناشر ناشر أداة الطرف الثالث التي يتم شراؤها. على سبيل المثال NewRelic سلسلة (مطلوب)
الإصدار إصدار المنتج/البيانات الاصطناعية المطلوبة. خيط

نطاق

اسم وصف قيمة
عنقود تحديد أن نطاق الملحق هو نظام المجموعة ScopeCluster
Namespace تحديد أن نطاق الملحق هو Namespace ScopeNamespace

ScopeCluster

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

مساحة اسم النطاق

اسم وصف قيمة
targetNamespace مساحة الاسم حيث سيتم إنشاء الملحق لملحق نطاق مساحة الاسم. إذا لم تكن مساحة الاسم هذه موجودة، إنشاؤها خيط