Cloud 함수 배포

이 가이드에서는 소스 코드에서 Cloud 함수를 배포하는 방법을 보여줍니다.

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

배포 기본사항

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

gcloud CLI 또는 Google Cloud 콘솔을 사용하여 함수를 배포하는 방법에 대한 안내를 보려면 탭을 선택합니다.

gcloud

  1. Google Cloud 콘솔에서 Cloud Shell을 활성화합니다.

    Cloud Shell 활성화

    Google Cloud 콘솔 하단에서 Cloud Shell 세션이 시작되고 명령줄 프롬프트가 표시됩니다. Cloud Shell은 Google Cloud CLI가 사전 설치된 셸 환경으로, 현재 프로젝트의 값이 이미 설정되어 있습니다. 세션이 초기화되는 데 몇 초 정도 걸릴 수 있습니다.

  2. 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자(영문 기준)의 문자, 숫자, 하이픈, 밑줄이 와야 하며 문자나 숫자로 끝나야 합니다.

    • --gen2 플래그는 Cloud Functions(2세대)에 배포하도록 지정합니다. 이 플래그는 2세대 함수의 초기 배포에 필요합니다. Cloud Functions(1세대)와 Cloud Functions(2세대)에 대한 비교는 Cloud Functions 버전 비교를 참조하세요.

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

    • --runtime 플래그는 함수에 사용되는 언어 런타임을 지정합니다. Cloud 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 (2세대 전용) 지정된 트리거와 일치하는 이벤트가 발생하면 Eventarc로 함수를 트리거합니다. --gen2 플래그를 지정해야 합니다. 자세한 내용과 추가 옵션은 Eventarc 트리거를 참조하세요.
    --trigger-event=EVENT_TYPE
    [--trigger-resource=RESOURCE]
    (1세대만) 지정된 이벤트가 발생할 때 함수를 트리거합니다. 일부 이벤트 유형에는 리소스 지정이 필요합니다. 자세한 내용은 Cloud Functions(1세대)에서 지원되는 트리거를 참조하세요.

    함수를 배포할 때 선택적으로 추가 구성, 네트워킹, 보안 옵션을 지정할 수 있습니다.

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

    일부 배포 명령어 예시는 명령줄 예시를 참조하세요.

콘솔

  1. Google Cloud 콘솔에서 Cloud Functions 개요 페이지로 이동합니다.

    Cloud Functions로 이동

    Cloud Functions를 배포할 Google Cloud 프로젝트가 선택되어 있는지 확인합니다.

  2. 함수 만들기를 클릭합니다.

  3. 환경 필드에서 1세대 또는 2세대를 선택합니다. Cloud Functions(1세대) 및 Cloud Functions(2세대) 비교는 Cloud Functions 버전 비교를 참조하세요.

  4. 함수 이름 필드에 함수 이름을 입력합니다. 함수 이름은 문자로 시작해야 합니다. 이어서 최대 62자(영문 기준)의 문자, 숫자, 하이픈, 밑줄이 와야 하며 문자나 숫자로 끝나야 합니다.

  5. 리전 필드에서 함수를 배포하려는 리전을 선택합니다.

  6. 트리거 섹션에서 선택한 환경에 따라 단계를 수행합니다.

    • 1세대
      1. HTTPS 인증 섹션에서 함수에 대해 인증되지 않은 호출을 허용할지 여부에 따라 적합한 옵션을 선택합니다. 기본적으로 인증이 필요합니다. 자세한 내용은 호출 인증을 참조하세요.
      2. 트리거 유형 필드에서 트리거 유형을 선택합니다. 자세한 내용은 Cloud Functions(1세대)에서 지원되는 트리거를 참조하세요.
      3. 선택한 트리거 유형에 대해 추가 필드를 작성합니다.
      4. 저장을 클릭합니다.
    • 2세대
      1. 트리거 유형 필드에서 사용할 트리거를 선택합니다.
        • HTTPS 트리거의 경우 함수의 인증되지 않은 호출을 허용할지 여부에 따라 적합한 옵션을 선택합니다. 모든 2세대 함수에는 HTTP(S) 트리거 엔드포인트가 포함됩니다. 기본적으로 인증이 필요합니다. 자세한 내용은 호출 인증을 참조하세요.
        • 이벤트 기반 함수의 경우 Cloud Pub/Sub, Cloud Storage, Cloud Firestore, 기타 트리거 중 하나를 선택합니다. 자세한 내용은 Eventarc 트리거를 참조하세요.
        • 필수 필드를 작성했으면 트리거 저장을 클릭합니다.
  7. 선택사항으로, 페이지 끝에서 런타임, 빌드... 섹션을 확장하여 추가 구성보안 옵션을 확인합니다.

  8. 다음을 클릭하여 코드 단계로 이동합니다.

  9. 런타임 필드에서 함수에 사용되는 언어 런타임을 선택합니다. Cloud Functions는 여러 런타임을 지원합니다. 자세한 내용은 런타임을 참조하세요.

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

  11. 소스 코드 필드에서 함수 소스 코드 제공 방법에 적합한 옵션을 선택합니다. 자세한 내용은 다음 섹션을 참조하세요.

  12. 배포를 클릭합니다.

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

Cloud 콘솔에 배포된 함수

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

로컬 머신에서 배포

이 섹션에서는 로컬 머신에 있는 소스 코드에서 함수를 배포하는 방법을 설명합니다.

gcloud

  1. Google Cloud 콘솔에서 Cloud Shell을 활성화합니다.

    Cloud Shell 활성화

    Google Cloud 콘솔 하단에서 Cloud Shell 세션이 시작되고 명령줄 프롬프트가 표시됩니다. Cloud Shell은 Google Cloud CLI가 사전 설치된 셸 환경으로, 현재 프로젝트의 값이 이미 설정되어 있습니다. 세션이 초기화되는 데 몇 초 정도 걸릴 수 있습니다.

  2. gcloud functions deploy 명령어를 사용하여 위 배포 안내를 따릅니다.

    --source 플래그의 경우 함수 소스 코드의 루트 디렉터리로 로컬 파일 시스템 경로를 지정합니다. 소스 디렉터리 구조를 참조하세요. 이 플래그를 생략하면 현재 작업 디렉터리가 사용됩니다.

    또한 선택적으로 --stage-bucket 플래그를 사용하여 배포 중 소스 코드를 업로드할 Cloud Storage 버킷을 지정할 수 있습니다.

    소스 코드를 업로드하는 동안 Cloud Functions는 .gcloudignore 파일을 통해 불필요한 파일을 제외합니다.

콘솔

  1. 소스 코드 필드가 표시될 때까지 Google Cloud 콘솔을 사용하여 위 배포 안내를 따릅니다.
  2. 소스 코드 필드에서 ZIP 업로드를 선택합니다.
  3. 대상 버킷 필드에서 찾아보기를 클릭하여 배포 중 소스 코드를 업로드할 Cloud Storage 버킷을 선택합니다.
  4. ZIP 파일 필드에서 찾아보기를 클릭하여 로컬 파일 시스템에서 업로드할 ZIP 파일을 선택합니다. 함수 소스 파일은 ZIP 파일의 루트에 있어야 합니다. 소스 디렉터리 구조를 참조하세요.
  5. 배포를 클릭합니다.

Cloud Storage에서 배포

이 섹션에서는 Cloud Storage 버킷에 있는 소스 코드에서 함수를 배포하는 방법을 설명합니다. 소스 코드는 ZIP 파일로 패키징해야 합니다.

Cloud Functions가 Cloud Storage 버킷에서 읽을 수 있도록 하려면 배포 에이전트에 storage.objects.get 권한이 있는지 확인합니다.

  • Cloud Functions(1세대)에서는 배포를 수행하는 계정에 이 권한을 부여해야 합니다.
  • Cloud Functions(2세대)에서 Cloud Functions 서비스 에이전트는 이 권한이 필요합니다. 소스 버킷이 함수와 동일한 프로젝트에 있으면 자동으로 부여됩니다. 버킷이 다른 프로젝트에 있으면 서비스 에이전트에 수동으로 부여해야 합니다.

버킷에 대한 액세스 제어에 대한 자세한 내용은 Cloud Storage 문서의 IAM 권한 사용을 참조하세요.

이제 이 권한을 사용하여 Cloud Storage에서 함수를 배포할 수 있습니다.

