Ec2Resource

파이프라인 활동에 의해 정의된 작업을 수행하는 Amazon EC2 인스턴스입니다.

AWS Data Pipeline 는 이제 세션 지향 방법을 사용하여 인스턴스에서 메타데이터 정보를 검색할 때 인증을 더 잘 처리하는 Amazon EC2 인스턴스에 대해 IMDSv2를 지원합니다. Amazon EC2 세션은 Amazon EC2 인스턴스에서 실행되는 소프트웨어가 로컬에 저장된 Amazon EC2 인스턴스 메타데이터 및 자격 증명에 액세스하는 데 사용하는 일련의 요청을 시작하고 종료합니다. 소프트웨어는 IMDSv2에 대한 간단한 HTTP PUT 요청으로 세션을 시작합니다. IMDSv2는 Amazon EC2 인스턴스에서 실행되는 소프트웨어에 비밀 토큰을 반환하며, 이 소프트웨어는 토큰을 암호로 사용하여 IMDSv2에 메타데이터 및 자격 증명을 요청합니다.

참고

기본 AMI는 IMDSv2와 호환되지 않으므로 Amazon EC2 인스턴스에 IMDSv2를 사용하려면 설정을 수정해야 합니다. 다음 SSM 파라미터 /aws/service/ami-amazon-linux-latest/amzn-ami-hvm-x86_64-ebs을(를) 통해 검색할 수 있는 새 AMI 버전을 지정할 수 있습니다.

인스턴스를 지정하지 않을 경우에서 AWS Data Pipeline 생성하는 기본 Amazon EC2 인스턴스에 대한 자세한 내용은 섹션을 참조하세요 AWS 리전에 의한 기본 Amazon EC2 인스턴스.

예시

EC2-Classic

중요

2013년 12월 4일 이전에 생성된 AWS 계정만 EC2-Classic 플랫폼을 지원합니다. 이러한 계정 중 하나가 있는 경우 VPC보다 오히려 EC2-Classic 네트워크의 파이프라인에 대해 EC2Resource 객체를 생성할 수 있는 옵션이 있을 수 있습니다. VPC에서 모든 파이프라인의 리소스를 생성하는 것을 강력히 권장합니다. 또한 EC2-Classic에 기존 리소스가 있는 경우 이를 VPC로 마이그레이션하는 것이 좋습니다.

다음 예제 객체는 일부 옵션 필드가 설정된 EC2-Classic에서 EC2 인스턴스를 시작합니다.

{
  "id" : "MyEC2Resource",
  "type" : "Ec2Resource",
  "actionOnTaskFailure" : "terminate",
  "actionOnResourceFailure" : "retryAll",
  "maximumRetries" : "1",
  "instanceType" : "m5.large",
  "securityGroups" : [
    "test-group",
    "default"
  ],
  "keyPair" : "my-key-pair"
}

EC2-VPC

다음 예제 객체는 일부 옵션 필드가 설정된 기본이 아닌 VPC에서 EC2 인스턴스를 시작합니다.

{
  "id" : "MyEC2Resource",
  "type" : "Ec2Resource",
  "actionOnTaskFailure" : "terminate",
  "actionOnResourceFailure" : "retryAll",
  "maximumRetries" : "1",
  "instanceType" : "m5.large",
  "securityGroupIds" : [
    "sg-12345678",
    "sg-12345678"
  ],
  "subnetId": "subnet-12345678",
  "associatePublicIpAddress": "true",
  "keyPair" : "my-key-pair"
}

구문

필수 필드	설명	슬롯 유형
resourceRole	Amazon EC2 인스턴스가 액세스할 수 있는 리소스를 제어하는 IAM 역할입니다.	String
role	가 EC2 인스턴스를 생성하는 데 AWS Data Pipeline 사용하는 IAM 역할입니다.	String

액체 호출 필드	설명	슬롯 유형
schedule	이 객체는 예약 간격을 실행할 때 호출됩니다. 이 객체의 종속 실행 순서를 설정하려면 다른 객체로 일정 참조를 지정합니다. 이 작업을 다음 중 한 가지 방법으로 수행할 수 있습니다. 파이프라인의 모든 객체가 일정을 상속받도록 하려면 명시 적으로 객체에 일정을 설정합니다. "schedule": {"ref": "DefaultSchedule"}. 대부분의 경우에서는 모든 객체가 상속할 수 있도록 일정 참조를 기본 파이프라인 객체에 두는 것이 유용합니다. 파이프라인에 마스터 일정 내에서 중첩된 일정이 있는 경우, 일정 참조가 있는 부모 객체를 생성할 수 있습니다. 선택형 일정 구성 예제에 대한 자세한 내용은 https://docs.aws.amazon.com/datapipeline/latest/DeveloperGuide/dp-object-schedule.html 단원을 참조하십시오.	참조 객체, 예: "schedule":{"ref":"myScheduleId"}

