Azure Cloud Services-rollen (uitgebreide ondersteuning) configureren met Visual Studio

Notitie

Dit artikel is van toepassing op Azure Azure Cloud Services (uitgebreide ondersteuning). Cloud Services (klassiek) wordt vanaf 31 augustus 2024 buiten gebruik gesteld. Voor meer informatie, zie Cloudservices (klassiek) implementatiemodel, dat op 31 augustus 2024buiten gebruik wordt gesteld. Voor nieuwe ontwikkeling raden we u aan een nieuwer servicetype te gebruiken dat is ontworpen voor uw specifieke doel, zoals Azure App Service-, Azure Functionsof Azure Container Apps. Zie Directory van Azure-productenvoor de meest recente lijst met beschikbare services.

Een Azure Cloud Services-project (uitgebreide ondersteuning) kan een of meer werkrollen of webrollen hebben. Voor elke rol moet u definiëren hoe die rol wordt ingesteld en moet u ook configureren hoe die rol wordt uitgevoerd.

De informatie voor uw cloudservice wordt opgeslagen in de volgende bestanden:

• ServiceDefinition.csdef - Het servicedefinitiebestand definieert de runtime-instellingen voor uw cloudservice, inclusief welke rollen vereist zijn, eindpunten en grootte van virtuele machines. Geen van de gegevens die zijn opgeslagen in ServiceDefinition.csdef kunnen worden gewijzigd wanneer uw rol wordt uitgevoerd.
• ServiceConfiguration.cscfg - Het serviceconfiguratiebestand configureert hoeveel exemplaren van een rol worden uitgevoerd en de waarden van de instellingen die zijn gedefinieerd voor een rol. De gegevens die zijn opgeslagen in ServiceConfiguration.cscfg kunnen worden gewijzigd terwijl uw rol wordt uitgevoerd.

Als u verschillende waarden wilt opslaan voor de instellingen die bepalen hoe een rol wordt uitgevoerd, kunt u meerdere serviceconfiguraties definiëren. U kunt voor elke implementatieomgeving een andere serviceconfiguratie gebruiken. U kunt bijvoorbeeld de verbindingsreeks voor uw opslagaccount instellen voor het gebruik van de lokale Azure Storage Emulator in een lokale serviceconfiguratie en een andere serviceconfiguratie maken voor het gebruik van Azure Storage in de cloud.

Wanneer u een Azure Cloud Services-project (uitgebreide ondersteuning) in Visual Studio maakt, worden er automatisch twee serviceconfiguraties gemaakt en toegevoegd aan uw Azure-project:

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

Voorwaarden

