Konfigurera ditt Azure-projekt i Visual Studio för att använda flera tjänstkonfigurationer

Anmärkning

Den här artikeln gäller för Azure Azure Cloud Services (utökad support). Cloud Services (klassisk) har dragits tillbaka från och med den 31 augusti 2024. Mer information finns i Distributionsmodellen för molntjänster (klassisk) upphör den 31 augusti 2024. För ny utveckling rekommenderar vi att du använder en nyare tjänsttyp som utformats för ditt specifika ändamål, till exempel Azure App Service, Azure Functionseller Azure Container Apps. Den senaste listan över tillgängliga tjänster finns i Directory för Azure-produkter.

Ett Azure Cloud Services-projekt (utökat stöd) i Visual Studio innehåller tre konfigurationsfiler: ServiceDefinition.csdef, ServiceConfiguration.Local.cscfgoch ServiceConfiguration.Cloud.cscfg:

• ServiceDefinition.csdef distribueras till Azure för att beskriva kraven för molntjänsten och dess roller och för att tillhandahålla inställningar som gäller för alla instanser. Inställningar kan läsas vid körningstid genom Azure Service Hosting Runtime-API:et. Den här filen kan bara uppdateras i Azure när molntjänsten stoppas.
• ServiceConfiguration.Local.cscfg och ServiceConfiguration.Cloud.cscfg ange värden för inställningar i definitionsfilen och ange antalet instanser som ska köras för varje roll. Filen "Lokal" innehåller värden som används i lokal felsökning. "Cloud"-filen distribueras till Azure som ServiceConfiguration.cscfg och innehåller inställningar för servermiljön. Den här filen kan uppdateras medan molntjänsten körs i Azure.

Konfigurationsinställningarna hanteras och ändras i Visual Studio med egenskapssidor för den aktuella rollen (högerklicka på rollen och välj Egenskapereller dubbelklicka på rollen). Ändringar kan begränsas till den konfiguration som väljs i listrutan Service Configuration. Egenskaperna för webb- och arbetsroller är liknande, förutom de som beskrivs i följande avsnitt.

Information om underliggande scheman för tjänstdefinitions- och tjänstkonfigurationsfilerna finns i artiklarna .csdef XML-schema och .cscfg XML-schema artiklar. Mer information om tjänstkonfiguration finns i Konfigurera Cloud Services.

Konfigurationssida

Tjänstkonfiguration

Väljer vilken ServiceConfiguration.*.cscfg fil som påverkas av ändringar. Som standard finns det lokala varianter och molnvarianter, och du kan använda kommandot Hantera... för att kopiera, byta namn på och ta bort konfigurationsfiler. Dessa filer läggs till i molntjänstprojektet och visas i Solution Explorer. Det går dock bara att byta namn på eller ta bort konfigurationer från den här kontrollen.

Instanser

Ange egenskapen Instance count till antalet instanser som tjänsten ska köra för den här rollen.

Startåtgärd (endast webbroll)

Ange den här egenskapen för att ange att Visual Studio ska starta en webbläsare för antingen HTTP-slutpunkterna eller HTTPS-slutpunkterna, eller båda när du börjar felsöka.

Alternativet HTTPS-slutpunkt är endast tillgängligt om du redan har definierat en HTTPS-slutpunkt för din roll. Du kan definiera en HTTPS-slutpunkt på egenskapssidan Slutpunkter.

Om du redan har lagt till en HTTPS-slutpunkt är alternativet HTTPS-slutpunkt aktiverat som standard och Visual Studio startar en webbläsare för den här slutpunkten när du börjar felsöka, förutom en webbläsare för HTTP-slutpunkten, förutsatt att båda startalternativen är aktiverade.

Inställningssidan

På sidan Inställningar kan du lägga till inställningar i en konfiguration som namn/värde-par. Kod som körs i rollen kan läsa värdena för dina konfigurationsinställningar vid körning med hjälp av klasser som tillhandahålls av Azure Managed Library, mer specifikt metoden GetConfigurationSettingValue.

Konfigurera en anslutningssträng för ett lagringskonto

En anslutningssträng är en inställning som tillhandahåller anslutningsinformation och autentiseringsinformation för lagringsemulatorn eller för ett Azure Storage-konto. När kod i en roll får åtkomst till Azure Storage (blobbar, köer eller tabeller) behöver den en anslutningssträng.

Not

En anslutningssträng för Azure Storage-kontot måste använda ett definierat format (se Konfigurera Azure Storage-anslutningssträngar).

Du kan ange att anslutningssträngen ska använda lokal lagring efter behov och sedan ange till ett Azure Storage-konto när du distribuerar programmet till molntjänsten. Om du inte ställer in anslutningssträngen korrekt kan det leda till att din roll inte startar eller att den går igenom initierings-, upptagen- och stopptillstånden.

