Cloud Run 함수 배포
이 가이드에서는 소스 코드에서 Cloud Run 함수를 배포하는 방법을 보여줍니다.
배포 프로세스는 소스 코드 및 구성 설정을 사용하여 Cloud Run Functions가 함수 요청을 처리하기 위해 자동으로 관리하는 실행 가능한 이미지를 빌드합니다.
배포 기본사항
Cloud Run 함수를 배포하는 사용자에게는 Cloud Functions 개발자 IAM 역할 또는 동일한 권한이 포함된 역할이 있어야 합니다. 또한 배포 추가 구성을 참조하세요.
-
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
gcloud functions deploy
명령어를 사용하여 함수를 배포합니다.gcloud functions deploy
YOUR_FUNCTION_NAME \ --gen2 \ --region=YOUR_REGION \ --runtime=YOUR_RUNTIME \ --source=YOUR_SOURCE_LOCATION \ --entry-point=YOUR_CODE_ENTRYPOINT \TRIGGER_FLAGS 첫 번째 인수인
YOUR_FUNCTION_NAME
은 배포된 함수의 이름입니다. 함수 이름은 문자로 시작해야 합니다. 이어서 최대 62자(영문 기준)의 문자, 숫자, 하이픈, 밑줄이 와야 하며 문자나 숫자로 끝나야 합니다. 함수용으로 생성된 Cloud Run 서비스의 이름은 밑줄이 하이픈으로 대체되고 대문자가 소문자로 변환됩니다. 예를 들어Function_1
에는 Cloud Run에서function-1
이라는 이름이 지정됩니다.--gen2
플래그(선택사항)는 Cloud Run 함수에 배포할 것임을 지정합니다.--region
플래그는 함수를 배포할 리전을 지정합니다. Cloud Run Functions에서 지원되는 리전 목록은 위치를 참조하세요.--runtime
플래그는 함수에 사용되는 언어 런타임을 지정합니다. Cloud Run Functions는 여러 런타임을 지원합니다. 자세한 내용은 런타임을 참조하세요.--source
플래그는 함수 소스 코드의 위치를 지정합니다. 자세한 내용은 다음 섹션을 참조하세요.--entry-point
플래그는 소스 코드에서 함수의 진입점을 지정합니다. 이것은 함수가 실행될 때 수행되는 코드입니다. 이 플래그의 값은 소스 코드에 있는 함수 이름 또는 정규화된 클래스 이름이어야 합니다. 자세한 내용은 함수 진입점을 참조하세요.사용자 함수에 대해 트리거를 지정하려면 사용하려는 트리거에 따라 추가 플래그(위에서
TRIGGER_FLAGS
로 표시됨)가 필요합니다.트리거 플래그 트리거 설명 --trigger-http
HTTP(S) 요청으로 함수를 트리거합니다. 자세한 내용은 HTTP 트리거를 참조하세요. --trigger-topic=YOUR_PUBSUB_TOPIC
지정된 Pub/Sub 주제에 메시지가 게시되면 함수를 트리거합니다. 자세한 내용은 Pub/Sub 트리거를 참조하세요. --trigger-bucket=YOUR_STORAGE_BUCKET
지정된 Cloud Storage 버킷에서 객체를 만들거나 덮어쓸 때 함수를 트리거합니다. 자세한 내용은 Cloud Storage 트리거를 참조하세요. --trigger-event-filters=EVENTARC_EVENT_FILTERS
지정된 필터와 일치하는 이벤트가 발생하면 Eventarc로 함수를 트리거합니다. 자세한 내용과 추가 옵션은 Eventarc 트리거를 참고하세요. 함수를 배포할 때 선택적으로 추가 구성, 네트워킹, 보안 옵션을 지정할 수 있습니다.
배포 명령어와 플래그에 대한 자세한 내용은
gcloud functions deploy
문서를 참조하세요.일부 배포 명령어 예시는 명령줄 예시를 참조하세요.
배포가 성공적으로 완료되면 Google Cloud 콘솔의 Cloud Run 개요 페이지에서 함수가 녹색 체크표시로 표시됩니다.
함수의 초기 배포에는 기본 인프라가 프로비저닝되는 동안 몇 분 정도 걸릴 수 있습니다. 기존 함수를 재배포하는 것이 더 빠르고 수신 트래픽이 최신 버전으로 자동으로 마이그레이션됩니다.
로컬 머신에서 배포
이 섹션에서는 로컬 머신에 있는 소스 코드에서 함수를 배포하는 방법을 설명합니다.
-
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
gcloud functions deploy
명령어를 사용하여 위 배포 안내를 따릅니다.--source
플래그의 경우 함수 소스 코드의 루트 디렉터리로 로컬 파일 시스템 경로를 지정합니다. 소스 디렉터리 구조를 참조하세요. 이 플래그를 생략하면 현재 작업 디렉터리가 사용됩니다.또한 선택적으로
--stage-bucket
플래그를 사용하여 배포 중 소스 코드를 업로드할 Cloud Storage 버킷을 지정할 수 있습니다.소스 코드를 업로드하는 동안 Cloud Run Functions는
.gcloudignore
파일을 통해 불필요한 파일을 제외합니다.
Cloud Storage에서 배포
이 섹션에서는 Cloud Storage 버킷에 있는 소스 코드에서 함수를 배포하는 방법을 설명합니다. 소스 코드는 ZIP 파일로 패키징해야 합니다.
Cloud Run Functions가 Cloud Storage 버킷에서 읽으려면 Cloud Run Functions 서비스 에이전트에 storage.objects.get
권한이 있어야 합니다. 소스 버킷이 함수와 동일한 프로젝트에 있으면 권한이 자동으로 부여됩니다. 버킷이 다른 프로젝트에 있으면 서비스 에이전트에 권한을 수동으로 부여해야 합니다.
버킷에 대한 액세스 제어에 대한 자세한 내용은 Cloud Storage 문서의 IAM 권한 사용을 참조하세요.
이제 이 권한을 사용하여 Cloud Storage에서 함수를 배포할 수 있습니다.
-
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
gcloud functions deploy
명령어를 사용하여 위 배포 안내를 따릅니다.--source
플래그의 경우gs://
로 시작하는 Cloud Storage 경로를 지정합니다. 경로의 객체는 함수 소스 코드를 포함하는 ZIP 파일이어야 합니다. 함수 소스 파일은 ZIP 파일의 루트에 있어야 합니다. 소스 디렉터리 구조를 참조하세요.
명령줄 예시
다음 섹션에서는 일부 배포 시나리오 예시의 배포 명령어를 보여줍니다.
Cloud Run Functions에서 지원되는 여러 트리거에 대한 자세한 내용은 Cloud Run Functions 트리거를 참조하세요.
로컬 소스 코드의 HTTP 함수
다음과 같이 HTTP 함수가 있다고 가정합니다.
- 함수에서
nodejs22
을 사용합니다. - 소스 코드는 현재 작업 디렉터리(
.
)에 있습니다. - 코드 진입점의 이름은
myHttpFunction
입니다.
us-central1
리전에 my-http-function
이름으로 함수를 배포하려면 다음 명령어를 사용합니다.
gcloud functions deploy my-http-function \
--gen2 \
--region=us-central1 \
--runtime=nodejs22 \
--source=. \
--entry-point=myHttpFunction \
--trigger-http
Cloud Storage 소스 코드의 Pub/Sub 함수
다음과 같은 이벤트 기반 함수가 있다고 가정해 보세요.
- 이 함수는 Pub/Sub 메시지 게시 이벤트를 처리합니다.
- 함수에서
python312
를 사용합니다. - 소스 코드는 Cloud Storage에서 다음 경로에 있습니다.
gs://my-bucket/my_function_source.zip
. - 코드 진입점의 이름은
pubsub_handler
입니다.
europe-west1
리전에 my-pubsub-function
이름으로 함수를 배포하고 Pub/Sub 주제 my-topic
에서 메시지로 함수를 트리거하려면 다음 명령어를 사용합니다.
gcloud functions deploy my-pubsub-function \
--gen2 \
--region=europe-west1 \
--runtime=python312 \
--source=gs://my-bucket/my_function_source.zip \
--entry-point=pubsub_handler \
--trigger-topic=my-topic
로컬 소스 코드의 Cloud Storage 함수
다음과 같은 이벤트 기반 함수가 있다고 가정해 보세요.
- 함수가 Cloud Storage 객체 삭제 이벤트를 처리합니다.
- 함수에서
java21
을 사용합니다. - 소스 코드는
./functions/storage-function
경로에 로컬로 있습니다. - 코드 진입점의 이름은
myproject.StorageFunction
입니다.
asia-northeast1
리전에 my-storage-function
이름으로 함수를 배포하고 Cloud Storage 버킷 my-bucket
에서 이벤트로 함수를 트리거하려면 다음 명령어를 사용합니다.
gcloud functions deploy my-storage-function \
--gen2 \
--region=asia-northeast1 \
--runtime=java21 \
--source=./functions/storage-function \
--entry-point=myproject.StorageFunction \
--trigger-event-filters="type=google.cloud.storage.object.v1.deleted" \
--trigger-event-filters="bucket=my-bucket"
다음 단계
- Cloud Run Functions 트리거 자세히 알아보기
- Cloud Run Functions 빌드 프로세스 알아보기
- 추가 Cloud Run Functions 구성 옵션 살펴보기
- Cloud Run Functions 보안 알아보기
- Cloud Run Functions의 특정 사용 사례 예시는 튜토리얼을 참조하세요.