gcloud

  1. Google Cloud 콘솔에서 Cloud Shell을 활성화합니다.

    Cloud Shell 활성화

    Google Cloud 콘솔 하단에서 Cloud Shell 세션이 시작되고 명령줄 프롬프트가 표시됩니다. Cloud Shell은 Google Cloud CLI가 사전 설치된 셸 환경으로, 현재 프로젝트의 값이 이미 설정되어 있습니다. 세션이 초기화되는 데 몇 초 정도 걸릴 수 있습니다.

  2. gcloud functions deploy 명령어를 사용하여 위 배포 안내를 따릅니다.

    --source 플래그의 경우 gs://로 시작하는 Cloud Storage 경로를 지정합니다. 경로의 객체는 함수 소스 코드를 포함하는 ZIP 파일이어야 합니다. 함수 소스 파일은 ZIP 파일의 루트에 있어야 합니다. 소스 디렉터리 구조를 참조하세요.

콘솔

  1. 소스 코드 필드가 표시될 때까지 Google Cloud 콘솔을 사용하여 위 배포 안내를 따릅니다.
  2. 소스 코드 필드에서 Cloud Storage의 ZIP을 선택합니다.
  3. Cloud Storage 위치 필드에서 찾아보기를 클릭하여 Cloud Storage에서 ZIP 파일을 선택합니다. 함수 소스 파일은 ZIP 파일의 루트에 있어야 합니다. 소스 디렉터리 구조를 참조하세요.
  4. 배포를 클릭합니다.

소스 저장소에서 배포

이 섹션에서는 Cloud Source Repositories에 있는 소스 코드에서 함수를 배포하는 방법을 설명합니다. Cloud Source Repositories에서 배포하면 GitHub 또는 Bitbucket 저장소에 호스팅된 코드를 배포할 수 있습니다.

Cloud Source Repositories에서 코드를 배포하려면 먼저 저장소를 설정하고 선택적으로 이를 GitHub 또는 Bitbucket 저장소에 연결해야 합니다.

Cloud Functions가 소스 저장소에서 읽기를 수행할 수 있으려면 Cloud Functions 서비스 에이전트에 저장소에 대한 소스 저장소 리더(roles/source.reader) IAM 역할이 필요합니다. 소스 저장소가 함수와 동일한 프로젝트에 있으면 이 권한이 자동으로 포함됩니다. 소스 저장소가 다른 프로젝트에 있으면 권한을 수동으로 부여해야 합니다.

그런 후 저장소에서 함수를 배포할 수 있습니다.

gcloud

  1. Google Cloud 콘솔에서 Cloud Shell을 활성화합니다.

    Cloud Shell 활성화

    Google Cloud 콘솔 하단에서 Cloud Shell 세션이 시작되고 명령줄 프롬프트가 표시됩니다. Cloud Shell은 Google Cloud CLI가 사전 설치된 셸 환경으로, 현재 프로젝트의 값이 이미 설정되어 있습니다. 세션이 초기화되는 데 몇 초 정도 걸릴 수 있습니다.

  2. gcloud functions deploy 명령어를 사용하여 위 배포 안내를 따릅니다.

    --source 플래그의 경우 함수 소스 코드의 위치에 소스 저장소 참조를 지정합니다. 소스 디렉터리 구조를 참조하세요. Cloud Source Repositories의 기본 참조 형식은 다음과 같습니다.

    https://source.developers.google.com/projects/PROJECT_ID/repos/REPOSITORY_NAME
    

    위 경로에서 PROJECT_ID는 Google Cloud 프로젝트 ID이고 REPOSITORY_NAME은 소스 저장소의 이름입니다. 이 경로를 사용하면 master로 태그 지정된 버전에 있는 저장소 루트 디렉터리의 소스 코드가 사용됩니다.

    master 이외의 버전에서 배포하려면 다음 중 하나를 경로에 추가합니다.

    • /revisions/REVISION_NAME
    • /moveable-aliases/MOVEABLE_ALIAS
    • /fixed-aliases/FIXED_ALIAS

    저장소 루트 이외의 디렉터리에서 소스 코드를 배포하려면 버전, 이동 가능한 별칭, 고정된 별칭을 지정하고 /paths/PATH_TO_YOUR_SOURCE_DIRECTORY를 경로에 추가합니다.

