Megosztás a következőn keresztül:

Rövid útmutató: Az Azure Redis használata ASP.NET webalkalmazással

  • Cikk

Ebben a rövid útmutatóban a Visual Studio 2019 használatával hoz létre egy ASP.NET webalkalmazást, amely az Azure Cache for Redishez csatlakozva tárolja és kéri le az adatokat a gyorsítótárból. Ezután üzembe helyezheti az alkalmazást a Azure-alkalmazás Szolgáltatásban.

Ugrás a GitHubon található kódra

Klónozza az adattárat https://github.com/Azure-Samples/azure-cache-redis-samples/tree/main/quickstart/aspnet a GitHubon.

Előfeltételek

Azure Managed Redis-példány (előzetes verzió) létrehozása

  1. Azure Managed Redis-példány (előzetes verzió) létrehozásához jelentkezzen be az Azure Portalra, és válassza az Erőforrás létrehozása lehetőséget.

  2. Az Új lap keresőmezőbe írja be az Azure Cache for Redis kifejezést.

  3. Az Új Redis Cache lapon konfigurálja az új gyorsítótár beállításait.

    Beállítás Válasszon egy értéket Leírás
    Előfizetés Legördülő menüben válassza ki az előfizetését. Az előfizetés, amely alatt létre kell hozni ezt az új Azure Managed Redis-példányt.
    Erőforráscsoport Legördülő menüben jelöljön ki egy erőforráscsoportot, vagy válassza az Új létrehozása lehetőséget, és adjon meg egy új erőforráscsoportnevet. Annak az erőforráscsoportnak a neve, amelyben létre kívánja hozni a gyorsítótárat és más erőforrásokat. Ha az összes alkalmazás-erőforrást egy erőforráscsoportba helyezi, egyszerűen kezelheti vagy törölheti őket.
    DNS-név Adjon meg egy egyedi nevet a régióban. A gyorsítótár nevének 1 és 63 karakter közötti karakterláncnak kell lennie, ha a gyorsítótár csak számokat, betűket vagy kötőjeleket tartalmazó régiónevével van kombinálva. (Ha a gyorsítótár neve kevesebb, mint 45 karakter hosszú, akkor az összes jelenleg elérhető régióban működnie kell.) A névnek számmal vagy betűvel kell kezdődnie és végződnie, és nem tartalmazhat egymást követő kötőjeleket. A gyorsítótárpéldány gazdagépneve .\<DNS name\>.\<Azure region\>.redis.azure.net
    Helyen Legördülő menüben válasszon ki egy helyet. Az Azure Managed Redis a kiválasztott Azure-régiókban érhető el.
    Gyorsítótár típusa Legördülő menüben válassza ki a teljesítményszintet és a gyorsítótár méretét. A réteg határozza meg a Redis-példány teljesítményét, míg a gyorsítótár mérete határozza meg az adatok tárolására rendelkezésre álló memóriát. A megfelelő teljesítményszint kiválasztásával kapcsolatos útmutatásért lásd : A megfelelő szint kiválasztása

    Képernyőkép az Azure Managed Redis Basics lapról.

  4. Válassza a Tovább: Hálózatkezelés lehetőséget, és válasszon egy nyilvános vagy privát végpontot.

  5. Válassza a Tovább: Speciális lehetőséget.

    Konfigurálja a példányhoz hozzáadni kívánt Redis-modulokat .

    Alapértelmezés szerint egy új felügyelt gyorsítótár esetében:

    • A Microsoft Entra-azonosító engedélyezve van.
    • A hozzáférési kulcsok hitelesítése biztonsági okokból le van tiltva.

    Fontos

    Az optimális biztonság érdekében azt javasoljuk, hogy a Microsoft Entra ID-t felügyelt identitásokkal használva engedélyezze a kéréseket a gyorsítótáron, ha lehetséges. A Microsoft Entra-azonosító és a felügyelt identitások használatával történő engedélyezés kiváló biztonságot és egyszerű használatot biztosít a megosztott hozzáférési kulcsok engedélyezésével szemben. A felügyelt identitások gyorsítótárral való használatáról további információt a Microsoft Entra ID használata gyorsítótár-hitelesítéshez című témakörben talál.

    Állítsa be a fürtkezelési szabályzatotenterprise-ra nemclustered cache-hez, vagy osS-re fürtözött gyorsítótárhoz. A fürtszabályzat kiválasztásáról további információt a Fürtszabályzat című témakörben talál.

    Képernyőkép az Azure Managed Redis Advanced lapról.

    Ha aktív georeplikációt használ, azt a létrehozás során kell konfigurálni. További információ: Aktív georeplikálás konfigurálása Azure Managed Redis-példányokhoz.

    Fontos

    A létrehozása után nem módosíthatja egy Azure Managed Redis-példány (előzetes verzió) fürtkezelési szabályzatát. RediSearch használata esetén a vállalati fürtszabályzat szükséges, és NoEviction ez az egyetlen támogatott kiürítési szabályzat.

    Fontos

    Ha ezt a gyorsítótárpéldányt georeplikációs csoportban használja, a kizárási házirendek nem módosíthatók a példány létrehozása után. A gyorsítótár létrehozása előtt mindenképpen ismernie kell az elsődleges csomópontok kiürítési szabályzatait. Az aktív georeplikációs adatokról további információt az Aktív georeplikációs előfeltételek című témakörben talál.

    Fontos

    A gyorsítótárpéldány létrehozása után nem módosíthatja a modulokat. A modulokat az Azure Cache for Redis-példány létrehozásakor engedélyezni kell. A gyorsítótár létrehozása után nincs lehetőség a modul konfigurálásának engedélyezésére.

  6. Válassza a Következő: Címkék és kihagyás lehetőséget.

  7. Válassza a Tovább: Ellenőrzés és létrehozás lehetőségre.

  8. Tekintse át a beállításokat, és válassza a Létrehozás lehetőséget.

    A Redis-példány létrehozása több percet vesz igénybe. Az előrehaladást az Azure Managed Redis áttekintési oldalán követheti nyomon. Ha az állapot futásként jelenik meg, a gyorsítótár készen áll a használatra.

