Artifact Registry에 저장된 컨테이너 이미지를 Cloud Run에 배포할 수 있습니다. 또한 소스에서 Cloud Run으로 직접 배포할 수 있습니다. 여기에는 빌드한 소스의 컨테이너 이미지를 자동으로 만들고 이미지를 Artifact Registry에 저장하는 작업이 포함됩니다.
배포 시 필요한 권한
소스에서 배포
소스에서 배포하려면 빌드, 빌드된 컨테이너 이미지를 저장하고 배포하기 위한 권한이 있어야 합니다.
컨테이너 이미지 배포
Cloud Run에 배포하려면 배포하려는 이미지가 포함된 프로젝트 또는 저장소에 Artifact Registry 리더 역할 (roles/artifactregistry.reader)과 Cloud Run 배포 권한이 있어야 합니다.
저장소가 다른 프로젝트에 있는 경우 Cloud Run 서비스 에이전트에 Artifact Registry 리더 권한을 부여해야 합니다.
[[["이해하기 쉬움","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-09-04(UTC)"],[[["\u003cp\u003eCloud Run supports deploying container images from Artifact Registry, or directly from source code, automatically creating and storing the image in Artifact Registry.\u003c/p\u003e\n"],["\u003cp\u003eDeploying from source requires permissions to build, store, and deploy the built container image.\u003c/p\u003e\n"],["\u003cp\u003eDeploying container images requires the Artifact Registry Reader role and Cloud Run deployment permissions, potentially including permissions for the Cloud Run Service Agent if images are in a different project.\u003c/p\u003e\n"],["\u003cp\u003eCloud Run can automatically containerize local source code, push the image to a specified Artifact Registry repository, and deploy it, creating the repository if necessary and permissions are in place.\u003c/p\u003e\n"],["\u003cp\u003eContainer images can be deployed by tag or digest, and deploying a service for the first time will create an immutable revision that is bound to a specific digest.\u003c/p\u003e\n"]]],[],null,["# Deploying to Cloud Run\n\nYou can deploy a container image stored in Artifact Registry to\n[Cloud Run](/run/docs). You can also deploy directly from source to\nCloud Run, which includes automatically creating a container image for\nyour built source and storing the image in Artifact Registry.\n\nPermissions required to deploy\n------------------------------\n\nDeploying from source\n: To deploy from source, you must have\n [permissions](/run/docs/deploying-source-code#required_roles)\n to build, store the built container image, and deploy.\n\nDeploying container images\n\n: To deploy to Cloud Run, you must have the Artifact\n Registry Reader role (`roles/artifactregistry.reader`) on the project or\n repository containing the images you want to deploy and the\n Cloud Run\n [deployment permissions](/run/docs/deploying#required_roles).\n\n If your repositories are in a different project, you must grant\n Artifact Registry Reader permissions to the\n [Cloud Run Service Agent](/iam/docs/service-agents).\n\nDeploying from local source\n---------------------------\n\nFor [supported languages](/run/docs/deploying-source-code#supported),\nCloud Run can automatically:\n\n1. Containerize local source code.\n2. Push the container image to an Artifact Registry repository.\n3. Deploy the container image Cloud Run from the repository.\n\nCloud Run pushes and pulls images using the repository\n`cloud-run-source-deploy` in the region that you specify at deploy time.\nIf the repository does not exist, Cloud Run creates it for you if\nyour account has the required [permissions](/run/docs/deploying-source-code#permissions_required_to_deploy).\n\nFor details, see [Deploying from source code](/run/docs/deploying-source-code#permissions_required_to_deploy). You can also try the\n[Cloud Run quickstarts](/run/docs/quickstarts) for languages that\nsupport deploying from source code.\n\nDeploying container images\n--------------------------\n\nYou can deploy an image by [tag or digest](/artifact-registry/docs/docker/names#versions) that is stored in\nArtifact Registry.\n\nDeploying to a service for the first time creates its first revision. Note that\nrevisions are immutable. If you deploy from a container image tag, it will be\nresolved to a digest and the revision will always serve this particular digest.\n\nYou can deploy a container using the Google Cloud console or the `gcloud`\ncommand line. For instructions see, [Deploying container images](/run/docs/deploying)."]]
