자습서: Azure App Service로 ASP.NET Core 및 Azure SQL Database 앱 배포

  • 아티클

이 자습서에서는 Azure App Service에 데이터 기반 ASP.NET Core 앱을 배포하고 Azure SQL Database에 연결하는 방법을 알아봅니다. 또한 애플리케이션에서 캐싱 코드를 사용하도록 설정하기 위해 Azure Cache for Redis를 배포합니다. Azure App Service는 스케일링 성능이 뛰어난 자체 패치 웹 호스팅 서비스로, Windows 또는 Linux에서 앱을 쉽게 배포할 수 있습니다. 이 자습서에서는 ASP.NET Core 7.0 앱을 사용하지만 프로세스는 다른 버전의 ASP.NET Core 및 ASP.NET Framework와 동일합니다.

이 자습서에는 다음이 필요합니다.

샘플 응용 프로그램

이 자습서에 사용된 샘플 애플리케이션을 탐색하려면 리포지토리에서 다운로드하거나,https://github.com/Azure-Samples/msdocs-app-service-sqldb-dotnetcore다음 Git 명령을 사용하여 복제합니다.

git clone https://github.com/Azure-Samples/msdocs-app-service-sqldb-dotnetcore.git
cd msdocs-app-service-sqldb-dotnetcore

1. App Service, 데이터베이스 및 캐시 만들기

이 단계에서는 Azure 리소스를 만듭니다. 이 자습서에 사용된 단계에서는 App Service, Azure SQL Database 및 Azure Cache를 포함하는 기본 보안 리소스 세트를 만듭니다. 만들기 프로세스의 경우 다음을 지정합니다.

  • 웹앱의 이름입니다. https://<app-name>.azurewebsites.net 형식의 웹앱의 DNS 이름의 일부로 사용되는 이름입니다.
  • 전 세계에서 앱을 물리적으로 실행할 지역입니다.
  • 앱의 런타임 스택입니다. 여기에서 앱에 사용할 .NET 버전을 선택합니다.
  • 앱에 대한 호스팅 계획입니다. 앱에 대한 기능 및 크기 조정 용량 세트를 포함하는 가격 책정 계층입니다.
  • 앱의 리소스 그룹입니다. 리소스 그룹을 사용하면 애플리케이션에 필요한 모든 Azure 리소스를 논리 컨테이너에 그룹화할 수 있습니다.

Azure Portal에 로그인하고 다음 단계에 따라 Azure App Service 리소스를 만듭니다.

1단계: Azure Portal에서:

  1. Azure Portal 상단의 검색 창에 "웹앱 데이터베이스"를 입력합니다.
  2. Marketplace 제목 아래에서 웹앱 + 데이터베이스라는 항목을 선택합니다. 만들기 마법사로 직접 이동할 수도 있습니다.

A screenshot showing how to use the search box in the top tool bar to find the Web App + Database creation wizard.

2단계:웹앱 만들기 + 데이터베이스 페이지에서 다음과 같이 양식을 작성합니다.

  1. 리소스 그룹 → 새로 만들기를 선택하고 msdocs-laravel-mysql-tutorial이라는 이름을 사용합니다.
  2. 지역 → 가까운 Azure 지역을 선택합니다.
  3. 이름 → msdocs-laravel-mysql-XYZ, 여기서 XYZ는 임의의 세 문자입니다. 이 이름은 Azure에서 고유해야 합니다.
  4. 런타임 스택 → .NET 7(STS).
  5. Azure Cache for Redis를 추가하시겠습니까? → 예.
  6. 호스팅 계획 → 기본. 준비가 되면 나중에 프로덕션 가격 책정 계층으로 스케일 업할 수 있습니다.
  7. SQLAzure는 기본적으로 데이터베이스 엔진으로 선택됩니다. Azure SQL Database는 항상 안정적인 최신 버전의 SQL Server에서 실행되는 완전 관리형 PaaS(Platform as a Service) 데이터베이스 엔진입니다.
  8. 검토 + 만들기를 선택합니다.
  9. 유효성 검사가 완료되면 만들기를 선택합니다.

