Rychlý start: Použití Azure Cache for Redis s webovou aplikací ASP.NET
V tomto rychlém startu pomocí sady Visual Studio 2019 vytvoříte ASP.NET webovou aplikaci, která se připojí ke službě Azure Cache for Redis pro ukládání a načítání dat z mezipaměti. Pak aplikaci nasadíte do služby Aplikace Azure Service.
Přeskočit na kód na GitHubu
Naklonujte úložiště https://github.com/Azure-Samples/azure-cache-redis-samples/tree/main/quickstart/aspnet na GitHubu.
Požadavky
- Předplatné Azure – vytvoření bezplatného předplatného
- Visual Studio 2019 s úlohami vývoje pro ASP.NET a web a vývoj pro Azure
Vytvoření mezipaměti
V dalším kroku vytvoříte pro aplikaci mezipaměť.
Pokud chcete vytvořit mezipaměť, přihlaste se k webu Azure Portal a vyberte Vytvořit prostředek.
Na stránce Nový vyberte Databáze a pak vyberte Azure Cache for Redis.
Na stránce New Redis Cache nakonfigurujte nastavení pro novou mezipaměť.
Nastavení Zvolit hodnotu Popis Předplatné Rozevírací seznam a vyberte své předplatné. Předplatné, ve kterém se má tato nová instance Azure Cache for Redis vytvořit. Skupina prostředků Rozevírací seznam a vyberte skupinu prostředků nebo vyberte Vytvořit novou a zadejte nový název skupiny prostředků. Název skupiny prostředků, ve které chcete vytvořit mezipaměť a další prostředky. Když umístíte všechny prostředky aplikace do jedné skupiny prostředků, můžete je snadno spravovat nebo odstraňovat společně. Název DNS Zadejte jedinečný název. Název mezipaměti musí být řetězec mezi 1 a 63 znaky, který obsahuje pouze číslice, písmena nebo pomlčky. Název musí začínat a končit číslicí nebo písmenem a nesmí obsahovat po sobě jdoucí pomlčky. Název hostitele vaší instance mezipaměti je< NÁZEV> DNS.redis.cache.windows.net. Místo Rozevírací seznam a výběr umístění Vyberte oblast poblíž jiných služeb, které používají vaši mezipaměť. Typ mezipaměti Rozevírací seznam a výběr úrovně Úroveň určuje velikost, výkon a funkce, které jsou k dispozici pro mezipaměť. Další informace najdete v tématu Přehled služby Azure Cache for Redis. Vyberte kartu Sítě nebo vyberte tlačítko Sítě v dolní části stránky.
Na kartě Sítě vyberte metodu připojení.
Vyberte kartu Další: Upřesnit nebo vyberte tlačítko Další: Upřesnit v dolní části stránky a zobrazte kartu Upřesnit.
- U mezipamětí Basic nebo Standard přepněte výběr pro port, který není tls. Můžete také vybrat, jestli chcete povolit ověřování Microsoft Entra.
- Pro mezipaměť Premium nakonfigurujte nastavení pro port bez protokolu TLS, clustering, spravovanou identitu a trvalost dat. Můžete také vybrat, jestli chcete povolit ověřování Microsoft Entra.
Vyberte kartu Další: Značky nebo vyberte tlačítko Další: Značky v dolní části stránky.
Volitelně můžete na kartě Značky zadat název a hodnotu, pokud chcete prostředek zařadit do kategorií.
Vyberte Zkontrolovat a vytvořit. Přejdete na kartu Zkontrolovat a vytvořit, kde Azure ověří vaši konfiguraci.
Jakmile se zobrazí zelená zpráva o úspěšném ověření, vyberte Vytvořit.
Vytvoření mezipaměti chvíli trvá. Průběh můžete sledovat na stránce Přehled služby Azure Cache for Redis. Když se stav zobrazí jako Spuštěno, je mezipaměť připravená k použití.
Načtení názvu hostitele, portů a přístupových klíčů z webu Azure Portal
K připojení serveru Azure Cache for Redis potřebuje klient mezipaměti název hostitele, porty a klíč pro mezipaměť. Někteří klienti mohou tyto položky označovat trochu odlišnými názvy. Název hostitele, porty a klíče můžete získat z webu Azure Portal.
Přístupové klíče získáte tak, že v nabídce Prostředek vyberete Možnost Ověřování . Pak vyberte kartu Přístupové klávesy .
Pokud chcete získat název hostitele a porty pro vaši mezipaměť, vyberte v nabídce Prostředek přehled . Název hostitele je ve formátu DNS name.redis.cache.windows.net>.<
Úprava souboru CacheSecrets.config
Vytvořte v počítači soubor s názvem CacheSecrets.config. Umístěte ho do umístění, kde se nevrátí se změnami se zdrojovým kódem ukázkové aplikace. V tomto rychlém startu je soubor CacheSecrets.config umístěný zde: C:\AppSecrets\CacheSecrets.config.
Upravte soubor CacheSecrets.config. Pak přidejte následující obsah:
<appSettings> <add key="CacheConnection" value="<cache-name>.redis.cache.windows.net,abortConnect=false,ssl=true,allowAdmin=true,password=<access-key>"/> </appSettings>
<cache-name>
nahraďte názvem hostitele mezipaměti.<access-key>
nahraďte primárním klíčem mezipaměti.Tip
Při rotaci klíčů můžete použít sekundární přístupový klíč jako alternativní klíč během opětovného generování primárního přístupového klíče.
Uložte soubor.
Aktualizace aplikace MVC
V této části uvidíte aplikaci MVC, která zobrazuje jednoduchý test ve službě Azure Cache for Redis.
Jak se soubor web.config připojuje k mezipaměti
Při místním spuštění aplikace se informace v CacheSecrets.config používají k připojení k instanci Azure Cache for Redis. Později můžete tuto aplikaci nasadit do Azure. Přitom nakonfigurujete nastavení aplikace v Azure tak, aby aplikace místo použití tohoto souboru načetla informace o připojení k mezipaměti.
Protože soubor CacheSecrets.config není nasazený v Azure společně s aplikací, použijete ho jen při místním testování aplikace. Tyto informace maximálně zabezpečte, abyste zabránili škodlivému přístupu k datům mezipaměti.
Aktualizace souboru web.config
V Průzkumník řešení otevřete soubor web.config.
V souboru web.config můžete nastavit
<appSettings>
prvek pro místní spuštění aplikace.<appSettings file="C:\AppSecrets\CacheSecrets.config">
Modul runtime ASP.NET sloučí obsah externího souboru se značkami v elementu <appSettings>
. Pokud zadaný soubor nelze nalézt, modul runtime atribut souboru ignoruje. Vaše tajné kódy (připojovací řetězce k mezipaměti) nejsou součástí zdrojového kódu aplikace. Když webovou aplikaci nasadíte do Azure, soubor CacheSecrets.config se nenasadí.
Instalace StackExchange.Redis
Vaše řešení potřebuje, aby se StackExchange.Redis
balíček spustil. Nainstalujte ho pomocí tohoto postupu:
Pokud chcete aplikaci nakonfigurovat tak, aby používala balíček NuGet StackExchange.Redis pro Visual Studio, vyberte Nástroje > NuGet Správce balíčků > konzolu Správce balíčků.
V okně
Package Manager Console
spusťte následující příkaz:Install-Package StackExchange.Redis
Balíček NuGet stáhne a přidá požadované odkazy na sestavení pro klientskou aplikaci pro přístup ke službě
StackExchange.Redis
Azure Cache for Redis pomocí klienta.
Připojení do mezipaměti pomocí Redisu Připojení ion
Připojení k mezipaměti spravuje RedisConnection
třída. Připojení je nejprve provedeno v tomto příkazu z ContosoTeamStats/Controllers/HomeController.cs
:
private static Task<RedisConnection> _redisConnectionFactory = RedisConnection.InitializeAsync(connectionString: ConfigurationManager.AppSettings["CacheConnection"].ToString()););
Hodnota tajného kódu Cache Připojení ion je přístupná pomocí zprostředkovatele konfigurace Secret Manageru a používá se jako parametr hesla.
Uvidíte RedisConnection.cs
, že StackExchange.Redis
obor názvů byl přidán do kódu. To je potřeba pro RedisConnection
třídu.
using StackExchange.Redis;
Kód RedisConnection
zajišťuje, že existuje vždy v pořádku připojení k mezipaměti tím, že spravuje ConnectionMultiplexer
instanci z StackExchange.Redis
. RedisConnection
Třída znovu vytvoří připojení, když dojde ke ztrátě připojení a nemůže se znovu připojit automaticky.
Další informace najdete v tématu StackExchange.Redis a kód v úložišti GitHub.
Zobrazení rozložení v ukázce
Rozložení domovské stránky pro tuto ukázku je uloženo v souboru _Layout.cshtml . Na této stránce spustíte skutečné testování mezipaměti kliknutím na Azure Cache for Redis Test z této stránky.
V Průzkumníku řešení rozbalte složku Zobrazení>Sdílené. Potom otevřete soubor _Layout.cshtml.
Zobrazí se následující řádek v
<div class="navbar-header">
souboru .@Html.ActionLink("Azure Cache for Redis Test", "RedisCache", "Home", new { area = "" }, new { @class = "navbar-brand" })
Zobrazení dat z mezipaměti
Na domovské stránce vyberete Azure Cache for Redis Test a zobrazí se ukázkový výstup.
V Průzkumníku řešení rozbalte složku Zobrazení a klikněte pravým tlačítkem na složku Domů.
Tento kód byste měli vidět v souboru RedisCache.cshtml .
@{ ViewBag.Title = "Azure Cache for Redis Test"; } <h2>@ViewBag.Title.</h2> <h3>@ViewBag.Message</h3> <br /><br /> <table border="1" cellpadding="10"> <tr> <th>Command</th> <th>Result</th> </tr> <tr> <td>@ViewBag.command1</td> <td><pre>@ViewBag.command1Result</pre></td> </tr> <tr> <td>@ViewBag.command2</td> <td><pre>@ViewBag.command2Result</pre></td> </tr> <tr> <td>@ViewBag.command3</td> <td><pre>@ViewBag.command3Result</pre></td> </tr> <tr> <td>@ViewBag.command4</td> <td><pre>@ViewBag.command4Result</pre></td> </tr> <tr> <td>@ViewBag.command5</td> <td><pre>@ViewBag.command5Result</pre></td> </tr> </table>
Místní spuštění aplikace
Projekt je standardně nakonfigurovaný tak, aby pro účely testování a ladění byla aplikace hostovaná místně ve službě IIS Express.
Spuštění aplikace místně
V sadě Visual Studio vyberte Ladění>Spustit ladění a sestavte a spusťte aplikaci místně pro účely testování a ladění.
V prohlížeči vyberte Azure Cache for Redis Test na navigačním panelu.
V následujícím příkladu
Message
měl klíč dříve hodnotu uloženou v mezipaměti, která byla nastavena pomocí konzoly Azure Cache for Redis na portálu. Aplikace tuto hodnotu z mezipaměti aktualizovala. Aplikace rovněž spustila příkazyPING
aCLIENT LIST
.
Publikování a spuštění v Azure
Jakmile aplikaci úspěšně místně otestujete, můžete ji nasadit do Azure a spustit v cloudu.
Publikování aplikace do Azure
V sadě Visual Studio klikněte pravým tlačítkem na uzel projektu v Průzkumníku řešení. Potom vyberte Publikovat.
Vyberte Microsoft Azure App Service, dále Vytvořit nový a nakonec Publikovat.
V dialogovém okně Vytvořit plán App Service udělejte následující změny:
Nastavení Doporučená hodnota Popis Název aplikace Použijte výchozí hodnotu. Po nasazení do Azure se název aplikace stane názvem hostitele této aplikace. Kvůli zachování jedinečnosti může být v případě potřeby tento název doplněný o časové razítko. Předplatné Zvolte svoje předplatné Azure. K tomuto předplatnému se účtují všechny související poplatky za hosting. Pokud máte několik předplatných Azure, zkontrolujte, že je vybrané to správné. Skupina prostředků Použijte stejnou skupinu prostředků, ve které jste vytvořili mezipaměť (například TestResourceGroup). Skupina prostředků vám pomůže spravovat všechny prostředky jako skupinu. Až budete později chtít aplikaci odstranit, stačí jen odstranit tuto skupinu. Plán služby App Service Vyberte Nový a potom vytvořte nový plán služby App Service s názvem TestingPlan.
Použijte stejné Umístění jako při vytváření mezipaměti.
Jako velikost zvolte Free.Plán služby App Service definuje sadu výpočetních prostředků pro provozování webové aplikace. Až nakonfigurujete nastavení hostingu služby App Service, vyberte Vytvořit.
Sledujte okno Výstup v sadě Visual Studio, kde se zobrazuje stav publikování. Po publikování aplikace se zaprotokoluje adresa URL aplikace:
Přidání nastavení aplikace pro mezipaměť
Po publikování nové aplikace přidejte nové nastavení aplikace. Toto nastavení slouží k uložení informací o připojení k mezipaměti.
Přidání nastavení aplikace
Do panelu hledání nahoře na portálu Azure Portal zadejte název aplikace a vyhledejte novou aplikaci, kterou jste vytvořili.
Přidejte nové nastavení aplikace s názvem PřipojeníKMezipaměti, které aplikace použije pro připojení k mezipaměti. Použijte stejnou hodnotu, jakou jste pro
CacheConnection
nakonfigurovali v souboru TajnéKódyMezipaměti.config. Tato hodnota obsahuje název hostitele mezipaměti a přístupový klíč.
Spuštění aplikace v Azure
V prohlížeči přejděte na adresu URL aplikace. Tato adresa se zobrazuje ve výsledcích operace publikování v okně výstupu v sadě Visual Studio. Je také k dispozici na portálu Azure Portal na stránce přehledu aplikace, kterou jste vytvořili.
Na navigačním panelu vyberte Azure Cache for Redis Test , abyste otestovali přístup k mezipaměti, jak jste to udělali s místní verzí.
Vyčištění prostředků
Pokud budete pokračovat v používání tohoto rychlého startu, můžete zachovat prostředky, které jste vytvořili, a znovu je použít.
V opačném případě, pokud jste už s ukázkovou aplikací v tomto rychlém startu skončili, můžete prostředky Azure vytvořené v tomto rychlém startu odstranit, abyste se vyhnuli poplatkům.
Důležité
Odstranění skupiny prostředků je nevratné. Při odstranění skupiny prostředků se všechny prostředky, které obsahuje, trvale odstraní. Ujistěte se, že nechtěně neodstraníte nesprávnou skupinu prostředků nebo prostředky. Pokud jste vytvořili prostředky pro hostování této ukázky v existující skupině prostředků obsahující prostředky, které chcete zachovat, můžete všechny prostředky odstranit jednotlivě nalevo místo odstranění skupiny prostředků.
Odstranění skupiny prostředků
Přihlaste se k portálu Azure Portal a potom vyberte Skupiny prostředků.
Do pole Filtrovat podle názvu zadejte název vaší skupiny prostředků. V pokynech v tomto článku se používala skupina prostředků TestResources. U skupiny prostředků ve výsledcích hledání vyberte ... a pak vyberte Odstranit skupinu prostředků.
Zobrazí se výzva k potvrzení odstranění skupiny prostředků. Potvrďte odstranění zadáním názvu vaší skupiny prostředků a vyberte Odstranit.
Po chvíli se skupina prostředků včetně všech prostředků, které obsahuje, odstraní.