Cloud Run은 요청 또는 이벤트를 통해 호출 가능한 컨테이너를 실행할 수 있는 완전 관리형 애플리케이션 플랫폼입니다.
Cloud Run은 서버리스이므로 인프라 관리가 필요 없습니다. 따라서 개발자가 본연의 업무인 애플리케이션 개발에 집중할 수 있습니다. 자세히 알아보기
무료 크레딧 $300로 개념 증명 시작
-
Gemini 2.0 Flash Thinking 이용
-
AI API 및 BigQuery를 포함하여 인기 제품 월별 무료 사용량
-
자동 청구, 약정 없음
무료 제품 혜택 보기
20개가 넘는 항상 무료 제품을 계속 살펴보기
AI API, VM, 데이터 웨어하우스 등 일반적인 사용 사례에 20개가 넘는 무료 제품을 사용할 수 있습니다.
학습
교육 및 튜토리얼
Cloud Run을 사용한 Pub/Sub
Pub/Sub 푸시 구독에서 Cloud Run 서비스를 작성, 배포, 호출하는 방법을 알아보세요.
학습
교육 및 튜토리얼
Cloud Storage에서 이미지 처리 튜토리얼
Cloud Run, Cloud Vision API, ImageMagick을 사용해 Cloud Storage 버킷에 업로드된 불쾌감을 주는 이미지를 감지하여 흐리게 처리합니다.
학습
교육 및 튜토리얼
Cloud Run 서비스 보안 튜토리얼
Cloud Run에서 실행되는 보안 이중 서비스 애플리케이션을 만듭니다. 이 애플리케이션은 누구나 마크다운 텍스트를 작성하기 위해 사용할 수 있는 공개 '프런트엔드' 서비스와 마크다운 텍스트를 HTML로 렌더링하는 비공개 '백엔드' 서비스가 포함된 마크다운 편집기입니다.
학습
교육 및 튜토리얼
Cloud Run 서비스의 로컬 문제 해결
Google Cloud Observability 도구를 사용하여 검색하고 로컬 개발 워크플로를 통해 조사하여 Cloud Run 서비스의 문제를 해결합니다. 이 튜토리얼은 배포 시 런타임 오류가 발생하는 샘플 프로젝트를 사용하여 문제를 찾고 해결합니다.
학습
교육 및 튜토리얼
Gemma 3 및 Ollama를 사용하여 Cloud Run GPU에서 LLM 추론 실행
GPU 지원 Cloud Run 서비스에 Google의 Gemma 3를 배포하는 방법을 알아봅니다.
학습
교육 및 튜토리얼
Hello Cloud Run
이 실습의 목표는 컨테이너 이미지를 빌드하여 Cloud Run에 배포하는 것입니다. 이 실습에서는 스테이트리스(Stateless) 컨테이너를 배포하고 실행하여 Cloud Run을 시작하는 방법을 알아봅니다.
star
star
star
star
star_half
45분
입문용
크레딧 5점
학습
교육 및 튜토리얼
Cloud Run 및 Pub/Sub을 사용하여 복원력이 우수한 비동기 시스템 구축
Google Cloud Run 서버리스 퀘스트의 실습에서는 각 실습의 가상 비즈니스 시나리오를 읽고 시나리오 속 인물들이 서버리스 솔루션을 구현하는 데 도움을 줄 것입니다.
star
star
star
star
star_half
1시간
입문용
크레딧 7점
사용 사례
사용 사례
웹 서비스: REST API 백엔드
최신 모바일 앱은 일반적으로 RESTful 백엔드 API를 사용하여 애플리케이션 데이터의 현재 보기를 제공하고 프런트엔드 개발팀과 백엔드 개발팀을 구분합니다. Cloud Run에서 실행하는 API 서비스를 사용하면 개발자들이 Cloud SQL이나 Firestore (NoSQL) 같은 관리형 데이터베이스에서 데이터를 안정적으로 유지할 수 있습니다. Cloud Run에 로그인하면 Cloud 데이터베이스에 저장된 앱-리소스 데이터에 대한 액세스 권한이 부여됩니다.
웹 서비스
API
Cloud SQL
Firestore
백엔드
사용 사례
사용 사례
웹 서비스: 백오피스 관리
백오피스를 관리하려면 문서와 스프레드시트, 그 밖의 커스텀 통합과 공급업체에서 제공하는 웹 애플리케이션 실행이 필요합니다. 컨테이너화된 내부 웹 애플리케이션을 Cloud Run에서 호스팅하면 언제든 필요할 때 애플리케이션을 사용할 수 있으며, 사용한 만큼만 비용이 청구됩니다.
웹 서비스
백오피스
관리
사용 사례
사용 사례
간단한 데이터가 도착하는 즉시 변환하여 구조화된 데이터로 저장하는 Cloud Run 데이터 처리 애플리케이션을 빌드하세요. Google Cloud 소스에서 변환을 트리거할 수 있습니다. .csv 파일이 만들어지면 이벤트가 발생한 후 Cloud Run 서비스로 전송됩니다. 이후 데이터가 추출되고 구조화되어 BigQuery 테이블에 저장됩니다.
웹 서비스
데이터 처리
정형 데이터
변환
사용 사례
사용 사례
자동화: 예약된 문서 생성
Cloud Run 서비스를 사용해 인보이스를 생성하려면 Cloud Scheduler로 월별 작업을 예약하세요. 커스텀 바이너리를 포함하는 컨테이너는 Cloud Run에 배포할 수 있으므로 LibreOffice 같은 PDF 생성 도구에서 서버리스로 실행할 수 있습니다. 따라서 인보이스를 생성할 때만 비용이 부과됩니다.
자동화
작업 예약
사용 사례
사용 사례
자동화: 웹훅을 사용한 비즈니스 워크플로
이벤트 기반 접근 방법을 사용하여 작업을 함께 연결하세요. Cloud Run은 필요에 따라 확장할 뿐만 아니라 웹훅 대상을 구현하고 요청의 형태로 이벤트를 푸시하며 이벤트를 수신 및 처리할 때만 비용이 부과됩니다. 적시에 대응하여 인프라에서 마이크로서비스를 트리거하는 서비스로 GitHub 또는 Slack에서 푸시하는 이벤트에 대응하거나 구매 완료, 작업 준비 완료, 알림 발생 시에 웹훅을 전송할 수 있습니다.
자동화
비즈니스 워크플로
웹훅
이벤트
사용 사례
사용 사례
Heroku의 Node.js 앱을 Cloud Run으로 마이그레이션
Heroku에서 실행 중인 Node.js 웹 앱을 Google Cloud의 Cloud Run으로 마이그레이션하는 방법을 알아봅니다. 이 튜토리얼은 Heroku의 앱을 Google Cloud의 관리형 서비스로 마이그레이션하려는 설계자와 제품 소유자를 대상으로 작성되었습니다.
Node.js
마이그레이션
사용 사례
사용 사례
Google Cloud의 .NET 애플리케이션을 위한 현대화 여정
이 문서에서는 모놀리식 애플리케이션의 일반적인 제한사항을 살펴보고 이를 현대화하기 위한 점진적이지만 구조화된 프로세스를 설명합니다. 이 문서는 Windows 및 .NET 에코시스템에 익숙하고 현대화에 대해 자세히 알아보기를 원하는 클라우드 설계자, 시스템 관리자, CTO를 대상으로 합니다.
.NET
현대화
마이그레이션
코드 샘플
코드 샘플
템플릿에서 Cloud Run 프로젝트 시작
Flask, Django, Node.js, Java, Go 템플릿을 비롯한 Intellij 내의 템플릿에서 앱을 시작합니다.
코드 샘플
코드 샘플
Node.js 샘플
HelloWorld, Pub/Sub, Cloud SQL 예시, 이미지 처리 등을 포함합니다.
코드 샘플
코드 샘플
Python 샘플
HelloWorld, Pub/Sub, Cloud SQL 예시를 포함합니다.
코드 샘플
코드 샘플
Go 샘플
HelloWorld, Pub/Sub, Cloud SQL 예시, 이미지 처리 등을 포함합니다.
코드 샘플
코드 샘플
자바 샘플
HelloWorld, Pub/Sub, Cloud SQL 예시, 이미지 처리 등을 포함합니다.
코드 샘플
코드 샘플
.NET HelloWorld
Cloud Run용 .Net 샘플
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-15(UTC)
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["이해하기 어려움","hardToUnderstand","thumb-down"],["잘못된 정보 또는 샘플 코드","incorrectInformationOrSampleCode","thumb-down"],["필요한 정보/샘플이 없음","missingTheInformationSamplesINeed","thumb-down"],["번역 문제","translationIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-07-15(UTC)"],[],[],null,["# Cloud Run documentation\n=======================\n\n[Read product documentation](/run/docs/overview/what-is-cloud-run)\nCloud Run is a fully managed application platform that lets you run\ncontainers that are invocable via requests or events.\nCloud Run is serverless: it abstracts away all\ninfrastructure management, so you can focus on what matters most---building\ngreat applications. [Learn more](/run/docs/overview/what-is-cloud-run).\n[Get started for free](https://console.cloud.google.com/freetrial) \n\n#### Start your proof of concept with $300 in free credit\n\n- Get access to Gemini 2.0 Flash Thinking\n- Free monthly usage of popular products, including AI APIs and BigQuery\n- No automatic charges, no commitment \n[View free product offers](/free/docs/free-cloud-features#free-tier) \n\n#### Keep exploring with 20+ always-free products\n\n\nAccess 20+ free products for common use cases, including AI APIs, VMs, data warehouses,\nand more.\n\nDocumentation resources\n-----------------------\n\nFind quickstarts and guides, review key references, and get help with common issues. \nformat_list_numbered\n\n### Guides\n\n-\n\n\n Quickstarts:\n [Service](/run/docs/quickstarts/deploy-container),\n\n [Job](/run/docs/quickstarts/jobs/create-execute),\n or\n [Function](/run/docs/quickstarts/functions/deploy-functions-console)\n\n\n-\n\n [Learn about the Cloud Run container runtime contract](/run/docs/container-contract)\n\n-\n\n [Deploy container images](/run/docs/deploying)\n\n-\n\n [Continuous deployment from Git](/run/docs/continuous-deployment-with-cloud-build)\n\n-\n\n [Deploy a function](/run/docs/deploy-functions)\n\n-\n\n [Map custom domains](/run/docs/mapping-custom-domains)\n\n-\n\n [Add authentication to Cloud Run apps](/run/docs/securing/identity-aware-proxy-cloud-run)\n\nfind_in_page\n\n### Reference\n\n-\n\n [gcloud commands](/sdk/gcloud/reference/run)\n\n-\n\n [Container runtime contract](/run/docs/reference/container-contract)\n\n-\n\n [IAM Roles](/run/docs/reference/iam/roles)\n\n-\n\n [Configuration options for Cloud Run services](/run/docs/configuring)\n\ninfo\n\n### Resources\n\n-\n\n [Pricing](/run/pricing)\n\n-\n\n [Release notes](/run/docs/release-notes)\n\n-\n\n [Locations](/run/docs/locations)\n\n-\n\n [Support](/run/docs/support)\n\nRelated resources\n-----------------\n\nTraining and tutorials \nUse cases \nCode samples \nExplore self-paced training, use cases, reference architectures, and code samples with examples of how to use and connect Google Cloud services. Training \nTraining and tutorials\n\n### Pub/Sub with Cloud Run\n\n\nLearn how to write, deploy, and call a Cloud Run service from a Pub/Sub push subscription.\n\n\n[Learn more](/run/docs/tutorials/pubsub) \nTraining \nTraining and tutorials\n\n### Processing images from Cloud Storage tutorial\n\n\nUse Cloud Run, Cloud Vision API, and ImageMagick to detect and blur offensive images uploaded to a Cloud Storage bucket.\n\n\n[Learn more](/run/docs/tutorials/image-processing) \nTraining \nTraining and tutorials\n\n### Securing Cloud Run services tutorial\n\n\nCreate a secure two-service application running on Cloud Run. This application is a Markdown editor which includes a public \"frontend\" service which anyone can use to compose markdown text, and a private \"backend\" service which renders Markdown text to HTML.\n\n\n[Learn more](/run/docs/tutorials/secure-services) \nTraining \nTraining and tutorials\n\n### Local troubleshooting of a Cloud Run service\n\n\nTroubleshoot a broken Cloud Run service using Google Cloud Observability tools for discovery and a local development workflow for investigation. This tutorial uses a sample project that results in runtime errors when deployed, which you troubleshoot to find and fix the problem.\n\n\n[Learn more](/run/docs/tutorials/local-troubleshooting) \nTraining \nTraining and tutorials\n\n### Run LLM inference on Cloud Run GPUs with Gemma 3 and Ollama\n\n\nLearn how to deploy Google's Gemma 3 on a GPU-enabled Cloud Run service.\n\n\n[Learn more](/run/docs/tutorials/gpu-gemma-with-ollama) \nTraining \nTraining and tutorials\n\n### Hello Cloud Run\n\n\nThe goal of this lab is for you to build a container image and deploying it to Cloud Run. In this lab, you'll learn how to get started with Cloud Run by deploying and running a stateless container.\n\n\nstar star star star star_half\n45 minutes introductory 5 credits\n\n\u003cbr /\u003e\n\n[Learn more\narrow_forward](https://www.cloudskillsboost.google/focuses/5162?parent=catalog) \nTraining \nTraining and tutorials\n\n### Build a Resilient, Asynchronous System with Cloud Run and Pub/Sub\n\n\nFor the labs in the Google Cloud Run Serverless Quest, you will read through a fictitious business scenario in each lab and assist the characters in implementing a serverless solution.\n\n\nstar star star star star_half\n1 hour introductory 7 credits\n\n\u003cbr /\u003e\n\n[Learn more\narrow_forward](https://www.cloudskillsboost.google/focuses/8389?parent=catalog) \nUse case \nUse cases\n\n### Web services: REST APIs backend\n\n\nModern mobile apps commonly rely on RESTful backend APIs to provide current views of application data and separation for frontend and backend development teams. API services running on Cloud Run allow developers to persist data reliably on managed databases such as Cloud SQL or Firestore (NoSQL). Logging in to Cloud Run grants users access to app‐resource data stored in Cloud Databases.\n\nWeb services API Cloud SQL Firestore backend\n\n\u003cbr /\u003e\n\n[Learn more](/run/docs/triggering/https-request) \nUse case \nUse cases\n\n### Web services: Back‐office administration\n\n\nBack‐office administration often requires documents, spreadsheets, and other custom integrations, and running a vendor‐supplied web application. Hosting the containerized internal web application on Cloud Run means it is always ready and you are only billed when it is used.\n\nWeb services back office administration\n\n\u003cbr /\u003e\n\n[Learn more](/run/docs/tutorials/identity-platform) \nUse case \nUse cases\n\n### Data processing: Lightweight data transformation\n\n\nBuild Cloud Run data processing applications that transform lightweight data as it arrives and store it as structured data. Transformations can be triggered from Google Cloud sources. When a .csv file is created, an event is fired and delivered to a Cloud Run service. Data is then extracted, structured, and stored in a BigQuery table.\n\nWeb services data processing structured data transformations\n\n\u003cbr /\u003e\n\n[Learn more](/run/docs/tutorials/image-processing) \nUse case \nUse cases\n\n### Automation: Scheduled document generation\n\n\nSchedule a monthly job with Cloud Scheduler to generate invoices using a Cloud Run service. Because containers containing custom binaries can be deployed to Cloud Run, it is able to run in a PDF generation tool like LibreOffice in a serverless way, which means only paying when you are generating invoices.\n\nAutomation job scheduling\n\n\u003cbr /\u003e\n\n[Learn more](/run/docs/triggering/using-scheduler) \nUse case \nUse cases\n\n### Automation: Business workflow with webhooks\n\n\nConnect your operations together with an event‐driven approach. Cloud Run scales on demand while implementing a webhook target, pushing events in the form of requests and only charging you when you receive and process the event. React to events from GitHub or Slack, or send webhooks when a purchase is made, a job is ready, or an alert is fired with a service that can react on a just‐in‐time basis to trigger a microservice in your infrastructure.\n\nAutomation business workflow webhooks events\n\n\u003cbr /\u003e\n\n[Learn more](/run/docs/triggering/webhooks) \nUse case \nUse cases\n\n### Migrating Node.js apps from Heroku to Cloud Run\n\n\nLearn how to migrate Node.js web apps that are running on Heroku to Cloud Run on Google Cloud. This tutorial is intended for architects and product owners who want to migrate their apps from Heroku to managed services on Google Cloud.\n\nNode.js Migration\n\n\u003cbr /\u003e\n\n[Learn more](/run/docs/migrate/migrating-nodejs-apps-from-heroku-to-cloud-run) \nUse case \nUse cases\n\n### Modernization path for .NET applications on Google Cloud\n\n\nThis document looks at the common limitations of monolithic applications and describes a gradual yet structured process for modernizing them. This document is intended for cloud architects, system administrators, and CTOs who are familiar with Windows and the .NET ecosystem and want to learn more about what modernization involves.\n\n.NET Modernization Migration\n\n\u003cbr /\u003e\n\n[Learn more](/solutions/modernization-path-dotnet-applications-google-cloud) \nCode sample \nCode Samples\n\n### Starting a Cloud Run project from a template\n\n\nStart your app from a template within Intellij, including Flask, Django, Node.js, Java, and Go templates.\n\n\n[Get started](/code/docs/intellij/creating-a-cloud-run-app) \nCode sample \nCode Samples\n\n### Node.js samples\n\n\nIncludes HelloWorld, Pub/Sub, Cloud SQL examples, image processing, and many others.\n\n\n[Open GitHub](https://github.com/GoogleCloudPlatform/nodejs-docs-samples/blob/master/run/helloworld/) \nCode sample \nCode Samples\n\n### Python samples\n\n\nIncludes HelloWorld, Pub/Sub, and Cloud SQL examples\n\n\n[Open GitHub](https://github.com/GoogleCloudPlatform/python-docs-samples/blob/master/run/) \nCode sample \nCode Samples\n\n### Go samples\n\n\nIncludes HelloWorld, Pub/Sub, Cloud SQL examples, image processing, and many others.\n\n\n[Open GitHub](https://github.com/GoogleCloudPlatform/golang-samples/tree/master/run/) \nCode sample \nCode Samples\n\n### Java samples\n\n\nIncludes HelloWorld, Pub/Sub, Cloud SQL examples, image processing, and many others.\n\n\n[Open GitHub](https://github.com/GoogleCloudPlatform/java-docs-samples/tree/master/run/) \nCode sample \nCode Samples\n\n### .Net HelloWorld\n\n\n.Net sample for Cloud Run\n\n\n[Open GitHub](https://github.com/GoogleCloudPlatform/dotnet-docs-samples/tree/main/run/helloworld)\n\nRelated videos\n--------------"]]