Compute > Cloud Functions > 콘솔 사용 가이드

이 문서는 Cloud Functions 콘솔에서 함수를 생성하고 관리하는 방법을 설명합니다.

함수 관리

함수를 생성, 수정, 삭제, 복사할 수 있습니다.

함수 생성

함수 설정을 하고 코드를 작성하여 빌드한 뒤 생성 버튼을 클릭하면 마지막 빌드한 패키지로 함수가 생성됩니다.

함수 설정

분류	No.	항목	설명
기본 정보	1.	이름	함수의 이름 중복된 함수 이름은 허용하지 않습니다. 함수 엔드포인트 URL로 사용됩니다.
	2.	설명	함수의 설명, 최대 250자
함수 설정	3.	엔드포인트 URL	함수 호출 HTTP Endpoint URL 함수 이름 입력 시 자동으로 변경됩니다.
	4.	유형	Pool Manager New Deployment
	5.	리소스	함수 동작 환경 리소스 선택 Pool Manager 유형일 경우 지정된 리소스만 선택 가능 New Deployment 유형일 경우 커스텀 리소스 입력 가능
	6.	실행 제한 시간	함수 실행 시간을 지정(Time out). 함수가 실행되고 지정된 시간을 초과하면 함수는 강제 중단되고 오류로 응답
	7.	(Pool Manager) 동시 실행 설정	함수의 동시 실행 수 지정. 동시에 함수 호출이 되는 경우 호출 횟수만큼 인스턴스가 동시에 실행되며, 최대 인스턴스는 제한됩니다.
	8.	(New Deployment) 최소 인스턴스 수	최소한으로 유지할 인스턴스 수 지정.
	9.	(New Deployment) 최대 인스턴스 수	자동으로 확장 가능한 최대 인스턴스 수 지정.
로그 설정	10.	로그 서비스 연동	Log & Crash Search 서비스를 사용하여 연동할 것인지 선택 함수의 로그는 Log & Crash Search 서비스에서 직접 확인 가능합니다. 로그는 10라인 단위로 전송됩니다.

[참고]
(Pool Manager) 동시 실행 설정

[참고]
(New Deployment) 인스턴스 수 - 리소스 사용량에 따라 지정된 인스턴스 수만큼 생성되지 않을 수 있습니다.

코드 작성

분류	No.	항목	설명
소스 코드	1.	런타임 환경	함수의 런타임 환경을 선택
	2.	Entry Point	함수의 진입 지점을 지정. 예: 함수명 런타임 환경의 템플릿에 맞춰 자동으로 완성됩니다. 임의로 수정 시 작성한 소스 코드의 Entry Point와 일치해야 합니다. 잘못 입력한 경우 빌드로는 확인할 수 없고, 테스트 시 로그를 통해 확인할 수 있습니다.
코드	3.	코드 에디터	런타임 환경의 템플릿 파일이 로드되고, 해당 파일을 수정하여 함수를 작성 코드 에디터에서 디렉터리 추가는 불가능합니다. 디렉터리 구조를 편집하려면 템플릿 파일을 다운로드해 로컬에서 직접 수정한 뒤 ZIP 파일 업로드 방식을 사용해야 합니다.
	4.	사용자 로컬 환경	사용자 로컬 환경에서 함수 코드를 작성하여 ZIP 파일 형태로 업로드
	5.	빌드	사용자가 작성하거나 업로드한 코드를 빌드하여 패키지를 생성합니다. 빌드된 패키지는 테스트에 사용되며, 함수 생성/수정 시 마지막 빌드한 패키지가 함수 버전으로 연동됩니다.
테스트	6.	테스트 이벤트	함수에 전달할 JSON Body를 작성
	7.	테스트	이벤트에 작성한 JSON Body를 전달하여 함수를 테스트. (빌드가 선행되어야 합니다.) 로그로 함수 동작을 확인할 수 있습니다. GET 메서드로 호출합니다.
	8.	생성	생성 버튼을 이용해 함수 설정과 작성한 함수에 맞게 함수를 생성

[참고]
빌드 버튼을 통해 생성된 패키지는 함수 생성/수정 시 마지막 빌드한 패키지가 함수 버전으로 연동됩니다. 함수 생성 전 최소 1회 이상 빌드를 수행해야 합니다.

함수 수정

기존 함수의 함수 설정 및 코드를 수정하기 위해 수정 버튼을 클릭해 함수를 수정합니다.

수정 불가 항목

• 이름, 런타임 환경
  • 해당 항목을 제외한 모든 항목을 수정할 수 있습니다.

소스 코드

• 코드 에디터를 사용하는 경우 기존 코드가 로드됩니다.
• 사용자 로컬 환경의 ZIP 파일을 업로드하여 함수를 생성했을 경우, 코드 에디터로 변경하면 ZIP 파일을 보여주지 않고 기본 템플릿 코드를 로드합니다.

함수 삭제

기존 함수를 선택하여 삭제합니다. 한 번에 여러 함수 삭제가 가능합니다.

함수 복사

기존 함수와 동일한 함수를 복사합니다. 이름은 중복이 불가능하여 복사 전에 이름을 새롭게 작성할 수 있습니다. - 트리거는 복사되지 않습니다. (HTTP 트리거는 기본 제공) - 버전은 현재 적용된 버전만 복사됩니다.

함수 정보

함수 목록

- 사용자가 생성한 함수 목록을 확인할 수 있습니다. - 빌드 상태는 현재 버전의 빌드 상태를 표시합니다.

