Bagikan melalui

Gambaran umum onboarding sumber daya Penyedia Sumber Daya Kustom Azure

  • Artikel

Onboarding sumber daya Penyedia Sumber Daya Kustom Azure adalah model ekstensibilitas untuk jenis sumber daya Azure. Ini memungkinkan Anda untuk menerapkan operasi atau manajemen di seluruh sumber daya Azure yang ada sesuai skala. Untuk informasi selengkapnya, lihat Bagaimana Penyedia Sumber Daya Kustom Azure dapat memperluas Azure. Artikel ini menjelaskan:

  • Apa yang dapat dilakukan onboarding sumber daya.
  • Dasar-dasar onboarding sumber daya dan cara menggunakannya.
  • Tempat mencari panduan dan sampel kode untuk memulai.

Penting

Penyedia Sumber Daya Kustom saat ini dalam pratinjau publik. Versi pratinjau ini disediakan tanpa perjanjian tingkat layanan, dan tidak disarankan untuk beban kerja produksi. Fitur tertentu mungkin tidak didukung atau mungkin memiliki kemampuan yang dibatasi. Untuk informasi selengkapnya, lihat Ketentuan Penggunaan Tambahan untuk Pratinjau Microsoft Azure.

Apa yang dapat dilakukan onboarding sumber daya?

Mirip dengan sumber daya kustom Penyedia Sumber Daya Kustom Azure, onboarding sumber daya menentukan kontrak yang akan memproksi permintaan "onboarding" ke titik akhir. Tidak seperti sumber daya kustom, onboarding sumber daya tidak membuat jenis sumber daya baru. Sebagai gantinya, ini mengizinkan ekstensi jenis sumber daya yang ada. Dan onboarding sumber daya berfungsi dengan Azure Policy, sehingga manajemen dan konfigurasi sumber daya dapat dilakukan sesuai skala. Beberapa contoh alur kerja onboarding sumber daya:

  • Menginstal dan mengelola ke ekstensi komputer virtual.
  • Mengunggah dan mengonfigurasi default di akun penyimpanan Azure.
  • Mengaktifkan pengaturan diagnostik garis besar sesuai skala.

Dasar-dasar onboarding sumber daya

Anda mengonfigurasi onboarding sumber daya melalui Penyedia Sumber Daya Kustom Azure dengan menggunakan jenis sumber daya Microsoft.CustomProviders/resourceProviders dan Microsoft.CustomProviders/associations. Untuk mengaktifkan onboarding sumber daya untuk penyedia sumber daya kustom, selama proses konfigurasi, buat resourceType yang disebut "asosiasi" dengan routingType yang menyertakan "Ekstensi". The Microsoft.CustomProviders/associations dan Microsoft.CustomProviders/resourceProviders tidak harus berada dalam grup sumber daya yang sama.

Berikut adalah contoh penyedia sumber daya kustom Azure:

{
  "properties": {
    "resourceTypes": [
      {
        "name": "associations",
        "routingType": "Proxy,Cache,Extension",
        "endpoint": "https://microsoft.com/"
      }
    ]
  },
  "location": "eastus"
}
Properti Diperlukan? Deskripsi
nama Ya Nama definisi titik akhir. Untuk onboarding sumber daya, namanya harus "associations".
routingType Ya Menentukan jenis kontrak dengan titik akhir. Untuk onboarding sumber daya, routingTypes yang valid adalah "Proxy,Cache,Extension" dan "Webhook,Cache,Extension".
titik akhir Ya Titik akhir untuk merutekan permintaan. Cara ini akan menangani respons dan segala efek samping permintaan.

Setelah Membuat penyedia sumber daya kustom dengan jenis sumber daya asosiasi, Anda dapat menargetkan menggunakan Microsoft.CustomProviders/associations. Microsoft.CustomProviders/associations adalah sumber daya ekstensi yang dapat memperluas sumber daya Azure lainnya. Ketika instans Microsoft.CustomProviders/asosiasi dibuat, itu akan mengambil properti targetResourceId, yang seharusnya menjadi ID sumber daya Microsoft.CustomProviders/resourceProviders atau Microsoft.Solutions/applications yang valid. Dalam kasus ini, permintaan akan diteruskan ke jenis sumber daya asosiasi pada instans Microsoft.CustomProviders/resourceProviders yang Anda buat.

