How-to guides

사용자는 Samsung Cloud Platform Console을 통해 Cloud Functions의 필수 정보를 입력하고, 상세 옵션을 선택하여 해당 서비스를 생성할 수 있습니다.

Cloud Functions 생성하기

  1. 모든 서비스 > Compute > Cloud Functions 메뉴를 클릭하세요. Cloud Functions의 Service Home 페이지로 이동합니다.

  2. Service Home 페이지에서 Cloud Functions 생성 버튼을 클릭하세요. Cloud Functions 생성 페이지로 이동합니다.

  3. Cloud Functions 생성 페이지에서 서비스 생성에 필요한 정보들을 입력하세요.

    구분
    필수 여부
    상세 설명
    Funtion 명필수생성할 Funtion 이름 입력
    • 영문 소문자 시작하며 영문 소문자, 숫자, 특수문자(-)를 이용하여 3 ~ 64자 이내로 입력
    Runtime필수Runtime 생성 방법 선택
    • 새로 작성: Runtime을 새로 작성
    • Blueprint로 시작하기: 서비스에서 제공하는 Runtime 소스코드 활용하여 작성
    Runtime & Vesion필수Runtime 및 버전 선택
    • 새로 작성을 선택한 경우
      • Java 런타임의 경우, UI 코드 편집을 지원하지 않으며, Object Storage에서 Jar파일을 가져와서 실행 가능
    • Blueprint로 시작하기를 선택한 경우
      • 해당 Runtime & Version의 소스코드 보기 버튼을 클릭하여 소스코드 예시 확인 가능
    표. Cloud Functions 서비스 정보 입력 항목

  4. 요약 패널에서 생성한 상세 정보와 예상 청구 금액을 확인하고, 완료 버튼을 클릭하세요.

    • 생성이 완료되면, Cloud Functions 목록 페이지에서 생성한 자원을 확인하세요.

Cloud Functions 상세정보 확인하기

Cloud Functions 상세 페이지는 상세 정보, 모니터링, 로그, 코드, 구성, 트리거, 태그, 작업이력 탭으로 구성되어 있습니다.

Cloud Functions 서비스의 상세 정보를 확인하려면 다음 절차를 따르세요.

  1. 모든 서비스 > Compute > Cloud Functions 메뉴를 클릭하세요. Cloud Functions의 Service Home 페이지로 이동합니다.
  2. Service Home 페이지에서 Function 메뉴를 클릭하세요. Function 목록 페이지로 이동합니다.
  3. Function 목록 페이지에서 상세 정보를 확인할 자원을 클릭하세요. Function 상세 페이지로 이동합니다.
    • Function 상세 페이지에는 상태 정보 및 부가 기능 정보가 표시되며, 상세 정보, 모니터링, 로그, 코드, 구성, 트리거, 태그, 작업이력 탭으로 구성됩니다.
      구분상세 설명
      Cloud Functions 상태Cloud Functions의 상태 정보
      • Ready: 녹색 아이콘, 정상적인 함수 호출이 가능한 상태
      • Not Ready: 회색 아이콘, 정상적인 함수 불가능한 상태
      • Deploying: 황색 아이콘, 함수 생성 또는 변경 중인 상태로써 다음 동작으로 발동
        • 함수 생성 및 수정
        • 코드 탭에서 편집기로 코드 수정
        • 코드 탭에서 jar 파일 검사
        • 트리거 탭에서 추가 및 변경
        • 구성 탭에서 변경
      • Running: 청색 아이콘, 정상적인 함수 호출이 가능하고 콜드 스타트 방지 정책이 적용된 상태
      서비스 해지서비스를 해지하는 버튼
      표. Cloud Functions 상태 정보 및 부가 기능

상세 정보

Function 목록 페이지에서 선택한 자원의 상세 정보를 확인하고, 필요한 경우 정보를 수정할 수 있습니다.

구분상세 설명
서비스서비스명
자원 유형자원 유형
SRNSamsung Cloud Platform에서의 고유 자원 ID
자원명자원 이름
  • Cloud Functions 서비스에서는 Funtion 이름을 의미