선택 필드	설명	슬롯 유형
actionOnResourceFailure	이 리소스의 리소스 실패 후 취한 조치입니다. 유효 값은 "retryall"및 "retrynone"입니다.	String
actionOnTaskFailure	이 리소스의 작업 실패 후 취한 조치입니다. 유효한 값은 "continue" 또는 "terminate"입니다.	String
associatePublicIpAddress	인터페이스로 퍼블릭 IP 주소를 할당할지 여부를 나타냅니다. 인스턴스가 Amazon EC2 또는 Amazon VPC에 포함된 경우 기본값은 true입니다. 그렇지 않은 경우 기본값은 false입니다.	불
attemptStatus	원격 활동에서 가장 최근에 보고된 상태입니다.	String
attemptTimeout	원격 작업 완료의 제한 시간입니다. 이 필드를 설정하면 지정된 시작 시간 이내에 완료되지 않는 원격 활동을 재시도할 수 있습니다.	기간
availabilityZone	Amazon EC2 인스턴스를 시작할 가용 영역입니다.	String
disableIMDSv1	기본값은 false이며 IMDSv1 및 IMDSv2를 모두 활성화합니다. 이 값을 true로 설정하면 IMDSv1이 비활성화되고 IMDSv2만 제공됩니다.	불
failureAndRerunMode	종속 요소에 장애가 있거나 재시도될 때의 소비자 노드 거동을 설명합니다.	열거
httpProxy	클라이언트가 AWS 서비스에 연결하는 데 사용하는 프록시 호스트입니다.	참조 객체, 예: "httpProxy":{"ref":"myHttpProxyId"}
imageId	인스턴스에 사용할 AMI의 ID입니다. 기본적으로 HVM AMI 가상화 유형을 AWS Data Pipeline 사용합니다. 사용되는 특정 AMI ID는 리전을 기반으로 합니다. HVM AMI를 선택 지정하여 기본 AMI를 겹쳐쓸 수 있습니다. AMI 유형에 대한 자세한 내용은 Amazon EC2 사용 설명서의 Linux AMI 가상화 유형 및 Linux AMI 찾기를 참조하세요.	String
initTimeout	리소스가 시작되기 전까지의 대기 시간입니다.	기간
instanceCount	사용되지 않음.	Integer
instanceType	시작할 Amazon EC2 인스턴스의 유형입니다.	String
keyPair	키 페어 이름. 키 쌍을 지정하지 않고 Amazon EC2 인스턴스를 시작하면 인스턴스에 로그온되지 않습니다.	String
lateAfterTimeout	파이프라인 시작 후 객체가 완료되어야 하는 경과 시간입니다. 스케줄 유형이 ondemand(으)로 설정되지 않은 경우에만 트리거됩니다.	기간
maxActiveInstances	구성요소의 동시 활성 인스턴스 최대수입니다. 재실행은 활성 인스턴스의 수에 포함되지 않습니다.	Integer
maximumRetries	장애 시 재시도 최대 횟수.	Integer
minInstanceCount	사용되지 않음.	Integer
onFail	현재 객체에 장애가 있을 때 실행할 작업입니다.	참조 객체, 예: "onFail":{"ref":"myActionId"}
onLateAction	객체가 아직 예약되지 않았거나 계속 실행 중인 경우에 트리거되어야 하는 작업입니다.	참조 객체, 예: "onLateAction":{"ref":"myActionId"}
onSuccess	현재 객체가 성공하면 실행할 작업입니다.	참조 객체, 예: "onSuccess":{"ref":"myActionId"}
parent	슬롯을 상속해 올 현재 객체의 상위 객체입니다.	참조 객체, 예: "parent":{"ref":"myBaseObjectId"}
pipelineLogUri	파이프라인의 로그를 업로드할 Amazon S3 URI(예: 's3://BucketName/Key/')입니다.	String
리전	Amazon EC2 인스턴스가 실행되어야 할 리전의 코드입니다. 기본적으로 인스턴스는 파이프라인과 동일한 리전에서 실행됩니다. 종속 데이터 세트와 동일한 리전에서 인스턴스를 실행할 수 있습니다.	열거
reportProgressTimeout	원격 작업에서 reportProgress를 연속으로 호출하는 제한 시간입니다. 이것이 설정되면 지정 기간 동안 진행 상황을 보고하지 않는 원격 활동은 중단된 것으로 간주되어 재시도됩니다.	기간
retryDelay	두 번의 재시도 사이의 제한 시간 간격입니다.	기간
runAsUser	TaskRunner를 실행할 사용자.	String
runsOn	이 객체에서는 이 필드가 허용되지 않습니다.	참조 객체, 예:"runsOn":{"ref":"myResourceId"}
scheduleType	일정 유형을 사용하여 파이프라인 정의에 있는 객체의 일정을 간격 시작 시점으로, 종료 시점으로 또는 필요할 때 지정할 수 있습니다. 유효한 값: timeseries. 각 간격이 종료될 때 인스턴스 일정이 지정됩니다. cron. 각 간격이 시작할 때 인스턴스 일정이 지정됩니다. ondemand. 활성화될 때마다 한 번씩 파이프라인을 실행할 수 있습니다. 그러므로 다시 실행하기 위해 파이프라인을 복제하거나 다시 생성할 필요가 없습니다. 온디맨드 일정을 사용하려면 기본 객체에서 지정해야 하며, 이것이 파이프라인의 객체에 지정된 유일한 scheduleType이어야 합니다. 온디맨드 파이프라인을 사용하려면 후속 실행마다 ActivatePipeline 작업을 호출하십시오.	열거
securityGroupIds	리소스 풀의 인스턴스에 대해 사용할 하나 이상의 Amazon EC2 보안 그룹의 ID입니다.	String
securityGroups	리소스 풀의 인스턴스에 대해 사용할 하나 이상의 Amazon EC2 보안 그룹입니다.	String
spotBidPrice	스팟 인스턴스의 시간당 최대 금액(달러)이며, 0 초과 20.00 미만의 십진수 값입니다.	String
subnetId	인스턴스를 시작할 Amazon EC2 서브넷의 ID입니다.	String
terminateAfter	이 숫자만큼의 시간이 지난 뒤 리소스를 종료합니다.	기간
useOnDemandOnLastAttempt	스팟 인스턴스를 마지막으로 요청할 때 스팟 인스턴스가 아니라 온디맨드 인스턴스를 요청합니다. 이렇게 하면 이전의 시도가 모두 실패했어도 마지막 시도가 중단되지 않습니다.	불
workerGroup	이 객체에서는 이 필드가 허용되지 않습니다.	String