A screenshot showing how to configure a new app and database in the Web App + Database wizard.

3단계: 배포를 완료하는 데 몇 분 정도 걸립니다. 배포가 완료되면 리소스로 이동 단추를 선택합니다. App Service 앱으로 직접 이동하지만 다음 리소스가 생성됩니다.

  • 리소스 그룹 → 만들어진 모든 리소스의 컨테이너입니다.
  • App Service 요금제 → App Service의 컴퓨팅 리소스를 정의합니다. 기본 계층의 Linux 계획이 만들어집니다.
  • App Service → 앱을 나타내며 App Service 요금제에서 실행됩니다.
  • 가상 네트워크 → App Service 앱과 통합되고 백 엔드 네트워크 트래픽을 격리합니다.
  • 프라이빗 엔드포인트 → 가상 네트워크의 데이터베이스 서버 및 Redis Cache에 대한 액세스 엔드포인트입니다.
  • 네트워크 인터페이스 → 각 프라이빗 엔드포인트에 대해 하나씩 개인 IP 주소를 나타냅니다.
  • Azure SQL Database 서버 → 프라이빗 엔드포인트 뒤에서만 액세스할 수 있습니다.
  • Azure SQL Database → 서버에서 데이터베이스와 사용자가 만들어집니다.
  • Azure Cache for Redis → 프라이빗 엔드포인트 뒤에서만 액세스할 수 있습니다.
  • 프라이빗 DNS 영역 → 가상 네트워크에서 데이터베이스 서버 및 Redis Cache의 DNS 확인을 사용하도록 설정합니다.

A screenshot showing the deployment process completed.

2. 연결 문자열 확인

만들기 마법사는 SQL 데이터베이스 및 Redis 캐시에 대한 연결 문자열을 이미 생성했습니다. 이 단계에서는 나중에 생성된 연결 문자열을 찾습니다.

1단계: App Service 페이지의 왼쪽 메뉴에서 구성을 선택합니다.

A screenshot showing how to open the configuration page in App Service.

2단계:

  1. 페이지 아래쪽으로 스크롤하여 연결 문자열 섹션에서 AZURE_SQL_CONNECTIONSTRING을 찾습니다. 이 문자열은 만들기 마법사에 의해 새 SQL 데이터베이스에서 생성되었습니다. 애플리케이션을 설정하려면 이 이름만 있으면 됩니다.
  2. 또한 애플리케이션 설정 섹션에서 AZURE_REDIS_CONNECTIONSTRING을 찾습니다. 이 문자열은 만들기 마법사에 의해 새 Redis 캐시에서 생성되었습니다. 애플리케이션을 설정하려면 이 이름만 있으면 됩니다.
  3. 원하는 경우 각 설정 오른쪽에 있는 편집 단추를 선택하여 해당 값을 보거나 복사할 수 있습니다. 나중에 AZURE_SQL_CONNECTIONSTRING 및 AZURE_REDIS_CONNECTIONSTRING을 사용하도록 애플리케이션을 변경합니다.

A screenshot showing how to create an app setting.

3. 샘플 코드 배포

이 단계에서는 GitHub Actions을 사용하여 GitHub 배포를 구성합니다. 이는 App Service에 배포하는 여러 방법 중 하나일 뿐 아니라 배포 프로세스에서 연속적으로 통합할 수 있는 좋은 방법이기도 합니다. 기본적으로 GitHub 리포지토리에 대한 모든 git push는 빌드 및 배포 작업을 시작합니다.

1단계: 새 브라우저 창에서:

  1. GitHub 계정으로 로그인합니다.
  2. https://github.com/Azure-Samples/msdocs-app-service-sqldb-dotnetcore으로 이동합니다.
  3. 포크를 선택합니다.
  4. 포크 만들기를 선택합니다.

A screenshot showing how to create a fork of the sample GitHub repository.