Azure Cache for Redis-példány létrehozása

  1. Gyorsítótár létrehozásához jelentkezzen be az Azure Portalra. A portál menüjében válassza az Erőforrás létrehozása lehetőséget.

    Sceenshot, amely az Azure Portal bal oldali navigációs panelén kiemelt Erőforrás létrehozása lehetőséget jeleníti meg.

  2. Az Első lépések panelen írja be az Azure Cache for Redist a keresősávba. A keresési eredmények között keresse meg az Azure Cache for Redist, majd válassza a Létrehozás lehetőséget.

    Képernyőkép az Azure Marketplace-ről és az Azure Cache for Redisről a keresőmezőben, és a Létrehozás gomb ki van emelve.

  3. Az Új Redis Cache panel Alapszintű beállítások lapján konfigurálja a következő beállításokat a gyorsítótárhoz:

    Beállítás Művelet Leírás
    Előfizetés Válassza ki az Azure-előfizetését. Az Azure Cache for Redis új példányának létrehozásához használandó előfizetés.
    Erőforráscsoport Jelöljön ki egy erőforráscsoportot, vagy válassza az Új létrehozása lehetőséget, és adjon meg egy új erőforráscsoportnevet. Annak az erőforráscsoportnak a neve, amelyben létre szeretné hozni a gyorsítótárat és más erőforrásokat. Ha az összes alkalmazás-erőforrást egy erőforráscsoportba helyezi, egyszerűen kezelheti vagy törölheti őket.
    DNS-név Adjon meg egy egyedi nevet. A gyorsítótár nevének 1–63 karakterből álló sztringnek kell lennie, amely csak számokat, betűket és kötőjeleket tartalmaz. A névnek számmal vagy betűvel kell kezdődnie és végződnie, és nem tartalmazhat egymást követő kötőjeleket. A gyorsítótárpéldány gazdagépneve .\<DNS name>.redis.cache.windows.net
    Helyen Válasszon ki egy helyet. Olyan Azure-régió , amely a gyorsítótárat használó egyéb szolgáltatások közelében található.
    Gyorsítótár termékváltozata Válasszon egy termékváltozatot. Az termékváltozat határozza meg a gyorsítótár számára elérhető méretet, teljesítményt és funkcióparamétereket. További információ: Azure Cache for Redis – áttekintés.
    Gyorsítótár mérete Válasszon egy gyorsítótárméretet. További információ: Azure Cache for Redis – áttekintés.

  4. Válassza a Hálózatkezelés lapot, vagy válassza a Tovább: Hálózatkezelés lehetőséget.

  5. A Hálózatkezelés lapon válassza ki a gyorsítótárhoz használni kívánt kapcsolati módszert.

  6. Válassza a Speciális lapot, vagy válassza a Tovább: Speciális lehetőséget.

  7. A Speciális panelen ellenőrizze vagy válassza ki a hitelesítési módszert az alábbi információk alapján:

    Képernyőkép a Speciális panelről és a választható lehetőségekről.

    • Alapértelmezés szerint egy új alapszintű, standard vagy prémium szintű gyorsítótár esetében a Microsoft Entra-hitelesítés engedélyezve van, és a hozzáférési kulcsok hitelesítése le van tiltva.
    • Alapszintű vagy standard gyorsítótárak esetén kiválaszthatja a nem TLS-portok kiválasztását.
    • Standard és Prémium szintű gyorsítótárak esetén engedélyezheti a rendelkezésre állási zónákat. A gyorsítótár létrehozása után nem tilthatja le a rendelkezésre állási zónákat.
    • Prémium szintű gyorsítótár esetén konfigurálja a nem TLS-port, a fürtözés, a felügyelt identitás és az adatmegőrzés beállításait.

    Fontos

    Az optimális biztonság érdekében azt javasoljuk, hogy a Microsoft Entra ID-t felügyelt identitásokkal használva engedélyezze a kéréseket a gyorsítótáron, ha lehetséges. A Microsoft Entra-azonosító és a felügyelt identitások használatával történő engedélyezés kiváló biztonságot és egyszerű használatot biztosít a megosztott hozzáférési kulcsok engedélyezésével szemben. A felügyelt identitások gyorsítótárral való használatáról további információt a Microsoft Entra ID használata gyorsítótár-hitelesítéshez című témakörben talál.

  8. (Nem kötelező) Válassza a Címkék lapot, vagy válassza a Tovább: Címkék lehetőséget.

  9. (Nem kötelező) A Címkék lapon adja meg a címke nevét és értékét, ha kategorizálni szeretné a gyorsítótár-erőforrást.

  10. Válassza az Áttekintés + létrehozás lehetőséget.

    A Felülvizsgálat + létrehozás lapon az Azure automatikusan ellenőrzi a konfigurációt.

  11. A zöld érvényesítési üzenet megjelenése után válassza a Létrehozás lehetőséget.

