.NET .NET Aspire integrációk áttekintése

.NET Aspire integrációk a NuGet-csomagok válogatott csomagjai, amelyek a natív felhőbeli alkalmazások olyan kiemelkedő szolgáltatásokkal és platformokkal való integrációját segítik elő, mint például a Redis és a PostgreSQL. Minden integráció alapvető natív felhőfunkciókat biztosít automatikus kiépítési vagy szabványosított konfigurációs mintákon keresztül.

Integrációs feladatok

A legtöbb .NET.NET Aspire integráció két külön kódtárból áll, amelyek mindegyike más-más felelősségi körrel rendelkezik. Az egyik típus az alkalmazás gazdagépének projektben lévő erőforrásokat jelöli, más néven hosztingintegrációkat. A másik integrációtípus azokat az ügyfélkönyvtárakat jelöli, amelyek a hoszting integrációk által modellezett erőforrásokhoz csatlakoznak, és ezeket nevezik ügyfélintegrációknak.

Integrációk üzemeltetése

Az üzemeltetési integrációk erőforrások (például tárolók vagy felhőbeli erőforrások) kiépítésével vagy meglévő példányokra (például helyi SQL Serverre) mutatva konfigurálják az alkalmazásokat. Ezek a csomagok különböző szolgáltatásokat, platformokat vagy képességeket modelleznek, beleértve a gyorsítótárakat, az adatbázisokat, a naplózást, a tárolást és az üzenetkezelési rendszereket.

Az üzemeltetési integrációk kibővítik a IDistributedApplicationBuilder felületet, lehetővé téve, hogy a alkalmazásgazda projekt az alkalmazásmodellerőforrásait fejezze ki. A hivatalos hosting integrációs NuGet-csomagok a aspire, integrationés hostingcímkékkel vannak megjelölve. A hivatalos üzemeltetési integrációk mellett a közösség a közösségi eszközkészlet részeként különböző szolgáltatásokhoz és platformokhoz is létrehozott üzemeltetési integrációkat.

Az egyéni üzemeltetési integrációslétrehozásáról további információt az Egyéni .NET.NET Aspire üzemeltetési integrációslétrehozása című témakörben talál.

Client integrációk

Client integrációk az ügyfélkódtárakat függőséginjektálási (DI), konfigurálási séma meghatározására, valamint állapotellenőrzési, rugalmasságiés adott esetben telemetriai hozzáadására. .NET .NET Aspire ügyfél-integrációs könyvtárak előtagja Aspire., majd tartalmazzák a teljes csomagnevet, amellyel integrálódnak, például Aspire.StackExchange.Redis.

Ezek a csomagok úgy konfigurálják a meglévő ügyfélkódtárakat, hogy csatlakozzanak az üzemeltetési integrációkhoz. Kibővítik a IHostApplicationBuilder felületet, amely lehetővé teszi az ügyfél-használó projekteket, például a webalkalmazást vagy az API-t a csatlakoztatott erőforrás használatára. A hivatalos ügyfélintegrációs NuGet-csomagokaspire, integrationés clientcímkével vannak megjelölve. A hivatalos ügyfélintegrációk mellett a közösség a közösségi eszközkészlet részeként ügyfélintegrációkat hozott létre a különböző szolgáltatásokhoz és platformokhoz.

Az egyéni ügyfélintegrációk létrehozásáról további információt az Egyéni .NET.NET Aspire ügyfélintegrációk létrehozásacímű témakörben talál.

Az üzemeltetés és az ügyfélintegrációk közötti kapcsolat

Az üzemeltetés és az ügyfélintegrációk együttes használat esetén a legjobbak, de nem összekapcsolva, és külön használhatók. Egyes üzemeltetési integrációk nem rendelkeznek megfelelő ügyfélintegrációval. A konfiguráció teszi lehetővé, hogy az üzemeltetési integráció működjön az ügyfélintegrációval.

Tekintse meg az alábbi diagramot, amely az üzemeltetés és az ügyfélintegrációk közötti kapcsolatot mutatja be:

Az alkalmazásgazda projekt az, ahol a hosztintegrációkat használják. A konfiguráció, különösen a környezeti változók projektekbe, végrehajthatókba és tárolókba kerülnek, így az ügyfélintegrációk csatlakozhatnak az üzemeltetési integrációkhoz.

