기본 액션

네이버 클라우드 플랫폼 콘솔의 Cloud Functions > Action에서 기본 타입의 액션을 생성하고 수정, 삭제할 수 있습니다. 생성한 액션을 실행하고 모니터링하는 방법은 Action/Trigger 실행과 Action을 참고해 주십시오.

액션 생성

액션을 생성합니다. 액션 생성 시 트리거를 연결하거나, 트리거가 없는 경우 트리거를 추가하여 연결할 수 있습니다. 트리거를 연결하지 않고 동작 가능한 액션을 생성할 수도 있습니다. 액션을 생성하는 방법은 다음과 같습니다.

1. Services > Compute > Cloud Functions 메뉴를 차례대로 클릭해 주십시오.
2. Action 메뉴를 클릭해 주십시오.
3. [Action 생성] 버튼을 클릭해 주십시오.
4. 트리거 선택의 트리거 종류에서 액션에 연결할 트리거를 클릭하여 선택해 주십시오.
   • 트리거 설정 없이 액션 만들기: 트리거를 연결하지 않고 생성하려는 경우
5. 이름에서 연결할 트리거를 클릭하여 선택한 다음 [추가] 버튼을 클릭해 주십시오.
   • 새로운 트리거 만들기: 연결할 트리거가 없거나 새로운 트리거를 생성하여 연결하려는 경우. 자세한 사용 방법은 Trigger 참고
6. 연결 트리거 목록이 나타나면 정보를 확인한 다음 [다음] 버튼을 클릭해 주십시오.
7. 생성할 액션 내용을 설정해 주십시오.
   • 기본 정보: 액션 타입, 이름, 설명, 소속 패키지 설정
   • 소스 코드: 선택한 언어로 콘솔에서 코드를 직접 작성하거나 코드 파일 업로드
   • VPC 연결 정보: VPC 리소스 접근을 위한 VPC, Subnet 설정
   • 옵션 설정: 액션 메인 함수 이름, 메모리, 타임아웃, 웹 액션 설정
   • 디폴트 파라미터: 액션에 사용할 디폴트 파라미터 코드 작성
8. [생성] 버튼을 클릭해 주십시오.

기본 정보

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

• 패키지: 액션이 속할 패키지를 클릭하여 선택. 새 패키지를 생성하여 포함시키려면 [생성] 버튼 클릭
• 타입: 액션 종류 가운데 기본을 클릭하여 선택
  • 기본: 하나의 액션을 실행
  • 시퀀스: 여러 개의 액션을 연결하여 순차적으로 실행
• 이름: 액션 이름을 영문 대소문자, 숫자, 특수 문자 _ -를 조합하여 입력. 단, 첫 글자로 특수문자 -는 사용할 수 없으며 다른 리소스(패키지, 액션, 트리거) 이름과 중복 불가
  • 패키지 이름이 package_name이고 액션 이름이 action_name인 경우 패키지에 속한 액션 이름 형식: {package_name}/{action_name}
• 설명: 생성할 액션에 대한 설명을 입력

소스 코드

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

• 언어: 소스 코드 작성 언어를 클릭하여 선택
• 타입: 소스 코드를 작성하는 방법을 클릭하여 선택
  • 코드: 콘솔에서 직접 작성
  • 파일: 작성한 소스 코드 파일을 Drop files here or click to upload. 를 클릭하여 업로드

작성 예제

파라미터 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;
      }
  }
  

VPC 연결 정보

액션을 사용하여 자신의 VPC 리소스에 접근 가능하도록 설정합니다. VPC 환경에서 Cloud Functions를 이용한다면 VPC 리소스 연결은 필수로 설정해야 합니다. VPC 연결 정보의 각 항목에 대한 설명은 다음과 같습니다.

• VPC: 액션이 접근하고자 하는 VPC 이름을 클릭하여 선택. 새 VPC를 생성하려면 [VPC 생성] 버튼 클릭
• Subnet: 선택한 VPC에 접근 시 사용할 Subnet을 클릭하여 선택
  • 연동 가능한 Subnet 종류: Private만 가능
  • Public Subnet 리소스 접근 방법: Private Subnet 리소스와 동일하게 ACG 설정을 통해 가능
  • Private Subnet과 연동한 액션에서 인터넷 통신 방법: Subnet에 NAT Gateway 설정을 통해 가능하며, 설정 방법은 NAT Gateway 사용 가이드 참고

ACG 설정

VPC, Subnet 설정을 완료했다면 실제 액션 코드 내에서 VPC 리소스 접근 허용을 위해 접근하려는 리소스의 ACG 설정이 필요합니다.

VPC 환경에서 Cloud Functions 액션을 생성하면 연결된 VPC 환경에 ACG 설정에서 사용할 수 있는 접근 소스로 cloudfunctions-vpc-{vpc ID}의 별칭이 자동 생성되며, 자동 생성된 별칭을 ACG의 Inbound 규칙의 접근 소스에 추가해야 합니다.

예컨대 액션 코드에서 VPC에 생성한 서버로 접근하려면 다음과 같이 서버에 적용할 ACG 규칙 설정의 Inbound 탭 메뉴를 클릭한 다음 접근 소스에 cloudfunctions-vpc-{vpc ID}를 추가해야 합니다.

VPC에 생성된 Cloud DB에 접근하려는 경우 일반 서버와 동일하게 DB 서버 생성 시 자동 생성되는 별칭을 ACG의 Inbound 규칙에 추가하면 됩니다.

옵션 설정

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

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

디폴트 파라미터

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

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

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

{
  "name": "Ncloud",
  "place": "Cloud Functions"
}

디폴트 파라미터의 암호화

액션에 필요한 데이터를 안전하게 사용하고 싶다면, 액션의 디폴트 파라미터의 암호화 설정을 통해 Key Management Service와 연동할 수 있습니다. Key Management Service는 사용자의 중요한 정보를 암호화하는 데 사용한 키를 엄격하고 안전한 정책 하에 보호하는 네이버 클라우드 플랫폼의 서비스입니다.

액션 디폴트 파라미터 암호화 설정에서는 Key Management Service의 안전한 키 관리 서비스를 이용하여 액션에 사용할 데이터를 암호화하여 안전하게 저장하고, 액션이 실행될 때에는 간편하게 복호화된 데이터를 사용할 수 있습니다.

• 사용 예시

1. 디폴트 파라미터 영역에 사용하고자 하는 데이터의 JSON 형식에 맞추어 작성합니다. 작성한 JSON 데이터 중 depth가 1인 string 타입 데이터만 암호화를 지원합니다.

2. 암호화 설정을 ON으로 변경하고, 사용할 NCloud Key Management Service의 AES-256 타입 키를 선택합니다. 키는 액션당 한 개 선택 가능합니다.

3. 암호화할 디폴트 파라미터의 JSON 키를 선택합니다.

4. 선택한 JSON 키에 해당하는 디폴트 파라미터가 암호화되고, 파라미터 키 영역 하단에 암호화된 파라미터 JSON 키가 표시됩니다.

5. 액션 생성을 완료하고, 액션을 실행합니다.

액션 수정

액션의 이름, 종류를 제외한 나머지 내용을 수정할 수 있습니다. 수정하는 방법은 다음과 같습니다.

1. Services > Compute > Cloud Functions 메뉴를 차례대로 클릭해 주십시오.
2. Action 메뉴를 클릭해 주십시오.
3. Packages/Actions에서 수정할 액션을 클릭해 주십시오.
4. 기본 정보 탭 메뉴를 클릭한 다음 [수정] 버튼을 클릭해 주십시오.
5. 필요한 정보를 수정해 주십시오.
6. [저장] 버튼을 클릭해 주십시오.

액션 삭제

액션을 삭제할 수 있습니다. 액션 삭제 시 액션과 연결된 외부 연결 주소의 리소스 및 스테이지 정보가 함께 삭제되며, 해당 액션이 포함된 시퀀스 액션이 수정되거나 삭제될 수 있습니다. 또한 삭제한 액션은 복구가 불가능하기 때문에 신중하게 진행해 주십시오. 액션을 삭제하는 방법은 다음과 같습니다.

1. Services > Compute > Cloud Functions 메뉴를 차례대로 클릭해 주십시오.
2. Action 메뉴를 클릭해 주십시오.
3. Packages/Actions에서 삭제할 액션을 클릭해 주십시오.
4. 기본 정보 탭 메뉴를 클릭한 다음 [삭제] 버튼을 클릭해 주십시오.
5. [삭제] 버튼을 클릭해 주십시오.