1. SSH 키 생성 및 GitHub 등록 (WSL2 기준)

WSL2 환경에서 작업하실 예정이므로, 윈도우 프롬프트가 아닌 **WSL2 터미널(Ubuntu 등)**에서 실행하세요.

    1. SSH 키 생성: 터미널에 아래 명령어를 입력합니다. (이메일은 본인의 GitHub 계정 이메일로 수정하세요) ssh-keygen -t ed25519 -C "your_email@example.com"
      • 파일 저장 위치는 기본값(Enter)으로 두세요.
      • Passphrase(암호)는 설정해도 되고, 귀찮다면 Enter로 넘어가도 됩니다.
    2. 공개 키 복사: 생성된 키 중 .pub로 끝나는 파일의 내용을 확인합니다. cat ~/.ssh/id_ed25519.pub
      • 화면에 출력된 ssh-ed25519 ...로 시작하는 긴 문자열을 모두 복사하세요.
    3. GitHub에 등록:
      • GitHub 웹사이트 접속 → SettingsSSH and GPG keysNew SSH key 클릭.
      • Title은 'My WSL2' 정도로 적고, Key 부분에 복사한 내용을 붙여넣기 한 뒤 저장합니다.

        ------------------------------------------------------------------------------------------------------

        2. 작업 폴더 설정 추천
        • 추천 위치: WSL2 내부 파일 시스템인 ~/ (Home) 디렉토리 아래에 폴더를 만드세요.
          • 예: /home/사용자이름/projects/
        • 이유: 윈도우 드라이브(C:)와 WSL2 사이의 파일 접근은 속도가 매우 느리고, 권한(Permission) 문제가 발생할 수 있습니다. WSL2 내부에 파일을 두는 것이 주피터 노트북 실행 및 Git 속도 면에서 훨씬 유리합니다.
      • 현재 user/ 폴더를 말씀하셨는데, 윈도우 사용자 폴더(/mnt/c/Users/...)를 말씀하시는 것이라면 권장하지 않습니다.
        -----------------------------------------------------------------------------------------------------------

3. VS Code와 GitHub 저장소 연결

      •  

이제 VS Code에서 실제 작업을 시작하는 단계입니다.

      1. VS Code에서 WSL 접속: VS Code 왼쪽 하단의 파란색 >< 아이콘을 클릭하고 **'Connect to WSL'**을 선택합니다.
      2. 저장소 클론(Clone):
        • 상단 메뉴 Terminal > New Terminal을 엽니다.
        • 위에서 추천한 폴더로 이동한 뒤, GitHub의 SSH 주소를 사용하여 클론합니다. git clone git@github.com:계정명/저장소명.git
      3. 폴더 열기: File > Open Folder에서 방금 클론한 폴더를 선택해 엽니다.

        1. 윈도우 탐색기에서 WSL2 폴더 찾는 법
        • 방법 1 (직접 입력): 탐색기 주소창에 \\wsl$ 라고 입력하고 Enter를 누르세요. 설치된 배포판(예: Ubuntu) 폴더가 보일 겁니다. 그 안으로 들어가면 home > simchan2 경로를 찾을 수 있습니다.
        • 방법 2 (터미널에서 열기): 지금 터미널 화면(/home/simchan2)에서 아래 명령어를 입력해 보세요.이 명령어를 치면 현재 리눅스 디렉토리가 윈도우 탐색기 창으로 바로 열립니다. (매우 편리합니다!)
        • Bash
           
          explorer.exe .
          
        • 방법 3 (네트워크 위치): 탐색기 왼쪽 사이드바 맨 아래를 보시면 **'Linux'**라는 고래 아이콘 모양의 항목이 있습니다. 그걸 클릭해서 들어가셔도 됩니다.

        2. 작업 폴더 구조 추천
        1. 개발용 통합 폴더 생성:
        2. Bash
           
          mkdir ~/projects
          cd ~/projects
          
        3. GitHub 저장소별 폴더: 나중에 git clone을 하면 ~/projects/내저장소명 식으로 깔끔하게 정리됩니다.
      4. /home/simchan2 바로 아래에 파일을 다 두면 나중에 관리가 어려울 수 있으니, 별도의 프로젝트 폴더를 만드는 것을 추천합니다.
      5. 윈도우와 리눅스는 서로 다른 세상 같지만, 의외로 탐색기에서 아주 쉽게 접근할 수 있습니다.

        1. 계정 설정(Account Settings)으로 이동하기
        1. GitHub 화면 오른쪽 맨 위를 보시면 용진님의 **프로필 사진(작은 원)**이 보일 거예요. 그걸 클릭하세요.
        2. 나오는 메뉴 중에서 아래쪽에 있는 Settings를 클릭하세요. (톱니바퀴 모양 아이콘이 있습니다.)
        3. 그러면 왼쪽 사이드바 메뉴가 바뀔 겁니다. 거기서 'Access' 섹션 안에 있는 SSH and GPG keys를 찾으실 수 있습니다.

        2. 요약 경로
        3. SSH 키 등록하기 (복습)
        1. 초록색 버튼인 New SSH key를 누릅니다.
        2. Title: 'WSL2-Laptop' 처럼 본인이 알아보기 쉬운 이름을 적습니다.
        3. Key: 아까 WSL2 터미널에서 cat ~/.ssh/id_ed25519.pub 명령어로 확인한 그 긴 문자열을 통째로 복사해서 붙여넣습니다.
        4. Add SSH key 버튼을 누르면 끝입니다!
      6. 그 메뉴에 들어가셨다면, 이전에 안내해 드린 단계를 이어서 진행하시면 됩니다.
      7. GitHub 우측 상단 프로필 클릭 → Settings → 왼쪽 메뉴의 SSH and GPG keys

+ Recent posts