Az új gyorsítótár üzembe helyezése több perc alatt megtörténik. Az üzembe helyezés előrehaladását az Azure Cache for Redis Áttekintés panelen követheti nyomon. Amikor az állapot a Futtatás állapotot jeleníti meg, a gyorsítótár készen áll a használatra.

A Microsoft Entra ID-hitelesítés használata a gyorsítótárban

Az Azure Redis-gyorsítótárak a Nagyvállalati és Nagyvállalati Flash-szintek kivételével alapértelmezés szerint engedélyezve vannak a Microsoft Entra-hitelesítéssel. A hozzáférési kulcsok alapértelmezés szerint le vannak tiltva.

Fontos

A Microsoft a Microsoft Entra ID-hitelesítés használatát javasolja a legbiztonságosabb hitelesítéshez jelszavak vagy hozzáférési kulcsok használata helyett. A cikk jelen szakaszában ismertetett hitelesítés hozzáférési kulcsokat használ, amelyek nagyon nagy megbízhatóságot igényelnek az alkalmazásban, és olyan kockázatokat hordoznak, amelyek nem jelentkeznek a Microsoft Entra-azonosító használatakor. A jelen dokumentumban szereplő módszert csak akkor használja, ha a Microsoft Entra-azonosító hitelesítése nem járható út.

  1. Az Azure Portalon válassza ki azt a gyorsítótárat, ahol a Microsoft Entra tokenalapú hitelesítést szeretné használni.

  2. Válassza a Hitelesítés lehetőséget az Erőforrás menüben.

  3. Válassza a Tag kiválasztása lehetőséget, és adja meg egy érvényes felhasználó nevét. A beírt felhasználó alapértelmezés szerint automatikusan adattulajdonosi hozzáférési szabályzatot kap, amikor a Mentés lehetőséget választja. A gyorsítótárpéldányhoz való csatlakozáshoz megadhat egy felügyelt identitást vagy szolgáltatásnevet is.

    Képernyőkép az erőforrásmenüben kiválasztott hitelesítésről és a Microsoft Entra-hitelesítés engedélyezéséről.

A Microsoft Entra ID és az Azure CLI használatával kapcsolatos információkért tekintse meg az identitás referenciaoldalait.

A Kódtár telepítése a Microsoft Entra ID-hitelesítés használatához

Az Azure.StackExchange.Redis kódtár tartalmazza a Microsoftot, amely a Microsoft Entra ID hitelesítési módszerével csatlakozik az Azure Redis-szolgáltatásokhoz a Microsoft Entra ID használatával. Az összes Azure Cache for Redisre, az Azure Cache for Redis Enterprise-ra és az Azure Managed Redisre (előzetes verzió) érvényes.

  1. Projekt megnyitása a Visual Studióban

  2. Kattintson a jobb gombbal a projektre, és válassza a NuGet-csomagok kezelése...

  3. Keressen a Microsoft.Azure.StackExchangeRedis kifejezésre.

  4. A telepítéshez kattintson a Telepítés gombra

  5. A telepítés befejezéséhez fogadja el az összes felkért tartalmat

