Az Azure Egyéni erőforrás-szolgáltatók erőforrás-előkészítés áttekintése

Cikk
06/01/2023

Az Azure Custom Resource Providers-erőforrás-előkészítés az Azure-erőforrástípusok bővíthetőségi modellje. Lehetővé teszi a műveletek vagy felügyelet nagy léptékű alkalmazását a meglévő Azure-erőforrásokra. További információ: Hogyan terjeszthetik ki az Azure-t az Egyéni Azure-erőforrás-szolgáltatók? című témakört. Ez a cikk a következőket ismerteti:

Milyen erőforrás-előkészítési műveletekre van lehetőség.
Az erőforrás-előkészítés alapjai és használatának alapjai.
Útmutatók és kódminták keresése az első lépésekhez.

Fontos

Az egyéni erőforrás-szolgáltatók jelenleg nyilvános előzetes verzióban vannak. Ez az előzetes verzió szolgáltatásszint-szerződés nélkül érhető el, éles számítási feladatokhoz nem ajánljuk. Előfordulhat, hogy egyes funkciók nem támogatottak, vagy korlátozott képességekkel rendelkeznek. További információ: Kiegészítő használati feltételek a Microsoft Azure előzetes verziójú termékeihez.

Mit tehet az erőforrás-előkészítés?

Az egyéni Azure-erőforrás-szolgáltatókhoz hasonlóan az erőforrás-előkészítés olyan szerződést határoz meg, amely proxyt küld egy végpontra irányuló "előkészítési" kérésekhez. Az egyéni erőforrásoktól eltérően az erőforrás-előkészítés nem hoz létre új erőforrástípust. Ehelyett lehetővé teszi a meglévő erőforrástípusok kiterjesztését. Az erőforrás-előkészítés pedig Azure Policy működik, így az erőforrások kezelése és konfigurálása nagy léptékben végezhető el. Néhány példa az erőforrás-előkészítési munkafolyamatokra:

Virtuálisgép-bővítmények telepítése és kezelése.
Az alapértelmezett beállítások feltöltése és konfigurálása az Azure Storage-fiókokban.
Az alapkonfiguráció diagnosztikai beállításainak engedélyezése nagy léptékben.

Az erőforrás-előkészítés alapjai

Az azure-beli egyéni erőforrás-szolgáltatókon keresztül konfigurálhatja az erőforrások előkészítését a Microsoft.CustomProviders/resourceProviders és a Microsoft.CustomProviders/associations erőforrástípusok használatával. Ha engedélyezni szeretné az erőforrás-előkészítést egy egyéni erőforrás-szolgáltató számára, a konfigurációs folyamat során hozzon létre egy "társítások" nevű resourceType nevű erőforrástípust egy routingType paranccsal , amely tartalmazza a "Bővítmény" értéket. A Microsoft.CustomProviders/associations és a Microsoft.CustomProviders/resourceProviders nem kell ugyanahhoz az erőforráscsoporthoz tartoznia.

Íme egy azure-beli egyéni erőforrás-szolgáltatói minta:

{
  "properties": {
    "resourceTypes": [
      {
        "name": "associations",
        "routingType": "Proxy,Cache,Extension",
        "endpoint": "https://microsoft.com/"
      }
    ]
  },
  "location": "eastus"
}

Tulajdonság	Kötelező?	Description
name	Yes	A végpontdefiníció neve. Az erőforrások előkészítéséhez a névnek "társításoknak" kell lennie.
routingType	Yes	Meghatározza a végponttal kötött szerződés típusát. Az erőforrás-előkészítéshez az érvényes routingTypes a "Proxy,Cache,Extension" és "Webhook,Cache,Extension".
endpoint	Yes	A kérések átirányításához a végpont. Ez kezeli a választ és a kérés esetleges mellékhatásait.

Miután létrehozta az egyéni erőforrás-szolgáltatót a társítások erőforrástípusával, a Microsoft.CustomProviders/associations használatával célozhat. A Microsoft.CustomProviders/associations egy bővítményerőforrás, amely bármely más Azure-erőforrást kiterjeszthet. A Microsoft.CustomProviders/associations példány létrehozásakor a targetResourceId tulajdonságnak kell lennie, amelynek érvényes Microsoft.CustomProviders/resourceProviders vagy Microsoft.Solutions/applications erőforrás-azonosítónak kell lennie. Ezekben az esetekben a rendszer a kérelmet a létrehozott Microsoft.CustomProviders/resourceProviders példány társítási erőforrástípusára továbbítja.

Megjegyzés

Ha egy Microsoft.Solutions/applications erőforrás-azonosítót ad meg targetResourceId azonosítóként, akkor a felügyelt erőforráscsoportban egy "nyilvános" nevű Microsoft.CustomProviders/resourceProviders erőforrás-azonosítónak kell lennie.

Minta Azure Custom Resource Providers-társítás:

{
  "properties": {
    "targetResourceId": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}",
    ...
  }
}

Tulajdonság	Kötelező?	Description
targetResourceId	Yes	A Microsoft.CustomProviders/resourceProviders vagy a Microsoft.Solutions/applications erőforrás-azonosítója.

Az erőforrás-előkészítés használata

Az erőforrás-előkészítés más erőforrások Microsoft.CustomProviders/associations bővítményerőforrással való kibővítésével működik. Az alábbi példában a rendszer egy virtuális gépre vonatkozóan kéri a kérést, de bármely erőforrás bővíthető.

Először létre kell hoznia egy egyéni erőforrás-szolgáltatói erőforrást társítás típusú erőforrástípussal. Ez deklarálja a visszahívási URL-címet, amelyet a megfelelő Microsoft.CustomProviders/associations erőforrás létrehozásakor fog használni, amely az egyéni erőforrás-szolgáltatót célozza meg.

Minta Microsoft.CustomProviders/resourceProviders létrehozási kérelem:

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}"
}

Az egyéni erőforrás-szolgáltató létrehozása után más erőforrásokat is megcélzhat, és alkalmazhatja rájuk az egyéni erőforrás-szolgáltató mellékhatásait.

Minta Microsoft.CustomProviders/associations létrehozási kérelem:

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"
    }
  }
}

Ezt a kérést ezután a rendszer a létrehozott egyéni erőforrás-szolgáltatóban megadott végpontra továbbítja, amelyre a targetResourceId hivatkozik ebben az űrlapban:

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"
    }
  }
}

A végpontnak egy alkalmazás/json Content-Type és egy érvényes JSON-választörzs használatával kell válaszolnia. A JSON tulajdonságobjektumában visszaadott mezők bekerülnek a társítás visszatérési válaszába.

Segítség kérése

Ha kérdése van az Azure Custom Resource Providers fejlesztésével kapcsolatban, próbálja meg megkérdezni őket a Stack Overflow-on. Lehet, hogy már megválaszoltak egy hasonló kérdést, ezért először a közzététel előtt ellenőrizze. Adja hozzá a címkét azure-custom-providers a gyors válaszhoz!

Következő lépések

Ebben a cikkben megismerkedett az egyéni erőforrás-szolgáltatókkal. További információért tekintse meg ezeket a cikkeket:

Share via