Konfigurace rolí Azure Cloud Services (rozšířená podpora) pomocí sady Visual Studio

Poznámka

Tento článek se týká Azure Azure Cloud Services (rozšířená podpora). Cloud Services (classic) bude ukončeno k 31. srpnu 2024. Další informace najdete v tématu Model nasazení cloudových služeb (Classic), který 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) může mít jednu nebo více pracovních nebo webových rolí. Pro každou roli musíte definovat, jak je tato role nastavená, a také nakonfigurovat, jak se tato role spouští.

Informace o cloudové službě jsou uložené v následujících souborech:

• ServiceDefinition.csdef – Definiční soubor služby definuje nastavení doby běhu pro cloudovou službu, včetně požadovaných rolí, koncových bodů a velikosti virtuálního počítače. Žádná data uložená v ServiceDefinition.csdef se nedají změnit, když je vaše role spuštěná.
• ServiceConfiguration.cscfg – Konfigurační soubor služby konfiguruje, kolik instancí role se spouští, a hodnoty nastavení definovaných pro roli. Data uložená v ServiceConfiguration.cscfg je možné změnit, když je vaše role spuštěná.

Pokud chcete uložit různé hodnoty pro nastavení, která řídí, jak se role spouští, můžete definovat více konfigurací služby. Pro každé prostředí nasazení můžete použít jinou konfiguraci služby. Můžete například nastavit připojovací řetězec účtu úložiště tak, aby používal místní emulátor služby Azure Storage v konfiguraci místní služby a vytvořili jinou konfiguraci služby pro použití služby Azure Storage v cloudu.

Při vytváření projektu Azure Cloud Services (rozšířená podpora) v sadě Visual Studio se automaticky vytvoří dvě konfigurace služeb a přidají se do projektu Azure:

• ServiceConfiguration.Cloud.cscfg
• ServiceConfiguration.Local.cscfg

Požadavky

