Konfigurace projektu Azure v sadě Visual Studio pro použití více konfigurací služeb

Poznámka

Tento článek se týká Azure Azure Cloud Services (rozšířená podpora). Služba Cloud Services (classic) bude vyřazena k 31. srpnu 2024. Další informace najdete v tématu Model nasazení cloudových služeb (Classic) bude ukončen k 31. srpnu 2024. Pro nový vývoj doporučujeme použít novější typ služby navržený pro váš konkrétní účel, například Azure App Service, Azure Functionsnebo Azure Container Apps. Nejnovější seznam dostupných služeb najdete v tématu Adresář produktů Azure.

Projekt Azure Cloud Services (rozšířená podpora) v sadě Visual Studio obsahuje tři konfigurační soubory: ServiceDefinition.csdef, ServiceConfiguration.Local.cscfga ServiceConfiguration.Cloud.cscfg:

• ServiceDefinition.csdef se nasadí do Azure, aby popsal požadavky cloudové služby a jejích rolí a poskytl nastavení, která se vztahují na všechny instance. Nastavení lze během běhu číst pomocí rozhraní API Azure Service Hosting Runtime. Tento soubor je možné aktualizovat v Azure jenom v případě, že je cloudová služba zastavená.
• ServiceConfiguration.Local.cscfg a ServiceConfiguration.Cloud.cscfg zadejte hodnoty pro nastavení v definičním souboru a zadejte počet instancí, které se mají spustit pro každou roli. Místní soubor obsahuje hodnoty použité v místním ladění; Soubor "Cloud" se nasadí do Azure jako ServiceConfiguration.cscfg a poskytne nastavení pro serverové prostředí. Tento soubor je možné aktualizovat, když je cloudová služba spuštěná v Azure.

Nastavení konfigurace se spravuje a upravuje ve Visual Studio pomocí stránek vlastností příslušné role (klikněte pravým tlačítkem myši na roli a vyberte Vlastnostinebo poklikejte na roli). Změny mohou být vymezeny podle toho, která konfigurace je zvolena v rozevíracím seznamu Konfigurace služby. Vlastnosti pro webové role a pracovní role jsou podobné, kromě případů popsaných v následujících částech.

Informace o podkladových schématech pro definiční soubory služby a konfigurační soubory služby najdete v článcích schématu XML csdef a schématu XML cscfg. Další informace o konfiguraci služby najdete v části Jak nakonfigurovat cloudové služby.

Stránka Konfigurace

Konfigurace služby

Vybere, na který ServiceConfiguration.*.cscfg soubor mají vliv změny. Ve výchozím nastavení existují místní a cloudové varianty a můžete použít příkaz Spravovat... ke kopírování, přejmenování a odebírání konfiguračních souborů. Tyto soubory se přidají do projektu cloudové služby a zobrazí se v průzkumníku řešení . Přejmenování nebo odebrání konfigurací je však možné provést pouze z tohoto ovládacího prvku.

Instance

Nastavte vlastnost Instance count na počet instancí, které má služba pro tuto roli spustit.

Akce po spuštění (pouze webová role)

Nastavte tuto vlastnost, aby Visual Studio spustilo webový prohlížeč pro koncové body HTTP nebo HTTPS, nebo obojí, při spuštění ladění.

Možnost koncového bodu HTTPS je dostupná jenom v případě, že jste už pro svou roli definovali koncový bod HTTPS. Koncový bod HTTPS můžete definovat na stránce vlastností Koncové body.

Pokud jste už přidali koncový bod HTTPS, je ve výchozím nastavení povolená možnost koncového bodu HTTPS a Visual Studio spustí prohlížeč pro tento koncový bod při spuštění ladění, kromě prohlížeče pro koncový bod HTTP za předpokladu, že jsou povoleny obě možnosti spuštění.

Stránka Nastavení

Na stránce Nastavení můžete do konfigurace přidávat položky jako páry název-hodnota. Kód spuštěný v roli může číst hodnoty nastavení konfigurace za běhu pomocí tříd poskytovaných azure Managed Library, konkrétně GetConfigurationSettingValue metoda.

Konfigurace připojovacího řetězce pro účet úložiště

Připojovací řetězec je nastavení, které poskytuje informace o připojení a ověřování pro emulátor úložiště nebo pro účet Azure Storage. Pokaždé, když kód v roli přistupuje ke službě Azure Storage (objekty blob, fronty nebo tabulky), potřebuje připojovací řetězec.

Poznámka

Připojovací řetězec pro účet služby Azure Storage musí používat definovaný formát (viz Konfigurace připojovacích řetězců služby Azure Storage).

Připojovací řetězec můžete nastavit tak, aby podle potřeby používal místní úložiště. Poté, při nasazování aplikace do cloudové služby, jej nastavte na účet Azure Storage. Selhání při správném nastavení připojovacího řetězce může způsobit, že se vaše role nespustí nebo bude cyklovat mezi stavy inicializace, obsazení a zastavení.

