AWS Lambda '호출' 액션 YAML - Amazon CodeCatalyst
LambdaInvokeIdentifierDependsOnComputeTypeFleetTimeoutInputsSourcesArtifacts - inputVariables - inputEnvironmentNameConnectionsNameRoleConfigurationFunctionAWSRegionRequestPayloadRequestPayloadFileContinueOnErrorLogTypeResponseFiltersOutputsArtifactsNameFiles

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

AWS Lambda '호출' 액션 YAML

다음은 AWS Lambda 호출 작업의 YAML 정의입니다. 이 작업을 사용하는 방법을 알아보려면 을 참조하십시오워크플로를 사용하여 Lambda 함수 호출.

이 작업 정의는 광범위한 워크플로 정의 파일 내에 섹션으로 존재합니다. 이 파일에 대한 자세한 내용은 워크플로 YAML 정의을 참조합니다.

참고

다음에 나오는 대부분의 YAML 속성에는 비주얼 편집기에 해당하는 UI 요소가 있습니다. UI 요소를 검색하려면 Ctrl+F를 사용합니다. 요소가 관련 YAML 속성과 함께 나열됩니다.

# The workflow definition starts here.
# See 최상위 속성 for details.
        
Name: MyWorkflow
SchemaVersion: 1.0 
Actions:

# The action definition starts here.   
  LambdaInvoke_nn: 
    Identifier: aws/lambda-invoke@v1
    DependsOn:
      - dependent-action
    Compute:  
      Type: EC2 | Lambda
      Fleet: fleet-name
    Timeout: timeout-minutes
    Inputs:
      # Specify a source or an artifact, but not both.
      Sources:
        - source-name-1
      Artifacts:
        - request-payload
      Variables:
        - Name: variable-name-1
          Value: variable-value-1
        - Name: variable-name-2
          Value: variable-value-2
    Environment:
      Name: environment-name
      Connections:
        - Name: account-connection-name
          Role: iam-role-name
    Configuration:
      Function: my-function|function-arn
      AWSRegion: us-west-2
      # Specify RequestPayload or RequestPayloadFile, but not both.
      RequestPayload: '{"firstname": "Li", lastname: "Jean", "company": "ExampleCo", "team": "Development"}'
      RequestPayloadFile: my/request-payload.json
      ContinueOnError: true|false
      LogType: Tail|None
      ResponseFilters: '{"name": ".name", "company": ".department.company"}'
    Outputs:
      Artifacts:
        - Name: lambda_artifacts
          Files: 
            - "lambda-response.json"

LambdaInvoke

(필수)

액션의 이름을 지정합니다. 모든 작업 이름은 워크플로 내에서 고유해야 합니다. 액션 이름은 영숫자 (a-z, A-Z, 0-9), 하이픈 (-), 밑줄 (_) 로 제한됩니다. 공백은 허용되지 않습니다. 액션 이름에 특수 문자와 공백을 사용할 때는 따옴표를 사용할 수 없습니다.

기본값: Lambda_Invoke_Action_Workflow_nn.

해당 UI: 구성 탭/ 작업 이름

Identifier

(LambdaInvoke/Identifier)

(필수)

작업을 식별합니다. 버전을 변경하려는 경우가 아니면 이 속성을 변경하지 마십시오. 자세한 내용은 사용할 작업 버전 지정 단원을 참조하십시오.

기본값: aws/lambda-invoke@v1.

해당 UI: 워크플로 다이어그램/ LambdaInvoke _nn/ aws/lambda-invoke @v1 레이블

DependsOn

(LambdaInvoke/DependsOn)

(선택 사항)

이 작업을 실행하기 위해 성공적으로 실행되어야 하는 작업, 작업 그룹 또는 게이트를 지정하십시오.

'종속 조건' 기능에 대한 자세한 내용은 을 참조하십시오. 시퀀스 작업

해당 UI: 입력 탭/ 기준 - 선택 사항

Compute

(LambdaInvoke/Compute)

(선택 사항)

워크플로 작업을 실행하는 데 사용되는 컴퓨팅 엔진. 워크플로 수준 또는 작업 수준에서 컴퓨팅을 지정할 수 있지만 둘 다에서 지정할 수는 없습니다. 워크플로 수준에서 지정된 경우 컴퓨팅 구성은 워크플로에 정의된 모든 작업에 적용됩니다. 워크플로 수준에서는 동일한 인스턴스에서 여러 작업을 실행할 수도 있습니다. 자세한 내용은 작업 간 컴퓨팅 공유 단원을 참조하십시오.