자원 ID서비스의 고유 자원 ID
생성자서비스를 생성한 사용자
생성 일시서비스를 생성한 일시
수정자서비스를 수정한 사용자
수정 일시서비스를 수정한 일시
Function명Cloud Function의 이름
RuntimeRuntime 종류 및 버전
LLM Endpoint이용 가이드를 클릭하여 LLM Endpoint 정보 및 사용 방법 확인 가능
표. Cloud Functions 상세 - 상세 정보 탭 항목
참고
AIOS를 연계하여 LLM을 활용하는 방법에 대한 자세한 내용은 AIOS 연계하기 를 참고하시길 바랍니다.

모니터링

Function 목록 페이지에서 선택한 자원의 Cloud Functions 사용 정보를 확인할 수 있습니다.

구분상세 설명
호출수단위 시간 동안 해당 Function이 호출된 평균 횟수(건)
실행시간단위 시간 동안 해당 Function을 실행한 평균 실행 시간(초)
메모리 사용량해당 Function 실행하는 중 중 단위 시간 동안 사용한 평균 메모리 사용량(kb)
현재 작업수함수가 동시에 여러 번 호출될 경우, 동시 처리를 위해 단위 시간 동안 생성된 작업의 평균 횟수(건)
성공 호출수함수 호출 시 단위 시간 동안 런타임 코드가 정상적으로 동작하여 응답 코드를 전달한 평균 횟수(건)
실패 호출수함수 호출 시 단위 시간 동안 오류가 발생한 평균 호출 횟수
  • 응답 시간 초과 및 로직 오류에 의한 런타임 포함
표. Cloud Functions 상세 - 모니터링 탭 항목

로그

Function 목록 페이지에서 선택한 자원의 Cloud Functions 로그를 확인할 수 있습니다.

구분상세 설명
단위 기간Cloud Functions의 로그 정보를 확인할 기간 선택
  • 시간 단위(1시간, 3시간, 12시간)로 선택하거나 사용자가 직접 설정 가능
로그 메시지최근 발생 함수부터 순서대로 표시됩니다.
표. Cloud Functions 상세 - 로그 탭 항목
참고
로그 메시지는 최근 발생 메시지를 기준으로 이전 1,000개의 메시지까지 확인이 가능합니다.

코드

Function 목록 페이지에서 선택한 자원의 Cloud Functions 코드를 확인하고 수정할 수 있습니다.

참고

사용 Runtime에 따라 소스 코드 확인 및 편집 방식이 달라집니다.

  • 인라인 편집기: Node.js, Python, PHP, Go
  • 압축파일(.jar/.zip) 실행: Java
구분상세 설명
소스 코드인라인 편집기 방식
코드 정보코드 정보를 표시
수정수정 버튼을 클릭한 후, 인라인 편집기에서 코드 수정 가능
표. Cloud Functions 상세 - 코드 탭 내 인라인 편집기 항목
구분상세 설명
소스 코드압축파일(.jar/.zip) 실행 방식
코드 정보압축 파일 정보 표시
  • Java Runtime: Java Runtime 버전 정보
  • Handler 정보: 실행 Class와 Method 정보
  • 압축파일명(.jar/.zip)명: 현재 설정된 압축 파일의 이름
  • 파일 업로드 일시: 현재 설정된 압축 파일의 업로드 일시
  • 전송 상태: 압축 파일 전송 이력
    • 전송 성공: 압축 파일 설정을 성공한 경우
    • 압축 파일 전송 실패 시 실패 사유
