> ## Documentation Index
> Fetch the complete documentation index at: https://docs.replit.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Workflows

> Workflows를 설정하는 방법—원하는 명령을 실행하는 구성 가능한 실행 버튼—을 알아보세요.

export const YouTubeEmbed = ({videoId, title = "YouTube video", startAt}) => {
  if (!videoId) {
    return null;
  }
  let url = "https://www.youtube.com/embed/" + videoId;
  if (startAt) {
    url = url + "?start=" + startAt;
  }
  return <Frame>
      <iframe src={url} title={title} allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowFullScreen></iframe>
    </Frame>;
};

Workflow는 Replit App 내에서 실행할 수 있는 재사용 가능하고 맞춤 설정 가능한 단계의 순서입니다. `python main.py` 실행처럼 간단하거나 여러 단계의 절차를 실행하는 것처럼 복잡할 수 있습니다.

<Frame>
  <img src="https://mintcdn.com/replit/9NKf1XREDj9JhKJb/images/workflows/workflows-pane.png?fit=max&auto=format&n=9NKf1XREDj9JhKJb&q=85&s=a4464dfb08cede3df14c1eb43d33b284" alt="image" width="525" height="622" data-path="images/workflows/workflows-pane.png" />
</Frame>

사용 사례 예시:

* 여러 서비스를 병렬로 실행 (예: 프론트엔드 + 백엔드)
* 파일 또는 명령을 순차적으로 실행 (예: 린터 실행 → 테스트 실행, 컴파일 → 코드 실행)