해당 UI: 없음

Type

(LambdaInvoke/Compute/Type)

(포함된 Compute 경우 필수)

컴퓨팅 엔진 유형. 다음 값 중 하나를 사용할 수 있습니다.

  • EC2(비주얼 에디터) 또는 EC2 (YAML에디터)

    작업 실행 중 유연성을 위해 최적화되었습니다.

  • Lambda (비주얼 에디터) 또는 (에디터) Lambda YAML

    작업 시작 속도를 최적화했습니다.

컴퓨팅 유형에 대한 자세한 정보는 컴퓨팅 유형을 참고하세요.

해당 UI: 구성 탭/ 컴퓨팅 유형

Fleet

(LambdaInvoke/Compute/Fleet)

(선택 사항)

워크플로 또는 워크플로 작업을 실행할 시스템 또는 플릿을 지정합니다. 온디맨드 플릿을 사용하면 작업이 시작되면 워크플로에서 필요한 리소스를 프로비저닝하고 작업이 완료되면 시스템이 폐기됩니다. 온디맨드 플릿의 예:,. Linux.x86-64.Large Linux.x86-64.XLarge 온디맨드 플릿에 대한 자세한 내용은 을 참조하십시오. 온디맨드 플릿 속성

프로비전된 플릿을 사용하면 워크플로 작업을 실행할 전용 컴퓨터 세트를 구성합니다. 이러한 시스템은 유휴 상태로 유지되므로 작업을 즉시 처리할 수 있습니다. 프로비전된 플릿에 대한 자세한 내용은 을 참조하십시오. 프로비저닝된 플릿 속성

생략된 경우 기본값은 Fleet 입니다. Linux.x86-64.Large

해당 UI: 구성 탭/ 컴퓨팅 플릿

Timeout

(LambdaInvoke/Timeout)

(필수)

작업이 CodeCatalyst 종료되기 전에 작업을 실행할 수 있는 시간을 분 (편집기) 또는 시간과 분 (비주얼 편집기) 단위로 지정합니다. YAML 최소값은 5분이고 최대값은 에 설명되어 의 워크플로 할당량 CodeCatalyst 있습니다. 기본 타임아웃은 최대 타임아웃과 동일합니다.

해당 UI: 구성 탭/ 타임아웃 - 선택 사항

Inputs

(LambdaInvoke/Inputs)

(필수)

이 Inputs 섹션에서는 워크플로 실행 중에 AWS Lambda 호출 작업에 필요한 데이터를 정의합니다.

참고

AWS Lambda 호출 작업당 하나의 입력 (소스 또는 아티팩트) 만 허용됩니다. 변수는 이 총계에 포함되지 않습니다.

해당 UI: 입력 탭

Sources

(LambdaInvoke/Inputs/Sources)

(제공된 RequestPayloadFile경우 필수)

요청 페이로드 JSON 파일을 AWS Lambda 호출 작업에 전달하고 이 페이로드 파일이 소스 리포지토리에 저장되어 있는 경우 해당 소스 리포지토리의 레이블을 지정하십시오. 현재 지원되는 레이블은 뿐입니다. WorkflowSource

요청 페이로드 파일이 소스 리포지토리에 포함되어 있지 않은 경우 해당 파일은 다른 작업에서 생성된 아티팩트에 있어야 합니다.

페이로드 파일에 대한 자세한 내용은 을 참조하십시오. RequestPayloadFile

참고

페이로드 파일을 지정하는 대신 속성을 사용하여 페이로드 JSON 코드를 작업에 직접 추가할 수 있습니다. RequestPayload 자세한 내용은 RequestPayload 단원을 참조하십시오.

소스에 대한 자세한 내용은 소스 리포지토리를 워크플로에 연결 단원을 참조하십시오.

해당 UI: 입력 탭/ 소스 - 선택 사항

Artifacts - input

(LambdaInvoke/Inputs/Artifacts)

(제공된 RequestPayloadFile경우 필수)

요청 페이로드 JSON 파일을 AWS Lambda 호출 작업에 전달하고 이 페이로드 파일이 이전 작업의 출력 아티팩트에 포함되어 있는 경우 여기에 해당 아티팩트를 지정하십시오.

페이로드 파일에 대한 자세한 내용은 을 참조하십시오. RequestPayloadFile

참고

페이로드 파일을 지정하는 대신 속성을 사용하여 페이로드 JSON 코드를 작업에 직접 추가할 수 있습니다. RequestPayload 자세한 내용은 RequestPayload 단원을 참조하십시오.

예제를 포함한 아티팩트에 대한 자세한 내용은 을 참조하십시오. 작업 간 아티팩트 및 파일 공유

해당 UI: 구성 탭/ 아티팩트 - 선택 사항

Variables - input

(LambdaInvoke/Inputs/Variables)

(선택 사항)

작업에 사용할 수 있도록 하려는 입력 변수를 정의하는 이름/값 쌍의 시퀀스를 지정합니다. 변수 이름은 영숫자 (a-z, A-Z, 0-9), 하이픈 (-), 밑줄 (_) 로 제한됩니다. 공백은 허용되지 않습니다. 변수 이름에 특수 문자와 공백을 사용할 때는 따옴표를 사용할 수 없습니다.

예제를 비롯한 변수에 대한 자세한 내용은 을 참조하십시오워크플로에서 변수 사용.

해당 UI: 입력 탭/ 변수 - 선택 사항

Environment

(LambdaInvoke/Environment)

(필수)

작업에 사용할 CodeCatalyst 환경을 지정합니다. 작업은 선택한 환경에 VPC 지정된 AWS 계정 및 선택적 Amazon에 연결됩니다. 작업은 환경에 지정된 기본 IAM 역할을 사용하여 Amazon에 연결하고 Amazon VPC 연결에 지정된 IAM 역할을 사용하여 Amazon에 연결합니다VPC. AWS 계정

참고

기본 IAM 역할에 작업에 필요한 권한이 없는 경우 다른 역할을 사용하도록 작업을 구성할 수 있습니다. 자세한 내용은 작업의 IAM 역할 변경 단원을 참조하십시오.

환경에 대한 자세한 내용은 AWS 계정 및 에 배포 VPCs 및 을 참조하십시오환경 생성.

해당 UI: 구성 탭/ 환경

Name

(LambdaInvoke/Environment/Name)

(포함된 Environment 경우 필수)

작업에 연결할 기존 환경의 이름을 지정합니다.

해당 UI: 구성 탭/ 환경

Connections

(LambdaInvoke/Environment/Connections)

(액션의 최신 버전에서는 선택 사항, 이전 버전에서는 필수)

작업에 연결할 계정 연결을 지정합니다. 에서 최대 1개의 계정 연결을 지정할 수 Environment 있습니다.

계정 연결을 지정하지 않은 경우:

  • 작업은 CodeCatalyst 콘솔 환경에 지정된 AWS 계정 연결 및 기본 IAM 역할을 사용합니다. 환경에 계정 연결 및 기본 IAM 역할을 추가하는 방법에 대한 자세한 내용은 을 참조하십시오환경 생성.

  • 기본 IAM 역할에는 작업에 필요한 정책 및 권한이 포함되어야 합니다. 이러한 정책 및 권한이 무엇인지 확인하려면 작업 YAML 정의 설명서에서 역할 속성에 대한 설명을 참조하십시오.

계정 연결에 대한 자세한 내용은 을 참조하십시오연결된 AWS 리소스에 대한 액세스 허용 AWS 계정. 환경에 계정 연결을 추가하는 방법에 대한 자세한 내용은 을 참조하십시오환경 생성.

해당 UI: 액션 버전에 따라 다음 중 하나:

  • (최신 버전) 구성 탭/환경/내용 my-environment? /쓰리 닷 메뉴/ 역할 전환

  • (이전 버전) 구성 탭/'환경/계정/역할'/ 계정 연결AWS

Name

(LambdaInvoke/Environment/Connections/Name)

(포함된 경우 필수Connections)

계정 연결 이름을 지정합니다.

해당 UI: 액션 버전에 따라 다음 중 하나:

  • (최신 버전) 구성 탭/환경/내용 my-environment? /쓰리 닷 메뉴/ 역할 전환

  • (이전 버전) 구성 탭/'환경/계정/역할'/ 계정 연결AWS

Role

(LambdaInvoke/Environment/Connections/Role)

(포함된 경우 필수Connections)

호출 작업이 Lambda 함수에 AWS 액세스하고 AWS Lambda 호출하는 데 사용하는 IAM 역할 이름을 지정합니다. CodeCatalyst 스페이스에 역할을 추가했는지, 역할에 다음 정책이 포함되어 있는지 확인하십시오.

IAM역할을 지정하지 않으면 CodeCatalyst 콘솔 환경에 나열된 기본 IAM 역할이 작업에 사용됩니다. 환경에서 기본 역할을 사용하는 경우 해당 역할에 다음 정책이 적용되는지 확인하십시오.

  • 다음 권한 정책:

    주의

    권한을 다음 정책에 표시된 권한으로 제한하십시오. 더 광범위한 권한이 있는 역할을 사용하면 보안 위험이 발생할 수 있습니다.

    {
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "VisualEditor0",
            "Effect": "Allow",
            "Action": "lambda:InvokeFunction",
            "Resource": "arn:aws:lambda:aws-region:aws-account:function:function-name"
        }
    ]
}

  • 다음과 같은 사용자 지정 신뢰 정책:

    {
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "",
            "Effect": "Allow",
            "Principal": {
                "Service":  [
                   "codecatalyst-runner.amazonaws.com",
                   "codecatalyst.amazonaws.com"
                 ]
            },
            "Action": "sts:AssumeRole"
        }
    ]
}
참고

원하는 경우 이 작업에 CodeCatalystWorkflowDevelopmentRole-spaceName 역할을 사용할 수 있습니다. 이에 대한 자세한 내용은 계정 및 스페이스에 대한 CodeCatalystWorkflowDevelopmentRole-spaceName역할 만들기 섹션을 참조하세요. CodeCatalystWorkflowDevelopmentRole-spaceName역할에는 보안 위험을 초래할 수 있는 전체 액세스 권한이 있다는 점을 이해하세요. 보안이 덜 우려되는 자습서 및 시나리오에서만 이 역할을 사용하는 것이 좋습니다.

해당 UI: 액션 버전에 따라 다음 중 하나가 표시됩니다.

  • (최신 버전) 구성 탭/환경/내용 my-environment? /쓰리 닷 메뉴/ 역할 전환

  • (이전 버전) 구성 탭/'환경/계정/역할'/ 역할

Configuration

(LambdaInvoke/Configuration)

(필수)

작업의 구성 속성을 정의할 수 있는 섹션입니다.

해당 UI: 구성 탭

Function

(LambdaInvoke/Configuration/Function)

(필수)

이 작업이 호출할 AWS Lambda 함수를 지정합니다. 함수 이름 또는 Amazon 리소스 이름 (ARN) 을 지정할 수 있습니다. 이름 또는 Lambda ARN 콘솔에서 찾을 수 있습니다.

참고

Lambda 함수가 있는 AWS 계정은 에 지정된 계정과 다를 수 있습니다. Connections:

해당 UI: 구성 탭/ 함수

AWSRegion

(LambdaInvoke/Configuration/AWSRegion)

(필수)

AWS Lambda 함수가 있는 AWS 지역을 지정합니다. 지역 코드 목록은 의 지역별 엔드포인트를 참조하십시오. AWS 일반 참조

해당 UI: 구성 탭/ 대상 버킷 - 선택 사항

RequestPayload

(LambdaInvoke/Configuration/RequestPayload)

(선택 사항)

요청 페이로드를 AWS Lambda 호출 작업에 전달하려면 여기에 요청 페이로드를 형식으로 지정하십시오. JSON

예제 요청 페이로드:

'{ "key": "value" }'

요청 페이로드를 Lambda 함수로 전달하지 않으려면 이 속성을 생략하십시오.

참고

RequestPayload 또는 RequestPayloadFile을 지정할 수 있지만 둘 다 함께 지정할 수는 없습니다.

요청 페이로드에 대한 자세한 내용은 참조의 Invoke 주제를 참조하십시오.AWS Lambda API

해당 UI: 구성 탭/ 요청 페이로드 - 선택 사항

RequestPayloadFile

(LambdaInvoke/Configuration/RequestPayloadFile)

(선택 사항)

요청 페이로드를 AWS Lambda invoke 작업에 전달하려면 여기에 이 요청 페이로드 파일의 경로를 지정하십시오. 파일은 형식이 맞아야 합니다. JSON

요청 페이로드 파일은 소스 리포지토리 또는 이전 작업의 아티팩트에 있을 수 있습니다. 파일 경로는 소스 리포지토리 또는 아티팩트 루트를 기준으로 합니다.

요청 페이로드를 Lambda 함수로 전달하지 않으려면 이 속성을 생략하십시오.

참고

RequestPayload 또는 RequestPayloadFile을 지정할 수 있지만 둘 다 함께 지정할 수는 없습니다.

요청 페이로드 파일에 대한 자세한 내용은 참조의 Invoke 주제를 참조하십시오.AWS Lambda API

해당 UI: 구성 탭/ 요청 페이로드 파일 - 선택 사항

ContinueOnError