Catatan

Jika ID sumber daya Microsoft.Solutions/applications tersedia sebagai targetResourceId, dipastikan ada Microsoft.CustomProviders/resourceProviders yang disebarkan di grup sumber daya terkelola dengan nama "public".

Sampel asosiasi Penyedia Sumber Daya Kustom Azure:

{
  "properties": {
    "targetResourceId": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}",
    ...
  }
}
Properti Diperlukan? Deskripsi
targetResourceId Ya ID sumber daya Microsoft.CustomProviders/resourceProviders atau Microsoft.Solutions/applications.

Cara menggunakan onboarding sumber daya

Onboarding sumber daya bekerja dengan cara memperluas sumber daya lain dengan sumber daya ekstensi Microsoft.CustomProviders/associations. Di sampel berikut, permintaan dibuat untuk komputer virtual, tetapi segala sumber daya dapat diperluas.

Pertama, Anda perlu membuat sumber daya penyedia sumber daya kustom dengan jenis sumber daya asosiasi. Ini akan mendeklarasikan URL panggilan balik yang akan digunakan saat sumber daya Microsoft.CustomProviders/associations yang sesuai dibuat, yang menargetkan penyedia sumber daya kustom.

Sampel permintaan membuat Microsoft.CustomProviders/resourceProviders:

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}?api-version=2018-09-01-preview
Authorization: Bearer eyJ0e...
Content-Type: application/json

{
  "properties": {
    "resourceTypes": [
      {
        "name": "associations",
        "routingType": "Proxy,Cache,Extension",
        "endpoint": "https://{myCustomEndpoint}/"
      }
    ]
  },
  "location": "{location}"
}

Setelah membuat penyedia sumber daya kustom, Anda dapat menargetkan sumber daya lain dan menerapkan efek samping dari penyedia sumber daya kustom kepada mereka.

Sampel permintaan membuat Microsoft.CustomProviders/associations:

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{virtualMachineName}/providers/Microsoft.CustomProviders/associations/{associationName}?api-version=2018-09-01-preview
Authorization: Bearer eyJ0e...
Content-Type: application/json

{
  "properties": {
    "targetResourceId": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}",
    "myProperty1": "myPropertyValue1",
    "myProperty2": {
        "myProperty3" : "myPropertyValue3"
    }
  }
}

Permintaan ini kemudian akan diteruskan ke titik akhir yang ditentukan dalam penyedia sumber daya kustom yang Anda buat, yang direferensikan oleh targetResourceId dalam formulir ini:

PUT https://{endpointURL}/?api-version=2018-09-01-preview
Content-Type: application/json
X-MS-CustomProviders-RequestPath: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}/associations/{associationName}
X-MS-CustomProviders-ExtensionPath: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{virtualMachineName}/providers/Microsoft.CustomProviders/associations/{associationName}
X-MS-CustomProviders-ExtendedResource: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{virtualMachineName}

{
  "properties": {
    "myProperty1": "myPropertyValue1",
    "myProperty2": {
        "myProperty3" : "myPropertyValue3"
    }
  }
}

Titik akhir harus merespons dengan Content-Type aplikasi/json dan isi respons JSON yang valid. Bidang yang dikembalikan di bawah objek properti JSON akan ditambahkan ke respons pengembalian asosiasi.

Mendapatkan bantuan

Jika Anda memiliki pertanyaan tentang penerapan Penyedia Sumber Daya Kustom Azure, coba tanyakan di Stack Overflow. Pertanyaan serupa mungkin sudah dijawab, jadi periksa terlebih dahulu sebelum memposting. Tambahkan tag azure-custom-providers untuk mendapatkan respons cepat!

Langkah berikutnya

Dalam artikel ini, Anda mempelajari tentang penyedia sumber daya kustom. Lihat artikel ini untuk mempelajari selengkapnya: