Udostępnij za pośrednictwem


Szybki start: wdrażanie aplikacji internetowej ASP.NET

Uwaga

Od 1 czerwca 2024 r. wszystkie nowo utworzone aplikacje usługi App Service będą miały możliwość wygenerowania unikatowej domyślnej nazwy hosta przy użyciu konwencji <app-name>-<random-hash>.<region>.azurewebsites.netnazewnictwa . Istniejące nazwy aplikacji pozostaną niezmienione.

Przykład: myapp-ds27dh7271aah175.westus-01.azurewebsites.net

Aby uzyskać więcej informacji, zapoznaj się z unikatową domyślną nazwą hosta zasobu usługi App Service.

Z tego przewodnika Szybki start dowiesz się, jak utworzyć i wdrożyć pierwszą aplikację internetową ASP.NET w usłudze aplikacja systemu Azure Service. Usługa App Service obsługuje różne wersje aplikacji platformy .NET i udostępnia wysoce skalowalną, samonastosowalną usługę hostingu internetowego. ASP.NET aplikacje internetowe są międzyplatformowe i mogą być hostowane w systemie Linux lub Windows. Po zakończeniu masz grupę zasobów platformy Azure składającą się z planu hostingu usługi App Service i usługi App Service z wdrożonym aplikacją internetową.

Alternatywnie możesz wdrożyć aplikację internetową ASP.NET w ramach kontenera systemu Windows lub Linux w usłudze App Service.

Napiwek

Znajdź porady dotyczące narzędzia GitHub Copilot w krokach programu Visual Studio, Visual Studio Code i witryny Azure Portal.

Uwaga

Kompilowanie aplikacji .NET 9 (STS) w usłudze Windows App Service przy użyciu programu MSBuild lub SCM_DO_BUILD nie jest jeszcze obsługiwane. Obsługa tych scenariuszy kompilacji nastąpi po początkowej dacie ogólnodostępnej i do 4 grudnia 2024 r. Wdrożenia tworzone poza usługą App Service za pośrednictwem programu Visual Studio, programu Visual Studio Code, funkcji GitHub Actions i usługi Azure DevOps są w pełni obsługiwane.

Wymagania wstępne

  • Konto platformy Azure z aktywną subskrypcją. Utwórz konto bezpłatnie.
  • Program Visual Studio 2022 z pakietem roboczym tworzenia aplikacji ASP.NET i aplikacji internetowych.
  • (Opcjonalnie) Aby wypróbować narzędzie GitHub Copilot, konto narzędzia GitHub Copilot. Dostępna jest 30-dniowa bezpłatna wersja próbna.

Jeśli program Visual Studio 2022 został już zainstalowany:

  1. Zainstaluj najnowsze aktualizacje w programie Visual Studio, wybierając pozycję Sprawdzanie dostępności aktualizacji w Pomocy>.
  2. Dodaj obciążenie, wybierając pozycję Narzędzia Pobierz narzędzia>i funkcje.

1. Tworzenie aplikacji internetowej ASP.NET

1. Inicjowanie szablonu aplikacji internetowej ASP.NET

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

  2. W obszarze Tworzenie nowego projektu znajdź i wybierz pozycję ASP.NET Core Web App (Strony Razor), a następnie wybierz pozycję Dalej.

  3. W obszarze Konfigurowanie nowego projektu nadaj aplikacji nazwę MyFirstAzureWebApp, a następnie wybierz pozycję Dalej.

    Zrzut ekranu programu Visual Studio — konfigurowanie aplikacji internetowej ASP.NET 8.0.

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

  5. Upewnij się, że typ uwierzytelniania ma wartość Brak. Wybierz pozycję Utwórz.

    Zrzut ekranu programu Visual Studio — dodatkowe informacje podczas wybierania platformy .NET 8.0.

  6. Z menu programu Visual Studio wybierz pozycję Debuguj>rozpocznij bez debugowania, aby uruchomić aplikację internetową lokalnie. Jeśli zostanie wyświetlony komunikat z prośbą o zaufanie certyfikatowi z podpisem własnym, wybierz pozycję Tak.

    Zrzut ekranu programu Visual Studio — ASP.NET Core 8.0 uruchomiony lokalnie.

Napiwek

Jeśli masz konto GitHub Copilot, spróbuj uzyskać funkcje narzędzia GitHub Copilot dla programu Visual Studio.

  1. Otwórz okno terminalu na maszynie w katalogu roboczym. Utwórz nową aplikację internetową platformy .NET przy użyciu dotnet new webapp polecenia , a następnie zmień katalogi na nowo utworzoną aplikację.

    dotnet new webapp -n MyFirstAzureWebApp --framework net8.0
    cd MyFirstAzureWebApp
    
  2. W tej samej sesji terminalu 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świetlona aplikacja internetowa ASP.NET Core 8.0.

    Zrzut ekranu programu Visual Studio Code — ASP.NET Core 8.0 w przeglądarce lokalnej.

W tym kroku utworzysz rozwidlenie projektu demonstracyjnego do wdrożenia.

  1. Przejdź do przykładowej aplikacji .NET 8.0.
  2. Wybierz przycisk Rozwidlenie w prawym górnym rogu strony GitHub.
  3. Wybierz właściciela i pozostaw domyślną nazwę repozytorium.
  4. Wybierz pozycję Utwórz rozwidlenie.

Ten przewodnik Szybki start używa interfejsu wiersza polecenia dla deweloperów platformy Azure (azd) zarówno do tworzenia zasobów platformy Azure, jak i wdrażania w nim kodu. Aby uzyskać więcej informacji na temat interfejsu wiersza polecenia dla deweloperów platformy Azure, odwiedź dokumentację lub ścieżkę szkoleniową.

Pobierz i zainicjuj szablon aplikacji internetowej platformy ASP.NET Core dla tego przewodnika Szybki start, wykonując następujące kroki:

  1. Otwórz okno terminalu na maszynie w pustym katalogu roboczym. Zainicjuj azd azd init szablon przy użyciu polecenia .

    azd init --template https://github.com/Azure-Samples/quickstart-deploy-aspnet-core-app-service.git
    

    Po wyświetleniu monitu o nazwę środowiska wprowadź .dev

  2. W tej samej sesji terminalu uruchom aplikację lokalnie przy użyciu dotnet run polecenia . Użyj parametru --project , aby określić src katalog szablonu azd , czyli miejsce, w którym znajduje się kod aplikacji.

    dotnet run --project src --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 aplikacji internetowej platformy ASP.NET Core 8.0.

    Zrzut ekranu programu Visual Studio Code — ASP.NET Core 8.0 w przeglądarce lokalnej.

2. Publikowanie aplikacji internetowej

