Step Functions의 워크플로 스튜디오를 사용하여 워크플로우 생성 - AWS Step Functions

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

Step Functions의 워크플로 스튜디오를 사용하여 워크플로우 생성

Step Functions Workflow Studio를 사용하여 워크플로를 생성, 편집 및 실행하는 방법을 알아봅니다. 워크플로가 준비되면 워크플로를 저장, 실행 및 내보낼 수 있습니다.

상태 시스템 생성

Workflow Studio에서는 시작 템플릿이나 빈 템플릿을 선택하여 워크플로를 만들 수 있습니다.

스타터 템플릿은 워크플로우 프로토타입과 정의를 자동으로 만들고 관련된 모든 템플릿을 배포하는 ready-to-run 샘플 프로젝트입니다. AWS 프로젝트에 필요한 리소스 AWS 계정. 이러한 스타터 템플릿을 사용하여 그대로 배포 및 실행하거나 워크플로 프로토타입을 사용하여 이를 기반으로 구축할 수 있습니다. 스타터 템플릿에 대한 자세한 내용은 Step Functions용 스타터 템플릿을 사용하여 스테이트 머신을 배포합니다. 섹션을 참조하세요.

빈 템플릿에서는 디자인 또는 코드 모드를 사용하여 사용자 지정 워크플로를 만들 수 있습니다.

스타터 템플릿을 사용하여 스테이트 머신을 생성합니다.

  1. Step Functions 콘솔을 열고 상태 시스템 생성을 선택합니다.

  2. 템플릿 선택 대화 상자에서 다음 중 하나를 수행하여 샘플 프로젝트를 선택합니다.

    • 키워드로 검색 상자에 입력한 다음 검색 결과에서 작업 타이머를 선택합니다. Task Timer

    • 오른쪽 창의 전체 아래에 나열된 샘플 프로젝트를 탐색한 다음 태스크 타이머를 선택합니다.

  3. 다음을 선택하여 계속 진행합니다.

  4. 데모 실행을 선택하여 읽기 전용 및 ready-to-deploy 워크플로를 만들거나 빌드 온을 선택하여 빌드하고 나중에 배포할 수 있는 편집 가능한 상태 머신 정의를 생성합니다.

  5. 템플릿 사용을 선택하여 계속 선택합니다.

다음 단계는 이전 선택에 따라 달라집니다.

  1. 데모 실행 — 에서 배포한 리소스로 읽기 전용 프로젝트를 만들기 전에 상태 머신을 검토할 수 있습니다. AWS CloudFormation 다음 주소로 AWS 계정.

    상태 머신 정의를 볼 수 있으며 준비가 되면 Deploy and run을 선택하여 프로젝트를 배포하고 리소스를 생성할 수 있습니다.

    배포하는 데 리소스 및 권한을 생성하는 데 최대 10분이 걸릴 수 있습니다. Stack ID 링크를 사용하여 진행 상황을 모니터링할 수 있습니다. AWS CloudFormation.

    배포가 완료되면 콘솔에서 새 상태 머신을 확인할 수 있습니다.

  2. 기반 구축 — 워크플로 정의를 검토하고 편집할 수 있습니다. 사용자 지정 워크플로를 실행하기 전에 샘플 프로젝트에서 자리 표시자의 값을 설정해야 할 수도 있습니다.

참고

계정에 배포된 서비스에는 표준 요금이 적용될 수 있습니다.

빈 템플릿을 사용하여 워크플로 만들기

깔끔한 캔버스에서 시작하려면 빈 템플릿으로 워크플로를 만드세요.

  1. Step Functions 콘솔을 엽니다.

  2. 상태 머신 생성을 선택합니다.

  3. 템플릿 선택 대화 상자에서 공백을 선택합니다.

  4. 선택을 선택하여 워크플로 스튜디오를 에서 엽니다디자인 모드.

    이제 디자인 모드에서 워크플로를 디자인하거나 코드 모드에서 워크플로 정의를 작성할 수 있습니다.

  5. 구성을 선택하여 구성 모드에서 워크플로 구성을 관리합니다. 예를 들어 워크플로 이름을 입력하고 해당 유형을 선택합니다.

워크플로 설계

추가하려는 주의 이름을 알면 상단의 검색 상자를 사용하여 해당 주를 찾을 상태 브라우저 수 있습니다. 그렇지 않으면 브라우저에서 필요한 상태를 찾아 캔버스에 추가하세요.

워크플로의 상태를 워크플로의 다른 위치로 드래그하여 워크플로의 상태를 재정렬할 수 있습니다. 상태를 캔버스로 드래그하면 다음 스크린샷과 같이 워크플로에 상태가 삽입될 위치를 나타내는 선이 나타납니다.

주의 목적지를 나타내는 파란색 선을 보여 주는 예시 스크린샷.

상태를 캔버스에 놓으면 해당 코드가 자동으로 생성되어 워크플로 정의에 추가됩니다. 정의를 보려면 Inspector 패널에서 정의 토글을 켭니다. 내장된 코드 편집기를 사용하여 정의를 코드 모드 편집하도록 선택할 수 있습니다.

상태를 캔버스에 놓으면 오른쪽의 인스펙터 패널 패널에서 상태를 구성할 수 있습니다. 이 패널에는 캔버스에 배치하는 각 상태 또는 API 작업에 대한 구성, 입력, 출력오류 처리 탭이 있습니다. 구성 탭에서 워크플로에 포함할 상태를 구성합니다.

예를 들어, Lambda API Invoke 작업에 대한 구성 탭은 다음 옵션을 제공합니다.

  • 상태 이름: 사용자 지정 이름으로 상태를 식별하거나 기본 생성 이름을 사용할 수 있습니다.

  • API주에서 어떤 API 작업을 사용하는지 보여줍니다.

  • 통합 유형: 다른 서비스에서 API 작업을 호출하는 데 사용할 서비스 통합 유형을 선택할 수 있습니다.

  • 함수 이름은 다음과 같은 옵션을 제공합니다.

    • 함수 이름 입력: 함수 이름 또는 함수 이름을 입력할 수 ARN 있습니다.

    • 런타임 시 상태 입력에서 함수 이름 가져오기: 이 옵션을 사용하면 지정한 경로를 기반으로 상태 입력에서 함수 이름을 동적으로 가져올 수 있습니다.

    • 함수 이름 선택: 계정 및 리전에서 사용할 수 있는 함수 중에서 직접 선택할 수 있습니다.

  • 페이로드: Lambda 함수에 페이로드로 전달할 상태 입력, JSON 객체 또는 페이로드 없음을 선택할 수 있습니다. 원하는 경우 정적 값과 상태 입력에서 선택한 값을 모두 포함할 수 있습니다. JSON

  • (선택 사항) 일부 상태에는 태스크 완료 대기 또는 콜백 대기를 선택할 수 있는 옵션이 있습니다. 가능한 경우 다음 서비스 통합 패턴 중 하나를 선택할 수 있습니다.

    • 선택한 옵션 없음: Step Functions에서 요청 및 응답 통합 패턴을 사용합니다. Step HTTP Functions는 응답을 기다린 후 다음 상태로 진행합니다. Step Functions는 작업이 완료될 때까지 기다리지 않습니다. 사용할 수 있는 옵션이 없으면 상태에서 이 패턴을 사용합니다.

    • 태스크 완료 대기: Step Functions에서 작업 실행(.sync) 통합 패턴을 사용합니다.

    • 콜백 대기: Step Functions에서 태스크 토큰으로 콜백이 올 때까지 기다리세요. 통합 패턴을 사용합니다.

  • (선택 사항) 서로 다르게 구성된 리소스에 액세스하려면 AWS 계정 워크플로우 내에서 Step Functions는 계정 간 액세스를 제공합니다. IAM교차 계정 액세스 역할은 다음과 같은 옵션을 제공합니다.

    • IAM역할 제공 ARN: 적절한 리소스 액세스 권한이 포함된 IAM 역할을 지정합니다. 이러한 리소스는 대상 계정, 즉 다음과 같은 계정에서 사용할 수 있습니다. AWS 계정 이를 통해 계정 간 통화를 할 수 있습니다.

    • 상태 입력에서 런타임 ARN 시 IAM 역할 가져오기: 역할이 포함된 상태 JSON 입력의 기존 키-값 쌍에 대한 참조 경로를 지정합니다. IAM

  • 다음 상태를 사용하면 다음에 전환할 상태를 선택할 수 있습니다.

  • (선택 사항) 코멘트 필드는 워크플로에 영향을 주지 않지만 워크플로에 주석을 다는 데 사용할 수 있습니다.

