액션 생성

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. 추가한 액션들의 실행 순서를 설정해 주십시오.
   
   • 실행 순서 변경: 실행 순서를 변경할 액션을 드래그
   • 추가한 액션 삭제: 버튼 클릭