콘솔

  1. 소스 코드 필드가 표시될 때까지 Google Cloud 콘솔을 사용하여 위 배포 안내를 따릅니다.
  2. 소스 코드 필드에서 Cloud Source Repository를 선택합니다.
  3. 저장소 필드에 소스 저장소의 이름을 입력합니다.
  4. 브랜치/태그 필드에서 배포하려는 위치에 따라 브랜치 또는 태그를 선택합니다.
  5. 표시된 브랜치 또는 태그 이름을 입력합니다.
  6. 소스 코드가 있는 디렉터리 필드에서 함수 소스 코드가 포함된 저장소에 디렉터리 경로를 입력합니다 소스 디렉터리 구조를 참조하세요.
  7. 배포를 클릭합니다.

Google Cloud 콘솔 인라인 편집기에서 배포

이 섹션에서는 제공된 인라인 편집기를 사용하여 Google Cloud 콘솔에서 직접 함수를 작성하고 배포하는 방법을 설명합니다.

  1. 소스 코드 필드가 표시될 때까지 Google Cloud 콘솔을 사용하여 위 배포 안내를 따릅니다.
  2. 소스 코드 필드에서 인라인 편집기를 선택합니다.
  3. 제공된 편집기를 사용하여 필요에 따라 소스 파일을 만들거나 편집합니다. 소스 디렉터리 구조를 참조하세요.
    • 왼쪽 창에는 소스 파일이 나열되고 파일 만들기, 이름 바꾸기, 삭제를 수행할 수 있습니다.
    • 오른쪽 창은 파일 콘텐츠를 수정할 수 있는 텍스트 편집기입니다.
  4. 배포를 클릭합니다.

명령줄 예시

다음 섹션에서는 일부 배포 시나리오 예시의 배포 명령어를 보여줍니다.

Cloud Functions에서 지원되는 여러 트리거에 대한 자세한 내용은 Cloud Functions 트리거를 참조하세요.

로컬 소스 코드의 HTTP 함수

다음과 같이 HTTP 함수가 있다고 가정합니다.

  • 이 함수에는 Node.js 16이 사용됩니다.
  • 소스 코드는 현재 작업 디렉터리(.)에 있습니다.
  • 코드 진입점의 이름은 myHttpFunction입니다.

us-central1 리전에 my-http-function 이름으로 Cloud Functions(2세대)에 함수를 배포하려면 다음 명령어를 사용합니다.

gcloud functions deploy my-http-function \
  --gen2 \
  --region=us-central1 \
  --runtime=nodejs16 \
  --source=. \
  --entry-point=myHttpFunction \
  --trigger-http

Cloud Storage 소스 코드의 Pub/Sub 함수

다음과 같은 이벤트 기반 함수가 있다고 가정해 보세요.

  • 이 함수는 Pub/Sub 메시지 게시 이벤트를 처리합니다.
  • 이 함수에는 Python 3.9가 사용됩니다.
  • 소스 코드는 Cloud Storage에서 다음 경로에 있습니다. gs://my-bucket/my_function_source.zip.
  • 코드 진입점의 이름은 pubsub_handler입니다.

europe-west1 리전에 my-pubsub-function 이름으로 Cloud Functions(2세대)에 함수를 배포하고 Pub/Sub 주제 my-topic에서 메시지로 함수를 트리거하려면 다음 명령어를 사용합니다.

gcloud functions deploy my-pubsub-function \
  --gen2 \
  --region=europe-west1 \
  --runtime=python39 \
  --source=gs://my-bucket/my_function_source.zip \
  --entry-point=pubsub_handler \
  --trigger-topic=my-topic

로컬 소스 코드의 Cloud Storage 함수

다음과 같은 이벤트 기반 함수가 있다고 가정해 보세요.

  • 함수가 Cloud Storage 객체 삭제 이벤트를 처리합니다.
  • 함수에 자바 11이 사용됩니다.
  • 소스 코드는 ./functions/storage-function 경로에 로컬로 있습니다.
  • 코드 진입점의 이름은 myproject.StorageFunction입니다.

asia-northeast1 리전에 my-storage-function 이름으로 Cloud Functions(2세대)에 함수를 배포하고 Cloud Storage 버킷 my-bucket에서 이벤트로 함수를 트리거하려면 다음 명령어를 사용합니다.

gcloud functions deploy my-storage-function \
  --gen2 \
  --region=asia-northeast1 \
  --runtime=java11 \
  --source=./functions/storage-function \
  --entry-point=myproject.StorageFunction \
  --trigger-event-filters="type=google.cloud.storage.object.v1.deleted" \
  --trigger-event-filters="bucket=my-bucket"

다음 단계