Szybki start: wdrażanie ASP.NET internetowej

W tym przewodniku Szybki start dowiesz się, jak utworzyć i wdrożyć pierwszą aplikację internetową ASP.NET do Azure App Service. App Service obsługuje różne wersje aplikacji .NET i zapewnia wysoce skalowalną, samonadajną usługę hostingu w Internecie. ASP.NET internetowe są międzyplatformowe i mogą być hostowane w systemie Linux lub Windows. Po zakończeniu będziesz mieć grupę zasobów platformy Azure składającą się z planu hostingu App Service i App Service z wdrożoną aplikacją internetową.

Uwaga

Azure PowerShell do tworzenia aplikacji na platformie Windows hostingu. Aby tworzyć aplikacje w systemie Linux, użyj innego narzędzia, takiego jak interfejs wiersza polecenia platformy Azure

Wymagania wstępne

Jeśli zainstalowano już program Visual Studio 2022:

  1. Zainstaluj najnowsze aktualizacje w programie Visual Studio wybierając pozycję Help Check for > Updates (Sprawdzanie pomocy dotyczące aktualizacji).
  2. Dodaj obciążenie, wybierając pozycję Narzędzia Pobierz narzędzia > i funkcje.

Zainstaluj najnowszy zestaw SDK platformy .NET 6.0.

Zainstaluj najnowszy zestaw SDK platformy .NET 6.0.

Zainstaluj najnowszy zestaw SDK platformy .NET 6.0.