• Visual Studio (viz [Soubory ke stažení sady Visual Studio] (https://visualstudio.microsoft.com/downloads/?cid=learn-onpage-download-cta)) s nainstalovanou úlohou vývoje pro Azure a nainstalovanou sadou funkcí jednotlivých komponent šablony projektů a položek rozhraní .NET Framework. Viz Úpravasady Visual Studio .
• Účet Azure. Pokud nemáte účet Azure, aktivujte si výhody Azure pro předplatitele sady Visual Studio nebo se zaregistrujte na bezplatnou zkušební verzi.

Konfigurace projektu Azure Cloud Services (rozšířená podpora)

Projekt Azure Cloud Services (rozšířená podpora) můžete nakonfigurovat z Průzkumníka řešení v sadě Visual Studio, jak je znázorněno v následujících krocích:

1. Vytvořte nebo otevřete projekt Azure Cloud Services (rozšířená podpora) v sadě Visual Studio.

2. V Průzkumníka řešeníklikněte pravým tlačítkem na projekt a v místní nabídce vyberte Vlastnosti.

   Průzkumník řešení místní nabídka projektu

3. Na stránce vlastností projektu vyberte kartu Vývoj.

   

4. V seznamu Konfigurace služby vyberte název konfigurace služby, kterou chcete upravit.

   

Změna počtu instancí rolí

Pokud chcete zvýšit výkon cloudové služby, můžete změnit počet instancí spuštěné role na základě počtu uživatelů nebo očekávaného zatížení určité role. Pro každou instanci role se vytvoří samostatný virtuální počítač, když cloudová služba běží v Azure. To má vliv na fakturaci nasazení této cloudové služby. Další informace o fakturaci najdete v tématu Vysvětlení informací na faktuře za Microsoft Azure.

1. Vytvořte nebo otevřete projekt Azure Cloud Services (rozšířená podpora) v sadě Visual Studio.

2. V Průzkumníku řešenírozbalte uzel projektu. V uzlu Role klikněte pravým tlačítkem myši na roli, kterou chcete aktualizovat, a v místní nabídce vyberte Vlastnosti.

   místní nabídka

3. Vyberte kartu Konfigurace.

   

4. V seznamu Konfigurace služby vyberte konfiguraci služby, kterou chcete aktualizovat. (Pokud chcete provést změny všech konfigurací služby pro tuto roli, vyberte Všechny konfigurace.)

   Důležitý

   Pokud zvolíte konkrétní konfiguraci služby, některé vlastnosti jsou zakázané, protože je možné je nastavit pouze pro všechny konfigurace. Chcete-li upravit tyto vlastnosti, je nutné vybrat Všechny konfigurace.

   seznam konfigurace služby

5. Do textového pole Počet instancí zadejte počet instancí, které chcete pro tuto roli spustit. Každá instance běží na samostatném virtuálním počítači při publikování cloudové služby do Azure.

   

6. Na panelu nástrojů sady Visual Studio vyberte Uložit.

Správa připojovacích řetězců pro účty úložiště

Můžete přidat, odebrat nebo upravit připojovací řetězce pro konfigurace služby. Můžete také chtít nakonfigurovat konfiguraci cloudové služby, která používá účet úložiště v Azure.

Varování

Když zadáte informace o klíči účtu služby Azure Storage pro připojovací řetězec účtu úložiště, uloží se tyto informace místně v konfiguračním souboru služby. Tyto informace se ale v současné době neukládají jako šifrovaný text.

Když pro každou konfiguraci služby použijete jinou hodnotu, nemusíte při publikování cloudové služby do Azure používat jiné připojovací řetězce ani upravovat kód. Stejný název můžete použít pro připojovací řetězec v kódu a hodnota se liší podle konfigurace služby, kterou vyberete při sestavování cloudové služby nebo při publikování.

1. Vytvořte nebo otevřete projekt Azure Cloud Services (rozšířená podpora) v sadě Visual Studio.

2. V Průzkumníku řešenírozbalte uzel projektu. V uzlu Role klikněte pravým tlačítkem na roli, kterou chcete aktualizovat, a v místní nabídce vyberte Vlastnosti.

   místní nabídka v Průzkumníku řešení Azure

3. Vyberte kartu Nastavení.

   

4. V seznamu Konfigurace služby vyberte konfiguraci služby, kterou chcete aktualizovat.

   

5. Chcete-li přidat připojovací řetězec, vyberte Přidat nastavení.

   

6. Po přidání nového nastavení do seznamu aktualizujte řádek v seznamu potřebnými informacemi.

   

   • Název – zadejte název, který chcete použít pro připojovací řetězec.
   • Typ – v rozevíracím seznamu vyberte připojovacího řetězce.
   • hodnota – připojovací řetězec můžete zadat buď přímo do buňky Hodnota, nebo můžete vybrat tři tečky (...) pro práci v dialogovém okně Vytvořit připojovací řetězec úložiště.

7. V dialogovém okně Vytvořit připojovací řetězec úložiště vyberte možnost Připojit pomocí. Pak postupujte podle pokynů pro možnost, kterou vyberete:

   • emulátoru služby Microsoft Azure Storage – Pokud vyberete tuto možnost, zbývající nastavení v dialogovém okně jsou zakázaná, protože platí jenom pro Azure. Vyberte OK.
   • vaše předplatné – Pokud vyberete tuto možnost, použijte rozevírací seznam k výběru a přihlášení k účtu Microsoft nebo přidání účtu Microsoft. Vyberte předplatné Azure a účet úložiště. Vyberte OK.
   • Ručně zadané přihlašovací údaje – zadejte název účtu úložiště a primární nebo druhý klíč. Vyberte možnost pro připojení (Pro většinu scénářů se doporučuje HTTPS.) Vyberte OK.

8. Chcete-li odstranit připojovací řetězec, vyberte připojovací řetězec a pak vyberte Odebrat nastavení.

9. Na panelu nástrojů sady Visual Studio vyberte Uložit.

Programově přistupujte k připojovacímu řetězci

Následující kroky ukazují, jak programově přistupovat k připojovacímu řetězci pomocí jazyka C#.

1. Do souboru jazyka C# přidejte následující direktivy using, kde budete toto nastavení používat:

   using Microsoft.WindowsAzure;
   using Microsoft.WindowsAzure.Storage;
   using Microsoft.WindowsAzure.ServiceRuntime;
   

2. Následující kód ukazuje příklad přístupu k připojovacímu řetězci. Nahraďte zástupný symbol <ConnectionStringName> odpovídající hodnotou.

   // Setup the connection to Azure Storage
   var storageAccount = CloudStorageAccount.Parse(RoleEnvironment.GetConfigurationSettingValue("<ConnectionStringName>"));
   

Přidání vlastních nastavení pro použití v projektu Azure Cloud Services (rozšířená podpora)

Vlastní nastavení v konfiguračním souboru služby umožňují přidat název a hodnotu řetězce pro konkrétní konfiguraci služby. Toto nastavení můžete použít ke konfiguraci funkce v cloudové službě tak, že si přečtete hodnotu nastavení a použijete ji k řízení logiky v kódu. Tyto hodnoty konfigurace služby můžete změnit, aniž byste museli znovu sestavit balíček služby nebo když je cloudová služba spuštěná. Váš kód může zkontrolovat oznámení o tom, kdy se nastavení změní. Další informace naleznete v tématu RoleEnvironment.Changing Event.

Můžete přidat, odebrat nebo upravit vlastní nastavení pro konfigurace služby. U těchto řetězců můžete chtít různé hodnoty pro různé konfigurace služeb.

Když pro každou konfiguraci služby použijete jinou hodnotu, nemusíte při publikování cloudové služby do Azure používat různé řetězce ani upravovat kód. Stejný název můžete použít pro řetězec v kódu a hodnota se liší podle konfigurace služby, kterou vyberete při sestavování cloudové služby nebo při jejím publikování.

1. Vytvořte nebo otevřete projekt Azure Cloud Services (rozšířená podpora) v sadě Visual Studio.

2. V Průzkumníku řešenírozbalte uzel projektu. V uzlu Role klikněte pravým tlačítkem na roli, kterou chcete aktualizovat, a v místní nabídce vyberte Vlastnosti.

   místní nabídka kontextového menu role Azure v Průzkumníku řešení

3. Vyberte kartu Nastavení.

   

4. V seznamu Konfigurace služby vyberte konfiguraci služby, kterou chcete aktualizovat.

   seznam konfigurace služby

5. Pokud chcete přidat vlastní nastavení, vyberte Přidat nastavení.

   

6. Po přidání nového nastavení do seznamu aktualizujte řádek v seznamu potřebnými informacemi.

   

   • Název – zadejte název nastavení.
   • Typ – v rozevíracím seznamu vyberte řetězec.
   • Hodnota – zadejte hodnotu nastavení. Hodnotu můžete zadat přímo do buňky Hodnota, nebo můžete vybrat symbol tří teček (...) pro zadání hodnoty v dialogovém okně Upravit řetězec.

7. Pokud chcete odstranit vlastní nastavení, vyberte nastavení a pak vyberte Odebrat nastavení.

8. Na panelu nástrojů sady Visual Studio vyberte Uložit.

Programový přístup k hodnotě vlastního nastavení

Následující kroky ukazují, jak programově přistupovat k vlastnímu nastavení pomocí jazyka C#.

1. Do souboru jazyka C# přidejte následující direktivy using, kde budete toto nastavení používat:

   using Microsoft.WindowsAzure;
   using Microsoft.WindowsAzure.Storage;
   using Microsoft.WindowsAzure.ServiceRuntime;
   

2. Následující kód ukazuje příklad přístupu k vlastnímu nastavení. Nahraďte zástupný symbol <SettingName> odpovídající hodnotou.

   var settingValue = RoleEnvironment.GetConfigurationSettingValue("<SettingName>");
   

Správa místního úložiště pro každou instanci role

Pro každou instanci role můžete přidat místní úložiště systému souborů. Data uložená v tomto úložišti nejsou přístupná jinými instancemi role, pro kterou jsou data uložena, nebo jinými rolemi.

1. Vytvořte nebo otevřete projekt Azure Cloud Services (rozšířená podpora) v sadě Visual Studio.

2. V Průzkumníku řešenírozviňte uzel projektu. V uzlu Role klikněte pravým tlačítkem na roli, kterou chcete aktualizovat, a v místní nabídce vyberte Vlastnosti.

   místní nabídka Azure Průzkumníka řešení

3. Vyberte kartu místní úložiště.

   

4. V seznamu Konfigurace služby se ujistěte, že je vybraná možnost Všechny konfigurace, protože nastavení místního úložiště platí pro všechny konfigurace služby. Všechny ostatní hodnoty mají za následek zakázání všech vstupních polí na stránce.

   seznam konfigurace služby

5. Pokud chcete přidat položku místního úložiště, vyberte Přidat místní úložiště.

   místního úložiště

6. Po přidání nové položky místního úložiště do seznamu aktualizujte řádek v seznamu potřebnými informacemi.

   

   • Název – zadejte název, který chcete použít pro nové místní úložiště.
   • velikost (MB) – zadejte velikost v MB, kterou potřebujete pro nové místní úložiště.
   • Vyčistit při recyklaci role – Vyberte tuto možnost pro odebrání dat v novém místním úložišti, když je virtuální počítač pro tuto roli recyklován.

7. Pokud chcete odstranit položku místního úložiště, vyberte ji a pak vyberte Odebrat místní úložiště.

8. Na panelu nástrojů sady Visual Studio vyberte Uložit.

Přístup k místnímu úložišti prostřednictvím kódu programu

Tato část ukazuje, jak programově přistupovat k místnímu úložišti pomocí jazyka C# napsáním testovacího textového souboru MyLocalStorageTest.txt.

Zápis textového souboru do místního úložiště

Následující kód ukazuje příklad zápisu textového souboru do místního úložiště. Nahraďte zástupný symbol <LocalStorageName> odpovídající hodnotou.

// Retrieve an object that points to the local storage resource
LocalResource localResource = RoleEnvironment.GetLocalResource("<LocalStorageName>");

//Define the file name and path
string[] paths = { localResource.RootPath, "MyLocalStorageTest.txt" };
String filePath = Path.Combine(paths);

using (FileStream writeStream = File.Create(filePath))
{
    Byte[] textToWrite = new UTF8Encoding(true).GetBytes("Testing Web role storage");
    writeStream.Write(textToWrite, 0, textToWrite.Length);
}

Vyhledání souboru zapsaného do místního úložiště

Pokud chcete zobrazit soubor vytvořený kódem v předchozí části, postupujte takto:

1. V oznamovací oblasti Windows klikněte pravým tlačítkem myši na ikonu Azure a v místní nabídce vyberte Zobrazit uživatelské rozhraní emulátoru výpočetních prostředků.

   

2. Vyberte webovou roli.

   

3. V nabídce Microsoft Azure Compute Emulator vyberte Nástroje>Otevřít místní úložiště.

   

4. Když se otevře okno Průzkumníka Windows, zadejte do textového pole Hledání „MyLocalStorageTest.txt“ a stisknutím klávesy Enter spusťte hledání.

Související obsah

Další informace o projektech Azure v sadě Visual Studio najdete v tématu Konfigurace projektu Azure. Další informace o schématu cloudové služby najdete v referenčníschématu .