2단계: App Service 페이지의 왼쪽 메뉴에서 배포 센터를 선택합니다.

A screenshot showing how to open the deployment center in App Service.

3단계: 배포 센터 페이지에서:

  1. 원본에서 GitHub를 선택합니다. 기본적으로 GitHub Actions이 빌드 공급자로 선택됩니다.
  2. GitHub 계정에 로그인하고 프롬프트에 따라 Azure를 인증합니다.
  3. 조직에서 계정을 선택합니다.
  4. 리포지토리에서 msdocs-app-service-sqldb-dotnetcore를 선택합니다.
  5. 분기에서 기본을 선택합니다.
  6. 상단 메뉴에서 저장을 선택합니다. App Service는 .github/workflows 디렉터리의 선택한 GitHub 리포지토리에 워크플로 파일을 커밋합니다.

A screenshot showing how to configure CI/CD using GitHub Actions.

4단계: 포크된 샘플의 GitHub 페이지로 돌아가서 . 키를 눌러 브라우저에서 Visual Studio Code를 엽니다.

A screenshot showing how to open the Visual Studio Code browser experience in GitHub.

5단계: 브라우저의 Visual Studio Code에서:

  1. 탐색기에서 DotNetCoreSqlDb/appsettings.json을 엽니다.
  2. 이전에 App Service에서 만든 연결 문자열과 일치하는 연결 문자열 이름 MyDbConnection을 AZURE_SQL_CONNECTIONSTRING으로 변경합니다.

A screenshot showing connection string name changed in appsettings.json.

6단계:

  1. 탐색기에서 DotNetCoreSqlDb/Program.cs를 엽니다.
  2. options.UseSqlServer 메서드에서 연결 문자열 이름 MyDbConnection을 AZURE_SQL_CONNECTIONSTRING으로 변경합니다. 여기서 연결 문자열은 샘플 애플리케이션에서 사용됩니다.
  3. builder.Services.AddDistributedMemoryCache(); 메서드를 제거하고 다음 코드로 바꿉니다. 코드를 메모리 내 캐시 사용에서 Azure의 Redis 캐시 사용으로 변경되며, 이전의 AZURE_REDIS_CONNECTIONSTRING을 사용하여 이를 수행합니다.
builder.Services.AddStackExchangeRedisCache(options =>
{
options.Configuration = builder.Configuration["AZURE_REDIS_CONNECTIONSTRING"];
options.InstanceName = "SampleInstance";
});

A screenshot showing connection string name changed in Program.cs.

7단계:

  1. 탐색기에서 .github/workflows/main_msdocs-core-sql-XYZ를 엽니다. 이 파일은 App Service 만들기 마법사에서 만들어졌습니다.
  2. dotnet publish 단계에서 dotnet tool install -g dotnet-ef --version 7.0.14 명령을 사용하여 Entity Framework Core 도구 설치 단계를 추가합니다.
  3. 새 단계에서 dotnet ef migrations bundle --runtime linux-x64 -p DotNetCoreSqlDb/DotNetCoreSqlDb.csproj -o ${{env.DOTNET_ROOT}}/myapp/migrate 배포 패키지에 데이터베이스 마이그레이션 번들을 생성하는 또 다른 단계를 추가합니다. 마이그레이션 번들은 .NET SDK 없이 프로덕션 환경에서 실행할 수 있는 자체 포함 실행 파일입니다. App Service Linux 컨테이너에는 .NET 런타임만 있고 .NET SDK는 없습니다.

A screenshot showing steps added to the GitHub workflow file for database migration bundle.

8단계:

  1. 원본 제어 확장을 선택합니다.
  2. 텍스트 상자에 Configure DB & Redis & add migration bundle 같은 커밋 메시지를 입력합니다.
  3. 커밋 및 푸시를 선택합니다.

A screenshot showing the changes being committed and pushed to GitHub.