실행 시간 필드	설명	슬롯 유형
@activeInstances	현재 예약되어 있는 활성 인스턴스 객체의 목록입니다.	참조 객체, 예:"activeInstances":{"ref":"myRunnableObjectId"}
@actualEndTime	이 객체의 실행이 완료된 시간입니다.	DateTime
@actualStartTime	이 객체의 실행이 시작된 시간입니다.	DateTime
cancellationReason	이 객체가 취소된 경우의 cancellationReason입니다.	String
@cascadeFailedOn	객체 실패가 발생한 종속 체인에 대한 설명입니다.	참조 객체, 예:"cascadeFailedOn":{"ref":"myRunnableObjectId"}
emrStepLog	Amazon EMR 활동을 시도할 때만 사용할 수 있는 단계 로그.	String
errorId	이 객체가 실패한 경우의 오류 ID입니다.	String
errorMessage	이 객체가 실패한 경우의 오류 메시지입니다.	String
errorStackTrace	이 객체가 실패한 경우의 오류 스택 트레이스입니다.	String
@failureReason	리소스 실패 이유입니다.	String
@finishedTime	이 객체의 실행이 완료된 시간입니다.	DateTime
hadoopJobLog	Amazon EMR 활동을 시도할 때 사용할 수 있는 Hadoop 작업 로그.	문자열
@healthStatus	종료 상태에 도달한 마지막 객체 인스턴스의 성공 또는 실패를 나타내는 객체의 상태입니다.	String
@healthStatusFromInstanceId	종료 상태에 도달한 마지막 인스턴스 객체의 ID입니다.	String
@healthStatusUpdatedTime	상태가 마지막으로 업데이트된 시간입니다.	DateTime
hostname	작업 시도를 선택한 클라이언트의 호스트 이름입니다.	String
@lastDeactivatedTime	이 객체가 마지막으로 비활성화된 시간입니다.	DateTime
@latestCompletedRunTime	실행이 완료된 최근 실행 시간입니다.	DateTime
@latestRunTime	실행이 예약된 최근 실행 시간입니다.	DateTime
@nextRunTime	다음으로 예약된 실행 시간입니다.	DateTime
reportProgressTime	원격 활동에서 진행 상황을 보고한 가장 최근 시간입니다.	DateTime
@scheduledEndTime	객체의 일정 종료 시간.	DateTime
@scheduledStartTime	객체의 일정 시작 시간.	DateTime
@상태	이 객체의 상태입니다.	String
@version	객체를 생성할 당시의 파이프라인 버전입니다.	String
@waitingOn	이 객체가 대기 중인 종속 요소 목록에 대한 설명입니다.	참조 객체, 예: "waitingOn":{"ref":"myRunnableObjectId"}

시스템 필드	설명	슬롯 유형
@오류	잘못 형성된 객체를 설명하는 오류.	String
@pipelineId	이 객체가 속하는 파이프라인의 ID.	String
@sphere	수명 주기상 객체의 위치. 구성요소 객체가 인스턴스 객체를 트리거하고, 인스턴스 객체는 시도 객체를 실행합니다.	String