Pokud chcete vytvořit připojovací řetězec, vyberte Přidat nastavení a nastavte Typ na Připojovací řetězec.

U nových nebo existujících připojovacích řetězců vyberte ...* napravo od pole Hodnota a otevřete dialogové okno Vytvořit připojovací řetězec úložiště:

1. V části Připojit pomocízvolte možnost Vaše předplatné a vyberte účet úložiště z předplatného. Visual Studio pak z .publishsettings souboru automaticky získá přihlašovací údaje k účtu úložiště.
2. Výběr ručně zadaných přihlašovacích údajů umožňuje zadat název účtu a klíč přímo pomocí informací z webu Azure Portal. Zkopírování klíče účtu:
   1. Přejděte k účtu úložiště na portálu Azure a vyberte Spravovat klíče.
   2. Pokud chcete zkopírovat klíč účtu, přejděte k účtu úložiště na webu Azure Portal, vyberte Nastavení > Přístupové klíčea pak pomocí tlačítka pro kopírování zkopírujte primární přístupový klíč do schránky.
3. Vyberte jednu z možností připojení. Zadejte vlastní koncové body vás požádá o zadání konkrétních adres URL pro objekty blob, tabulky a fronty. Vlastní koncové body umožňují používat vlastních domén a řídit přístup přesněji. Viz Konfigurace připojovacích řetězců služby Azure Storage.
4. Vyberte OK, a potom Soubor > Uložit, abyste aktualizovali konfiguraci novým připojovacím řetězcem.

Znovu, když publikujete aplikaci do Azure, zvolte konfiguraci služby, která obsahuje účet Azure Storage pro připojovací řetězec. Po publikování aplikace ověřte, že aplikace funguje podle očekávání ve službách Azure Storage.

Další informace o tom, jak aktualizovat konfigurace služby, naleznete v části Správa připojovacích řetězců pro účty úložiště.

Stránka koncové body

Webová role má obvykle jeden koncový bod HTTP na portu 80. Pracovní role může mít libovolný počet koncových bodů HTTP, HTTPS nebo TCP. Koncové body můžou být vstupní koncové body, které jsou dostupné externím klientům nebo interním koncovým bodům, které jsou k dispozici pro jiné role spuštěné ve službě.

• Pokud chcete externím klientům a webovým prohlížečům zpřístupnit koncový bod HTTP, změňte typ koncového bodu na vstup a zadejte název a číslo veřejného portu.
• Pokud chcete externím klientům a webovým prohlížečům zpřístupnit koncový bod HTTPS, změňte typ koncového bodu na vstupnía zadejte název, číslo veřejného portu a název certifikátu pro správu. Před zadáním certifikátu pro správu musíte také definovat certifikát na stránce vlastností Certifikáty.
• Pokud chcete zpřístupnit koncový bod pro interní přístup jinými rolemi v cloudové službě, změňte typ koncového bodu na interní a zadejte název a možné privátní porty pro tento koncový bod.

Stránka místního úložiště

Můžete použít stránku vlastností Místní úložiště k rezervaci jednoho nebo více místních prostředků pro roli. Místní úložný prostředek je vyhrazený adresář v souborovém systému virtuálního počítače Azure, kde běží instance role.

Stránka Certifikáty

Stránka vlastností Certifikáty přidává informace o certifikátech do konfigurace služby. Mějte na paměti, že vaše certifikáty nejsou zabalené do vaší služby; Certifikáty musíte nahrát samostatně do Azure prostřednictvím webu Azure Portal.

Přidání certifikátu sem přidá informace o vašich certifikátech do konfigurace služby. Certifikáty nejsou zabalené se službou; Certifikáty musíte nahrát samostatně prostřednictvím webu Azure Portal.

Pokud chcete přidružit certifikát k vaší roli, zadejte název certifikátu. Tento název použijete pro označení certifikátu při konfiguraci koncového bodu HTTPS na stránce Koncové body. Dále určete, zda je úložiště certifikátů ve Místním Počítači nebo ve Úložišti Aktuálního Uživatele a jeho název. Nakonec zadejte kryptografický otisk certifikátu. Pokud je certifikát v úložišti Aktuální uživatel\Osobní (Můj), můžete kryptografický otisk certifikátu zadat výběrem certifikátu z vyplněného seznamu. Pokud se nachází v jiném umístění, zadejte hodnotu kryptografického otisku ručně.

Když přidáte certifikát z úložiště certifikátů, všechny zprostředkující certifikáty se automaticky přidají do nastavení konfigurace za vás. Kromě toho se tyto zprostředkující certifikáty musí nahrát do Azure, aby správně nakonfigurovali službu pro SSL.

Všechny certifikáty pro správu, které přidružíte ke službě, se vztahují na vaši službu pouze v případě, že je spuštěná v cloudu. Když je vaše služba spuštěná v místním vývojovém prostředí, používá standardní certifikát spravovaný emulátorem výpočetních prostředků.