9단계: Azure Portal의 배포 센터 페이지로 돌아갑니다.

  1. 로그를 선택합니다. 커밋된 변경 내용에서 새 배포 실행이 이미 시작되었습니다.
  2. 배포 실행에 대한 로그 항목에서 최신 타임스탬프를 사용하여 로그 빌드/배포 항목을 선택합니다.

A screenshot showing how to open deployment logs in the deployment center.

10단계: GitHub 리포지토리로 이동하고 GitHub 작업이 실행 중인지 확인합니다. 워크플로 파일은 빌드 및 배포라는 두 가지 개별 단계를 정의합니다. GitHub 실행이 완료 상태를 표시할 때까지 기다립니다. 이 작업에는 몇 분이 걸릴 수 있습니다.

A screenshot showing a GitHub run in progress.

4. 데이터베이스 스키마 생성

가상 네트워크로 보호되는 SQL Database를 사용하면 dotnet 데이터베이스 마이그레이션을 실행하는 가장 쉬운 방법은 App Service 컨테이너를 사용하는 SSH 세션에 있습니다.

1단계: App Service 페이지로 돌아가서 왼쪽 메뉴에서 SSH를 선택합니다.

A screenshot showing how to open the SSH shell for your app from the Azure portal.

2단계: SSH 터미널에서:

  1. cd /home/site/wwwroot를 실행합니다. 여기에 배포된 모든 파일이 있습니다.
  2. ./migrate를 사용하여 GitHub 워크플로에서 생성된 마이그레이션 번들을 실행합니다. 성공하면 App Service가 SQL Database에 성공적으로 연결됩니다. /home의 파일에 대한 변경 내용만 앱을 다시 시작한 후에도 유지될 수 있습니다. /home 외의 변경 내용은 유지되지 않습니다.

A screenshot showing the commands to run in the SSH shell and their output.

5. 앱으로 이동

1단계: App Service 페이지에서:

  1. 왼쪽 메뉴에서 개요를 선택합니다.
  2. 앱의 URL을 선택합니다. https://<app-name>.azurewebsites.net으로 직접 이동할 수도 있습니다.

A screenshot showing how to launch an App Service from the Azure portal.

2단계: 목록에 몇 가지 작업을 추가합니다. 축하합니다! Azure App Service에서 보안 데이터 기반 ASP.NET Core 앱을 실행하고 있습니다.

A screenshot of the .NET Core app running in App Service.

팁

샘플 애플리케이션은 캐시 배제 패턴을 구현합니다. 두 번째로 데이터 뷰를 방문하거나 데이터를 변경한 후 동일한 페이지를 다시 로드하는 경우 웹 페이지의 처리 시간은 데이터베이스 대신 캐시에서 데이터를 로드하기 때문에 훨씬 더 빠른 시간을 보여줍니다.

6. 진단 로그 스트림

Azure App Service는 애플리케이션 문제를 진단하는 데 도움이 되도록 콘솔에 기록된 모든 메시지를 캡처합니다. 샘플 앱은 각 엔드포인트에 콘솔 로그 메시지를 출력하여 이 기능을 보여 줍니다.

1단계: App Service 페이지에서:

  1. 왼쪽 메뉴에서 App Service 로그를 선택합니다.
  2. 애플리케이션 로깅에서 파일 시스템을 선택합니다.

A screenshot showing how to enable native logs in App Service in the Azure portal.

2단계: 왼쪽 메뉴에서 로그 스트림을 선택합니다. 플랫폼 로그 및 컨테이너 내부의 로그를 포함하여 앱에 대한 로그가 표시됩니다.

A screenshot showing how to view the log stream in the Azure portal.

7. 리소스 정리

완료되면 리소스 그룹을 삭제하여 Azure 구독에서 모든 리소스를 삭제할 수 있습니다.

1단계: Azure Portal 상단의 검색 창에서:

  1. 리소스 그룹 이름을 입력합니다.
  2. 리소스 그룹을 선택합니다.

A screenshot showing how to search for and navigate to a resource group in the Azure portal.

2단계: 리소스 그룹 페이지에서 리소스 그룹 삭제를 선택합니다.