Csatlakozás a gyorsítótárhoz a Microsoft Entra ID használatával

  1. A kódtárak belefoglalása a kódba

    using Azure.Identity;
using StackExchange.Redis

  2. Az alapértelmezett Azure-hitelesítő adatok használata az ügyfélkapcsolat hitelesítéséhez. Ez lehetővé teszi, hogy a kód a bejelentkezett felhasználói hitelesítő adatokat használja helyi futtatáskor, és egy Azure-beli felügyelt identitást, amikor kódmódosítás nélkül fut az Azure-ban.

var configurationOptions = await ConfigurationOptions.Parse($"{_redisHostName}").ConfigureForAzureWithTokenCredentialAsync(new DefaultAzureCredential());
ConnectionMultiplexer _newConnection = await ConnectionMultiplexer.ConnectAsync(configurationOptions);
IDatabase Database = _newConnection.GetDatabase();

A web.config fájl szerkesztése

  1. Szerkessze a Web.config fájlt a következő tartalom hozzáadásával:

    <appSettings>
    <add key="RedisHostName" value="<cache-hostname-with-portnumber>"/>
</appSettings>

  2. Cserélje le <cache-hostname> a gyorsítótár-gazdagép nevét az Azure Portal Erőforrás menüjének Áttekintés lapján megjelenő módon.

    Például az Azure Managed Redis vagy a Vállalati szintek esetében: my-redis.eastus.azure.net:10000

  3. Mentse a fájlt.

További információ: StackExchange.Redis és a GitHub-adattár kódja.

A web.config fájl szerkesztése

  1. Szerkessze a Web.config fájlt a következő tartalom hozzáadásával:

    <appSettings>
    <add key="RedisHostName" value="<cache-hostname-with-portnumber>"/>
</appSettings>

  2. Cserélje le <cache-hostname> a gyorsítótár-gazdagép nevét az Azure Portal Erőforrás menüjének Áttekintés lapján megjelenő módon.

    Például az Azure Cache for Redis esetében my-redis.eastus.azure.net:6380

  3. Mentse a fájlt.

További információ: StackExchange.Redis és a GitHub-adattár kódja.

Az alkalmazás futtatása helyben

Alapértelmezés szerint a projekt úgy van konfigurálva, hogy helyben üzemeltesse az alkalmazást az IIS Expressben a teszteléshez és a hibakereséshez.

Az alkalmazás futtatása helyben

  1. A Visual Studióban válassza a Debug (Hibakeresés) >Start Debugging (Hibakeresés indítása) elemet az alkalmazás teszteléshez és hibakereséshez való létrehozásához és helyi elindításához.

  2. A böngészőben válassza az Azure Cache for Redis Test lehetőséget a navigációs sávon.

  3. Az alábbi példában a Message kulcs korábban gyorsítótárazott értékkel rendelkezett, amelyet a portálOn az Azure Cache for Redis konzollal állított be. Az alkalmazás frissítette ezt a gyorsítótárazott értéket. Az alkalmazás továbbá végrehajtotta a PING és a CLIENT LIST parancsot.

    Képernyőkép a helyileg elvégzett egyszerű tesztről.

Közzététel és futtatás az Azure-ban

Az alkalmazás sikeres helyi tesztelése után az Azure-beli üzembe helyezés és a felhőben történő futtatás következik.