함수 기본 정보

- 함수의 기본 정보를 확인할 수 있습니다. - 로그 관리 항목에서 Log & Crash Search 버튼을 클릭해 Log & Crash Search 서비스로 이동하여 로그를 확인할 수 있습니다.

함수 버전 관리

- 함수의 버전을 관리할 수 있습니다. - 생성된 모든 버전의 이력을 확인하고, 이전 버전으로 롤백할 수 있습니다.

버전 관리 개요

함수 생성/수정 화면에서 빌드 버튼을 클릭해 코드를 빌드하면 패키지가 생성됩니다. - 함수 생성/수정 시 마지막 빌드한 패키지가 함수 버전으로 연동됩니다. - 각 버전은 독립적으로 관리되며, 테스트한 버전을 그대로 함수에 적용할 수 있습니다. - 함수 생성 시 최소 1회 이상 빌드를 진행해야 함수 생성이 가능합니다.

버전 정보

No.	항목	설명
1.	버전 목록	함수의 모든 버전 이력을 확인할 수 있습니다. 버전 이름, 런타임, 소스 코드, 빌드 상태 등의 정보가 표시됩니다.
2.	현재 적용된 버전	현재 함수에 적용된 버전이 표시됩니다.
3.	소스 코드 다운로드	선택한 버전의 소스 코드를 ZIP 파일로 다운로드할 수 있습니다.
4.	로그 확인	선택한 버전의 빌드 로그를 확인할 수 있습니다. 기본 정보 탭의 빌드 로그 확인 기능과 동일합니다.

버전 배포

• 버전 목록에서 배포할 버전을 선택하고 버전 배포 버튼을 클릭하면 해당 버전으로 함수가 업데이트됩니다.
• 현재 적용된 버전은 선택할 수 없습니다.
• 여러 버전을 동시에 선택할 수 없으며, 하나의 버전만 배포 가능합니다.
• 빌드 실패한 버전도 배포할 수 있습니다.

[참고]
버전 배포 시 확인 팝업이 표시되며, 성공 시 버전 목록이 자동으로 갱신됩니다.

버전 삭제

• 버전 목록에서 삭제할 버전을 선택하고 버전 삭제 버튼을 클릭하면 해당 버전이 삭제됩니다.
• 현재 적용된 버전은 삭제할 수 없습니다.
• 여러 버전을 선택하여 한 번에 삭제할 수 있습니다.
• 버전 삭제 시 해당 버전의 소스 코드도 함께 삭제됩니다.

[참고]
버전 삭제 시 확인 팝업이 표시되며, 삭제된 버전은 복구할 수 없습니다.

제약 사항

• 함수 생성/수정 화면에서 빌드한 패키지는 함수 생성/수정을 취소하면 함수 버전으로 연동되지 않습니다.
• 함수 삭제 시 해당 함수와 연동된 모든 버전도 함께 삭제됩니다.
• 함수 복사 시 원본 함수의 현재 적용된 버전만 복사되며, 모든 버전 이력이 복사되지는 않습니다.
• 함수 생성 시 여러 런타임으로 빌드할 수 있으나, 함수 수정 시에는 생성 당시 선택한 런타임으로만 빌드할 수 있습니다.

함수 트리거 관리

• 함수를 실행할 수 있는 트리거를 관리할 수 있습니다.
• HTTP 트리거는 함수 생성 시 기본으로 제공됩니다.
  • 활성화/비활성화를 통해 사용 여부를 설정할 수 있습니다.

• 주어진 HTTP 트리거를 통해 생성한 함수를 수행할 수 있습니다.
  • 예시 : https://{userdomain}/{함수명}
  • Method : GET, POST

트리거 생성/수정

• Timer
  • Value: Cron 문자열로 주기를 입력합니다.
• API Gateway
  • API Gateway 서비스를 이용하여 HTTP Endpoint를 추가할 수 있습니다.

트리거 삭제

• 여러 건의 트리거를 선택하여 삭제할 수 있습니다. 기본 트리거인 HTTP 트리거는 삭제할 수 없습니다.

함수 모니터링

- 함수의 사용량을 확인할 수 있습니다. - 함수 호출 횟수, 호출 거부 수, 오류 발생 횟수, 성공률, 함수 실행 시간 지표를 제공합니다. - 설정된 시간 내의 지표를 제공합니다. - 로그가 연동된 경우 Log & Crash Search 버튼을 이용해 Log & Crash Search 서비스로 이동할 수 있습니다.

항목	설명
함수 호출 횟수	총 함수 호출 횟수(초당)
호출 거부 수	인스턴스가 생성되지 않아 함수 호출 실패한 횟수(초당)
오류 발생 횟수	응답 코드가 200이 아닌 응답 횟수(초당)
성공률	총 함수 호출 횟수 대비 성공한 호출 비율
함수 실행 시간	함수 호출에 대한 응답 시간

[참고]
호출 거부 수는 Pool Manager 유형일 경우만 해당합니다.
함수 호출 횟수, 호출 거부 수, 오류 발생 횟수는 지표 step 범위 내 초당 평균 횟수로 표시됩니다. 예를 들어, step이 15초이고 해당 기간 내 1건이 발생했다면 0.0667(1÷15)로 표시됩니다.
함수 실행 시간의 평균은 전체 누적 평균이고, 최댓값은 해당 기간 동안의 최대 실행 시간입니다.