A screenshot showing the location of the Delete Resource Group button in the Azure portal.

3단계:

  1. 리소스 그룹 이름을 입력하여 삭제를 확인합니다.
  2. 삭제를 선택합니다.

A screenshot of the confirmation dialog for deleting a resource group in the Azure portal. :

자주 묻는 질문

이 설정 비용은 얼마인가요?

리소스 만들기 가격 책정은 다음과 같습니다.

  • App Service 요금제는 Basic 계층에서 만들어지며 스케일 업 또는 스케일 다운할 수 있습니다. App Service 가격 책정을 참조하세요.
  • Azure SQL Database는 최소한의 코어가 있는 표준 시리즈 하드웨어에서 범용 서버리스 계층으로 만들어집니다. 비용이 적게 들고 다른 지역에 배포할 수 있습니다. 최대 크기를 줄여 비용을 훨씬 더 줄일 수도 있고 서비스 계층, 컴퓨팅 계층, 하드웨어 구성, 코어 수, 데이터베이스 크기, 영역 중복을 조정하여 스케일 업할 수도 있습니다. Azure SQL Database 가격 책정을 참조하세요.
  • Azure Cache for Redis는 최소 캐시 크기로 기본 계층에서 만들어집니다. 이 계층에는 약간의 비용이 듭니다. 더 높은 가용성, 클러스터링 및 기타 기능을 위해 더 높은 성능 계층으로 크기 조정할 수 있습니다. Azure Cache for Redis 가격 책정을 참조하세요.
  • 피어링과 같은 추가 기능을 구성하지 않는 한 가상 네트워크에는 요금이 발생하지 않습니다. Azure Virtual Network 가격 책정을 참조하세요.
  • 프라이빗 DNS 영역에는 약간의 요금이 청구됩니다. Azure DNS 가격 책정을 참조하세요.

다른 도구를 사용하여 가상 네트워크 뒤에서 보호되는 Azure SQL Database 서버에 연결하려면 어떻게 할까요?

  • 명령줄 도구에서 기본 액세스의 경우 앱의 SSH 터미널에서 sqlcmd을 실행할 수 있습니다. 앱의 컨테이너는 sqlcmd와 함께 제공되지 않으므로 수동으로 설치해야 합니다. 설치된 클라이언트는 앱 다시 시작에서 유지되지 않습니다.
  • SQL Server Management Studio 클라이언트 또는 Visual Studio에서 연결하려면 컴퓨터가 가상 네트워크 내에 있어야 합니다. 예를 들어 서브넷 중 하나에 연결된 Azure VM이거나 Azure Virtual Network와 사이트 간 VPN 연결이 있는 온-프레미스 네트워크의 컴퓨터일 수 있습니다.

로컬 앱 개발은 GitHub Actions에서 어떻게 작동하나요?

App Service에서 자동 생성된 워크플로 파일을 예로 들면 각 git push는 새 빌드 및 배포 실행을 시작합니다. GitHub 리포지토리의 로컬 클론에서 원하는 업데이트를 GitHub로 푸시합니다. 예시:

git add .
git commit -m "<some-message>"
git push origin main

GitHub Actions 배포 중에 오류를 디버그하려면 어떻게 해야 하나요?

자동 생성된 GitHub 워크플로 파일에서 단계가 실패하는 경우 실패한 명령을 수정하여 자세한 출력을 생성해 보세요. 예를 들어 -v 옵션을 추가하여 dotnet 명령에서 더 많은 출력을 가져올 수 있습니다. 변경 내용을 커밋하고 푸시하여 App Service에 다른 배포를 트리거합니다.

다음 단계

사용자 지정 도메인 및 인증서를 사용하여 앱을 보호하는 방법을 알아보려면 다음 자습서로 이동합니다.

 사용자 지정 도메인 및 인증서를 사용하여 보호

또는 다른 리소스를 확인합니다.

자습서: 관리 ID를 사용하여 비밀 없이 App Service에서 SQL Database 커넥트

ASP.NET Core 앱 구성