Az alkalmazás közzététele az Azure-ban

  1. A Visual Studio Megoldáskezelőjében kattintson a jobb gombbal a projektcsomópontra. Ezután válassza a Publish (Közzététel) lehetőséget.

    Képernyőkép a közzététel gombról.

  2. Válassza a Microsoft Azure App Service, majd a Create New (Új létrehozása) elemet, végül pedig a Publish (Közzététel) lehetőséget.

    Képernyőkép az App Service-ben való közzétételről.

  3. A Create App Service (App Service létrehozása) párbeszédpanelen hajtsa végre a következő módosításokat:

    Beállítás Javasolt érték Leírás
    Alkalmazás neve Használja az alapértelmezettet. Az alkalmazás neve az alkalmazás állomásneve az Azure-ban való üzembe helyezéskor. Ha a név egyediségéhez ez szükséges, a rendszer időbélyeg-utótagot fűzhet hozzá.
    Előfizetés Válassza ki az Azure-előfizetését. A kapcsolódó üzemeltetési költségek ennél az előfizetésnél lesznek felszámítva. Ha több Azure-előfizetéssel is rendelkezik, ellenőrizze, hogy a kívánt előfizetés van-e kiválasztva.
    Erőforráscsoport Használja ugyanazt az erőforráscsoportot, mint amelyben a gyorsítótárat létrehozta (pl.: TestResourceGroup). Az erőforráscsoport segítségével az összes erőforrást egy csoportként kezelheti. Később, amikor törölni kívánja az alkalmazást, elég csak a csoportot törölnie.
    App Service-csomag Válassza az Új elemet, és hozzon létre egy TestingPlan nevű új App Service-csomagot.
    Használja ugyanazt a Helyet, mint amelyet a gyorsítótár létrehozásakor használt.
    A méretnél válassza az Ingyenes lehetőséget.    		 Az App Service-csomag meghatároz egy futtatáshoz használható számításierőforrás-készletet a webalkalmazás számára.

    Képernyőkép az App Service párbeszédpanelről.

  4. Az App Service üzemeltetési beállításainak konfigurálása után válassza a Létrehozás lehetőséget.

  5. A közzététel állapotát a Visual Studio Kimenet ablakában ellenőrizheti. Az alkalmazás közzététele után a rendszer naplózza az alkalmazás URL-címét:

    Képernyőkép a közzétételi adatokról a kimeneti panelen.

A gyorsítótárhoz tartozó alkalmazásbeállítás hozzáadása

Az új alkalmazás közzététele után adjon hozzá egy új alkalmazásbeállítást. A rendszer ezt a beállítást használja a gyorsítótár kapcsolati adatainak tárolására.

Az alkalmazásbeállítás hozzáadása

  1. A létrehozott új alkalmazás megkereséséhez írja be az alkalmazás nevét az Azure Portal tetején található keresősávba.

    Képernyőkép arról, hogyan keresheti meg az alkalmazást az Azure Portalon.

  2. Adjon hozzá egy CacheConnection nevű új alkalmazásbeállítást, amelyet az alkalmazás a gyorsítótárhoz való csatlakozáshoz fog használni. Használja ugyanazt az értéket, amelyet RedisHostName a web.config fájlban konfigurált .

Az alkalmazás futtatása az Azure-ban

  1. Lépjen a böngészőben az alkalmazás URL-címére. Az URL-cím megjelenik a Visual Studio kimeneti ablakában a közzétételi művelet eredményei között. Az URL-címet az Azure Portalon, a létrehozott alkalmazás áttekintési oldalán is meg kell adni.

  2. Válassza az Azure Cache for Redis Test lehetőséget a navigációs sávon a gyorsítótár-hozzáférés teszteléséhez, ahogyan a helyi verzió esetében tette.

Az erőforrások eltávolítása

Ha továbbra is használni szeretné a cikkben létrehozott erőforrásokat, tartsa meg az erőforráscsoportot.

Ellenkező esetben, ha végzett az erőforrásokkal, törölheti a létrehozott Azure-erőforráscsoportot a díjak elkerülése érdekében.

Fontos

Az erőforráscsoport törlése nem vonható vissza. Az erőforráscsoport törlésekor a benne foglalt összes erőforrás véglegesen törlődik. Figyeljen arra, hogy ne töröljön véletlenül erőforráscsoportot vagy erőforrásokat. Ha olyan meglévő erőforráscsoportban hozta létre az erőforrásokat, amely a megtartani kívánt erőforrásokat tartalmazza, az erőforráscsoport törlése helyett egyenként törölheti az egyes erőforrásokat.

Erőforráscsoport törlése

  1. Jelentkezzen be az Azure Portalra, és válassza az Erőforráscsoportok elemet.

  2. Válassza ki a törölni kívánt erőforráscsoportot.

    Ha sok erőforráscsoport van, használja a Szűrő bármely mezőhöz... mezőt, írja be a cikkhez létrehozott erőforráscsoport nevét. Válassza ki az erőforráscsoportot az eredménylistában.

    Képernyőkép a munkaablakban törölni kívánt erőforráscsoportok listájáról.

  3. Válassza az Erőforráscsoport törlése elemet.

  4. A rendszer az erőforráscsoport törlésének megerősítését kéri. A megerősítéshez írja be az erőforráscsoport nevét, és válassza a Törlést.

    Képernyőkép egy űrlapról, amely megköveteli az erőforrás nevét a törlés megerősítéséhez.

A rendszer néhány pillanaton belül törli az erőforráscsoportot és annak erőforrásait.

Kapcsolódó tartalom