|
1 | 1 | --- |
2 | | -title: "연습 0: 사전 준비" |
| 2 | +title: "레슨 0 - 사전 준비" |
| 3 | +description: "Tailspin Toys의 복사본을 만들고 Copilot CLI 워크숍에 사용할 GitHub Codespace를 준비합니다." |
3 | 4 | authors: |
4 | 5 | - geektrainer |
5 | | -lastUpdated: 2026-06-30 |
| 6 | +lastUpdated: 2026-09-18 |
6 | 7 | --- |
7 | 8 |
|
8 | | -Copilot CLI 연습을 시작하기 전에 모든 것을 준비해야 합니다. Tailspin Toys 리포지토리(Repository)의 복사본을 만들고 [코드스페이스][codespaces]를 시작합니다. 다음 연습에서는 해당 코드스페이스의 통합 터미널을 사용해 Copilot CLI를 설치하고 실행합니다. |
| 9 | +Copilot CLI 레슨을 시작하기 전에 필요한 사항을 준비합니다. Tailspin Toys 리포지토리의 복사본을 만들고 [Codespace][codespaces]를 시작합니다. 다음 레슨에서는 통합 터미널을 사용해 Copilot CLI를 설치하고 실행합니다. |
9 | 10 |
|
10 | | -## 실습용 리포지토리 설정 |
| 11 | +이 레슨에서는 다음을 수행합니다. |
11 | 12 |
|
12 | | -앞으로 작성할 코드를 위한 리포지토리 복사본을 만들기 위해 [template][template-repository]에서 새 인스턴스(Instance)를 만듭니다. 새 인스턴스에는 실습에 필요한 파일이 모두 포함되며, 연습을 진행하는 동안 이 리포지토리를 사용합니다. |
| 13 | +- 템플릿에서 Tailspin Toys 프로젝트의 복사본을 만듭니다. |
| 14 | +- Codespace를 만들고 프로젝트가 준비되었는지 확인합니다. |
13 | 15 |
|
14 | | -1. 새 브라우저 창에서 이 실습의 GitHub 리포지토리로 이동합니다: `https://github.com/github-samples/tailspin-toys`. |
15 | | -2. 실습용 리포지토리 페이지에서 **Use this template** 버튼을 선택해 리포지토리 복사본을 만듭니다. 그런 다음 **Create a new repository**를 선택합니다. |
| 16 | +## 실습용 리포지토리 설정하기 |
16 | 17 |
|
17 | | -  |
| 18 | +Tailspin Toys 프로젝트의 복사본을 사용해 작업합니다. 지금 [템플릿 리포지토리][tailspin-template]에서 복사본을 만듭니다. 새 리포지토리에는 실습에 필요한 파일이 모두 포함되어 있습니다. |
18 | 19 |
|
19 | | -3. GitHub 또는 Microsoft가 진행하는 행사에서 이 워크숍을 수행하는 경우에는 멘토가 제공하는 안내를 따릅니다. 그렇지 않다면 GitHub Copilot에 액세스할 수 있는 조직에 새 리포지토리를 만들어도 됩니다. |
20 | | - |
21 | | -  |
22 | | - |
23 | | -4. 이후 실습에서 참조할 수 있도록 생성한 리포지토리 경로(**organization-or-user-name/repository-name**)를 기록해 둡니다. |
| 20 | +1. 새 브라우저 창에서 [Tailspin Toys 템플릿][tailspin-template]으로 이동합니다. |
| 21 | +2. **Use this template**를 선택한 다음 **Create a new repository**를 선택하여 리포지토리 복사본을 만듭니다. |
| 22 | +3. GitHub 또는 Microsoft가 진행하는 행사에서 워크숍을 수행하는 경우 멘토의 안내를 따릅니다. 그렇지 않다면 GitHub Copilot을 사용할 수 있는 조직에 새 리포지토리를 만듭니다. |
| 23 | +4. 나중에 참조할 수 있도록 생성한 리포지토리 경로(`organization-or-user-name/repository-name`)를 기록해 둡니다. |
24 | 24 |
|
25 | 25 | > [!NOTE] |
26 | | -> **백로그가 준비되었습니다** |
27 | | -> |
28 | | -> template에서 리포지토리를 만들면 GitHub issue 백로그가 자동으로 생성됩니다. 워크숍 내내 이 issue를 바탕으로 작업하므로 직접 등록할 내용은 없습니다. |
29 | | -
|
30 | | -## 코드스페이스 만들기 |
| 26 | +> 템플릿에서 리포지토리를 만들면 GitHub 이슈 백로그가 자동으로 생성됩니다. 워크숍 전체에서 해당 이슈를 사용하므로 직접 등록할 필요가 없습니다. |
31 | 27 |
|
32 | | -이제 코드스페이스를 사용해 실습을 진행합니다. |
33 | | - |
34 | | -[GitHub Codespaces][codespaces]는 브라우저에서 직접 코드를 작성하고, 실행하고, 디버그할 수 있는 클라우드 기반 개발 환경입니다. 여러 프로그래밍 언어, 확장, 도구를 지원하는 완전한 기능의 IDE를 제공합니다. |
35 | | - |
36 | | -1. 방금 만든 리포지토리로 이동합니다. |
37 | | -2. 초록색 **Code** 버튼을 선택합니다. |
| 28 | +새 워크숍 템플릿 복사본을 사용합니다. 여기에는 리포지토리 지침, 애플리케이션 코드, 테스트, `quality-checks` 스킬, 실습에 사용할 백로그가 포함되어 있습니다. 이전 복사본을 사용한다면 필요한 파일이 있는지 진행자에게 확인합니다. |
38 | 29 |
|
39 | | -  |
| 30 | +## Codespace 만들기 |
40 | 31 |
|
41 | | -3. **Codespaces** 탭을 선택한 다음 **+** 버튼을 선택해 새 Codespace를 만듭니다. |
| 32 | +이제 Codespace에서 워크숍을 진행합니다. |
42 | 33 |
|
43 | | -  |
| 34 | +[GitHub Codespaces][codespaces]는 브라우저에서 코드를 작성하고 실행하고 디버그할 수 있는 클라우드 기반 개발 환경입니다. 여러 프로그래밍 언어, 확장, 도구를 지원하는 완전한 기능의 편집기를 제공합니다. |
44 | 35 |
|
45 | | -코드스페이스를 만드는 데는 몇 분 정도 걸리지만, 모든 서비스를 수동으로 설치하는 것보다 훨씬 빠릅니다. 기다리는 동안에는 GitHub Copilot의 다른 기능을 살펴볼 수 있으며, 다음 단계에서 그 부분을 이어서 알아봅니다. |
| 36 | +1. 방금 만든 리포지토리로 이동합니다. |
| 37 | +2. **Code**를 선택합니다. |
| 38 | +3. **Codespaces** 탭을 선택한 다음 **Create codespace on main**을 선택합니다. |
| 39 | +4. Codespace 설정이 완료될 때까지 기다립니다. 템플릿에서 프로젝트 종속성, Playwright Chromium, 로컬 데이터베이스를 설치합니다. |
| 40 | +5. **Do you trust the authors of the files in this folder?**라는 메시지가 표시되면 **Trust Folder & Continue**를 선택합니다. |
| 41 | +6. 리포지토리 루트에서 터미널을 열고 애플리케이션을 시작합니다. |
46 | 42 |
|
47 | | -> [!CAUTION] |
48 | | -> 이후 연습에서 다시 코드스페이스로 돌아옵니다. 지금은 브라우저 탭에서 그대로 열어 둡니다. |
| 43 | + ```bash |
| 44 | + npm run dev |
| 45 | + ``` |
49 | 46 |
|
50 | | -> [!NOTE] |
51 | | -> 이 워크숍은 코드스페이스 또는 로컬 [dev container][dev-containers] 안에서 실행하도록 설계되었습니다. 두 환경 모두 원활한 진행에 필요한 사전 요구 사항이 모두 설치된 상태를 보장합니다. 로컬에서 실행하고 싶다면 복제한 리포지토리를 VS Code에서 열고, 메시지가 표시되면 **Reopen in Container**를 선택합니다. 그러면 코드스페이스에서 사용하는 것과 동일한 dev container를 VS Code가 빌드합니다. |
| 47 | +7. Codespaces에서 포트 `4321`을 사용할 수 있다고 표시되면 **Open in Browser**를 선택하고 Tailspin Toys 사이트가 로드되는지 확인합니다. |
| 48 | +8. 터미널로 돌아가 <kbd>Ctrl</kbd>+<kbd>C</kbd>를 눌러 개발 서버를 중지합니다. |
52 | 49 |
|
53 | | -[codespaces]: https://github.com/features/codespaces |
54 | | -[dev-containers]: https://code.visualstudio.com/docs/devcontainers/containers |
55 | | -## 요약 |
| 50 | +## 요약 및 다음 단계 |
56 | 51 |
|
57 | | -축하합니다! 실습용 리포지토리 복사본을 만들었습니다. 또한 Copilot CLI 작업을 시작할 때 사용할 코드스페이스 생성도 시작했습니다. |
| 52 | +준비가 끝났습니다. 이 레슨에서는 템플릿에서 Tailspin Toys 프로젝트의 복사본을 만들고 Codespace를 준비했습니다. |
58 | 53 |
|
59 | | -## 다음 단계 |
60 | | - |
61 | | -Copilot CLI를 설치하고 GitHub 계정으로 인증해 보겠습니다. [연습 1 - GitHub Copilot CLI 설치][next-lesson]로 계속 진행합니다. |
| 54 | +다음으로 Codespace에 [GitHub Copilot CLI를 설치][next-lesson]하고 GitHub 계정으로 인증합니다. |
62 | 55 |
|
63 | 56 | ## 리소스 |
64 | 57 |
|
65 | 58 | - [GitHub Codespaces 개요][codespaces] |
66 | 59 | - [템플릿에서 리포지토리 만들기][template-repository] |
67 | | -- [Codespaces 빠른 시작][codespaces-quickstart] |
| 60 | +- [Codespaces 시작하기][codespaces-quickstart] |
68 | 61 |
|
| 62 | +[tailspin-template]: https://github.com/github-samples/tailspin-toys |
69 | 63 | [template-repository]: https://docs.github.com/repositories/creating-and-managing-repositories/creating-a-template-repository |
70 | 64 | [codespaces-quickstart]: https://docs.github.com/codespaces/getting-started/quickstart |
71 | 65 | [next-lesson]: ../1-install-copilot-cli/ |
| 66 | +[codespaces]: https://github.com/features/codespaces |
0 commit comments