Konfigurowanie ról usług Azure Cloud Services (rozszerzona obsługa) za pomocą programu Visual Studio

Notatka

Ten artykuł dotyczy usługi Azure Azure Cloud Services (wsparcie dodatkowe). Usługi Cloud Services (wersja klasyczna) są wycofane z dnia 31 sierpnia 2024 r. Aby uzyskać więcej informacji, zobacz Model wdrażania usług w chmurze (klasyczny) zostanie wycofany 31 sierpnia 2024 r.. W przypadku nowego programowania zalecamy użycie nowszego typu usługi przeznaczonego do określonego celu, takiego jak Azure App Service, Azure Functionslub Azure Container Apps. Aby uzyskać najnowszą listę dostępnych usług, zobacz Directory of Azure products.

Projekt Azure Cloud Services (rozszerzone wsparcie) może mieć jedną lub więcej ról pracownika albo sieciowych. Dla każdej roli należy zdefiniować sposób konfigurowania tej roli, a także skonfigurować sposób działania tej roli.

Informacje dotyczące usługi w chmurze są przechowywane w następujących plikach:

• ServiceDefinition.csdef — plik definicji usługi definiuje ustawienia czasu wykonywania usługi w chmurze, w tym wymagane role, punkty końcowe i rozmiar maszyny wirtualnej. Żadne dane przechowywane w ServiceDefinition.csdef nie mogą być zmieniane po uruchomieniu roli.
• ServiceConfiguration.cscfg — plik konfiguracji usługi konfiguruje liczbę uruchomionych wystąpień roli oraz wartości ustawień zdefiniowanych dla roli. Dane przechowywane w ServiceConfiguration.cscfg mogą być zmieniane, gdy rola jest aktywna.

Aby przechowywać różne wartości ustawień, które kontrolują sposób uruchamiania roli, można zdefiniować wiele konfiguracji usługi. Dla każdego środowiska wdrażania można użyć innej konfiguracji usługi. Możesz na przykład ustawić parametry połączenia konta magazynu, aby użyć lokalnego emulatora usługi Azure Storage w konfiguracji usługi lokalnej i utworzyć inną konfigurację usługi do korzystania z usługi Azure Storage w chmurze.

Podczas tworzenia projektu usługi Azure Cloud Services (rozszerzonej pomocy technicznej) w programie Visual Studio dwie konfiguracje usługi są tworzone automatycznie i dodawane do projektu platformy Azure:

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

Warunki wstępne

• Program Visual Studio (zobacz [Pliki do pobrania programu Visual Studio] (https://visualstudio.microsoft.com/downloads/?cid=learn-onpage-download-cta)) z zainstalowanym obciążeniem programowania na platformie Azure azure oraz zainstalowanym szablon em poszczególnych składników .NET Framework i szablonami elementów. Zobacz Modyfikowanie programu Visual Studio.
• Konto platformy Azure. Jeśli nie masz konta Azure, aktywuj korzyści Azure dla subskrybentów Visual Studio lub zarejestruj się na bezpłatną wersję próbną.

Konfigurowanie projektu usługi Azure Cloud Services (wsparcie dodatkowe)

Projekt usługi Azure Cloud Services (wsparcie dodatkowe) można skonfigurować w Eksploratorze rozwiązań w programie Visual Studio, jak pokazano w poniższych krokach:

1. Utwórz lub otwórz projekt usług Azure Cloud Services (wsparcie dodatkowe) w programie Visual Studio.

2. W eksploratorze rozwiązań kliknij prawym przyciskiem myszy projekt, a następnie z menu kontekstowego wybierz pozycję Właściwości.

   menu kontekstowe projektu eksploratora rozwiązań

3. Na stronie właściwości projektu wybierz kartę Rozwój.

   strona właściwości projektu

4. Na liście Konfiguracja Usługi wybierz nazwę tej konfiguracji usługi, którą chcesz edytować.

   

Zmienianie liczby wystąpień ról

Aby zwiększyć wydajność usługi w chmurze, możesz zmienić liczbę uruchomionych wystąpień roli na podstawie liczby użytkowników lub oczekiwanego obciążenia dla określonej roli. Oddzielna maszyna wirtualna jest tworzona dla każdego wystąpienia roli, gdy usługa w chmurze działa na platformie Azure. Ma to wpływ na rozliczenia dotyczące wdrożenia tej usługi w chmurze. Aby uzyskać więcej informacji na temat rozliczeń, zobacz Omówienie rachunku za korzystanie z usługi Microsoft Azure.

1. Utwórz lub otwórz projekt Azure Cloud Services (extended support - rozszerzone wsparcie) w programie Visual Studio.

2. W eksploratorze rozwiązań rozwiń węzeł projektu. Pod węzłem Ról kliknij prawym przyciskiem myszy rolę, którą chcesz zaktualizować, a następnie z menu kontekstowego wybierz pozycję Właściwości.

   

3. Wybierz kartę Konfiguracja.

   karta konfiguracji

4. Na liście Konfiguracja usługi wybierz konfigurację usługi, którą chcesz zaktualizować. (Jeśli chcesz wprowadzić zmiany we wszystkich konfiguracjach usługi dla tej roli, wybierz pozycję Wszystkie konfiguracje.

   Ważny

   Jeśli wybierzesz określoną konfigurację usługi, niektóre właściwości są wyłączone, ponieważ można je ustawić tylko dla wszystkich konfiguracji. Aby edytować te właściwości, należy wybrać Wszystkie konfiguracje.

   

5. W polu tekstowym Liczba wystąpień wprowadź liczbę wystąpień, które chcesz uruchomić dla tej roli. Każde wystąpienie uruchamia się na oddzielnej maszynie wirtualnej w trakcie publikowania usługi chmurowej na platformie Azure.

   liczby wystąpień

6. Na pasku narzędzi programu Visual Studio wybierz pozycję Zapisz.

Zarządzanie ciągami połączeń dla kont przechowywania

Możesz dodawać, usuwać lub modyfikować parametry połączenia dla konfiguracji usługi. Możesz również skonfigurować usługę w chmurze, która używa konta magazynowego na platformie Azure.

Ostrzeżenie

Po wprowadzeniu informacji o kluczu konta usługi Azure Storage dla parametrów połączenia konta magazynu te informacje są przechowywane lokalnie w pliku konfiguracji usługi. Jednak te informacje nie są obecnie przechowywane jako zaszyfrowany tekst.

Używając innej wartości dla każdej konfiguracji usługi, nie musisz używać różnych parametrów połączenia w usłudze w chmurze ani modyfikować kodu podczas publikowania usługi w chmurze na platformie Azure. Możesz użyć tej samej nazwy dla parametrów połączenia w kodzie, a wartość jest inna, na podstawie konfiguracji usługi wybranej podczas kompilowania usługi w chmurze lub publikowania.

1. Utwórz lub otwórz projekt usług Azure Cloud Services (wsparcie dodatkowe) w programie Visual Studio.

2. W eksploratorze rozwiązań rozwiń węzeł projektu. Pod węzłem Role, kliknij prawym przyciskiem myszy rolę, którą chcesz zaktualizować, a następnie z menu kontekstowego wybierz pozycję Właściwości.

   

3. Wybierz kartę Ustawienia.

   karta Ustawienia

4. Na liście Konfiguracja usługi wybierz konfigurację usługi, którą chcesz zaktualizować.

   

5. Aby dodać łańcuch połączenia, wybierz pozycję Dodaj ustawienie.

   

6. Po dodaniu nowego ustawienia do listy zaktualizuj wiersz na liście przy użyciu niezbędnych informacji.

   

   • Nazwa — wprowadź nazwę, której chcesz użyć dla parametrów połączenia.
   • Typ — wybierz parametry połączenia z listy rozwijanej.
   • Wartość — możesz wprowadzić łańcuch połączenia bezpośrednio w komórce lub wybrać wielokropek (...) do pracy w oknie dialogowym Tworzenie łańcucha połączenia magazynu.

7. W oknie dialogowym Tworzenie parametrów połączenia magazynu wybierz opcję Connect przy użyciu. Następnie postępuj zgodnie z instrukcjami dotyczącymi wybranej opcji:

   • emulatora usługi Microsoft Azure Storage — w przypadku wybrania tej opcji pozostałe ustawienia w oknie dialogowym zostaną wyłączone, ponieważ mają zastosowanie tylko do platformy Azure. Wybierz pozycję OK.
   • Twoja subskrypcja — jeśli wybierzesz tę opcję, użyj listy rozwijanej, aby wybrać konto Microsoft i zalogować się do niego lub dodać konto Microsoft. Wybierz subskrypcję platformy Azure i konto magazynowe. Wybierz pozycję OK.
   • ręcznie wprowadzone poświadczenia — wprowadź nazwę konta magazynu i klucz podstawowy lub drugi. Wybierz opcję Connection (protokół HTTPS jest zalecany w przypadku większości scenariuszy). Wybierz opcję OK.

8. Aby usunąć parametry połączenia, wybierz parametry połączenia, a następnie wybierz pozycję Usuń ustawienie.

9. Na pasku narzędzi programu Visual Studio, wybierz Zapisz.

Programowy dostęp do parametrów połączenia

W poniższych krokach pokazano, jak programowo uzyskać dostęp do parametrów połączenia przy użyciu języka C#.

1. Dodaj następujące dyrektywy using do pliku C#, w którym zamierzasz użyć ustawienia.

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

2. Poniższy kod ilustruje przykład sposobu uzyskiwania dostępu do parametrów połączenia. Zastąp symbol zastępczy <ConnectionStringName> odpowiednią wartością.

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

Dodawanie ustawień niestandardowych do użycia w projekcie usług Azure Cloud Services (wsparcie dodatkowe)

Ustawienia niestandardowe w pliku konfiguracji usługi umożliwiają dodanie nazwy i wartości ciągu dla określonej konfiguracji usługi. Możesz użyć tego ustawienia, aby skonfigurować funkcję w usłudze w chmurze, odczytując wartość ustawienia i używając tej wartości do kontrolowania logiki w kodzie. Możesz zmienić te wartości konfiguracji usługi bez konieczności ponownego kompilowania pakietu usługi lub uruchamiania usługi w chmurze. Kod może sprawdzać powiadomienia o zmianie ustawienia. Aby uzyskać więcej informacji, zobacz RoleEnvironment.Changing Event.

Możesz dodawać, usuwać lub modyfikować ustawienia niestandardowe dla konfiguracji usługi. Możesz chcieć użyć różnych wartości dla tych ciągów dla różnych konfiguracji usługi.

Używając innej wartości dla każdej konfiguracji usługi, nie musisz używać różnych ciągów w usłudze w chmurze ani modyfikować kodu podczas publikowania usługi w chmurze na platformie Azure. Możesz użyć tej samej nazwy dla ciągu w kodzie, a wartość jest inna w zależności od konfiguracji usługi wybranej podczas kompilowania usługi w chmurze lub publikowania.

1. Utwórz lub otwórz projekt Azure Cloud Services (rozszerzona obsługa) w programie Visual Studio.

2. W eksploratorze rozwiązań rozwiń węzeł projektu. W ramach węzła Ról kliknij prawym przyciskiem myszy rolę, którą chcesz zaktualizować, a następnie z menu kontekstowego wybierz pozycję Właściwości.

   

3. Wybierz kartę Ustawienia.

   karta Ustawienia

4. Na liście Konfiguracja usługi wybierz konfigurację usługi, którą chcesz zaktualizować.

   

5. Aby dodać ustawienie niestandardowe, wybierz pozycję Dodaj ustawienie.

   

6. Po dodaniu nowego ustawienia do listy zaktualizuj wiersz na liście przy użyciu niezbędnych informacji.

   

   • Nazwa — wprowadź nazwę ustawienia.
   • Typ — wybierz ciąg z listy rozwijanej.
   • wartość — wprowadź wartość ustawienia. Możesz wprowadzić wartość bezpośrednio do komórki Wartość lub wybrać wielokropek (...), aby wprowadzić wartość w oknie dialogowym Edytowanie ciągu .

7. Aby usunąć ustawienie niestandardowe, wybierz ustawienie, a następnie wybierz pozycję Usuń ustawienie.

8. Na pasku narzędzi programu Visual Studio wybierz pozycję Zapisz.

Dostęp programowy do wartości ustawienia niestandardowego

W poniższych krokach pokazano, jak programowo uzyskać dostęp do ustawienia niestandardowego przy użyciu języka C#.

1. Dodaj następujące dyrektywy using do pliku C#, w którym będziesz używał ustawienia:

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

2. Poniższy kod ilustruje przykład sposobu uzyskiwania dostępu do ustawienia niestandardowego. Zastąp symbol zastępczy <SettingName> odpowiednią wartością.

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

Zarządzanie magazynem lokalnym dla każdego wystąpienia roli

Możesz dodać lokalny magazyn systemu plików dla każdego wystąpienia roli. Dane przechowywane w tym magazynie nie są dostępne dla innych wystąpień roli, dla których dane są przechowywane, ani dla innych ról.

1. Utwórz lub otwórz projekt usług Azure Cloud Services (wsparcie dodatkowe) w programie Visual Studio.

2. W eksploratorze rozwiązań rozwiń węzeł projektu. Pod węzłem Roles kliknij prawym przyciskiem myszy na rolę, którą chcesz zaktualizować, a następnie z menu kontekstowego wybierz Właściwości .

   

3. Wybierz kartę Local Storage.

   

4. Na liście Service Configuration upewnij się, że Wszystkie Konfiguracje jest zaznaczona, ponieważ lokalne ustawienia pamięci mają zastosowanie do wszystkich konfiguracji usługi. Każda inna wartość powoduje wyłączenie wszystkich pól wejściowych na stronie.

   

5. Aby dodać wpis magazynu lokalnego, wybierz pozycję Dodaj magazyn lokalny.

   magazyn lokalny

6. Po dodaniu nowego wpisu magazynu lokalnego do listy zaktualizuj wiersz na liście przy użyciu niezbędnych informacji.

   

   • Nazwa — wprowadź nazwę, której chcesz użyć dla nowej pamięci lokalnej.
   • Rozmiar (MB) — wprowadź rozmiar w MB potrzebny dla nowej pamięci lokalnej.
   • Wyczyść przy przetwarzaniu roli — wybierz tę opcję, aby usunąć dane w nowym magazynie lokalnym, gdy maszyna wirtualna dla roli zostanie przetworzona.

7. Aby usunąć wpis magazynu lokalnego, wybierz wpis, a następnie wybierz pozycję Usuń magazyn lokalny.

8. Na pasku narzędzi programu Visual Studio wybierz pozycję Zapisz.

Programowe uzyskiwanie dostępu do magazynu lokalnego

W tej sekcji pokazano, jak programowo uzyskać dostęp do magazynu lokalnego przy użyciu języka C#, pisząc testowy plik tekstowy MyLocalStorageTest.txt.

Zapisz plik tekstowy w pamięci lokalnej

Poniższy kod przedstawia przykład zapisywania pliku tekstowego do pamięci lokalnej. Zastąp symbol zastępczy <LocalStorageName> odpowiednią wartością.

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

Znajdź plik zapisany w pamięci lokalnej

Aby wyświetlić plik utworzony przez kod w poprzedniej sekcji, wykonaj następujące kroki:

1. W obszarze powiadomień systemu Windows kliknij prawym przyciskiem myszy ikonę platformy Azure, a następnie z menu kontekstowego wybierz pozycję Pokaż interfejs użytkownika emulatora obliczeniowego.

   emulatora obliczeń platformy Azure

2. Wybierz rolę w sieci.

   

3. Na menu emulatora obliczeń Microsoft Azure wybierz pozycję Narzędzia>Otwórz magazyn lokalny.

   

4. Po otwarciu okna Eksploratora Windows wpisz "MyLocalStorageTest.txt" w polu tekstowym Wyszukiwania, a następnie naciśnij Enter, aby rozpocząć wyszukiwanie.

Powiązana zawartość

Dowiedz się więcej o projektach platformy Azure w programie Visual Studio, czytając Konfigurowanie projektu platformy Azure. Dowiedz się więcej o schemacie usługi w chmurze, czytając Odniesienie do schematu.