Om du vill skapa en anslutningssträng väljer du Lägg till inställning och anger Typ till "Anslutningssträng".

För nya eller befintliga anslutningssträngar väljer du ...* till höger om fältet Value för att öppna dialogrutan Skapa lagringsanslutningssträng:

1. Under Anslut med hjälp avväljer du alternativet för Din prenumeration för att välja ett lagringskonto från en prenumeration. Visual Studio hämtar sedan autentiseringsuppgifterna för lagringskontot automatiskt från .publishsettings-filen.
2. Om du väljer Manuellt angivna autentiseringsuppgifter kan du ange kontonamnet och nyckeln direkt med hjälp av information från Azure-portalen. Så här kopierar du kontonyckeln:
   1. Gå till lagringskontot på Azure-portalen och välj Hantera nycklar.
   2. Om du vill kopiera kontonyckeln går du till lagringskontot på Azure-portalen, väljer Inställningar > Åtkomstnycklaroch använder sedan kopieringsknappen för att kopiera den primära åtkomstnyckeln till Urklipp.
3. Välj något av anslutningsalternativen. Ange anpassade slutpunkter ber dig ange specifika URL:er för blobar, tabeller och köer. Med anpassade slutpunkter kan du använda anpassade domäner och styra åtkomsten mer exakt. Se Konfigurera Anslutningssträngar för Azure Storage.
4. Välj OKoch sedan Fil > Spara för att uppdatera konfigurationen med den nya anslutningssträngen.

När du publicerar ditt program till Azure väljer du den tjänstkonfiguration som innehåller Azure Storage-kontot för anslutningssträngen. När programmet har publicerats kontrollerar du att programmet fungerar som förväntat mot Azure Storage-tjänsterna.

Mer information om hur du uppdaterar tjänstkonfigurationer finns i avsnittet Hantera anslutningssträngar för lagringskonton.

Sidan Slutpunkter

En webbroll har vanligtvis en enda HTTP-slutpunkt på port 80. En arbetsroll kan å andra sidan ha valfritt antal HTTP-, HTTPS- eller TCP-slutpunkter. Slutpunkter kan vara indataslutpunkter, som är tillgängliga för externa klienter eller interna slutpunkter, som är tillgängliga för andra roller som körs i tjänsten.

• Om du vill göra en HTTP-slutpunkt tillgänglig för externa klienter och webbläsare ändrar du slutpunktstypen till indata och anger ett namn och ett offentligt portnummer.
• Om du vill göra en HTTPS-slutpunkt tillgänglig för externa klienter och webbläsare ändrar du slutpunktstypen till indataoch anger ett namn, ett offentligt portnummer och ett hanteringscertifikatnamn. Du måste också definiera certifikatet på egenskapssidan certifikat innan du kan ange ett hanteringscertifikat.
• Om du vill göra en slutpunkt tillgänglig för intern åtkomst av andra roller i molntjänsten ändrar du slutpunktstypen till intern och anger ett namn och möjliga privata portar för den här slutpunkten.

Lokal lagringssida

Du kan använda egenskapssidan för Lokal Lagring för att reservera en eller flera lokala lagringsresurser för en roll. En lokal lagringsresurs är en reserverad katalog i filsystemet på den virtuella Azure-dator där en instans av en roll körs.

Certifikatsidan

Egenskapssidan Certifikat lägger till information om dina certifikat i tjänstkonfigurationen. Observera att dina certifikat inte är paketerade med din tjänst. du måste ladda upp dina certifikat separat till Azure via Azure-portalen.

När du lägger till ett certifikat här läggs information om dina certifikat till i tjänstkonfigurationen. Certifikat paketeras inte med tjänsten. du måste ladda upp dina certifikat separat via Azure-portalen.

Om du vill associera ett certifikat med din roll anger du ett namn för certifikatet. Du använder det här namnet för att referera till certifikatet när du konfigurerar en HTTPS-slutpunkt på sidan slutpunkter. Ange sedan om certifikatarkivet är lokal dator eller aktuell användare och namnet på arkivet. Ange slutligen certifikatets tumavtryck. Om certifikatet finns i arkivet Aktuell användare\Personlig (Min) kan du ange certifikatets tumavtryck genom att välja certifikatet från en ifylld lista. Om den finns på någon annan plats anger du tumavtrycksvärdet för hand.

När du lägger till ett certifikat från certifikatarkivet läggs eventuella mellanliggande certifikat automatiskt till i konfigurationsinställningarna åt dig. Dessutom måste dessa mellanliggande certifikat laddas upp till Azure för att din tjänst för SSL ska konfigureras korrekt.

Alla hanteringscertifikat som du associerar med din tjänst gäller endast för din tjänst när den körs i molnet. När tjänsten körs i den lokala utvecklingsmiljön använder den ett standardcertifikat som hanteras av beräkningsemulatorn.