액션 생성

Classic 환경에서 이용 가능합니다.

네이버 클라우드 플랫폼 콘솔의 Cloud Functions > Action에서 액션을 생성할 수 있습니다. 액션을 생성하는 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼 콘솔의 Region 메뉴에서 이용 중인 리전을 클릭하여 선택해 주십시오.
2. Platform 메뉴에서 Classic을 클릭하여 선택해 주십시오.
3. Services > Compute > Cloud Functions 메뉴를 차례대로 클릭해 주십시오.
4. Action 메뉴를 클릭해 주십시오.
5. [Action 생성] 버튼을 클릭해 주십시오.
6. 생성할 액션 내용을 설정해 주십시오.
   • 기본 정보: 소속 패키지, 액션 타입, 이름, 설명 설정
   • 소스 코드: 선택한 언어로 콘솔에서 코드를 직접 작성하거나 코드 파일 업로드
   • 디폴트 파라미터: 액션에 사용할 디폴트 파라미터 코드 작성
   • 옵션 설정: 액션 메인 함수 이름, 메모리, 타임아웃, 웹 액션 설정
7. [저장] 버튼을 클릭해 주십시오.

기본 정보

액션을 생성하기 위해 기본적으로 필요한 정보를 설정합니다. 기본 정보의 각 항목에 대한 설명은 다음과 같습니다.

• 패키지: 액션이 속할 패키지를 클릭하여 선택. 새 패키지를 생성하여 포함시키려면 [+생성] 버튼 클릭
• 타입: 액션 종류를 클릭하여 선택
  • 일반 액션: 기본 액션 타입으로 하나의 액션을 실행
  • 웹 액션: 하나의 액션을 실행하며 API Gateway 트리거 HTTP 방식과 연동하여 HTTP 요청, 응답을 처리
  • 시퀀스 액션: 여러 개의 액션을 연결하여 순차적으로 실행
  • 시퀀스 웹 액션: 여러 개의 웹 액션을 연결하여 순차적으로 실행
• 이름: 액션 이름을 영문 대소문자, 숫자, 특수 문자( _ , - )를 조합하여 입력. 단, 첫 글자로 특수문자 '-'는 사용할 수 없으며 다른 리소스(패키지, 액션, 트리거) 이름과 중복 불가
  • 예를 들어, 패키지 이름이 package_name 이고 액션 이름이 action_name 이라면, 패키지에 속한 액션 이름 형식은 다음과 같습니다:
    • package_name/action_name
• 설명: 생성할 액션에 대한 설명을 입력

소스 코드

액션 코드는 원하는 언어로 콘솔에서 직접 작성하거나 코드 파일을 업로드합니다. 코드 작성 시 실행 시점의 런타임 파라미터를 설정하지 않으면 패키지나 연결된 트리거, 액션의 디폴트 파라미터가 사용됩니다. 런타임 파라미터 외에도 추가 설정에 대한 코드를 별도로 작성하지 않는 경우 관련 설정은 기본값이 적용되며, 생성 후 변경이 불가능한 값도 있으니 주의하여 작성해 주십시오. 소스 코드의 각 항목에 대한 설명은 다음과 같습니다.

• 런타임: 소스 코드가 실행되는 언어 및 버전 환경을 클릭하여 선택

• 타입: 소스 코드를 작성하는 방법을 클릭하여 선택
  • 코드: 콘솔에서 직접 작성
  • 파일: 작성한 소스 코드 파일을 마우스로 파일을 끌고 오거나 여기를 클릭하세요. 를 클릭하여 업로드

작성 예제

파라미터 Params를 전달받아 Params에 Name과 Place가 존재하면 해당 문자열을 반환하고, 존재하지 않으면 World와 Ncloud를 반환하는 액션의 소스 코드의 언어별 작성 예제입니다. 소스 코드 작성 시 참조해 주십시오.

• Node.js

  function main(params) {
      var name = params.name || 'World';
      var place = params.place || 'Ncloud';
      return {payload:  'Hello, ' + name + ' in ' + place + '!'};
  }
  

• Python 3

  def main(args):
      name = args.get("name", "World")
      place  = args.get("place", "Ncloud")
      return {"payload": "Hello, " + name + " in " + place + "!"}
  

• Swift 3.1.1

  func main(args: [String:Any]) -> [String:Any] {
      let name = args["name"] ?? "World"
      let place = args["place"] ?? "Ncloud"
      return  [ "payload" : "Hello, \(name) in \(place)"]
  }
  

• PHP 7

  <?php
  function main(array $args) : array
  {
      $name = $args["name"] ?? "World";
      $place = $args["place"] ?? "Ncloud";
      return ["greeting" => "Hello, $name in $place!"];
  }
  ?>
  

