App Engine 가변형 환경에서 .NET 앱 만들기

리전 ID

REGION_ID는 앱을 만들 때 선택한 리전을 기준으로 Google에서 할당하는 축약된 코드입니다. 일부 리전 ID는 일반적으로 사용되는 국가 및 주/도 코드와 비슷하게 표시될 수 있지만 코드는 국가 또는 주/도와 일치하지 않습니다. 2020년 2월 이후에 생성된 앱의 경우 REGION_ID.r이 App Engine URL에 포함됩니다. 이 날짜 이전에 만든 기존 앱의 경우 URL에서 리전 ID는 선택사항입니다.

리전 ID에 대해 자세히 알아보세요.

이 빠른 시작에서는 짧은 메시지를 표시하는 앱을 만들고 배포하는 방법을 보여줍니다. 샘플 애플리케이션은 사용 가능한 최신 LTS .NET 버전을 사용합니다.

.NET 버전 6 이상의 경우 app.yaml 파일에 runtime_version 설정을 포함하여 런타임 버전을 지정할 수 있습니다. runtime_version 설정을 지정하지 않으면 기본적으로 사용 가능한 최신 LTS .NET 버전이 사용됩니다. 다양한 구성 옵션은 .NET 런타임을 참조하세요.

.NET 버전 3.1 이하의 코드 샘플은 GitHub에서 제공됩니다.

시작하기 전에

  1. Google Cloud 계정에 로그인합니다. Google Cloud를 처음 사용하는 경우 계정을 만들고 Google 제품의 실제 성능을 평가해 보세요. 신규 고객에게는 워크로드를 실행, 테스트, 배포하는 데 사용할 수 있는 $300의 무료 크레딧이 제공됩니다.
  2. Google Cloud Console의 프로젝트 선택기 페이지에서 Google Cloud 프로젝트를 선택하거나 만듭니다.

    프로젝트 선택기로 이동

  3. Google Cloud 프로젝트에 결제가 사용 설정되어 있는지 확인합니다.

  4. Cloud Build API 사용 설정

    API 사용 설정

  5. Google Cloud CLI를 설치합니다.
  6. gcloud CLI를 초기화하려면 다음 명령어를 실행합니다.

    gcloud init
  7. Google Cloud Console의 프로젝트 선택기 페이지에서 Google Cloud 프로젝트를 선택하거나 만듭니다.

    프로젝트 선택기로 이동

  8. Google Cloud 프로젝트에 결제가 사용 설정되어 있는지 확인합니다.

  9. Cloud Build API 사용 설정

    API 사용 설정

  10. Google Cloud CLI를 설치합니다.
  11. gcloud CLI를 초기화하려면 다음 명령어를 실행합니다.

    gcloud init

추가 기본 요건

  1. 프로젝트로 App Engine 앱을 초기화하고 리전을 선택합니다.

    gcloud app create --project=[YOUR_PROJECT_ID]
    

    메시지가 표시되면 App Engine 애플리케이션을 위치할 리전을 선택합니다.

  2. 다음 기본 요건을 설치합니다.

    • .NET Core SDK, LTS 버전을 설치합니다.

    • Visual Studio를 사용하는 경우, 2015 이상 버전을 사용해야 합니다. .NET Core 1.0, 1.1, 2.0, 2.1용으로 작성된 ASP.NET Core 앱의 이미지가 제공됩니다.

    • Visual Studio에서 App Engine으로 직접 배포하려면 Visual Studio용 Tools를 설치합니다.

App Engine 위치

App Engine은 리전을 기반으로 합니다. 즉, 앱을 실행하는 인프라가 특정 리전에 위치해 있으며 해당 리전 내의 모든 영역에서 중복으로 사용할 수 있도록 Google이 관리합니다.

앱을 실행하는 리전을 선택하는 데 있어 중요한 기준은 지연 시간, 가용성 또는 내구성 요구사항입니다. 일반적으로 앱 사용자와 가장 가까운 리전을 선택할 수 있지만 App Engine을 사용할 수 있는 위치와 앱에서 사용하는 다른 Google Cloud 제품 및 서비스의 위치도 고려해야 합니다. 여러 위치에서 서비스를 사용하면 앱의 지연 시간과 가격 책정에 영향을 미칠 수 있습니다.

앱의 리전을 설정한 후에는 변경할 수 없습니다.

App Engine 애플리케이션을 이미 만든 경우 다음 중 한 가지 방법으로 해당 리전을 볼 수 있습니다.

이 빠른 시작에서는 C#으로 웹 애플리케이션을 빌드하는 데 익숙하다고 가정합니다.

Hello World 앱 다운로드