수정Jar 파일 변경 가능
  • Function 코드 수정 페이지에서 Object Storage에서 가져오기 버튼을 클릭하여 변경 가능
  • 가져올 Object Storage 버킷 내 파일의 Private URL을 입력
  • 압축 파일 변경에 대한 자세한 내용은 [Java Runtime 코드 변경하기](#java-runtime 코드 변경하기) 참고
표. Cloud Functions 상세 - 코드 탭 내 압축파일(.jar/.zip) 실행 항목
참고
  • Java Runtime의 경우 UI 코드 편집 기능을 제공하지 않으며, Object Storage 서비스의 버킷에서 압축파일(.jar/.zip) 파일을 선택해야 합니다.
  • Object Storage 서비스의 인증키가 생성되지 않은 사용자의 경우, Object Storage에서 가져오기를 실행할 수 없으므로, 사전에 인증키를 생성해야 합니다.
  • Cloud Functions 서비스에 대한 Object Storage 버킷의 접근제어허용 상태로 변경해야 합니다.

구성

Function 목록 페이지에서 선택한 자원의 Cloud Functions 구성을 확인할 수 있습니다.

구분상세 설명
일반 구성Cloud Function의 메모리와 제한 시간 설정
  • 메모리: Function당 최대로 사용할 수 있는 메모리 제한값
  • 제한시간: Function당 호출을 대기하는 최대 시간. 제한 시간 이후는 Function이 Scale-to-zero 상태가 되고 종료
  • 함수 실행: 최소 및 최대 작업수
  • 수정 버튼을 클릭하여 일반 구성 설정 변경 가능
환경 변수런타임 환경 변수를 설정
  • 환경 변수 사용 시 코드를 업데이트하지 않고 함수의 동작을 조정 가능
  • 수정 버튼을 클릭하여 환경 변수 추가 또는 수정 가능
함수 URL함수에 접근 가능한 HTTPS URL 주소 발급
  • 수정 버튼을 클릭하여 활성화 여부인증 유형, 접근 허용 IP 설정 가능
  • IAM 유형으로 인증하여 함수를 호출하는 경우, 반드시 헤더 내 “x-scf-access-key”, “x-scf-secret-key” 포함 필요. 이 경우, 정책과 인증키의 IP 접근 제어는 미적용
Private 연결 구성PrivateLink Service와 연계하여 사용 가능
표. Cloud Functions 상세 - 구성 탭 항목
주의
접근 제어 사용을 해제하는 경우, 등록된 접근 정보가 삭제되어 함수 접근 제어가 불가능하므로 외부 스캔, 해킹 등의 보안 공격에 노출될 수 있습니다.
참고
  • 일반 구성의 메모리 할당량에 비례하는 CPU 코어 갯수가 자동으로 할당됩니다.
  • 일반 구성의 실행 최소 수가 1이상 일 경우 Cold Start가 방지 되지만, 지속적으로 비용이 부과됩니다.

트리거

Function 목록 페이지에서 선택한 자원의 트리거 정보를 확인하고 설정할 수 있습니다. 트리거를 설정하면 이벤트 발생 시 Function을 자동으로 실행할 수 있습니다.

구분상세 설명
CronjobCronjob을 트리거로 사용
  • 시간 또는 일정 주기에 따라 함수를 자동으로 호출
  • 수정 버튼을 클릭하여 반복 빈도시간대 변경 가능
API GatewayAPI Gateway를 트리거로 사용
  • API Gateway 이름과 상세 정보를 확인할 수 있습니다.
표. Cloud Functions 상세 - 트리거 탭 항목
주의
Cronjob 트리거를 함수 제한 시간 전에 호출할 경우, 함수가 중첩 실행되어 실행 횟수와 시간이 증가하게 됩니다. 따라서 지속적으로 추가 비용이 발생하여 높은 비용이 발생할 수 있으므로 주의하세요.
참고
  • Deploying 상태일 경우, 수정할 수 없습니다.
  • 트리거 설정에 대한 트리거 설정하기를 참고하세요.

태그

태그 탭에서 자원의 태그 정보를 확인하고, 추가하거나 변경 또는 삭제할 수 있습니다.

구분상세 설명
태그 목록태그 목록
  • 태그의 Key, Value 정보 확인 가능
  • 태그는 자원 당 최대 50개까지 추가 가능
  • 태그 입력 시 기존에 생성된 Key와 Value 목록을 검색하여 선택
표. Cloud Functions 상세 - 태그 탭 항목

작업 이력

작업 이력 페이지에서 자원의 작업 이력을 확인할 수 있습니다.

구분상세 설명
작업 이력 목록자원 변경 이력
  • 작업 내역, 작업 일시, 자원 유형, 자원명, 작업 결과, 작업자 정보 확인 가능
  • 작업 이력 목록 리스트에서 해당하는 자원을 클릭하면 작업 이력 상세 팝업창이 열림
표. Cloud Functions 상세 - 작업 이력 탭 항목

Java Runtime 코드 변경하기

Java Runtime을 사용하는 경우, 코드를 직접 수정할 수 없으므로 Object Storage 서비스의 버킷에서 압축 파일(.jar/.zip)을 선택하여 변경해야 합니다.

압축 파일을 변경하는 방법은 다음 절차를 따르세요.

Cloud Functions 서비스를 해지하려면 다음 절차를 따르세요.

  1. 모든 서비스 > Compute > Cloud Functions 메뉴를 클릭하세요. Cloud Functions의 Service Home 페이지로 이동합니다.
  2. Service Home 페이지에서 Function 메뉴를 클릭하세요. Function 목록 페이지로 이동합니다.
  3. Function 목록 페이지에서 코드 내 압축 파일을 변경할 자원을 클릭하세요. Function 상세 페이지로 이동합니다.
  4. Function 상세 페이지의 코드 탭에서 수정 버튼을 클릭하세요. Function 코드 수정 페이지로 이동합니다.
  5. Object Storage에서 가져오기 버튼을 클릭하세요. Object Storage에서 가져오기 팝업창이 열립니다.
구분상세 설명
Java RuntimeJava Runtime 정보
Handler 정보Handler 정보
  • 실행 Class: 압축파일(.jar/.zip) 설정 시 자동으로 입력
  • 실행 Method: 압축파일(.jar/.zip) 설정 시 자동으로 입력
압축파일(.jar/.zip)변경할 압축 파일을 설정
  • 압축파일명(.jar/.zip): 압축 파일의 이름을 표시. Object Storage에서 가져오기 설정 후, 자동으로 입력
  • Object Storage에서 가져오기: 압축파일(.jar/.zip)을 가져올 Object Storage 설정
표. Cloud Functions 상세 - Function 코드 수정 항목
  1. Object Storage URL에 압축 파일을 가져올 Object Storage의 URL 정보를 입력한 후, 확인 버튼을 클릭하세요. 알림 팝업창이 열립니다.
    • URL 정보는 가져올 Object Storage의 상세 페이지의 폴더 리스트 탭에서 파일 정보 > Private URL 항목에서 확인할 수 있습니다.
  2. 확인 버튼을 클릭하세요. Function 코드 수정 페이지의 **압축파일명(.jar/.zip)**에 가져온 압축 파일의 이름이 표시됩니다.
  3. 저장 버튼을 클릭하세요.
주의
  • 인증키가 생성되지 않은 사용자의 경우, Object Storage에서 가져오기를 실행할 수 없습니다.
  • URL이 존재하지 않거나 압축 파일이 다음에 해당하는 경우, 변경할 수 없습니다.
    • 지원하지 않는 확장자를 사용하는 경우
    • 압축 파일 내 유해한 파일이 있는 경우
    • 지원 가능한 크기를 초과한 경우

Cloud Functions 해지하기

Cloud Functions 서비스를 해지하려면 다음 절차를 따르세요.

  1. 모든 서비스 > Compute > Cloud Functions 메뉴를 클릭하세요. Cloud Functions의 Service Home 페이지로 이동합니다.
  2. Service Home 페이지에서 Function 메뉴를 클릭하세요. Function 목록 페이지로 이동합니다.
  3. Function 목록 페이지에서 해지할 자원을 클릭하고 서비스 해지 버튼을 클릭하세요.
  4. 해지가 완료되면 Function 목록 페이지에서 자원이 해지되었는지 확인하세요.
Overview
트리거 설정하기