[워크플로우 만들기](#creating-workflows)를 시작하려면 도구 사이드바 메뉴를 사용하거나 `Command + K`를 사용하여 Workflows 창을 검색하세요.

<YouTubeEmbed videoId="I5wePXNdPwg" title="Workflows on Replit" />

## 사용 가능한 작업 유형

현재 `Execute Shell Command`, `Install Packages`, `Run Workflow` 3가지 작업 유형이 있습니다.

### Execute Shell Command

`Execute Shell Command`는 Shell 명령을 저장하고 Shell 창과 동일한 환경을 사용하여 실행합니다. 이 작업 유형은 개별 파일 실행부터:

```text theme={null}
python main.py
```

복잡한 저장된 데이터베이스 쿼리 명령 실행까지 다양한 사용 사례를 제공합니다:

```text theme={null}
psql -h 0.0.0.0 -U your_username -d your_database -c "SELECT * FROM your_table;"
```

사용 사례 예시:

<Frame>
  <img src="https://mintcdn.com/replit/9NKf1XREDj9JhKJb/images/workflows/shellExec-task-example.gif?s=f4853df72f16df0c4101788413504893" alt="image" width="908" height="602" data-path="images/workflows/shellExec-task-example.gif" />
</Frame>

### Install Packages

`Install Packages`는 Replit의 내장 의존성 관리 시스템을 활용하여 프로젝트 의존성을 자동으로 감지하고 필요한 패키지를 설치합니다. UPM이 내부적으로 프로젝트에 설치할 패키지를 어떻게 추측하는지에 대한 자세한 내용은 [의존성 관리](/references/project-setup/dependency-management#the-universal-package-manager)를 참조하세요.

사용 사례 예시:

<Frame>
  <img src="https://mintcdn.com/replit/9NKf1XREDj9JhKJb/images/workflows/packager-task-example.webp?fit=max&auto=format&n=9NKf1XREDj9JhKJb&q=85&s=713ff279fccebb7e2b2f6538eac208a8" alt="image" width="720" height="429" data-path="images/workflows/packager-task-example.webp" />
</Frame>

### Run Workflow

`Run Workflow`를 사용하면 현재 워크플로우에서 다른 워크플로우를 실행할 수 있습니다. 이를 통해 워크플로우를 재사용하고 결합하여 더 복잡한 워크플로우를 만들 수 있습니다.

사용 사례 예시:

<Frame>
  <img src="https://mintcdn.com/replit/0ixNWaRF232g0Gwn/images/workflows/example-run-workflow.webp?fit=max&auto=format&n=0ixNWaRF232g0Gwn&q=85&s=2425c11902b5801a65517c3fb221ac0b" alt="image" width="720" height="678" data-path="images/workflows/example-run-workflow.webp" />
</Frame>

이 작업 유형을 사용하여 워크플로우 간 의존성을 만들면 하나의 워크플로우를 편집할 때 이를 참조하는 다른 워크플로우가 자동으로 최신 변경 사항을 사용합니다. 깊이 중첩된 워크플로우 호출에는 깊이 제한이 있습니다.

## 워크플로우 실행 모드

Workflow는 순차적 실행과 병렬 실행 두 가지 실행 모드를 제공합니다.

### 순차적 실행

순차적 실행은 정의된 순서대로 각 작업을 실행하며, 다음 단계로 넘어가기 전에 각 작업이 완료되기를 기다립니다. 워크플로우 내의 작업이 실패하면 시퀀스 실행을 중지합니다.

이 모드의 예시는 메인 브랜치에서 최신 변경 사항을 가져온 다음 현재 브랜치를 메인 브랜치에 리베이스하는 git 명령과 같이 논리적으로 연결된 명령을 정의하는 경우입니다:

<Frame>
  <img src="https://mintcdn.com/replit/9NKf1XREDj9JhKJb/images/workflows/example-sequential-workflow.png?fit=max&auto=format&n=9NKf1XREDj9JhKJb&q=85&s=718be1d1e659dff1dc04f15ec24deb52" alt="image" width="721" height="654" data-path="images/workflows/example-sequential-workflow.png" />
</Frame>

### 병렬 실행

병렬 실행은 각 작업을 병렬로 실행하여 워크플로우 내의 다른 작업과 독립적으로 각 작업이 시작되고 실행됩니다. 하나의 작업이 실패해도 다른 작업의 실행이 중지되지 않습니다.

이 모드의 예시는 프론트엔드와 백엔드 서버 모두를 시작해야 하는 풀스택 프로젝트를 실행하는 경우입니다:

<Frame>
  <img src="https://mintcdn.com/replit/0ixNWaRF232g0Gwn/images/workflows/example-parallel-workflow.png?fit=max&auto=format&n=0ixNWaRF232g0Gwn&q=85&s=a1067b806b25e3f8722e5368fd87b48a" alt="image" width="721" height="654" data-path="images/workflows/example-parallel-workflow.png" />
</Frame>

## 워크플로우 만들기

`+ New Workflow` 버튼을 클릭하여 Workflows 창에서 워크플로우를 만들 수 있습니다. 워크플로우에 설명적인 이름을 지정하고, 적합한 실행 모드를 선택하고, 작업을 추가하기 시작하세요. 작업을 드래그 앤 드롭하여 원하는 순서로 재정렬할 수 있습니다.

<Frame>
  <img src="https://mintcdn.com/replit/9NKf1XREDj9JhKJb/images/workflows/example-workflow-setup.webp?fit=max&auto=format&n=9NKf1XREDj9JhKJb&q=85&s=deadd852b9ac26042147e7b8d597521d" alt="image" width="720" height="414" data-path="images/workflows/example-workflow-setup.webp" />
</Frame>

## Run 버튼에 워크플로우 할당

워크플로우를 Run 버튼에 할당하여 기본 Run 버튼 동작을 대체할 수도 있습니다([Replit App 구성](/references/project-setup/configuration) 참조). `.replit` 내에 구성된 기본 실행 명령을 유지하려면 드롭다운에서 기본 "Run Replit App" 옵션을 선택하세요.

Run 버튼 옆의 드롭다운 메뉴에서 선택된 워크플로우가 Run 버튼을 클릭할 때 실행됩니다. 드롭다운 메뉴에서 원하는 워크플로우를 클릭하여 Run 버튼이 실행할 워크플로우를 변경하세요.

<Frame>
  <img src="https://mintcdn.com/replit/0ixNWaRF232g0Gwn/images/workflows/configure-run-button-workflow.gif?s=b93762a559fcb83f0b3560def5e965ef" alt="image" width="588" height="254" data-path="images/workflows/configure-run-button-workflow.gif" />
</Frame>

## 워크플로우 출력 보기

워크플로우 출력은 `Console` 창에 표시됩니다. 최신 출력만 표시하도록 전환하거나 Console을 완전히 지울 수 있습니다.

<Frame>
  <img src="https://mintcdn.com/replit/9NKf1XREDj9JhKJb/images/workflows/workflow-output-view.gif?s=3b33df7f4f6e0f43e7ae2c83532c4f96" alt="image" width="706" height="434" data-path="images/workflows/workflow-output-view.gif" />
</Frame>