.NET 시작하기

이 가이드는 Google Cloud에 적용되는 주요 앱 개발 개념을 배우려는 엔지니어 및 웹 개발자와 같이 클라우드에서 앱을 처음 빌드하는 사용자를 대상으로 합니다.

목표

비용

이 문서에서는 비용이 청구될 수 있는 Google Cloud구성요소를 사용합니다.

이 문서의 안내는 리소스 사용량이 Google Cloud의 항상 무료 등급 한도 내에서 유지되도록 작성되었습니다. 프로젝트 사용량을 기준으로 예상 비용을 산출하려면 가격 계산기를 사용하세요.

Google Cloud 신규 사용자는 무료 체험판을 사용할 수 있습니다.

이 문서에 설명된 태스크를 완료했으면 만든 리소스를 삭제하여 청구가 계속되는 것을 방지할 수 있습니다. 자세한 내용은 삭제를 참조하세요.

시작하기 전에

  1. Google Cloud 계정에 로그인합니다. Google Cloud를 처음 사용하는 경우 계정을 만들고 Google 제품의 실제 성능을 평가해 보세요. 신규 고객에게는 워크로드를 실행, 테스트, 배포하는 데 사용할 수 있는 $300의 무료 크레딧이 제공됩니다.
  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

  4. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  5. Verify that billing is enabled for your Google Cloud project.

  6. 기본 모드로 Firestore 데이터베이스를 만들려면 다음 단계를 완료하세요.
    1. Google Cloud 콘솔에서 Firestore 데이터베이스 만들기 페이지로 이동합니다.

      Firestore 데이터베이스 생성으로 이동

    2. Cloud Firestore 모드 선택 화면에서 기본 모드 선택을 클릭합니다.
    3. Firestore 데이터베이스의 위치를 선택합니다. 이 위치 설정은 Google Cloud 프로젝트의 기본 Google Cloud 리소스 위치 입니다. 이 위치는 위치 설정이 필요한 Google Cloud 프로젝트의 Google Cloud 서비스에 사용됩니다. 특히 기본 Cloud Storage 버킷 및 Cloud Run 앱에 사용됩니다.
    4. 데이터베이스 만들기를 클릭합니다.
  7. Cloud Run, Cloud Storage JSON, Cloud Logging, Error Reporting API를 사용 설정합니다.

    API 사용 설정에 필요한 역할

    API를 사용 설정하려면 serviceusage.services.enable 권한이 필요합니다. 프로젝트를 만든 경우 소유자 역할 (roles/owner)을 통해 이 권한이 이미 있을 수 있습니다. 그렇지 않으면 서비스 사용량 관리자 역할 (roles/serviceusage.serviceUsageAdmin)을 통해 이 권한을 얻을 수 있습니다. 역할을 부여하는 방법 알아보기

    API 사용 설정

  8. 샘플 저장소를 클론하고 Cloud Shell에서 샘플 애플리케이션을 엽니다.
    Cloud Shell로 이동

    Cloud Shell을 사용하면 브라우저에서 직접 명령줄을 통해 Google Cloud 리소스에 액세스할 수 있습니다.

  9. 저장소를 클론하라는 메시지가 표시되면 확인을 클릭합니다.
  10. 새 Google Cloud 프로젝트를 사용하도록 Cloud Shell에서 gcloud 도구를 구성합니다.

    # Configure gcloud for your project
    gcloud config set project PROJECT_ID

    PROJECT_ID를 Google Cloud 콘솔을 사용하여 만든 Google Cloud 프로젝트 ID로 바꿉니다.

    Google Cloud CLI는 명령줄에서 Google Cloud 리소스와 상호작용하는 주요 수단입니다. 이 튜토리얼에서는 gcloud 도구를 사용하여 앱을 배포하고 모니터링합니다.

앱 실행

  1. 앱을 실행합니다.
    GOOGLE_CLOUD_PROJECT=PROJECT_ID dotnet run
    
    PROJECT_ID를 생성한 Google Cloud 프로젝트 ID로 바꿉니다.
  2. Cloud Shell에서 웹 미리보기를 클릭하고, 포트 8080에서 미리보기를 선택합니다. 그러면 실행 중인 앱이 표시된 새 창이 열립니다.

Cloud Run에 앱 배포

Google Cloud 는 코드를 실행하기 위한 몇 가지 옵션을 제공합니다. 이 예시에서는 Cloud Run을 사용하여 확장 가능한 앱을 Google Cloud에 배포합니다. Cloud Run을 사용하면 서버를 관리할 필요가 없어 코드 작성에 집중할 수 있습니다. 또한 Cloud Run은 트래픽 급증에 대응하기 위해 자동으로 확장됩니다.

Dockerfile에서는 Cloud Run에 앱 실행 방법을 알려줍니다.

FROM mcr.microsoft.com/dotnet/core/aspnet:2.1
COPY . /app