{"meta":{"title":"GitHub Actions에 대한 빠른 시작 가이드","intro":"몇 분 만에 GitHub Actions의 핵심 기능을 사용해 보세요.","product":"GitHub Actions","breadcrumbs":[{"href":"/ko/actions","title":"GitHub Actions"},{"href":"/ko/actions/get-started","title":"시작하기"},{"href":"/ko/actions/get-started/quickstart","title":"빠른 시작"}],"documentType":"article"},"body":"# GitHub Actions에 대한 빠른 시작 가이드\n\n몇 분 만에 GitHub Actions의 핵심 기능을 사용해 보세요.\n\n## 소개\n\nGitHub Actions는 빌드, 테스트 및 배포 파이프라인을 자동화할 수 있는 CI/CD(연속 통합 및 지속적인 업데이트) 플랫폼입니다. 리포지토리에 변경 내용을 푸시하거나 병합된 끌어오기 요청을 프로덕션에 배포할 때마다 테스트를 실행하는 워크플로를 만들 수 있습니다.\n\n이 빠른 시작 가이드에서는 사용자 인터페이스 GitHub 를 사용하여 몇 가지 필수 기능을 GitHub Actions보여 주는 워크플로를 추가하는 방법을 보여 줍니다.\n\n미리 구성된 워크플로를 시작하려면 [actions/starter-workflows](https://github.com/actions/starter-workflows) 리포지토리의 템플릿 목록을 탐색합니다. 자세한 내용은 [워크플로 템플릿 사용](/ko/actions/how-tos/write-workflows/use-workflow-templates)을(를) 참조하세요.\n\n워크플로 개요 GitHub Actions 는 [워크플로](/ko/actions/concepts/workflows-and-actions/workflows)을 참조하세요. 구성하는 GitHub Actions다양한 구성 요소에 대해 알아보려면 [GitHub Actions에 대한 이해](/ko/actions/get-started/understand-github-actions)을 참조하세요.\n\n## 워크플로 템플릿 사용\n\nGitHub는 미리 구성된 워크플로 템플릿을 제공하며, 이를 그대로 사용하거나 사용자 지정하여 자신만의 워크플로를 만들 수 있습니다. GitHub는 코드를 분석하여 리포지토리에 유용할 수 있는 워크플로 템플릿을 보여줍니다. 예를 들어 리포지토리에 Node.js 코드가 포함된 경우 Node.js 프로젝트에 대한 제안이 표시됩니다.\n\n이러한 워크플로 템플릿은 빠르게 시작하고 실행할 수 있도록 설계되어 다음과 같은 다양한 구성을 제공합니다.\n\n* CI: [연속 통합 워크플로](https://github.com/actions/starter-workflows/tree/main/ci)\n* 배포: [배포 워크플로](https://github.com/actions/starter-workflows/tree/main/deployments)\n* 자동화: [워크플로 자동화](https://github.com/actions/starter-workflows/tree/main/automation)\n* 코드 검사: [코드 검사 워크플로](https://github.com/actions/starter-workflows/tree/main/code-scanning)\n* 페이지: [페이지 워크플로](https://github.com/actions/starter-workflows/tree/main/pages)\n\n워크플로 템플릿을 시작 위치로 사용하여 사용자 지정 워크플로를 빌드하거나 있는 그대로 사용할 수 있습니다. [actions/starter-workflows](https://github.com/actions/starter-workflows) 리포지토리에서 워크플로 템플릿의 전체 목록을 찾아볼 수 있습니다.\n\n## 필수 조건\n\n이 가이드는 다음을 전제로 합니다.\n\n* 사용 GitHub방법에 대한 기본 지식이 있습니다. 그렇지 않은 경우 리포지토리와 pull request에 대한 설명서의 일부 문서를 먼저 읽으면 도움이 됩니다. 예를 들어, [리포지토리를 위한 빠른 시작 가이드](/ko/repositories/creating-and-managing-repositories/quickstart-for-repositories), [지점](/ko/pull-requests/reference/branches), [끌어오기 요청](/ko/pull-requests/reference/pull-requests)을(를) 참조하세요.\n* 파일을 추가할 수 있는 위치에 대한 GitHub 리포지토리가 있습니다.\n* GitHub Actions에 액세스할 수 있습니다.\n\n > \\[!NOTE]\n > \\*\\* 작업\\*\\* 탭이 리포지토리의 이름 아래에 표시되지 않으면 리포지토리에 GitHub대해 작업이 비활성화되었기 때문일 수 있습니다. 자세한 내용은 [리포지토리에 대한 GitHub Actions 설정 관리](/ko/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository)을(를) 참조하세요.\n\n## 첫 번째 워크플로 만들기\n\n1. GitHub의 리포지토리에서 `.github/workflows` 디렉터리에 `github-actions-demo.yml`라는 이름의 워크플로 파일을 만드세요. 방법:\n * `.github/workflows` 디렉터리가 이미 있는 경우 해당 디렉터리GitHub로 이동하여 **파일 추가**를 클릭한 다음 **새 파일 만들기**를 클릭하고 파일 `github-actions-demo.yml`이름을 지정합니다.\n\n * 리포지토리에 디렉터리가 없는 `.github/workflows` 경우 리포 GitHub지토리의 기본 페이지로 이동하여 **파일 추가**를 클릭한 다음 **새 파일 만들기**를 클릭하고 파일 `.github/workflows/github-actions-demo.yml`이름을 지정합니다. 이렇게 하면 한 번에 `.github` 및 `workflows` 디렉터리와 `github-actions-demo.yml` 파일이 만들어집니다.\n > \\[!NOTE]\n > GitHub이(가) 리포지토리에서 GitHub Actions 워크플로를 찾을 수 있으려면 워크플로 파일은 `.github/workflows`라는 디렉터리에 저장해야 합니다.\n >\n > 워크플로 파일에 원하는 이름을 지정할 수 있지만 파일 이름 확장명으로 `.yml` 또는 `.yaml`을 사용해야 합니다. YAML은 구성 파일에 일반적으로 사용되는 생성 언어입니다.\n\n2. 다음 YAML 콘텐츠를 `github-actions-demo.yml` 파일에 복사합니다.\n\n ```yaml copy\n name: GitHub Actions Demo\n run-name: ${{ github.actor }} is testing out GitHub Actions 🚀\n on: [push]\n jobs:\n Explore-GitHub-Actions:\n runs-on: ubuntu-latest\n steps:\n - run: echo \"🎉 The job was automatically triggered by a ${{ github.event_name }} event.\"\n - run: echo \"🐧 This job is now running on a ${{ runner.os }} server hosted by GitHub!\"\n - run: echo \"🔎 The name of your branch is ${{ github.ref }} and your repository is ${{ github.repository }}.\"\n - name: Check out repository code\n uses: actions/checkout@v6\n - run: echo \"💡 The ${{ github.repository }} repository has been cloned to the runner.\"\n - run: echo \"🖥️ The workflow is now ready to test your code on the runner.\"\n - name: List files in the repository\n run: |\n ls ${{ github.workspace }}\n - run: echo \"🍏 This job's status is ${{ job.status }}.\"\n ```\n\n 이 단계에서는 이 워크플로의 세부 정보를 이해할 필요가 없습니다. 지금은 내용을 복사하여 파일에 붙여넣기만 하면 됩니다. 이 빠른 시작 가이드를 완료하면 [워크플로](/ko/actions/concepts/workflows-and-actions/workflows)에서 워크플로 파일의 구문에 대해 알아볼 수 있으며, GitHub Actions 컨텍스트(예: `${{ github.actor }}`, `${{ github.event_name }}`)에 대한 설명은 [문맥 참조](/ko/actions/reference/workflows-and-actions/contexts)을 참조하세요.\n\n3. **변경 내용 커밋**을 클릭합니다.\n\n4. \"변경 내용 제안\" 대화 상자에서 기본 분기를 커밋하는 옵션이나 새 분기를 생성하고 pull request를 시작하는 옵션을 선택합니다. 그런 다음 **변경 내용 커밋** 또는 **변경 내용 제안**을 클릭합니다.\n\n \n\n리포지토리의 분기로 워크플로 파일을 커밋하면 `push` 이벤트가 트리거되고 워크플로가 실행됩니다.\n\npull request를 시작하도록 선택한 경우 계속하여 pull request를 만들 수 있지만 커밋이 여전히 분기에 대해 이루어지고 새 워크플로를 트리거하므로 이 빠른 시작의 목적에는 이 작업이 필요하지 않습니다.\n\n## 워크플로 결과 보기\n\n1. GitHub에서 리포지토리의 기본 페이지로 이동합니다.\n\n2. 리포지토리 이름에서 ** 작업**을 클릭합니다.\n\n \n\n3. 왼쪽 사이드바에서 표시하려는 워크플로를 클릭합니다. 이 예제에서는 \"GitHub Actions 데모\"입니다.\n\n \n\n4. 워크플로 실행 목록에서 보려는 실행의 이름을 클릭합니다. 이 예제에서는 \"USERNAME이 GitHub Actions 테스트 중입니다.\"\n\n5. 워크플로 실행 페이지의 왼쪽 사이드바에 있는 **Jobs** 아래에서 **Explore-GitHub-Actions** 작업을 클릭합니다.\n\n \n\n6. 로그는 각 단계가 처리된 방법을 보여 줍니다. 단계를 확장하면 세부 정보를 볼 수 있습니다.\n\n \n\n 예를 들어 리포지토리에서 파일 목록을 볼 수 있습니다.\n\n \n\n방금 추가한 예제 워크플로는 코드가 브랜치에 푸시될 때마다 실행되며, GitHub Actions가 리포지토리의 콘텐츠와 함께 어떻게 작동하는지 보여 줍니다. 자세한 자습서는 [GitHub Actions에 대한 이해](/ko/actions/get-started/understand-github-actions)을(를) 참조하세요.\n\n## 다음 단계\n\nGitHub Actions 는 애플리케이션 개발 프로세스의 거의 모든 측면을 자동화하는 데 도움이 될 수 있습니다. 시작할 준비가 되셨나요? 다음 단계를 수행하는 GitHub Actions데 유용한 리소스는 다음과 같습니다.\n\n* 워크플로를 GitHub Actions 만들려면 [워크플로 템플릿 사용](/ko/actions/how-tos/write-workflows/use-workflow-templates)을 참조하세요.\n* CI(연속 통합) 워크플로는 [코드 빌드 및 테스트](/ko/actions/tutorials/build-and-test-code)을(를) 참조하세요.\n* 패키지를 빌드하고 게시하려면 [패키지 게시](/ko/actions/tutorials/publish-packages)을(를) 참조하세요.\n* 프로젝트를 배포하려면 [타사 플랫폼에 배포](/ko/actions/how-tos/deploy/deploy-to-third-party-platforms)을(를) 참조하세요.\n* 작업 및 프로세스를 자동화하려면 GitHub을 [](/ko/actions/tutorials/manage-your-work)참조하세요.\n* 보다 복잡한 기능을 GitHub Actions보여 주는 예제는 [워크플로에서 수행하는 작업 선택](/ko/actions/how-tos/write-workflows/choose-what-workflows-do)을 참조하세요. 이러한 자세한 예제에서는 실행기에서 코드를 테스트하고, CLI에 액세스 GitHub 하고, 동시성 및 테스트 매트릭스와 같은 고급 기능을 사용하는 방법을 설명합니다.\n* GitHub Actions로 워크플로를 자동화하고 개발을 가속화하는 숙련도를 인증하려면 GitHub Actions에서 GitHub Certifications 자격증을 취득하세요. 자세한 내용은 [GitHub Certifications에 대한 정보](/ko/get-started/showcase-your-expertise-with-github-certifications/about-github-certifications)을 참조하세요."}