이 가이드는 Google Cloud에 적용되는 주요 앱 개발 개념을 배우려는 엔지니어 및 웹 개발자와 같이 클라우드에서 앱을 처음 빌드하는 사용자를 대상으로 합니다.
목표
- Google Cloud 콘솔 및
gcloud과 같은 기본 Google Cloud 도구를 학습합니다. - Cloud Run에 앱을 배포합니다.
- Firestore로 데이터를 유지합니다.
- Cloud Storage에 파일 업로드를 저장합니다.
- Google Cloud Observability를 사용하여 앱을 모니터링합니다.
비용
이 문서에서는 비용이 청구될 수 있는 Google Cloud구성요소를 사용합니다.
이 문서의 안내는 리소스 사용량이 Google Cloud의 항상 무료 등급 한도 내에서 유지되도록 작성되었습니다.
프로젝트 사용량을 기준으로 예상 비용을 산출하려면 가격 계산기를 사용하세요.
이 문서에 설명된 태스크를 완료했으면 만든 리소스를 삭제하여 청구가 계속되는 것을 방지할 수 있습니다. 자세한 내용은 삭제를 참조하세요.
시작하기 전에
- Google Cloud 계정에 로그인합니다. Google Cloud를 처음 사용하는 경우 계정을 만들고 Google 제품의 실제 성능을 평가해 보세요. 신규 고객에게는 워크로드를 실행, 테스트, 배포하는 데 사용할 수 있는 $300의 무료 크레딧이 제공됩니다.
-
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 theresourcemanager.projects.createpermission. Learn how to grant roles.
-
Verify that billing is enabled for your Google Cloud project.
-
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 theresourcemanager.projects.createpermission. Learn how to grant roles.
-
Verify that billing is enabled for your Google Cloud project.
-
기본 모드로 Firestore 데이터베이스를 만들려면 다음 단계를 완료하세요.
-
Google Cloud 콘솔에서 Firestore 데이터베이스 만들기 페이지로 이동합니다.
- Cloud Firestore 모드 선택 화면에서 기본 모드 선택을 클릭합니다.
- Firestore 데이터베이스의 위치를 선택합니다. 이 위치 설정은 Google Cloud 프로젝트의 기본 Google Cloud 리소스 위치 입니다. 이 위치는 위치 설정이 필요한 Google Cloud 프로젝트의 Google Cloud 서비스에 사용됩니다. 특히 기본 Cloud Storage 버킷 및 Cloud Run 앱에 사용됩니다.
- 데이터베이스 만들기를 클릭합니다.
-
Google Cloud 콘솔에서 Firestore 데이터베이스 만들기 페이지로 이동합니다.
-
Cloud Run, Cloud Storage JSON, Cloud Logging, Error Reporting API를 사용 설정합니다.
API 사용 설정에 필요한 역할
API를 사용 설정하려면
serviceusage.services.enable권한이 필요합니다. 프로젝트를 만든 경우 소유자 역할 (roles/owner)을 통해 이 권한이 이미 있을 수 있습니다. 그렇지 않으면 서비스 사용량 관리자 역할 (roles/serviceusage.serviceUsageAdmin)을 통해 이 권한을 얻을 수 있습니다. 역할을 부여하는 방법 알아보기 -
샘플 저장소를 클론하고 Cloud Shell에서 샘플 애플리케이션을 엽니다.
Cloud Shell로 이동Cloud Shell을 사용하면 브라우저에서 직접 명령줄을 통해 Google Cloud 리소스에 액세스할 수 있습니다.
- 저장소를 클론하라는 메시지가 표시되면 확인을 클릭합니다.
-
새 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도구를 사용하여 앱을 배포하고 모니터링합니다.
앱 실행
-
앱을 실행합니다.
GOOGLE_CLOUD_PROJECT=PROJECT_ID dotnet run
PROJECT_ID를 생성한 Google Cloud 프로젝트 ID로 바꿉니다. - Cloud Shell에서 웹 미리보기를 클릭하고, 포트 8080에서 미리보기를 선택합니다. 그러면 실행 중인 앱이 표시된 새 창이 열립니다.
Cloud Run에 앱 배포
Google Cloud 는 코드를 실행하기 위한 몇 가지 옵션을 제공합니다. 이 예시에서는 Cloud Run을 사용하여 확장 가능한 앱을 Google Cloud에 배포합니다. Cloud Run을 사용하면 서버를 관리할 필요가 없어 코드 작성에 집중할 수 있습니다. 또한 Cloud Run은 트래픽 급증에 대응하기 위해 자동으로 확장됩니다.
Dockerfile에서는 Cloud Run에 앱 실행 방법을 알려줍니다.