(LambdaInvoke/Configuration/RequestPayloadFile)

(선택 사항)

AWS Lambda 호출된 함수가 실패하더라도 호출 작업을 성공한 것으로 표시할지 여부를 지정합니다. AWS Lambda Lambda 장애에도 불구하고 워크플로의 후속 작업을 시작할 수 true 있도록 이 속성을 로 설정하는 것을 고려해 보십시오.

기본값은 Lambda 함수가 실패할 경우 작업이 실패하는 것입니다 (비주얼 false 에디터나 편집기에서는 “off”). YAML

해당 UI: 구성 탭/ 오류 발생 시 계속

LogType

(LambdaInvoke/Configuration/LogType)

(선택 사항)

호출 후 Lambda 함수의 응답에 오류 로그를 포함할지 여부를 지정합니다. 콘솔의 Lambda 호출 작업의 로그 탭에서 이러한 로그를 볼 수 있습니다. CodeCatalyst 가능한 값은 다음과 같습니다.

  • Tail— 반환 로그

  • None— 로그 반환 금지

기본값은 Tail입니다.

로그 유형에 대한 자세한 내용은 AWS Lambda API참조의 Invoke 항목을 참조하십시오.

로그 보기에 대한 자세한 내용은 워크플로 실행 상태 및 세부 정보 보기 단원을 참조하세요.

해당 UI: 구성 탭/ 로그 유형

ResponseFilters

(LambdaInvoke/Configuration/ResponseFilters)

(선택 사항)

Lambda 응답 페이로드에서 출력 변수로 변환하려는 키를 지정합니다. 그런 다음 워크플로의 후속 작업에서 출력 변수를 참조할 수 있습니다. 의 변수에 대한 자세한 내용은 CodeCatalyst 을 참조하십시오워크플로에서 변수 사용.

예를 들어 응답 페이로드가 다음과 같은 경우:

responsePayload = {
  "name": "Saanvi",
  "location": "Seattle",
  "department": {
    "company": "Amazon",
    "team": "AWS"
  }
}

... 응답 필터는 다음과 같습니다.

Configuration:
  ...
  ResponseFilters: '{"name": ".name", "company": ".department.company"}'

... 그러면 액션은 다음과 같은 출력 변수를 생성합니다.

키 값

name

Saanvi

company

Amazon

그러면 후속 작업에서 name 및 company 변수를 참조할 수 있습니다.

에서 ResponseFilters 키를 지정하지 않는 경우 작업은 Lambda 응답의 각 최상위 키를 출력 변수로 변환합니다. 자세한 내용은 'AWS Lambda Invoke' 변수 단원을 참조하십시오.

응답 필터를 사용하여 생성된 출력 변수를 실제로 사용하려는 변수로만 제한하는 것을 고려해 보십시오.

해당 UI: 구성 탭/ 응답 필터 - 선택 사항

Outputs

(LambdaInvoke/Outputs)

(선택 사항)

워크플로우 실행 중 작업에 의해 출력되는 데이터를 정의합니다.

해당 UI: 출력 탭

Artifacts

(LambdaInvoke/Outputs/Artifacts)

(선택 사항)

액션으로 생성된 아티팩트를 지정합니다. 이러한 아티팩트를 다른 작업의 입력으로 참조할 수 있습니다.

예제를 포함한 아티팩트에 대한 자세한 내용은 을 참조하십시오. 작업 간 아티팩트 및 파일 공유

해당 UI: 출력 탭/아티팩트/빌드 아티팩트 이름

Name

(LambdaInvoke/Outputs/Artifacts/Name)

(선택 사항)

Lambda 함수에서 반환되는 Lambda 응답 페이로드를 포함할 아티팩트의 이름을 지정합니다. 기본값은 lambda_artifacts입니다. 아티팩트를 지정하지 않는 경우 Lambda 응답 페이로드는 콘솔의 작업에 대한 로그 탭에서 사용할 수 있는 작업 로그에서 볼 수 있습니다. CodeCatalyst 로그 보기에 대한 자세한 내용은 워크플로 실행 상태 및 세부 정보 보기 단원을 참조하세요.

해당 UI: 출력 탭/아티팩트/빌드 아티팩트 이름

Files

(LambdaInvoke/Outputs/Artifacts/Files)

(선택 사항)

아티팩트에 포함할 파일을 지정합니다. Lambda 응답 페이로드 파일이 lambda-response.json 포함되도록 지정해야 합니다.

해당 UI: 출력 탭/아티팩트/빌드로 생성된 파일