Wykonaj następujące kroki, aby utworzyć zasoby usługi App Service i opublikować projekt:

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

  2. W obszarze Publikowanie wybierz pozycję Azure , a następnie pozycję Dalej.

    Zrzut ekranu programu Visual Studio — publikowanie aplikacji internetowej i docelowej platformy Azure.

  3. Wybierz określony element docelowy , aplikacja systemu Azure Service (Linux) lub aplikacja systemu Azure Service (Windows). Następnie wybierz Dalej.

    Ważne

    W przypadku określania wartości docelowej ASP.NET Framework 4.8 użyj usługi aplikacja systemu Azure (Windows).

  4. Opcje zależą od tego, czy zalogowałeś się już na platformie Azure i czy masz konto programu 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ę zalogowałeś, wybierz żądane konto.

    Zrzut ekranu programu Visual Studio — wybieranie pozycji Zaloguj się do okna dialogowego platformy Azure.

  5. Po prawej stronie wystąpień usługi App Service wybierz pozycję +.

    Zrzut ekranu przedstawiający okno dialogowe Aplikacji programu Visual Studio — nowa aplikacja usługi App Service.

  6. W polu Subskrypcja zaakceptuj listę subskrypcji lub wybierz nową z listy rozwijanej.

  7. W obszarze Grupa zasobów wybierz pozycję Nowy. W polu Nazwa nowej grupy zasobów wprowadź nazwę myResourceGroup i wybierz przycisk OK.

  8. W obszarze Plan hostingu wybierz pozycję Nowy.

  9. W oknie dialogowym Plan hostingu : Utwórz nowy wprowadź wartości określone w poniższej tabeli:

    Ustawienie Sugerowana wartość opis
    Plan hostingu MyFirstAzureWebAppPlan Nazwa planu usługi App Service.
    Lokalizacja Europa Zachodnia Centrum danych, w którym hostowana jest aplikacja internetowa.
    Rozmiar Wybierz najniższą warstwę. Warstwy cenowe definiują funkcje hostingu.
  10. W polu Nazwa wprowadź unikatową nazwę aplikacji, która zawiera tylko prawidłowe znaki, to a-z, A-Z, 0-9i -. 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.

    Zrzut ekranu przedstawiający okno dialogowe Tworzenie zasobów aplikacji w programie Visual Studio.

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

  12. W oknie dialogowym Publikowanie upewnij się, że została wybrana nowa aplikacja usługi App Service, a następnie wybierz pozycję Zakończ, a następnie wybierz pozycję Zamknij. Program Visual Studio tworzy profil publikowania dla wybranej aplikacji usługi App Service.

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

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

    Na stronie zostanie wyświetlona aplikacja internetowa platformy ASP.NET Core 8.0.

    Zrzut ekranu programu Visual Studio — aplikacja internetowa ASP.NET Core 8.0 na platformie Azure.

  1. Otwórz program Visual Studio Code z katalogu głównego projektu.

    code .
    
  2. Jeśli zostanie wyświetlony monit, wybierz pozycję Tak, ufam autorom.

    Napiwek

    Jeśli masz konto GitHub Copilot, spróbuj uzyskać funkcje narzędzia GitHub Copilot dla programu Visual Studio Code.

  3. W programie Visual Studio Code otwórz paletę poleceń, wybierając pozycję Wyświetl>paletę poleceń.

  4. Wyszukaj i wybierz pozycję "aplikacja systemu Azure Service: Create New Web App (Advanced)" (Usługa aplikacja systemu Azure: Utwórz nową aplikację internetową (zaawansowane)".

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

    1. Jeśli zostanie wyświetlony monit, zaloguj się do konta platformy Azure.
    2. Wybierz swoją subskrypcję.
    3. Wybierz pozycję Utwórz nową aplikację internetową... Zaawansowane.
    4. W polu Wprowadź globalnie unikatową nazwę użyj nazwy unikatowej dla całej platformy Azure (prawidłowe znaki to a-z, 0-9i -). Dobrym wzorcem jest użycie kombinacji nazwy firmy i identyfikatora aplikacji.
    5. Wybierz pozycję Utwórz nową grupę zasobów i podaj nazwę, taką jak myResourceGroup.
    6. Po wyświetleniu monitu o wybranie stosu środowiska uruchomieniowego wybierz pozycję .NET 8 (LTS).
    7. Wybierz system operacyjny (Windows lub Linux).
    8. Wybierz lokalizację w pobliżu siebie.
    9. Wybierz pozycję Utwórz nowy plan usługi App Service, podaj nazwę i wybierz warstwę cenową Bezpłatna (F1).
    10. Wybierz pozycję Pomiń teraz dla zasobu usługi Application Insights.
    11. Po wyświetleniu monitu wybierz pozycję Wdróż.
    12. Wybierz pozycję MyFirstAzureWebApp jako folder do wdrożenia.
    13. Po wyświetleniu monitu wybierz pozycję Dodaj konfigurację .
  6. W oknie podręcznym Zawsze wdróż obszar roboczy "MyFirstAzureWebApp" na <nazwę> aplikacji", wybierz pozycję Tak , aby program Visual Studio Code był wdrażany w tej samej aplikacji usługi App Service za każdym razem, gdy jesteś w tym obszarze roboczym.

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

    Na stronie zostanie wyświetlona aplikacja internetowa platformy ASP.NET Core 8.0.

    Zrzut ekranu przedstawiający program Visual Studio Code — ASP.NET Core 8.0 aplikacji internetowej na platformie Azure.

  1. Zaloguj się do konta platformy Azure przy użyciu az login polecenia i wykonaj następujące polecenie:

    az login
    
    • az Jeśli polecenie nie jest rozpoznawane, upewnij się, że masz zainstalowany interfejs wiersza polecenia platformy Azure zgodnie z opisem w temacie Wymagania wstępne.
  2. Wdróż kod w lokalnym katalogu MyFirstAzureWebApp przy użyciu az webapp up polecenia :

    az webapp up --sku F1 --name <app-name> --os-type <os>
    
    • Zastąp <app-name> ciąg nazwą unikatową dla całej platformy Azure (prawidłowe znaki to a-z, 0-9i -). 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, która wiąże się z kosztami godzinowymi.
    • Zastąp ciąg <os> ciągiem linux lub windows.
    • Opcjonalnie możesz dołączyć argument --location <location-name> , w którym <location-name> jest dostępny region platformy Azure. Listę dozwolonych regionów dla konta platformy Azure można pobrać, uruchamiając az account list-locations polecenie .

    Wykonanie polecenia może potrwać kilka minut. Gdy jest uruchomiona, polecenie udostępnia komunikaty dotyczące tworzenia grupy zasobów, planu usługi App Service i aplikacji hostingu, konfigurowania rejestrowania, a następnie wykonywania wdrożenia zip. Następnie zostanie wyświetlony 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:

    Na stronie zostanie wyświetlona aplikacja internetowa platformy ASP.NET Core 8.0.

    Zrzut ekranu interfejsu wiersza polecenia — aplikacja internetowa ASP.NET Core 8.0 na platformie Azure.

Uwaga

Program Azure PowerShell jest zalecany do tworzenia aplikacji na platformie hostingowej systemu Windows. 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 przy użyciu Connect-AzAccount polecenia i wykonaj następujące polecenie:

    Connect-AzAccount
    
  1. Utwórz nową aplikację przy użyciu polecenia New-AzWebApp :

    New-AzWebApp -ResourceGroupName myResourceGroup -Name <app-name> -Location westeurope
    
    • Zastąp <app-name> ciąg nazwą unikatową dla całej platformy Azure (prawidłowe znaki to a-z, 0-9i -). Połączenie nazwy firmy i identyfikatora aplikacji jest dobrym wzorcem.
    • Opcjonalnie możesz uwzględnić parametr -Location <location-name> , w którym <location-name> jest dostępny region platformy Azure. Listę dozwolonych regionów dla konta platformy Azure można pobrać, uruchamiając Get-AzLocation polecenie .

    Wykonanie polecenia może potrwać kilka minut. Gdy jest uruchomiona, polecenie tworzy grupę zasobów, plan usługi App Service i zasób usługi App Service.

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

    dotnet publish --configuration Release
    
  3. Przejdź do katalogu wydania i utwórz plik zip z zawartości:

    cd bin\Release\net8.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:

    Na stronie zostanie wyświetlona aplikacja internetowa platformy ASP.NET Core 8.0.

    Zrzut ekranu interfejsu wiersza polecenia — aplikacja internetowa ASP.NET Core 8.0 na platformie Azure.

  1. Wpisz usługi app services w wyszukiwaniu. W obszarze Usługi wybierz pozycję App Services.

    Zrzut ekranu przedstawiający wyszukiwanie w portalu w witrynie Azure Portal.

  2. Na stronie App Services wybierz pozycję Utwórz>aplikację internetową.

  3. Na karcie Podstawy :

    • W obszarze Grupa zasobów wybierz pozycję Utwórz nową. Wpisz nazwę myResourceGroup.
    • W obszarze Nazwa wpisz globalnie unikatową nazwę aplikacji internetowej.
    • W obszarze Publikowanie wybierz pozycję Kod.
    • W obszarze Stos środowiska uruchomieniowego wybierz pozycję .NET 8 (LTS).
    • W obszarze System operacyjny wybierz pozycję Windows. Jeśli wybierzesz system Linux, nie możesz skonfigurować wdrożenia usługi GitHub w następnym kroku, ale nadal możesz to zrobić po utworzeniu aplikacji na stronie Centrum wdrażania.
    • Wybierz region, z którego chcesz obsługiwać aplikację.
    • W obszarze Plan usługi App Service wybierz pozycję Utwórz nową i wpisz myAppServicePlan jako nazwę.
    • W obszarze Plan cenowy wybierz pozycję Bezpłatna F1.

    Zrzut ekranu przedstawiający nową konfigurację aplikacji usługi App Service dla platformy .NET 8 w witrynie Azure Portal.

  4. Wybierz kartę Wdrożenie w górnej części strony

  5. W obszarze Ustawienia funkcji GitHub Actions ustaw pozycję Ciągłe wdrażanie na Wartość Włącz.

  6. W obszarze Szczegóły funkcji GitHub Actions uwierzytelnij się przy użyciu konta usługi GitHub i wybierz następujące opcje:

    • W polu Organizacja wybierz organizację, w której rozwidlisz projekt demonstracyjny.
    • W polu Repozytorium wybierz projekt dotnetcore-docs-hello-world .
    • W obszarze Gałąź wybierz pozycję main.

    Zrzut ekranu przedstawiający opcje wdrażania aplikacji przy użyciu środowiska uruchomieniowego platformy .NET 8.

    Uwaga

    Domyślnie kreator tworzenia wyłącza uwierzytelnianie podstawowe, a wdrożenie funkcji GitHub Actions jest tworzone przy użyciu tożsamości przypisanej przez użytkownika. Jeśli podczas tworzenia zasobu wystąpi błąd uprawnień, twoje konto platformy Azure może nie mieć wystarczających uprawnień. Wdrożenie funkcji GitHub Actions można skonfigurować później przy użyciu tożsamości wygenerowanej przez administratora platformy Azure lub zamiast tego włączyć uwierzytelnianie podstawowe.

  7. Wybierz przycisk Przejrzyj i utwórz w dolnej części strony.

  8. Po uruchomieniu walidacji wybierz przycisk Utwórz w dolnej części strony.

  9. Po zakończeniu wdrażania wybierz pozycję Przejdź do zasobu.

    Zrzut ekranu przedstawiający następny krok przechodzenia do zasobu.

  10. Przejdź do wdrożonej aplikacji w przeglądarce internetowej pod adresem URL http://<app-name>.azurewebsites.net. Jeśli zostanie wyświetlony komunikat "Twoja aplikacja internetowa jest uruchomiona i czeka na zawartość", wdrożenie usługi GitHub jest nadal uruchomione. Poczekaj kilka minut i odśwież stronę.

Szablon AZD zawiera pliki, które generują następujące wymagane zasoby dla aplikacji do uruchomienia w usłudze App Service:

  • Nowa grupa zasobów zawierająca wszystkie zasoby platformy Azure dla usługi.
  • Nowy plan usługi App Service określający lokalizację, rozmiar i funkcje farmy serwerów internetowych hostujących aplikację.
  • Nowe wystąpienie aplikacji usługi App Service do uruchamiania wdrożonej aplikacji.
  1. Zaloguj się do konta platformy Azure przy użyciu azd auth login polecenia i wykonaj następujące polecenie:

    azd auth login
    
  2. Utwórz zasoby platformy Azure i wdróż aplikację przy azd up użyciu polecenia :

    azd up
    

    Wykonanie azd up polecenia może potrwać kilka minut. azd up Używa plików Bicep w projektach do utworzenia grupy zasobów, planu usługi App Service i aplikacji hostingu. Wykonuje również pewne konfiguracje, takie jak włączanie rejestrowania i wdrażanie skompilowanego kodu aplikacji. Gdy jest uruchomiona, polecenie udostępnia komunikaty dotyczące procesu aprowizacji i wdrażania, w tym link do wdrożenia na platformie Azure. Po zakończeniu polecenie wyświetli również link do aplikacji wdrażania.

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

    Na stronie zostanie wyświetlona aplikacja internetowa platformy ASP.NET Core 8.0.

    Zrzut ekranu przedstawiający wdrożona przykładową aplikację .NET Framework 4.8.

3. Aktualizowanie aplikacji i ponowne wdrażanie

Wprowadzisz zmianę w pliku Index.cshtml i ponownie wdrożysz, aby zobaczyć zmiany. W szablonie .NET 8.0 znajduje się on w folderze Pages . W szablonie programu .NET Framework 4.8 znajduje się on w folderze Views/Home . Wykonaj następujące kroki, aby zaktualizować i ponownie wdrożyć aplikację internetową:

  1. W Eksplorator rozwiązań w projekcie 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>
    

    Napiwek

    Po włączeniu narzędzia GitHub Copilot w programie Visual Studio spróbuj wykonać następujące czynności:

    1. <div> Wybierz element i wpisz Alt+/.
    2. Zapytaj Copilot: "Zmień na kartę Bootstrap, która mówi .NET 💜 Azure".

    Zapisz zmiany.

  3. Aby ponownie wdrożyć na platformie Azure, kliknij prawym przyciskiem myszy projekt MyFirstAzureWebApp w Eksplorator rozwiązań i wybierz polecenie Publikuj.

  4. Na stronie Podsumowanie publikowania wybierz pozycję Publikuj.

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

    Na stronie zostanie wyświetlona zaktualizowana aplikacja internetowa platformy ASP.NET Core 8.0.

    Zrzut ekranu programu Visual Studio — zaktualizowana aplikacja internetowa ASP.NET Core 8.0 na platformie Azure.

  1. Otwórz plik Pages/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>
    

    Napiwek

    Wypróbuj to za pomocą narzędzia GitHub Copilot:

    1. Wybierz cały <div> element i kliknij pozycję .
    2. Zapytaj Copilot: "Zmień na kartę Bootstrap, która mówi .NET 💜 Azure".

    Zapisz zmiany.

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

  4. Wyszukaj i wybierz pozycję "aplikacja systemu Azure Service: Deploy to Web App" (Usługa aplikacja systemu Azure: Wdrażanie w aplikacji internetowej).

  5. Wybierz subskrypcję i używaną wcześniej aplikację internetową.

  6. Po wyświetleniu monitu wybierz pozycję Wdróż.

  7. Po zakończeniu publikowania wybierz pozycję Przeglądaj witrynę internetową w powiadomieniu.

    Na stronie zostanie wyświetlona zaktualizowana aplikacja internetowa platformy ASP.NET Core 8.0.

    Zrzut ekranu programu Visual Studio Code — zaktualizowana aplikacja internetowa ASP.NET Core 8.0 na platformie Azure.

Napiwek

Aby zobaczyć, jak program Visual Studio Code z rozwiązaniem GitHub Copilot pomaga ulepszyć środowisko tworzenia aplikacji internetowych, zobacz kroki programu Visual Studio Code.

W katalogu lokalnym otwórz plik Pages/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 wdróż aplikację przy użyciu polecenia i zastąp az webapp up ciąg <os> ciągiem 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 planu usługi App Service.

Po zakończeniu wdrażania wróć do okna przeglądarki, które zostało otwarte w kroku Przeglądaj w aplikacji i naciśnij pozycję Odśwież.

Na stronie zostanie wyświetlona zaktualizowana aplikacja internetowa platformy ASP.NET Core 8.0.

Zrzut ekranu interfejsu wiersza polecenia — zaktualizowano aplikację internetową platformy ASP.NET Core 8.0 na platformie Azure.

  1. W katalogu lokalnym otwórz plik Pages/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. Przejdź do katalogu wydania i utwórz plik zip z zawartości:

    cd bin\Release\net8.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, które zostało otwarte w kroku Przeglądaj w aplikacji i naciśnij pozycję Odśwież.

    Na stronie zostanie wyświetlona zaktualizowana aplikacja internetowa platformy ASP.NET Core 8.0.

    Zrzut ekranu interfejsu wiersza polecenia — zaktualizowano aplikację internetową platformy ASP.NET Core 8.0 na platformie Azure.

  1. Przejdź do rozwidlenia usługi GitHub przykładowego kodu.

  2. Na stronie repozytorium utwórz przestrzeń kodu, wybierając pozycję Code>Create codespace on main (Utwórz przestrzeń kodu na stronie głównej).

    Napiwek

    Jeśli masz konto GitHub Copilot, spróbuj uzyskać funkcje narzędzia GitHub Copilot w swojej przestrzeni kodu.

  3. Otwórz plik Index.cshtml.

    Plik Index.cshtml znajduje się w folderze Pages .

    Zrzut ekranu przedstawiający okno Eksploratora z programu Visual Studio Code w przeglądarce z wyróżnionym plikiem Index.cshtml w repozytorium dotnetcore-docs-hello-world.

  4. 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>
    

    Zmiany są zapisywane automatycznie.

    Napiwek

    Wypróbuj to za pomocą narzędzia GitHub Copilot:

    1. Wybierz cały <div> element i kliknij pozycję .
    2. Zapytaj Copilot: "Zmień na kartę Bootstrap, która mówi .NET 💜 Azure".
  5. W menu Kontrola źródła wprowadź komunikat zatwierdzenia, taki jak Modify homepage. Następnie wybierz pozycję Zatwierdź i potwierdź przejściowe zmiany, wybierając pozycję Tak.

    Napiwek

    Pozwól usłudze GitHub Copilot utworzyć komunikat zatwierdzenia, wybierając w polu komunikatu.

  6. Wybierz pozycję Synchronizuj zmiany 1, a następnie potwierdź, wybierając przycisk OK.

  7. Uruchomienie wdrożenia trwa kilka minut. Aby wyświetlić postęp, przejdź do https://github.com/<your-github-alias>/dotnetcore-docs-hello-world/actionsadresu .

  8. Wróć do okna przeglądarki, które było otwierane podczas przechodzenia do kroku aplikacji i odśwież stronę.

    Na stronie zostanie wyświetlona zaktualizowana aplikacja internetowa platformy ASP.NET Core 8.0.

    Zrzut ekranu interfejsu wiersza polecenia — zaktualizowano aplikację internetową platformy ASP.NET Core 8.0 na platformie Azure.

W katalogu lokalnym otwórz plik src/Pages/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 wdróż aplikację przy użyciu azd up polecenia :

azd up

azd up Pomija krok aprowizacji zasobów tym razem i ponownie wdraża kod, ponieważ nie ma żadnych zmian w plikach Bicep.

Po zakończeniu wdrażania przeglądarka zostanie otwarta w zaktualizowanej aplikacji internetowej ASP.NET Core 8.0.

Zrzut ekranu interfejsu wiersza polecenia — zaktualizowano aplikację internetową platformy ASP.NET Core 8.0 na platformie Azure.

4. Zarządzanie aplikacją platformy Azure

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

Zrzut ekranu witryny Azure Portal — wybierz opcję App Services.

Na stronie App Services wybierz nazwę aplikacji internetowej.

Zrzut ekranu przedstawiający stronę Azure Portal — App Services z wybraną przykładową aplikacją internetową.

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

Zrzut ekranu przedstawiający stronę przeglądu witryny Azure Portal — App Service.

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ń grupę zasobów, wpisz myResourceGroup w polu tekstowym, a następnie wybierz pozycję Usuń.
  4. Potwierdź ponownie, wybierając pozycję 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ń grupę zasobów, wpisz myResourceGroup w polu tekstowym, a następnie wybierz pozycję Usuń.
  4. Potwierdź ponownie, wybierając pozycję Usuń.

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

Dla wygody az webapp up polecenie uruchomione wcześniej w tym projekcie zapisuje nazwę grupy zasobów jako wartość domyślną za każdym razem, gdy uruchamiasz az polecenia z tego projektu.

Czyszczenie zasobów

W poprzednich krokach utworzono zasoby platformy Azure w grupie zasobów. Jeśli nie oczekujesz, że te zasoby będą potrzebne 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ę.

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ń grupę zasobów, wpisz myResourceGroup w polu tekstowym, a następnie wybierz pozycję Usuń.
  4. Potwierdź ponownie, wybierając pozycję Usuń.

Czyszczenie zasobów

Użyj polecenia , azd down aby usunąć grupę zasobów i wszystkie skojarzone z nią zasoby:

azd down

Zapoznaj się z dokumentacją interfejsu wiersza polecenia dla deweloperów platformy Azure, aby uzyskać kolejne kroki dotyczące pracy z szablonami azd i dodatkowymi funkcjami.

Następne kroki