함께 작업하기 AWS Step Functions - AWS VS Code용 툴킷
필수 조건VS Code에서 상태 머신 작업상태 머신 템플릿상태 머신 그래프 화면코드 조각코드 완성 및 유효성 검사

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

함께 작업하기 AWS Step Functions

AWS Toolkit for Visual Studio Code (VS Code) 를 사용하여 상태 머신으로 다양한 작업을 수행할 수 있습니다.

필수 조건

  • 시스템이 VS Code용 도구 키트 설치에 필요한 필수 조건을 충족하는지 확인한 다음 해당 도구 키트를 설치하세요.

  • AWS 탐색기를 열기 전, 자격 증명이 구성되어 있는지 확인하세요.

VS Code에서 상태 머신 작업

VS 코드를 사용하여 원격 상태 머신과 상호 작용하고 상태 머신을 JSON 이나 YAML 형식으로 개발할 수 있습니다. 상태 머신을 생성 또는 업데이트하여 기존 상태 머신 목록을 나열한 후 실행하고 다운로드할 수 있습니다. 또한 VS Code를 통해 템플릿에서 새 상태 머신을 생성하고 상태 머신의 화면을 보고 코드 조각, 코드 완성 및 코드 유효성 검사를 할 수 있습니다.

기존 상태 머신 목록

상태 시스템을 이미 생성한 경우 해당 상태 시스템의 목록을 볼 수 있습니다.

  1. AWS Explorer를 엽니다.

  2. Step Functions 선택

  3. 계정에 있는 모든 상태 머신 목록이 나열되는지 확인합니다.

상태 머신 다운로드

상태 머신 다운로드하기

  1. AWS Explorer에서 다운로드할 상태 머신을 마우스 오른쪽 버튼으로 클릭합니다.

  2. 다운로드를 선택한 다음 상태 머신을 다운로드할 위치를 선택합니다.

  3. 해당 상태 머신이 올바르게 다운로드되었는지 확인합니다.

상태 시스템 생성

새 상태 머신을 직접 생성하거나 템플릿을 사용할 수 있습니다. 템플릿에서 상태 머신을 생성하는 방법에 대한 자세한 내용은 상태 머신 템플릿(State Machine Templates) 섹션을 참조하세요. 새 상태 머신 생성하기

  1. 상태 머신 정의를 사용하여 새 Amazon States Language(ASL) 파일을 생성합니다. 오른쪽 하단의 메뉴를 사용하여 Amazon States Language로 설정합니다.

  2. Step Functions에 게시(Publish to Step Functions)를 선택합니다.

  3. 빠른 생성(Quick Create)을 클릭하고 역할을 선택한 다음 상태 머신의 이름을 정합니다.

상태 머신 업데이트

상태 시스템 업데이트하기

  1. 해당 상태 시스템 정의를 사용하여 ASL 파일을 편집합니다.

  2. Step Functions에 게시(Publish to Step Functions)를 선택합니다.

  3. 빠른 업데이트(Quick Update)를 선택한 다음 업데이트할 상태 머신을 선택합니다.

상태 머신 실행

상태 머신 실행하기

  1. AWS Explorer에서 실행할 상태 머신 마우스 오른쪽 버튼으로 클릭합니다.

  2. 상태 머신에 입력합니다. 파일에서 입력과 텍스트 상자에 모두 입력을 할 수 있습니다.

  3. 상태 머신을 시작하고 잘 실행되는지 확인합니다.

상태 머신 템플릿

템플릿에서 상태 머신을 생성 할 수 있는 옵션이 있습니다. 템플릿에는 일반적으로 사용되는 여러 상태가 포함된 샘플 상태 머신 정의가 포함되어 있으며 이를 통해 시작할 수 있습니다. 상태 머신 템플릿 사용하기

  1. VS Code에서 Command Palette를 엽니다.

  2. AWS Toolkit로 새 단계 기능 상태 머신 생성(Toolkit Create a new Step Functions state machine)을 선택합니다.

  3. 사용할 템플릿을 선택합니다.

  4. JSON 또는 YAML 템플릿 형식 사용 여부를 선택합니다.

상태 머신 그래프 화면

그래프 화면을 사용하면 상태 머신의 모양을 그래픽 형식으로 볼 수 있습니다. 그래프 화면을 생성하면 탭이 열리고 상태 머신 JSON 또는 YAML 화면이 나타납니다. 작성 중인 상태 머신 정의를 해당 화면과 비교할 수 있습니다. 상태 머신 정의를 변경하면 화면도 변경됩니다.

참고

상태 머신 정의 화면을 생성하려면 정의가 활성 편집기에 열려 있어야 합니다. 정의 파일을 닫거나 이름을 바꾸면 화면이 닫힙니다.

상태 머신 그래프 화면 생성하기

  1. 상태 머신을 정의합니다.

  2. VS Code에서 Command Palette를 엽니다.

  3. 화면을 생성하려면 오른쪽 상단 가장자리에 있는 시각화 버튼을 사용하거나 AWS 렌더 그래프( Render graph)를 선택합니다.

코드 조각

코드 조각을 사용하면 짧은 코드 섹션을 삽입할 수 있습니다. 코드 조각 사용하기

  1. 파일을 열고 JSON 형식의 .asl.json 확장자 또는 YAML 형식의 .asl.yaml 확장자로 저장합니다.

  2. 상태(States) 속성을 사용하여 새 상태 머신을 생성합니다.

  3. 상태(States) 내에 커서를 둡니다.

  4. Control + Space 키 조합을 사용하여 선호하는 원하는 코드 조각을 선택합니다.

  5. Tab을 사용하여 코드 조각에서 변수 및 파라미터를 트래버스합니다.

  6. 관련 상태에 커서를 둔 다음 Retry 및 Catch 조각을 테스트합니다.

코드 완성 및 유효성 검사

코드 완성의 작동 방식 확인

  1. 여러 상태를 생성합니다.

  2. 다음 StartAt, 또는 기본 속성 뒤에 커서를 놓습니다.

  3. Control + Space 키 조합을 사용하여 사용 가능한 완성을 나열합니다. Control + Space를 사용하여 추가 속성에 액세스할 수 있으며 State의 Type을 기반으로 합니다.

  4. 작업할 때 다음에 대해 다음에 대한 코드 유효성 검사가 수행됩니다.

    • 누락된 속성

    • 잘못된 값

    • 터미널 상태 없음

    • 포인트가 지정되지만 존재하지 않는 상태