Integrációs funkciók

Amikor ügyfélintegrációt ad hozzá egy projekthez a .NET.NET Aspire megoldáson belül, a szolgáltatás alapértelmezés szerint automatikusan alkalmazva lesz az adott projektre; vagyis a Service Defaults projektre hivatkozik, és meghívja a AddServiceDefaults bővítménymetódust. Ezek az alapértelmezett értékek úgy vannak kialakítva, hogy a legtöbb forgatókönyvben jól működjenek, és igény szerint testre szabhatók. A rendszer a következő szolgáltatás alapértelmezéseket alkalmazza:

• Megfigyelhetőség és telemetria: Automatikusan beállítja a naplózási, nyomkövetési és metrikakonfigurációkat:

  • naplózási: Olyan technika, amelyben a kód a program futtatása közben történt érdekes események naplóinak előállítására szolgál.
  • Nyomkövetési: A naplózás speciális formája, amely segít honosítani a hibákat és a teljesítményproblémákat a több gépen vagy folyamaton elosztott alkalmazásokon belül.
  • Metrikák: Az alkalmazás teljesítményének és állapotának monitorozásához rögzített numerikus mérések. A metrikákat gyakran használják riasztások létrehozására, ha lehetséges problémákat észlelnek.

• Állapotellenőrzések: HTTP-végpontokat tesz elérhetővé, hogy alapvető rendelkezésre állási és állapotinformációkat biztosítson egy alkalmazásról. Az állapot-ellenőrzések a tárolóvezénylők, terheléselosztók, API-átjárók és egyéb felügyeleti szolgáltatások döntéseinek befolyásolására szolgálnak.

• rugalmassági: A rendszer képes reagálni a meghibásodásra, és továbbra is működőképes marad. A rugalmasság nemcsak a hibák megelőzésére terjed ki, hanem a felhőalapú környezet helyreállítására és rekonstruálására is, hogy visszanyerje egészséges állapotát.

Verziószámozási szempontok

Az üzemeltetési és ügyfélintegrációk minden kiadásban frissülnek, hogy a függő erőforrások legújabb stabil verzióit célozhassa meg. Ha a tárolólemezképek új lemezképverziókkal frissülnek, az üzemeltetési integrációk ezekre az új verziókra frissülnek. Hasonlóképpen, ha egy új NuGet-verzió elérhető egy függő ügyfélkódtárhoz, a megfelelő ügyfélintegráció frissül az új verzióra. Ez biztosítja, hogy a legújabb funkciók és biztonsági frissítések elérhetők legyenek az alkalmazások számára.

Ha jelentős kompatibilitástörő változások történnek a függő erőforrásokban, az integrációk átmenetileg verziófüggő csomagokra oszthatók, hogy megkönnyítsék a kompatibilitástörő változás frissítését. További információért lásd a ilyen kompatibilitást megszakító változás első példáját.

Hivatalos integrációk

.NET .NET Aspire számos integrációt biztosít a natív felhőbeli alkalmazások létrehozásához. Ezeket az integrációkat úgy tervezték, hogy zökkenőmentesen működjenek az .NET.NET Aspire alkalmazásgazda- és ügyfélkódtárakkal. A következő szakaszok a felhőfüggetlen, Azurespecifikus, az Amazon Web Services (AWS) és a Közösségi eszközkészlet integrációkat ismertetik.

Felhőfüggetlen integrációk

Az alábbi szakasz részletesen ismerteti a felhőbeli .NET.NET Aspire integrációkat a megfelelő dokumentumokra és NuGet-csomagokra mutató hivatkozásokkal, és rövid leírást nyújt az egyes integrációkról.

A .NET AspireVisual Studio integrációjával kapcsolatos további információkért lásd a Visual Studio eszközök.

Azure integrációk

Azure integrációk Azure erőforrások használatára konfigurálják az alkalmazásokat. Ezek az üzemeltetési integrációk a Aspire.Hosting.Azure.* NuGet-csomagokban érhetők el, míg az ügyfélintegrációk a Aspire.* NuGet-csomagokban érhetők el:

Az Amazon Web Services (AWS) üzemeltetési integrációi

További információ: GitHub: Aspire. Hosting.AWS-kódtár.

Közösségi eszközkészlet-integrációk

További információ: .NET.NET Aspire Community Toolkit.