Tworzenie aplikacji internetowej platformy ASP.NET

  1. Otwórz Visual Studio a następnie wybierz pozycję Utwórz nowy projekt.

  2. W witrynie Create a new project (Tworzenie nowego projektu) znajdź i wybierz pozycję ASP.NET Core Web App (Aplikacja internetowa), a następnie wybierz pozycję Next (Dalej).

  3. W witrynie Configure your new project (Konfigurowanie nowego projektu) nadaj aplikacji nazwę MyFirstAzureWebApp, a następnie wybierz pozycję Next (Dalej).

    Visual Studio — skonfiguruj aplikację ASP.NET 6.0.

  4. Wybierz pozycję .NET Core 6.0 (obsługa długoterminowa).

  5. Upewnij się, że dla ustawienia Typ uwierzytelniania ustawiono wartość Brak. Wybierz przycisk Utwórz.

    Visual Studio — dodatkowe informacje podczas wybierania programu .NET Core 6.0.

  6. W Visual Studio menu wybierz pozycję Rozpocznij debugowanie bez debugowania, > aby uruchomić aplikację internetową lokalnie.

    Visual Studio — ASP.NET Core 6.0 działa lokalnie.

  1. W oknie terminalu utwórz nowy folder o nazwie MyFirstAzureWebApp i otwórz go w Visual Studio Code.

    mkdir MyFirstAzureWebApp
    code MyFirstAzureWebApp
    
  2. W Visual Studio Code otwórz okno terminalu, wpisując Ctrl + ` .

  3. W terminalu w Visual Studio Code utwórz nową aplikację internetową .NET przy użyciu dotnet new webapp polecenia .

    dotnet new webapp -f net6.0
    
  4. W terminalu Visual Studio Code uruchom aplikację lokalnie przy użyciu dotnet run polecenia .

    dotnet run --urls=https://localhost:5001/
    
  5. Otwórz przeglądarkę internetową i przejdź do aplikacji pod adresem https://localhost:5001.

    Na stronie zostanie wyświetlony szablon ASP.NET Core 6.0.

    Visual Studio Code — uruchom lokalnie program .NET 6.0 w przeglądarce.

  1. Otwórz okno terminalu na maszynie, aby otworzyć katalog roboczy. Utwórz nową aplikację internetową .NET przy użyciu polecenia , a następnie zmień dotnet new webapp katalogi na nowo utworzoną aplikację.

    dotnet new webapp -n MyFirstAzureWebApp --framework net6.0
    cd MyFirstAzureWebApp
    
  2. W tej samej sesji terminalowej uruchom aplikację lokalnie przy użyciu dotnet run polecenia .

    dotnet run --urls=https://localhost:5001/
    
  3. Otwórz przeglądarkę internetową i przejdź do aplikacji pod adresem https://localhost:5001.

    Na stronie zostanie wyświetlony szablon ASP.NET Core 6.0.

    Visual Studio Code — ASP.NET Core 6.0 w przeglądarce lokalnej.

Publikowanie aplikacji internetowej

Aby opublikować aplikację internetową, należy najpierw utworzyć i skonfigurować nową App Service, w których można opublikować aplikację.

W ramach konfigurowania App Service utworzysz:

  • Nowa grupa zasobów, która będzie zawierać wszystkie zasoby platformy Azure dla usługi.
  • Nowy plan hostingu określający lokalizację, rozmiar i funkcje farmy serwerów sieci Web, która hostuje aplikację.

Wykonaj następujące kroki, aby utworzyć App Service zasobów i opublikować projekt:

  1. W Eksplorator rozwiązań kliknij prawym przyciskiem myszy projekt MyFirstAzureWebApp i wybierz polecenie Publikuj.

  2. W witrynie Publish(Publikuj) wybierz pozycję Azure, a następnie pozycję Next (Dalej).

    Visual Studio — publikowanie aplikacji internetowej i docelowej platformy Azure.

  3. Wybierz wartość określonej wartości docelowej , Azure App Service (Linux) lub Azure App Service (Windows). Następnie kliknij przycisk Dalej.

    Ważne

    W przypadku określania ASP.NET framework 4.8 użyj Azure App Service (Windows).

  4. Twoje opcje zależą od tego, czy już zalogowano się na platformie Azure i czy masz konto Visual Studio połączone z kontem platformy Azure. Wybierz pozycję Dodaj konto lub Zaloguj się, aby zalogować się do subskrypcji platformy Azure. Jeśli już się zalogowano, wybierz odpowiednie konto.

    Visual Studio — wybierz okno dialogowe Zaloguj się do platformy Azure.

  5. Po prawej stronie App Service wystąpienia wybierz pozycję + .

    Visual Studio — okno dialogowe App Service nowej aplikacji.

  6. W przypadku subskrypcji zaakceptuj wymienioną subskrypcję lub wybierz nową z listy rozwijanej.

  7. W przypadku grupy zasobów wybierz pozycję Nowa. W nazwa nowej grupy zasobów, wprowadź myResourceGroup i wybierz przycisk OK.

  8. W przypadku opcji Plan hostingu wybierz pozycję Nowy.

  9. W oknie dialogowym Plan hostingu: Tworzenie nowego wprowadź wartości określone w poniższej tabeli:

    Ustawienie Sugerowana wartość Opis
    Plan hostingu MyFirstAzureWebAppPlan Nazwa planu usługi App Service.
    Lokalizacja West Europe Centrum danych, w którym hostowana jest aplikacja internetowa.
    Rozmiar Bezpłatna Warstwa cenowa określa funkcje hostowania.

    Tworzenie nowego planu hostingu

  10. W nazwa, wprowadź unikatową nazwę aplikacji, która zawiera tylko prawidłowe a-z znaki, to , , i A-Z 0-9 - . Możesz zaakceptować automatycznie wygenerowaną unikatową nazwę. Adres URL aplikacji internetowej to http://<app-name>.azurewebsites.net, gdzie <app-name> to nazwa aplikacji.

  11. Wybierz pozycję Utwórz, aby utworzyć zasoby platformy Azure.

    Visual Studio — okno dialogowe Tworzenie zasobów aplikacji.

    Po zakończeniu pracy kreatora zasoby platformy Azure zostaną utworzone i wszystko będzie gotowe do opublikowania ASP.NET Core projektu.

  12. W oknie dialogowym Publikowanie upewnij się, że nowa aplikacja App Service została wybrana w wystąpieniu App Service , a następnie wybierz pozycję Zakończ. Visual Studio profil publikowania dla wybranej App Service aplikacji.

  13. Na stronie Publikowanie wybierz pozycję Opublikuj. Jeśli zostanie wyświetlony komunikat ostrzegawczy, kliknij przycisk Kontynuuj.

    Visual Studio tworzy, pakuje i publikuje aplikację na platformie Azure, a następnie uruchamia aplikację w domyślnej przeglądarce.

    Aplikacja internetowa w ASP.NET Core 6.0 zostanie wyświetlona na stronie.

    Visual Studio — ASP.NET Core 6.0 na platformie Azure.

  1. W Visual Studio Code otwórz paletępoleceń , Ctrl + Shift + P.

  2. Wyszukaj i wybierz pozycję "Azure App Service: Wdrażanie w aplikacji internetowej".

  3. Odpowiedz na monity w następujący sposób:

    1. Wybierz folder MyFirstAzureWebApp jako folder do wdrożenia.
    2. Po wyświetleniu monitu wybierz pozycję Dodaj konfigurację.
    3. Jeśli zostanie wyświetlony monit, zaloguj się do konta platformy Azure.
    4. Wybierz swoją subskrypcję.
    5. Wybierz pozycję Utwórz nową aplikację internetową... Zaawansowane.
    6. W przypadku pola Wprowadź globalnie unikatową nazwę użyj nazwy, która jest unikatowa na całej platformie Azure (prawidłowe znaki to ,a-z 0-9 i -). Dobrym wzorcem jest użycie kombinacji nazwy firmy i identyfikatora aplikacji.
    7. Wybierz pozycję Utwórz nową grupę zasobów i podaj nazwę, na przykład myResourceGroup .
    8. Po wyświetleniu monitu o wybranie stosu środowiska uruchomieniowego:
    • W przypadku .NET 6.0 wybierz pozycję .NET 6
    • W .NET Framework 4.8 wybierz pozycję ASP.NET V4.8
    1. Wybierz system operacyjny (Windows linux).
      • W .NET Framework 4.8 Windows zostanie niejawnie wybrana.
    2. Wybierz lokalizację w pobliżu siebie.
    3. Wybierz pozycję Utwórz nowy plan App Service, podaj nazwę i wybierz warstwę cenową Bezpłatna F1.
    4. Wybierz pozycję Pomiń teraz dla zasobu Szczegółowe informacje Aplikacji.
  4. W oknie podręcznym Zawsze wdrażaj obszar roboczy "MyFirstAzureWebApp" w <app-name> obszarze " wybierz pozycję Tak. W ten sposób, o ile jesteś w tym samym obszarze roboczym, Visual Studio Code za każdym razem w tej samej App Service aplikacji.

  5. Po zakończeniu publikowania wybierz pozycję Przeglądaj witrynę internetową w powiadomieniu, a następnie wybierz pozycję Otwórz po wyświetleniu monitu.

    Aplikacja internetowa w ASP.NET Core 6.0 zostanie wyświetlona na stronie.

    Visual Studio Code — ASP.NET Core 6.0 na platformie Azure.

  1. Zaloguj się do konta platformy Azure za pomocą az login polecenia i w wierszu polecenia:

    az login
    
  2. Wd wdrażaj kod w lokalnym katalogu MyFirstAzureWebApp za pomocą az webapp up polecenia :

    az webapp up --sku F1 --name <app-name> --os-type <os>
    
    • Jeśli polecenie nie zostanie rozpoznane, upewnij się, że masz zainstalowany interfejs wiersza polecenia platformy az Azure zgodnie z opisem w tesłudze Prerequisites (Wymagania wstępne).
    • Zastąp <app-name> nazwą unikatową na całej platformie Azure (prawidłowe znaki to , a-z 0-9 i -). Dobrym wzorcem jest użycie kombinacji nazwy firmy i identyfikatora aplikacji.
    • Argument --sku F1 tworzy aplikację internetową w warstwie cenowej Bezpłatna. Pomiń ten argument, aby użyć szybszej warstwy Premium, co wiąże się z kosztem godzinowym.
    • <os>Zamień na linux lub windows . Należy użyć podczas windows określania wartości docelowej ASP.NET Framework 4.8.
    • Opcjonalnie możesz dołączyć argument --location <location-name> , gdzie <location-name> jest dostępnym regionem świadczenia usługi Azure. Listę regionów, w których można zezwolić na korzystanie z konta platformy Azure, możesz pobrać, uruchamiając az account list-locations polecenie .

    Ukończenie polecenia może potrwać kilka minut. Podczas działania program udostępnia komunikaty dotyczące tworzenia grupy zasobów, planu App Service i hostowania aplikacji, konfigurowania rejestrowania, a następnie wdrażania pliku ZIP. Następnie jest wyświetlany komunikat z adresem URL aplikacji:

    You can launch the app at http://<app-name>.azurewebsites.net
    
  3. Otwórz przeglądarkę internetową i przejdź do adresu URL:

    Aplikacja internetowa w ASP.NET Core 6.0 zostanie wyświetlona na stronie.

    Interfejs wiersza polecenia — ASP.NET Core 6.0 na platformie Azure.

Uwaga

Azure PowerShell jest zalecane do tworzenia aplikacji na Windows platformie hostingu. Aby utworzyć aplikacje w systemie Linux, użyj innego narzędzia, takiego jak interfejs wiersza polecenia platformy Azure.

  1. Zaloguj się do konta platformy Azure za pomocą Connect-AzAccount polecenia i w wierszu polecenia:

    Connect-AzAccount
    
  1. Utwórz nową aplikację za pomocą polecenia New-AzWebApp:

    New-AzWebApp -Name <app-name> -Location westeurope
    
    • Zastąp nazwą unikatową na całej <app-name> platformie Azure (prawidłowe znaki to , a-z 0-9 i -). Dobrym wzorcem jest użycie kombinacji nazwy firmy i identyfikatora aplikacji.
    • Opcjonalnie możesz dołączyć parametr -Location <location-name> , gdzie <location-name> jest dostępnym regionem świadczenia usługi Azure. Listę regionów, które można zezwolić na korzystanie z konta platformy Azure, możesz pobrać, uruchamiając Get-AzLocation polecenie .

    Ukończenie polecenia może potrwać kilka minut. Podczas działania tworzy ona grupę zasobów, plan App Service zasobów i App Service zasobów.

  2. Z folderu głównego aplikacji przygotuj lokalną aplikację MyFirstAzureWebApp do wdrożenia przy użyciu dotnet publish polecenia :

    dotnet publish --configuration Release
    
  3. Zmień katalog na release i utwórz plik zip z jego zawartości:

    cd bin\Release\net6.0\publish
    Compress-Archive -Path * -DestinationPath deploy.zip
    
  4. Opublikuj plik zip w aplikacji platformy Azure przy użyciu polecenia Publish-AzWebApp:

    Publish-AzWebApp -ResourceGroupName myResourceGroup -Name <app-name> -ArchivePath (Get-Item .\deploy.zip).FullName -Force
    

    Uwaga

    -ArchivePath wymaga pełnej ścieżki pliku zip.

  5. Otwórz przeglądarkę internetową i przejdź do adresu URL:

    Aplikacja internetowa w ASP.NET Core 6.0 zostanie wyświetlona na stronie.

    Interfejs wiersza polecenia — ASP.NET Core 6.0 na platformie Azure.

Aktualizowanie aplikacji i ponowne wdrażanie

Wykonaj następujące kroki, aby zaktualizować i ponownie wdychać aplikację internetową:

  1. W Eksplorator rozwiązań projektu otwórz w pliku Index.cshtml.

  2. Zastąp pierwszy <div> element następującym kodem:

    <div class="jumbotron">
        <h1>.NET 💜 Azure</h1>
        <p class="lead">Example .NET app to Azure App Service.</p>
    </div>
    

    Zapisz zmiany.

  3. Aby ponownie wdedytować na platformie Azure, kliknij prawym przyciskiem myszy projekt MyFirstAzureWebApp w witrynie Eksplorator rozwiązań wybierz pozycję Opublikuj.

  4. Na stronie Podsumowanie publikowania wybierz pozycję Opublikuj.

    Po zakończeniu publikowania program Visual Studio otworzy w przeglądarce adres URL aplikacji internetowej.

    Na stronie zostanie wyświetlona zaktualizowana aplikacja ASP.NET Core 6.0.

    Visual Studio — zaktualizowano ASP.NET Core 6.0 na platformie Azure.

  1. Otwórz plik Index.cshtml.

  2. Zastąp pierwszy <div> element następującym kodem:

    <div class="jumbotron">
        <h1>.NET 💜 Azure</h1>
        <p class="lead">Example .NET app to Azure App Service.</p>
    </div>
    

    Zapisz zmiany.

  3. W Visual Studio Code, otwórz paletę poleceń, Ctrl + Shift + P.

  4. Wyszukaj i wybierz pozycję "Azure App Service: Wdrażanie w aplikacji internetowej". Pamiętaj, że Visual Studio Code zapamiętać aplikację do wdrożenia obszaru roboczego w wcześniejszym kroku.

  5. Po wyświetleniu monitu wybierz pozycję Wd wdrażaj.

  6. Po zakończeniu publikowania wybierz pozycję Przeglądaj witrynę internetową w powiadomieniu i po wyświetleniu monitu wybierz pozycję Otwórz.

    Na stronie zostanie wyświetlona zaktualizowana aplikacja ASP.NET Core 6.0.

    Visual Studio Code — zaktualizowano ASP.NET Core 6.0 na platformie Azure.

W katalogu lokalnym otwórz plik Index.cshtml. Zastąp pierwszy <div> element:

<div class="jumbotron">
    <h1>.NET 💜 Azure</h1>
    <p class="lead">Example .NET app to Azure App Service.</p>
</div>

Zapisz zmiany, a następnie ponownie wdeń aplikację przy użyciu az webapp up polecenia :

ASP.NET Core 6.0 jest międzyplatformowe, w zależności od poprzedniego wdrożenia zastąp <os> nim linux lub windows .

az webapp up --os-type <os>

To polecenie używa wartości buforowanych lokalnie w pliku .azure/config, w tym nazwy aplikacji, grupy zasobów i App Service planu.

Po zakończeniu wdrażania wróć do okna przeglądarki otwartego w kroku Przejdź do aplikacji, a następnie wybierz pozycję Odśwież.

Na stronie zostanie wyświetlona zaktualizowana aplikacja ASP.NET Core 6.0.

Interfejs wiersza polecenia — ASP.NET Core 6.0 na platformie Azure.

  1. W katalogu lokalnym otwórz plik Index.cshtml. Zastąp pierwszy <div> element:

    <div class="jumbotron">
        <h1>.NET 💜 Azure</h1>
        <p class="lead">Example .NET app to Azure App Service.</p>
    </div>
    
  2. Z folderu głównego aplikacji przygotuj lokalną aplikację MyFirstAzureWebApp do wdrożenia przy użyciu dotnet publish polecenia :

    dotnet publish --configuration Release
    
  3. Zmień katalog na release i utwórz plik zip z jego zawartości:

    cd bin\Release\net6.0\publish
    Compress-Archive -Path * -DestinationPath deploy.zip
    
  4. Opublikuj plik zip w aplikacji platformy Azure przy użyciu polecenia Publish-AzWebApp:

    Publish-AzWebApp -ResourceGroupName myResourceGroup -Name <app-name> -ArchivePath (Get-Item .\deploy.zip).FullName -Force
    

    Uwaga

    -ArchivePath wymaga pełnej ścieżki pliku zip.

  5. Po zakończeniu wdrażania wróć do okna przeglądarki otwartego w kroku Przejdź do aplikacji, a następnie wybierz pozycję Odśwież.

    Na stronie zostanie wyświetlona zaktualizowana aplikacja ASP.NET Core 6.0.

    Interfejs wiersza polecenia — ASP.NET Core 6.0 na platformie Azure.

Zarządzanie aplikacją platformy Azure

Aby zarządzać aplikacją internetową, przejdź do witryny Azure Portal, a następnie wyszukaj i wybierz App Services.

Azure Portal — wybierz App Services opcję.

Na App Services wybierz nazwę aplikacji internetowej.

Azure Portal — App Services z wybraną przykładową aplikacją internetową.

Strona Przegląd aplikacji internetowej zawiera opcje podstawowego zarządzania, takie jak przeglądanie, zatrzymywanie, uruchamianie, ponowne uruchamianie i usuwanie. Menu po lewej stronie zawiera dodatkowe strony służące do konfigurowania aplikacji.

Azure Portal — App Service omówienie.

Czyszczenie zasobów

W poprzednich krokach utworzono zasoby platformy Azure w grupie zasobów. Jeśli nie będziesz już potrzebować tych zasobów w przyszłości, możesz je usunąć przez usunięcie grupy zasobów.

  1. W witrynie Azure Portal na stronie Przegląd aplikacji internetowej wybierz link myResourceGroup w obszarze Grupa zasobów.
  2. Na stronie grupy zasobów upewnij się, że zasoby na liście są tymi, które chcesz usunąć.
  3. Wybierz pozycję Usuń, wpisz ciąg myResourceGroup w polu tekstowym, a następnie wybierz opcję Usuń.

Czyszczenie zasobów

W poprzednich krokach utworzono zasoby platformy Azure w grupie zasobów. Jeśli nie będziesz już potrzebować tych zasobów w przyszłości, możesz je usunąć przez usunięcie grupy zasobów.

  1. W witrynie Azure Portal na stronie Przegląd aplikacji internetowej wybierz link myResourceGroup w obszarze Grupa zasobów.
  2. Na stronie grupy zasobów upewnij się, że zasoby na liście są tymi, które chcesz usunąć.
  3. Wybierz pozycję Usuń, wpisz ciąg myResourceGroup w polu tekstowym, a następnie wybierz opcję Usuń.

Czyszczenie zasobów

W poprzednich krokach utworzono zasoby platformy Azure w grupie zasobów. Jeśli te zasoby nie będą raczej potrzebne w przyszłości, usuń grupę zasobów, uruchamiając następujące polecenie w usłudze Cloud Shell:

az group delete --name myResourceGroup

Wykonanie tego polecenia może potrwać około minutę.

Czyszczenie zasobów

W poprzednich krokach utworzono zasoby platformy Azure w grupie zasobów. Jeśli nie będziesz potrzebować tych zasobów w przyszłości, usuń grupę zasobów, uruchamiając następujące polecenie programu PowerShell:

Remove-AzResourceGroup -Name myResourceGroup

Wykonanie tego polecenia może potrwać około minutę.

Następne kroki

W tym przewodniku Szybki start utworzono i wdrożono ASP.NET internetową w Azure App Service.

W następnym artykule dowiesz się, jak utworzyć aplikację .NET Core i połączyć ją z SQL Database: