Rövid útmutató: Azure Redis-gyorsítótárak használata .NET-keretrendszer

Ebben a rövid útmutatóban az Azure Cache for Redist egy .NET-keretrendszer alkalmazásba építi be, hogy hozzáférhessen egy biztonságos, dedikált gyorsítótárhoz, amely az Azure bármely alkalmazásából elérhető. A StackExchange.Redis-ügyfelet kifejezetten C# kóddal használja egy .NET-konzolalkalmazásban.

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

Klónozza az adattárat az Azure-Samples/azure-cache-redis-samplesból a GitHubon.

Előfeltételek

• Azure-előfizetés – hozzon létre egyet ingyenesen
• Visual Studio 2019
• A StackExchange.Redis-ügyfélnek 4 vagy újabb .NET-keretrendszer van szüksége.

Azure Managed Redis-példány létrehozása

1. Azure Managed Redis-példány 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 az Alapok lapon.

   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.
   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.
   Régió	Legördülő menüben válasszon ki egy helyet.	Az Azure Managed Redis a kiválasztott Azure-régiókban érhető el.
   Adatszint	Válassza ki a memóriában a nagy teljesítményű, vagy a Flash lehetőséget az alacsonyabb teljesítményű gyorsítótárakhoz	A memóriabeli szintek közé tartozik a Kiegyensúlyozott, a Memóriaoptimalizált és a Számításoptimalizált. Használja a Flash-szintet a memóriában (RAM) és a lemezen (SSD) tárolt adatok tárolására.
   Gyorsítótár mérete	Legördülő menüben válasszon ki egy méretet.	A gyorsítótár mérete a szinttől függ. A legkisebb méret egy kiegyensúlyozott szint. A legnagyobb memóriában tárolt szint egy memóriaoptimalizált szint.
   teljesítmény	Legördülő menüben válasszon egy teljesítménybeállítást.	A teljesítmény a vCPU-k számától függ. A vCPU száma a szinttől függően változik. A Compute Optimized rendelkezik a legtöbb vCPU-val.

   A megfelelő teljesítményszint kiválasztásával kapcsolatos útmutatásért lásd : A megfelelő szint kiválasztása.

   Fontos

   A több mint 120 GB tárterületet használó memóriabeli szintek mindegyike nyilvános előzetes verzióban érhető el, beleértve a Memóriaoptimalizált M150-et és újabbakat, a Kiegyensúlyozott B150 és újabbakat, valamint a Compute Optimized X150 és újabb verziókat. Ezek a szintek és magasabb szintek nyilvános előzetes verzióban érhetők el.

   Minden Flash-optimalizált szint nyilvános előzetes verzióban érhető el.

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

5. Válassza a Tovább: Aktív georeplikáció lehetőséget. Az aktív georeplikálás használatához engedélyezni kell a kiépítés során. Az aktív georeplikációs funkcióval nem rendelkező gyorsítótárak később nem vehetők fel aktív georeplikációs csoportokhoz, és nem csatlakozhatnak hozzájuk. További információ: Aktív georeplikálás konfigurálása Azure Managed Redis-példányokhoz.

6. Válassza a Tovább: Speciális fület.

   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.

   Fürtkezelési szabályzat beállítása:

   • Az Enterprise használata a RedisSearch vagy más modulok használatához
   • OsS használata fürtözött gyorsítótárhoz.
   • Nem fürtözött (előzetes verzió) használata nem 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.

   Fontos

   A létrehozás után nem módosíthatja egy Azure Managed Redis-példány fürtözé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.

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

8. Válassza a Tovább: Áttekintés és létrehozás lehetőséget.

9. 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” állapotké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. Az Azure Portalon keresse meg és válassza ki az Azure Cache for Redist.

2. Az Azure Cache for Redis lapon válassza azAzure Cache for Redis>.

3. Az Új Redis Cache lap Alapjai lapján konfigurálja a következő beállításokat:

   • Előfizetés: Válassza ki a használni kívánt előfizetést.
   • Erőforráscsoport: Válasszon ki egy erőforráscsoportot, vagy válassza az Új létrehozása lehetőséget, és adjon meg egy új erőforráscsoportnevet. Ha az összes alkalmazás-erőforrást ugyanabba az erőforráscsoportba helyezi, egyszerűen kezelheti vagy törölheti őket.
   • Név: Adjon meg egy, a régióban egyedi gyorsítótárnevet. A névnek a következőnek kell lennie:
     • Legyen 1–63 karakterből álló karakterlánc.
     • Csak számokat, betűket és kötőjeleket tartalmaz.
     • Kezdés és befejezés számmal vagy betűvel.
     • Nem tartalmaz egymást követő kötőjeleket.
   • Régió: Válasszon ki egy Azure-régiót a gyorsítótárat használó más szolgáltatások közelében.
   • Gyorsítótár termékváltozata: Válasszon ki egy termékváltozatot a gyorsítótár rendelkezésre álló méreteinek, teljesítményének és funkcióinak meghatározásához.
   • 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. A privát végpont használata ajánlott a biztonság érdekében. Ha a Privát végpont lehetőséget választja, válassza a Privát végpont hozzáadása lehetőséget, és hozza létre a privát végpontot.

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

7. A Speciális panelen konfigurálja a következő beállításokat:

   • Válassza a Microsoft Entra-hitelesítés vagy a hozzáférési kulcsok hitelesítése lehetőséget. A Microsoft Entra-hitelesítés alapértelmezés szerint engedélyezve van.
   • Adja meg, hogy engedélyezi-e a nem TLS-portot.
   • Prémium szintű gyorsítótár esetén konfigurálhatja vagy letilthatja 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. Standard gyorsítótár esetén a rendelkezésre állási zónák automatikusan lesznek lefoglalva. A rendelkezésre állási zónák nem érhetők el az alapszintű termékváltozathoz.
   • Prémium szintű gyorsítótár esetén konfigurálja a replikák számának, a fürtözés és a szegmensek számának, a rendszer által hozzárendelt felügyelt identitásnak és az adatmegőrzésnek a beállításait.

   Az alábbi képen a Standard termékváltozat Speciális lapja látható.

   

   Fontos

   Ha lehetséges, a Microsoft Entra ID és a felügyelt identitások használatával engedélyezheti a kéréseket a gyorsítótáron. A Microsoft Entra-azonosítót és felügyelt identitást használó engedélyezés nagyobb biztonságot nyújt, és könnyebben használható, mint a közös hozzáférési kulcs engedélyezése. 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. Ha szeretné, válassza a Címkék lapot, vagy válassza a Tovább: Címkék lehetőséget, és adja meg a címkék nevét és értékeit a gyorsítótár-erőforrások kategorizálásához.

9. Válassza a Véleményezés + létrehozás lehetőséget, és ha az ellenőrzés sikeres, válassza a Létrehozás lehetőséget.

Az új gyorsítótár üzembe helyezése több percet vesz igénybe. Az üzembe helyezés előrehaladását az Azure Cache for Redis portál oldalán követheti nyomon. Amikor a gyorsítótár működési állapotaműködésben van, 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 Managed Redis-gyorsítótárakban alapértelmezés szerint engedélyezve van a Microsoft Entra-hitelesítés.

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.

   

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 Microsoft Entra ID hitelesítési módszert az Azure Redis-szolgáltatásokhoz a Microsoft Entra ID használatával való csatlakozáshoz. Ez az összes Azure Cache for Redisre, az Azure Cache for Redis Enterprise-ra és az Azure Managed Redisre vonatkozik.

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();

Az app.config fájl szerkesztése

1. Szerkessze az app.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ének nevét az Azure Portal Erőforrás menüjének Áttekintés menüjében 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.

Az app.config fájl szerkesztése

1. Szerkessze az app.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ének nevét az Azure Portal Erőforrás menüjének Áttekintés menüjében 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.

A minta futtatása

A .NET-objektumok szerializálásának teszteléséhez buildelje és futtassa a konzolalkalmazást a Ctrl+F5 billentyűkombináció lenyomásával.

Erőforrások tisztí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

Egy erőforráscsoport törlése visszafordíthatatlan. 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.

   

3. Válassza az Erőforráscsoport törlése lehetőséget.

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.

   

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

Kapcsolódó tartalom

• Kapcsolat rugalmassága
• Ajánlott eljárások fejlesztése