• Java 8

  import com.google.gson.JsonObject;
  
  public class Hello {
      public static JsonObject main(JsonObject args) {
          String name = "World";
          String place = "Ncloud";
          if (args.has("name"))
              name = args.getAsJsonPrimitive("name").getAsString();
          if (args.has("place"))
              place = args.getAsJsonPrimitive("place").getAsString();
  
          JsonObject response = new JsonObject();
          response.addProperty("payload", "Hello, " + name + " in " + place + "!");
          return response;
      }
  }
  

디폴트 파라미터

매번 액션을 실행할 때마다 파라미터를 전달하는 대신 액션에 기본으로 적용될 수 있는 디폴트 파라미터를 입력할 수 있습니다. 액션의 디폴트 파라미터는 패키지 파라미터보다 적용 우선순위가 높고, 트리거 파라미터와 액션 실행 시점에 전달되는 런타임 파라미터보다는 적용 우선순위가 낮습니다. 단, 암호화 설정을 사용하는 경우 복호화된 파라미터가 가장 높은 우선순위로 적용됩니다. 디폴트 파라미터의 각 항목에 대한 설명은 다음과 같습니다.

• 입력 박스: JSON 형식으로 입력

JSON 형식의 디폴트 파라미터 예제 코드는 다음과 같습니다.

{
  "name": "NCloud",
  "place": "Cloud Function"
}

예제 코드

function main(params) {
  let name = params.name || "World";
  let place = params.place || "Naver";
  return {payload:  "Hello, " + name + " in " + place + "!"};
}

실행 결과

{"payload":"Hello, NCloud in Cloud Function!"}

옵션 설정

액션의 Main 함수 이름, 메모리, Timeout을 설정하거나 별도의 사용자 인증 없이 호출 가능한 URL을 제공하는 웹 액션을 설정할 수 있습니다. 웹 액션의 경우 다양한 REST API 형태의 모든 요청(GET, POST, PUT, DELETE 등)을 지원합니다.
옵션 설정의 각 항목에 대한 설명은 다음과 같습니다.

• Main 함수: 액션의 메인 함수나 클래스 이름으로 사용할 문자열 입력
• 액션 메모리: 원하는 메모리 크기를 클릭하여 선택
• 액션 Timeout: 액션의 실행 가능한 최대 시간을 ms 단위로 입력. 입력한 시간 초과 시 실행 결과 실패로 종료
• 웹 액션 관련 설정
  • HTTP 원문 사용: 웹 액션에서 HTTP 원문 그대로 웹 액션으로 전달받아 해석하여 처리할지 여부를 클릭하여 선택(True: HTTP 원문 사용, False: JSON 객체 사용)
  • 헤더 옵션 설정: 코드 내에서 헤더 수정 가능 여부를 클릭하여 선택(True: 수정 가능, False: CORS 헤더를 응답 헤더에 자동 추가)

시퀀스 액션 시나리오 설정

선택한 액션들이 순차적으로 실행되도록 시퀀스 액션의 시나리오를 설정합니다. 시나리오 설정 전 숙지해야 할 주의 사항은 다음과 같습니다.

• 시퀀스 액션에는 일반 액션, 웹 액션 외에 시퀀스 액션도 추가할 수 있습니다.
• 시퀀스 웹 액션에는 웹 액션 또는 시퀀스 웹 액션만 추가하는 것을 권장합니다.
• 사용자의 액션 파라미터는 첫 번째 액션에서만 전달됩니다. 후행 액션에서도 사용자 액션 파라미터값을 사용해야 할 경우 선행 액션에서 해당값을 결과에 명시적으로 추가해 주십시오.
• 시퀀스 액션에 등록된 각 액션은 자신의 디폴트 파라미터값을 사용할 수 있습니다. 디폴트 파라미터에 선행 액션의 결과와 동일한 Key가 있을 경우 선행 액션 결과의 우선 순위가 높습니다.
• 선행 액션에서 오류 발생 시 다음 액션은 실행되지 않습니다.
• 시퀀스 액션은 별도의 실행 타임아웃을 지정할 수 없습니다. 시퀀스 액션의 최대 실행 시간은 등록된 액션 실행 타임아웃의 총합과 같습니다. <예시> 액션 1, 액션 2의 실행 타임아웃이 각각 1분, 3분인 경우 시퀀스 액션은 최대 4분까지 실행 가능

위 주의 사항을 고려하여 시퀀스 액션 시나리오를 설정하는 방법은 다음과 같습니다.

1. Packages/Actions에서 시퀀스 액션에 추가할 액션을 클릭해 주십시오.
2. 추가한 액션들의 실행 순서를 설정해 주십시오.
   
   • 실행 순서 변경: 실행 순서를 변경할 액션을 드래그
   • 추가한 액션 삭제: 버튼 클릭