함수 배포

이 가이드에서는 gcloud functions 명령어를 사용하여 소스 코드에서 함수를 배포하는 방법을 보여줍니다. gcloud run 명령어를 사용하여 함수를 배포하는 방법을 알아보려면 gcloud CLI를 사용하여 Cloud Run 함수 배포를 참조하세요.

배포 프로세스는 소스 코드 및 구성 설정을 사용하여 Cloud Run Functions가 함수 요청을 처리하기 위해 자동으로 관리하는 실행 가능한 이미지를 빌드합니다.

배포 기본사항

배포할 수 있는 함수 유형에 관한 소개는 Cloud Run Functions 작성을 참조하세요.

함수를 배포하는 사용자에게 Cloud Functions 개발자 IAM 역할 또는 동일한 권한이 포함된 역할이 있어야 합니다. 또한 배포 추가 구성을 참조하세요.

  1. In the Google Cloud console, activate Cloud Shell.

    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.

  2. gcloud functions deploy 명령어를 사용하여 함수를 배포합니다.

    gcloud functions deploy YOUR_FUNCTION_NAME \
   --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이라는 이름이 지정됩니다.

    • --region 플래그는 함수를 배포할 리전을 지정합니다. Cloud Run에서 지원되는 리전 목록은 위치를 참조하세요.

    • --runtime 플래그는 함수에 사용되는 언어 런타임을 지정합니다. 지원되는 런타임 ID 목록은 런타임 지원을 참조하세요.

    • --source 플래그는 함수 소스 코드의 위치를 지정합니다.

    • --entry-point 플래그는 소스 코드에서 함수의 진입점을 지정합니다. 이것은 함수가 실행될 때 수행되는 코드입니다. 이 플래그의 값은 소스 코드에 있는 함수 이름 또는 정규화된 클래스 이름이어야 합니다. 자세한 내용은 함수 진입점을 참조하세요.

    • 사용자 함수에 대해 트리거를 지정하려면 사용하려는 트리거에 따라 추가 플래그(위에서 TRIGGER_FLAGS로 표시됨)가 필요합니다.

      트리거 플래그 트리거 설명
      --trigger-http HTTP(S) 요청으로 함수를 트리거합니다.
      --trigger-topic=YOUR_PUBSUB_TOPIC 지정된 Pub/Sub 주제에 메시지가 게시되면 함수를 트리거합니다.
      --trigger-bucket=YOUR_STORAGE_BUCKET 지정된 Cloud Storage 버킷에서 객체를 만들거나 덮어쓸 때 함수를 트리거합니다.
      --trigger-event-filters=EVENTARC_EVENT_FILTERS 지정된 필터와 일치하는 이벤트가 발생하면 Eventarc로 함수를 트리거합니다.

      배포 명령어와 플래그에 대한 자세한 내용은 gcloud functions deploy 문서를 참조하세요.

      gcloud functions deploy 구성 플래그에 대한 자세한 내용은 Cloud Run 문서를 참조하세요.

    3. 배포가 성공적으로 완료되면 Google Cloud 콘솔의 Cloud Functions 개요 페이지에서 함수가 녹색 체크표시와 함께 표시됩니다.

    함수의 초기 배포에는 기본 인프라가 프로비저닝되는 동안 몇 분 정도 걸릴 수 있습니다. 기존 함수를 재배포하는 것이 더 빠르고 수신 트래픽이 최신 버전으로 자동으로 마이그레이션됩니다.

    HTTP 엔드포인트 URL

    gcloud functions 명령어 또는 Cloud Functions v2 API로 함수를 만들면 기본적으로 함수에 cloudfunctions.net HTTP 엔드포인트 URL이 있습니다. 이 함수를 가져와 Cloud Run에 배포하면 함수는 run.app HTTP 엔드포인트 URL도 수신합니다. 하지만 Cloud Run에서 생성된 함수에는 cloudfunctions.net HTTP 엔드포인트 URL이 없습니다. 함수의 cloudfunctions.net URL과 run.app URL은 동일한 방식으로 작동합니다. 이들은 서로 바꿔서 사용할 수 있으며 함수를 트리거하는 데 사용됩니다.

    Terraform 예시

    Terraform을 사용하여 함수를 배포하는 방법에 관한 예시는 Terraform HTTP 예시 및 Terraform Pub/Sub 예시를 참조하세요.

    네트워킹 구성

    Cloud Functions v2 API(예: gcloud functions, REST API 또는 Terraform 사용)를 사용하여 만든 함수를 Cloud Run Admin API 및 Cloud Functions v2 API로 관리할 수 있습니다.

    VPC 네트워크 트래픽 라우팅 방법을 비롯해 함수 네트워크 관리에 대해 자세히 알아보려면 Cloud Run 네트워킹 권장사항을 참조하세요.

    Cloud Run에서 Cloud Run Functions를 배포하는 방법 알아보기

    Cloud Run에 함수를 배포하는 것은 이 문서에 설명된 단계와 비슷하지만 다음과 같은 추가적인 장점이 있습니다.