일부 주에는 일반 구성 옵션이 추가로 제공됩니다. 예를 들어 Amazon ECS RunTask 상태 구성에는 자리 표시자 값으로 채워진 API Parameters 필드가 포함되어 있습니다. 이러한 상태에서는 자리 표시자 값을 필요에 맞는 구성으로 바꿀 수 있습니다.

상태를 삭제하려면

백스페이스 키를 누르고 마우스 오른쪽 버튼을 클릭한 다음 상태 삭제를 선택하거나 디자인 도구 모음에서 삭제를 선택할 수 있습니다.

워크로드 실행

워크플로를 사용할 준비가 되면 Step Functions 콘솔에서 실행하고 실행을 확인할 수 있습니다.

Workflow Studio에서 워크플로 실행하기
  1. 설계, 코드 또는 구성 모드에서 실행을 선택합니다.

    새 탭에 실행 시작 대화 상자가 열립니다.

  2. 실행 시작 대화 상자에서 다음을 수행합니다.

    1. (선택 사항) 생성된 기본값을 재정의하려면 사용자 지정 실행 이름을 입력합니다.

      ASCII비이름 및 로깅

      Step Functions는 ASCII -자가 아닌 문자를 포함하는 상태 머신, 실행, 액티비티 및 레이블의 이름을 허용합니다. CloudWatchAmazon에서는 이러한 문자를 사용할 수 없으므로 지표를 추적할 수 있도록 ASCII 문자만 사용하는 것이 좋습니다 CloudWatch.

    2. (선택 사항) 입력 상자에 워크플로를 실행하는 데 필요한 JSON 형식으로 입력 값을 입력합니다.

    3. 실행 시작을 선택합니다.

    4. Step Functions 콘솔은 실행 ID가 제목인 페이지로 이동합니다. 이 페이지를 실행 세부 정보 페이지라고 합니다. 실행이 진행되는 동안 또는 완료된 후에 이 페이지에서 실행 결과를 검토할 수 있습니다.

      실행 결과를 검토하려면 그래프 보기에서 개별 상태를 선택한 다음 단계 세부 정보 창에서 개별 탭을 선택하여 입력, 출력 및 정의가 포함된 각 상태의 세부 정보를 각각 봅니다. 실행 세부 정보 페이지에서 볼 수 있는 실행 정보에 대한 자세한 내용은 실행 세부 정보 개요 섹션을 참조하세요.

워크플로 편집

Workflow Studio의 디자인 모드에서 기존 워크플로를 시각적으로 편집할 수 있습니다.

Step Functions 콘솔의 상태 시스템 페이지에서 편집할 워크플로를 선택합니다. Workflow Studio의 디자인 모드에서 워크플로가 열립니다.

에서 워크플로 정의를 편집할 수도 코드 모드 있습니다. Workflow Studio에서 워크플로 정의를 보거나 편집하려면 코드 버튼을 선택합니다.

참고

워크플로에 오류가 있으면 디자인 모드에서 오류를 수정해야 합니다. 워크플로에 오류가 있으면 코드 또는 구성 모드로 전환할 수 없습니다.

워크플로 내보내기

워크플로의 Amazon States Language (ASL) 정의와 워크플로 그래프를 내보낼 수 있습니다.

  1. Step Functions 콘솔에서 워크플로를 선택합니다.

  2. 상태 시스템 세부 정보 페이지에서 편집을 선택합니다.

  3. 작업 드롭다운 버튼을 선택한 후 다음 중 하나 또는 둘 다 모두 수행합니다.

    • 워크플로 그래프를 SVG 또는 PNG 파일로 내보내려면 그래프 내보내기에서 원하는 형식을 선택합니다.

    • 워크플로우 정의를 JSON or YAML 파일로 내보내려면 정의 내보내기에서 원하는 형식을 선택합니다.

자리 표시자가 있는 워크플로우 프로토타입 만들기

에서 워크플로 스튜디오 또는 워크플로 스튜디오를 사용할 수 있습니다.Application Composer아직 존재하지 않는 리소스로 이름이 지정된 자리 표시자 리소스를 포함하는 새 워크플로의 프로토타입을 만들 수 있습니다.

워크플로 프로토타입을 만들려면:

  1. Step Functions 콘솔에 로그인합니다.

  2. 상태 머신 생성을 선택합니다.

  3. 템플릿 선택 대화 상자에서 공백을 선택합니다.

  4. 선택을 선택하여 에서 워크플로 스튜디오를 엽니다디자인 모드.

  5. Workflow Studio의 디자인 모드가 열립니다. Workflow Studio에서 워크플로를 설계합니다. 자리 표시자 리소스 포함하기

    1. 자리 표시자 리소스를 포함하려는 상태를 선택한 다음 구성에서 다음을 선택합니다.

      • Lambda Invoke 상태의 경우 함수 이름을 선택한 다음 함수 이름 입력을 선택합니다. 함수 이름에 사용자 지정 이름을 입력할 수도 있습니다.

      • Amazon SQS Send Message 상태의 URL 경우 대기열을 선택한 다음 대기열 입력을 선택합니다URL. 플레이스홀더 대기열을 URL 입력합니다.

      • Amazon SNS Publish 상태의 경우 주제에서 주제를 선택합니다ARN.

      • 작업에 나열된 다른 모든 상태의 경우 기본 구성을 사용할 수 있습니다.

      참고

      워크플로에 오류가 있으면 디자인 모드에서 오류를 수정해야 합니다. 워크플로에 오류가 있으면 코드 또는 구성 모드로 전환할 수 없습니다.

    2. (선택 사항) 워크플로의 자동 생성된 ASL 정의를 보려면 [정의] 를 선택합니다.

    3. (선택 사항) Workflow Studio에서 워크플로 정의를 업데이트하려면 코드 버튼을 선택합니다.

      참고

      워크플로 정의에 오류가 있으면 코드 모드에서 오류를 수정해야 합니다. 워크플로 정의에 오류가 있으면 디자인 또는 구성 모드로 전환할 수 없습니다.

  6. (선택 사항) 상태 시스템 이름을 편집하려면 기본 상태 시스템 이름 옆에 있는 편집 아이콘을 선택하고 상태 시스템 이름 상자에 이름을 지정합니다. MyStateMachine

    구성 모드로 전환하여 기본 상태 시스템 이름을 편집할 수도 있습니다.

  7. 상태 시스템 유형 및 실행 역할과 같은 워크플로 설정을 지정합니다.

  8. 생성(Create)을 선택합니다.

이제 프로토타입을 만드는 데 사용할 수 있는 자리 표시자 리소스가 포함된 새 워크플로를 만들었습니다. 워크플로 정의와 워크플로 그래프를 내보낼 수 있습니다.

  • 워크플로 정의를 JSON or YAML 파일로 내보내려면 디자인 또는 코드 모드에서 작업 드롭다운 버튼을 선택합니다. 그런 다음 내보내기 정의의에서 내보내려는 형식을 선택합니다. 내보낸 이 정의를 로컬 개발의 출발점으로 사용하여 다음을 수행할 수 있습니다. AWS Toolkit for Visual Studio Code.

  • 워크플로 그래프를 SVG or PNG 파일로 내보내려면 디자인 또는 코드 모드에서 작업 드롭다운 버튼을 선택합니다. 그런 다음 내보내기 정의에서 원하는 형식을 선택합니다.