{"meta":{"title":"워크플로","intro":"트리거, 구문 및 고급 기능을 포함한 GitHub Actions 워크플로의 전반적인 개요를 살펴보세요.","product":"GitHub Actions","breadcrumbs":[{"href":"/ko/actions","title":"GitHub Actions"},{"href":"/ko/actions/concepts","title":"개념"},{"href":"/ko/actions/concepts/workflows-and-actions","title":"워크플로 및 작업"},{"href":"/ko/actions/concepts/workflows-and-actions/workflows","title":"워크플로"}],"documentType":"article"},"body":"# 워크플로\n\n트리거, 구문 및 고급 기능을 포함한 GitHub Actions 워크플로의 전반적인 개요를 살펴보세요.\n\n## 워크플로 정보\n\n**워크플로**는 하나 이상의 작업을 실행할 구성 가능한 자동화된 프로세스입니다. 워크플로는 리포지토리에 체크 인된 YAML 파일에서 정의되며, 리포지토리의 이벤트로 트리거될 때 실행되거나 수동으로 또는 정의된 일정에 따라 트리거될 수 있습니다.\n\n워크플로는 리포지토리의 `.github/workflows` 디렉터리에 정의됩니다. 리포지토리에 다음과 같은 각각의 다른 작업 집합을 수행하는 여러 워크플로가 있을 수 있습니다.\n\n* 끌어오기 요청을 빌드하고 테스트합니다.\n* 릴리스가 생성될 때마다 애플리케이션을 배포합니다.\n* 새 문제가 보고될 때마다 레이블을 추가합니다.\n\n## 워크플로 기본 사항\n\n워크플로에는 다음과 같은 기본 구성 요소가 포함되어야 합니다.\n\n1. 워크플로를 트리거하는 하나 이상의 *이벤트*.\n2. 하나 이상의 \\_작업\\_이며, 각 작업은 *실행기* 머신에서 실행되고 일련의 하나 이상의 \\_단계\\_를 실행합니다.\n3. 각 단계에서는 워크플로를 간소화할 수 있는 재사용 가능한 확장인 작업을 정의하거나 실행하는 스크립트를 실행할 수 있습니다.\n\n이러한 기본 구성 요소를 사용하는 방법에 관한 자세한 내용은 [GitHub Actions에 대한 이해](/ko/actions/get-started/understand-github-actions#the-components-of-github-actions)을(를) 참조하세요.\n\n![Runner 1이 작업 1을 실행하도록 트리거하는 이벤트 다이어그램으로, Runner 2를 트리거하여 작업 2를 실행합니다. 각 작업은 여러 단계로 구분됩니다.](/assets/images/help/actions/overview-actions-simple.png)\n\n## 워크플로 트리거\n\n워크플로 트리거는 워크플로를 실행하게 하는 이벤트입니다. 해당 이벤트는 다음과 같습니다.\n\n* 워크플로의 리포지토리에서 발생하는 이벤트\n* GitHub 외부에서 발생하여 `repository_dispatch`에서 GitHub 이벤트를 트리거하는 이벤트\n* 예약된 시간\n* 설명서\n\n예를 들어 리포지토리의 기본 분기로 푸시되거나, 릴리스가 생성되거나, 이슈가 열리면 실행되도록 워크플로를 구성할 수 있습니다.\n\n워크플로 트리거는 `on` 키로 정의됩니다. 자세한 내용은 [GitHub Actions에 대한 워크플로 구문](/ko/actions/reference/workflows-and-actions/workflow-syntax#on)을(를) 참조하세요.\n\n워크플로 실행을 트리거하려면 다음 단계를 수행합니다.\n\n1. 리포지토리에서 이벤트가 발생합니다. 이벤트에 연결된 커밋 SHA 및 Git 참조가 있습니다.\n2. GitHub 는 `.github/workflows` 리포지토리의 루트에 있는 디렉터리에서 이벤트의 연결된 커밋 SHA 또는 Git ref에 있는 워크플로 파일을 검색합니다.\n3. `on:` 값이 트리거 이벤트와 일치하는 모든 워크플로에 대해 워크플로 실행이 트리거됩니다. 또한 일부 이벤트를 실행하려면 워크플로 파일이 리포지토리의 기본 분기에 있어야 합니다.\n\n각 워크플로 실행은 이벤트의 연결된 커밋 SHA 또는 Git 참조에 있는 워크플로의 버전을 사용합니다. 워크플로가 실행되면 GitHub는 러너 환경에서 `GITHUB_SHA`(커밋 SHA) 및 `GITHUB_REF`(Git ref) 환경 변수를 설정합니다. 자세한 내용은 [변수에 정보 저장](/ko/actions/how-tos/write-workflows/choose-what-workflows-do/use-variables)을(를) 참조하세요.\n\n자세한 내용은 [워크플로우 시작](/ko/actions/how-tos/write-workflows/choose-when-workflows-run/trigger-a-workflow)을(를) 참조하세요.\n\n## 다음 단계\n\n첫 번째 워크플로를 빌드하려면 [예시 워크로드 만들기](/ko/actions/tutorials/create-an-example-workflow)을(를) 참조하세요."}