• Visual Studio (zie [Visual Studio-downloads] (https://visualstudio.microsoft.com/downloads/?cid=learn-onpage-download-cta)) met de Azure-ontwikkelworkload geïnstalleerd en het afzonderlijke onderdeel .NET Framework-project- en itemsjablonen geïnstalleerd. Zie Visual Studio-wijzigen.
• Een Azure-account. Als u geen Azure-account hebt, activeert u uw Azure-voordelen voor Visual Studio-abonnees of meldt u zich aan voor een gratis proefversie.

Een Azure Cloud Services-project (uitgebreide ondersteuning) configureren

U kunt een Azure Cloud Services-project (uitgebreide ondersteuning) configureren vanuit Solution Explorer in Visual Studio, zoals wordt weergegeven in de volgende stappen:

1. Maak of open een Azure Cloud Services-project (uitgebreide ondersteuning) in Visual Studio.

2. Klik in Solution Explorer-met de rechtermuisknop op het project en selecteer in het contextmenu Eigenschappen.

   Contextmenu voor het project in Solution Explorer

3. Selecteer op de eigenschappenpagina van het project het tabblad Ontwikkeling.

   

4. Selecteer in de lijst Serviceconfiguratie de naam van de serviceconfiguratie die u wilt bewerken.

   

Het aantal rolinstanties wijzigen

Als u de prestaties van uw cloudservice wilt verbeteren, kunt u het aantal exemplaren wijzigen van een rol die wordt uitgevoerd, op basis van het aantal gebruikers of de verwachte belasting voor een bepaalde rol. Er wordt een afzonderlijke virtuele machine gemaakt voor elk exemplaar van een rol wanneer de cloudservice wordt uitgevoerd in Azure. Dit is van invloed op de facturering voor de implementatie van deze cloudservice. Zie Inzicht in uw factuur voor Microsoft Azurevoor meer informatie over facturering.

1. Maak of open een Azure Cloud Services-project (uitgebreide ondersteuning) in Visual Studio.

2. Vouw in Solution Explorerhet projectknooppunt uit. Klik onder het knooppunt Rollen met de rechtermuisknop op de rol die u wilt bijwerken en selecteer in het contextmenu Eigenschappen.

   contextmenuSolution Explorer Azure-rol

3. Selecteer het tabblad Configuratie.

   

4. Selecteer in de lijst Serviceconfiguratie de serviceconfiguratie die u wilt bijwerken. (Als u wijzigingen wilt aanbrengen in alle serviceconfiguraties voor deze rol, selecteert u Alle configuraties.)

   Belangrijk

   Als u een specifieke serviceconfiguratie kiest, worden sommige eigenschappen uitgeschakeld omdat ze alleen voor alle configuraties kunnen worden ingesteld. Als u deze eigenschappen wilt bewerken, moet u Alle configuratiesselecteren.

   

5. Voer in het tekstvak Aantal exemplaren het aantal exemplaren in dat u voor deze rol wilt starten. Elk exemplaar wordt uitgevoerd op een afzonderlijke virtuele machine wanneer u de cloudservice naar Azure publiceert.

   

6. Selecteer op de werkbalk van Visual Studio Opslaan.

Verbindingsreeksen voor opslagaccounts beheren

U kunt verbindingsreeksen toevoegen, verwijderen of wijzigen voor uw serviceconfiguraties. U kunt ook een cloudserviceconfiguratie configureren die gebruikmaakt van een opslagaccount in Azure.

Waarschuwing

Wanneer u de sleutelgegevens van het Azure Storage-account invoert voor een verbindingsreeks voor een opslagaccount, worden deze gegevens lokaal opgeslagen in het serviceconfiguratiebestand. Deze informatie wordt momenteel echter niet opgeslagen als versleutelde tekst.

Door een andere waarde te gebruiken voor elke serviceconfiguratie, hoeft u geen verschillende verbindingsreeksen in uw cloudservice te gebruiken of uw code te wijzigen wanneer u uw cloudservice publiceert naar Azure. U kunt dezelfde naam gebruiken voor de verbindingsreeks in uw code en de waarde verschilt, op basis van de serviceconfiguratie die u selecteert wanneer u uw cloudservice bouwt of wanneer u deze publiceert.

1. Maak of open een Azure Cloud Services-project (uitgebreide ondersteuning) in Visual Studio.

2. Vouw in Solution Explorerhet projectknooppunt uit. Klik onder het knooppunt Rollen met de rechtermuisknop op de rol die u wilt bijwerken en selecteer in het contextmenu Eigenschappen.

   contextmenuSolution Explorer Azure-rol

3. Selecteer het tabblad Instellingen.

   

4. Selecteer in de lijst Serviceconfiguratie de serviceconfiguratie die u wilt bijwerken.

   

5. Als u een verbindingsreeks wilt toevoegen, selecteert u Instelling toevoegen.

   

6. Nadat de nieuwe instelling aan de lijst is toegevoegd, werkt u de rij in de lijst bij met de benodigde informatie.

   

   • Name - Voer de naam in die u wilt gebruiken voor de verbindingsreeks.
   • Typ - Selecteer connectiestring uit de vervolgkeuzelijst.
   • waarde: u kunt de verbindingsreeks rechtstreeks invoeren in de cel waarde of het beletselteken (...) selecteren om in het dialoogvenster Opslagverbindingsreeks maken te werken.

7. Selecteer in het dialoogvenster Opslagverbindingsreeks maken een optie voor Verbinding maken met behulp van. Volg vervolgens de instructies voor de optie die u selecteert:

   • Microsoft Azure Storage Emulator: als u deze optie selecteert, worden de overige instellingen in het dialoogvenster uitgeschakeld omdat ze alleen van toepassing zijn op Azure. Selecteer OK-.
   • uw abonnement: als u deze optie selecteert, gebruikt u de vervolgkeuzelijst om een Microsoft-account te selecteren en aan te melden of een Microsoft-account toe te voegen. Selecteer een Azure-abonnement en opslagaccount. Selecteer OK-.
   • handmatig ingevoerde referenties : voer de naam van het opslagaccount in en de primaire of tweede sleutel. Selecteer een optie voor Connection (HTTPS wordt aanbevolen voor de meeste scenario's.) Selecteer OK-.

8. Als u een verbindingsreeks wilt verwijderen, selecteert u de verbindingsreeks en selecteert u vervolgens Instelling verwijderen.

9. Selecteer op de werkbalk van Visual Studio Opslaan.

Programmatisch toegang krijgen tot een verbindingsreeks

De volgende stappen laten zien hoe u programmatisch toegang kunt krijgen tot een verbindingsreeks met behulp van C#.

1. Voeg de volgende using-richtlijnen toe aan een C#-bestand waarin u de instelling gaat gebruiken:

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

2. De volgende code illustreert een voorbeeld van hoe u toegang krijgt tot een verbindingsreeks. Vervang de tijdelijke aanduiding <ConnectionStringName> door de juiste waarde.

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

Aangepaste instellingen toevoegen voor gebruik in uw Azure Cloud Services-project (uitgebreide ondersteuning)

Met aangepaste instellingen in het serviceconfiguratiebestand kunt u een naam en waarde toevoegen voor een tekenreeks voor een specifieke serviceconfiguratie. U kunt deze instelling gebruiken om een functie in uw cloudservice te configureren door de waarde van de instelling te lezen en deze waarde te gebruiken om de logica in uw code te beheren. U kunt deze serviceconfiguratiewaarden wijzigen zonder dat u uw servicepakket opnieuw hoeft op te bouwen of wanneer uw cloudservice wordt uitgevoerd. Uw code kan controleren op meldingen van wanneer een instelling wordt gewijzigd. Zie RoleEnvironment.Changing Eventvoor meer informatie.

U kunt aangepaste instellingen voor uw serviceconfiguraties toevoegen, verwijderen of wijzigen. Mogelijk wilt u verschillende waarden voor deze tekenreeksen voor verschillende serviceconfiguraties.

Door een andere waarde te gebruiken voor elke serviceconfiguratie, hoeft u geen verschillende tekenreeksen in uw cloudservice te gebruiken of uw code te wijzigen wanneer u uw cloudservice publiceert naar Azure. U kunt dezelfde naam gebruiken voor de tekenreeks in uw code en de waarde verschilt, op basis van de serviceconfiguratie die u selecteert wanneer u uw cloudservice bouwt of wanneer u deze publiceert.

1. Maak of open een Azure Cloud Services-project (uitgebreide ondersteuning) in Visual Studio.

2. Vouw in Solution Explorerhet projectknooppunt uit. Klik onder het knooppunt Rollen met de rechtermuisknop op de rol die u wilt bijwerken en selecteer in het contextmenu Eigenschappen.

   

3. Selecteer het tabblad Instellingen.

   

4. Selecteer in de lijst Serviceconfiguratie de serviceconfiguratie die u wilt bijwerken.

   

5. Als u een aangepaste instelling wilt toevoegen, selecteert u Instelling toevoegen.

   

6. Nadat de nieuwe instelling aan de lijst is toegevoegd, werkt u de rij in de lijst bij met de benodigde informatie.

   

   • Naam - Voer de naam van de instelling in.
   • Type - Selecteer tekenreeks uit de vervolgkeuzelijst.
   • waarde - Voer de waarde van de instelling in. U kunt de waarde rechtstreeks invoeren in de waarde cel of het beletselteken (...) selecteren om de waarde in te voeren in het dialoogvenster Tekenreeks bewerken.

7. Als u een aangepaste instelling wilt verwijderen, selecteert u de instelling en selecteert u vervolgens Instelling verwijderen.

8. Selecteer op de werkbalk van Visual Studio Opslaan.

Programmatisch toegang krijgen tot de waarde van een aangepaste instelling

De volgende stappen laten zien hoe u programmatisch toegang kunt krijgen tot een aangepaste instelling met behulp van C#.

1. Voeg het volgende toe aan een C#-document waarin je de instelling gaat gebruiken:

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

2. De volgende code illustreert een voorbeeld van hoe u toegang krijgt tot een aangepaste instelling. Vervang de tijdelijke aanduiding <SettingName> door de juiste waarde.

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

Lokale opslag beheren voor elke rolinstantie

U kunt lokale bestandssysteemopslag toevoegen voor elk exemplaar van een rol. De gegevens die in die opslag zijn opgeslagen, zijn niet toegankelijk voor andere exemplaren van de rol waarvoor de gegevens zijn opgeslagen, of door andere rollen.

1. Maak of open een Azure Cloud Services-project (uitgebreide ondersteuning) in Visual Studio.

2. Vouw in Solution Explorerhet projectknooppunt uit. Klik onder het knooppunt Rollen met de rechtermuisknop op de rol die u wilt bijwerken en selecteer in het contextmenu Eigenschappen.

   

3. Selecteer het tabblad Lokale opslag.

   

4. Zorg ervoor dat alle configuraties is geselecteerd in de serviceconfiguratielijst, aangezien de lokale opslaginstellingen van toepassing zijn op alle serviceconfiguraties. Elke andere waarde resulteert erin dat alle invoervelden op de pagina worden uitgeschakeld.

   

5. Als u een lokale opslagvermelding wilt toevoegen, selecteert u Lokale opslag toevoegen.

   

6. Zodra de nieuwe lokale opslagvermelding is toegevoegd aan de lijst, werkt u de rij in de lijst bij met de benodigde informatie.

   

   • Name - Voer de naam in die u wilt gebruiken voor de nieuwe lokale opslag.
   • grootte (MB) - Voer de grootte in MB in die u nodig hebt voor de nieuwe lokale opslag.
   • Opruimen bij rollenrecycling: selecteer deze optie om de gegevens in de nieuwe lokale opslag te verwijderen wanneer de virtuele machine van de rol wordt herstart.

7. Als u een lokale opslagvermelding wilt verwijderen, selecteert u de vermelding en selecteert u vervolgens Lokale opslag verwijderen.

8. Selecteer op de werkbalk van Visual Studio Opslaan.

Programmatisch toegang tot lokale opslag

In deze sectie ziet u hoe u programmatisch toegang kunt krijgen tot lokale opslag met behulp van C# door een testtekstbestand te schrijven MyLocalStorageTest.txt.

Een tekstbestand schrijven naar lokale opslag

De volgende code toont een voorbeeld van het schrijven van een tekstbestand naar lokale opslag. Vervang de tijdelijke aanduiding <LocalStorageName> door de juiste waarde.

// 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);
}

Een bestand zoeken dat naar de lokale opslag is geschreven

Voer de volgende stappen uit om het bestand weer te geven dat door de code in de vorige sectie is gemaakt:

1. Klik in het Systeemvak van Windows met de rechtermuisknop op het Azure-pictogram en selecteer in het contextmenu De gebruikersinterface van de rekenemulator weergeven.

   

2. Selecteer de webrol.

   

3. Selecteer in het menu Microsoft Azure Compute EmulatorTools>Lokale winkel openen.

   

4. Wanneer het venster Windows Verkenner wordt geopend, typt u 'MyLocalStorageTest.txt' in het tekstvak Zoeken en selecteert u Enter om de zoekopdracht te starten.

Verwante inhoud

Lees Een Azure-project configurerenvoor meer informatie over Azure-projecten in Visual Studio. Meer informatie over het cloudserviceschema vindt u in schemareferentie.