간단한 App Engine용 Hello World 앱을 만들어 Google Cloud에 앱을 배포해 보겠습니다. Hello World 앱은 빈 ASP.NET Core 앱 생성 시 Visual Studio에서 생성되는 앱과 유사합니다. 샘플 앱에서는 app.yaml 파일이 추가됩니다. app.yaml 파일은 런타임 및 기타 App Engine 설정을 지정하는 App Engine 구성 파일입니다.

  1. Hello World 샘플 앱 저장소를 로컬 머신에 클론합니다.

    git clone https://github.com/GoogleCloudPlatform/dotnet-docs-samples
    

    또는 zip 파일로 샘플을 다운로드하고 압축을 풉니다.

  2. 샘플 코드가 있는 디렉터리로 변경합니다.

       cd dotnet-docs-samples/appengine/flexible/HelloWorld
    

로컬 머신에서 Hello World 실행

  1. dotnet-docs-samples/appengine/flexible/HelloWorld/HelloWorld.Sample 디렉터리에서 다음 명령어를 실행합니다.

    dotnet restore
    dotnet run
    
  2. 웹브라우저에서 http://localhost:5000으로 이동합니다. 이 페이지에 표시된 샘플 앱에서 "Hello World" 메시지를 볼 수 있습니다. 터미널 창에서 Ctrl+C를 눌러 웹 서버를 종료합니다.

App Engine에서 Hello World 배포 및 실행

  1. 명령줄에서 gcloud app deploy를 실행합니다.
  2. 브라우저를 실행하고 다음 위치에서 앱을 확인합니다. https://PROJECT_ID.REGION_ID.r.appspot.com gcloud app browse

이 경우, App Engine 인스턴스에서 실행 중인 웹 서버가 Hello World 메시지가 표시된 페이지를 제공합니다.

수고하셨습니다. App Engine 가변형 환경에 첫 번째 App Engine 앱을 배포했습니다.

애플리케이션을 배포하는 중에 오류가 발생했으면 문제 해결 팁을 확인하세요.

삭제 방법과 진행 가능한 다음 단계의 링크는 아래 섹션을 참조하세요.

삭제

Google Cloud 프로젝트를 삭제하면 프로젝트 내에서 사용되는 모든 리소스에 대한 결제를 중지하여 비용 청구를 방지할 수 있습니다.

  1. Google Cloud 콘솔에서 리소스 관리 페이지로 이동합니다.

    리소스 관리로 이동

  2. 프로젝트 목록에서 삭제할 프로젝트를 선택하고 삭제를 클릭합니다.
  3. 대화상자에서 프로젝트 ID를 입력한 후 종료를 클릭하여 프로젝트를 삭제합니다.

다음 단계

전체 플랫폼 알아보기

이제 App Engine 앱을 개발하고 배포하는 방법을 알아보았으므로 Google Cloud의 나머지 부분을 살펴볼 차례입니다. Google Cloud CLI가 이미 설치되어 있으므로 Cloud SQL, Cloud Storage, Firestore 등의 다양한 제품과 상호작용하는 도구가 제공됩니다.

App Engine 가변형 환경 알아보기

다음 항목을 통해 App Engine에 대해 더 알아볼 수 있습니다.

Hello World 코드 검토

Hello World는 가장 간단한 App Engine 앱으로, 한 가지 서비스만을 포함하고 버전도 하나뿐이며 모든 코드가 앱의 루트 디렉터리에 있습니다. 이 섹션은 각 앱 파일을 자세히 설명합니다.

Program.cs

Hello World 앱은 간단한 ASP.NET 앱입니다.

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

app.MapGet("/", () => builder.Configuration["My:Greeting"]);

app.Run();

app.yaml

app.yaml 파일은 앱의 다음 구성을 설명합니다.

  • env: flex를 설정하여 앱에서 App Engine 가변형 환경을 사용함을 나타냅니다.
  • 앱에서 사용하는 런타임을 지정합니다.

    runtime: aspnetcore
    env: flex
    
    runtime_config:
      operating_system: ubuntu22
    
    # This sample incurs costs to run on the App Engine flexible environment.
    # The settings below are to reduce costs during testing and are not appropriate
    # for production use. For more information, see:
    # https://cloud.google.com/appengine/docs/flexible/dotnet/configuring-your-app-with-app-yaml
    manual_scaling:
      instances: 1
    resources:
      cpu: 1
      memory_gb: 0.5
      disk_size_gb: 10
    
    env_variables:
      # The __ in My__Greeting will be translated to a : by ASP.NET.
      My__Greeting: Hello AppEngine!
    
    • .NET 런타임의 작동 방식에 대한 자세한 내용은 .NET 런타임을 참조하세요.

    • 버전과 서비스를 활용할 수 있도록 앱을 설계하는 방법에 대한 자세한 내용은 App Engine 개요를 참조하세요.

    • App Engine 구성 설정에 대한 자세한 내용은 app.yaml로 앱 구성을 참조하세요.