Git 클라이언트 사용

SourceCommit 리포지토리를 액세스하기 위한 자격 증명(HTTPS/SSH)을 발급한 후, 이 자격 증명을 이용해 원하는 리포지토리를 로컬 PC에 복제(clone)해 사용할 수 있습니다.

Git 자격 증명 발급

로컬 PC에서 Git 클라이언트를 이용해 SourceCommit 리포지토리를 액세스하려면 먼저 접속 방법(HTTPS/SSH)에 맞는 자격 증명을 발급해 주십시오.

HTTPS 접속용 Git 계정 설정

HTTPS 접속을 위한 Git 계정(User name/Password) 설정 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼 콘솔에 접속해 주십시오.

2. Services > Developer Tools > SourceCommit 메뉴를 차례대로 클릭해 주십시오.

3. SourceCommit 화면에서 [GIT 계정/GIT SSH 설정] 버튼을 클릭해 주십시오.

4. GIT 계정/GIT SSH 설정 팝업 창에서 [GIT 계정 설정] 탭을 클릭해 주십시오.
   

5. 계정 설정 영역에서 User name 항목의 사용자 이름을 확인해 주십시오.

   • 콘솔에 로그인 시 사용한 서브 계정 이름이 사용자 이름으로 사용됩니다.

6. Password 및 Confirm password 입력란에 비밀번호를 입력하고 [적용] 버튼을 클릭해 주십시오.

GIT SSH 접속 설정

SSH 접속을 위한 Git 자격증명(SSH 키) 생성 방법은 다음과 같습니다.

1. 로컬 PC에서 Git 클라이언트를 실행한 후 RSA 키 페어를 생성해 주십시오.

   • 생성할 키 페어의 경로와 암호를 입력해 주십시오.
     • 키 페어 경로 예: /Users/USER/.ssh/id_sourcecommit)
     • 암호 없이 사용하려면 엔터 키를 눌러 주십시오.

   $ ssh-keygen
   Generating public/private rsa key pair.
   Enter file in which to save the key (/Users/SourceCommit/.ssh/id_rsa): /Users/USER/.ssh/id_sourcecommit
   Enter passphrase (empty for no passphrase):
   Enter same passphrase again:
   
   Your identification has been saved in /Users/USER/.ssh/id_sourcecommit.
   Your public key has been saved in /Users/USER/.ssh/id_sourcecommit.pub.
   
   The key fingerprint is:
   
   SHA256:oHdc0iQA7I25CvtEwmgzBHIalk67UgKHyygw0fihDl8 USER@0000000000
   The key's randomart image is:
   +---[RSA 2048]----+
   |        o++o*.   |
   |        .*oX.+   |
   |       .*.O.+. . |
   |        .=.o+.=  |
   |        SooBo* . |
   |        ..+o+ +.o|
   |         E    .+o|
   |        .      =o|
   |              o.=|
   +----[SHA256]-----+
   

2. 생성된 키 페어의 퍼블릭 키를 클립보드에 복사해 주십시오.

   $ cat /Users/USER/.ssh/id_sourcecommit.pub
   
   ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQCtEtEm+UQfHJtSEaNS/Q4tnrOGWu12qHyaIbZGk5A/OzmxDvmUeJRyiVz0/49MPElDLk/HbnZUx5joZskqVpyzrbF12YT7IweUkWWYie4bZ/c8dwQUi9yjgE5NUs0m5xPxq/u1QfMySLEOwvat8e0V2dpt7p0XeZB7QaMM+sexP+78EtUa3PD60Vko++2oPpK7ze5DdYduQAIiRVbC5NWpRLbHrhsXYScPU537jDqtRp3pXUXlpEUcVADXffD4Mer7PTGXr1NrJMefeisFRev4oQ4dtcQU3KmTxDK1nZeIGRB92NwsEvXI6FEF3jRD+sk+stq8ZEJe23Iyg0Gs6K1 USER@xxxxxxxx
   

3. 네이버 클라우드 플랫폼 콘솔에서 Services > Developer Tools > SourceCommit 메뉴를 차례대로 클릭해 주십시오.

4. SourceCommit 화면에서 [GIT 계정/GIT SSH 설정] 버튼을 클릭해 주십시오.

5. GIT 계정/GIT SSH 설정 팝업 창에서 [GIT SSH 설정] 탭을 클릭해 주십시오.

6. SSH 퍼블릭 키 등록 영역에 복사한 퍼블릭 키를 붙여넣기 한 후 [등록] 버튼을 클릭해 주십시오.
   

   • 등록된 SSH 퍼블릭 키 영역에 SSH 키 항목이 표시됩니다.
     
   • SSH 퍼블릭 키의 SSH 키 항목 값은 SSH 접속 시의 User 이름으로 사용됩니다(config 파일 작성 시 User 항목의 값).

7. 다음 예시를 참고해 로컬 PC의 Git 클라이언트에서 퍼블릭 키가 저장된 경로(/Users/USER/.ssh/)에 config 파일을 작성해 주십시오.

   • SSH 퍼블릭 키의 SSH 키 항목 값을 User 항목의 값으로 입력해 주십시오.

   $ vi ~/.ssh/config
   Host devtools.fin-ncloud.com
   User [콘솔에 등록된 SSH 키 값]
   IdentityFile ~/.ssh/id_sourcecommit
   

리포지토리 복제(Clone)

네이버 클라우드 플랫폼 콘솔에서 SourceCommit 리포지토리의 Git URL을 복사한 다음 로컬 PC에서 Git 클라이언트를 이용해 SourceCommit 리포지토리를 복제할 수 있습니다.

HTTPS 접속으로 리포지토리 복제

HTTPS 접속을 이용한 리포지토리 복제 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼 콘솔에 접속해 주십시오.
2. Services > Developer Tools > SourceCommit 메뉴를 차례대로 클릭해 주십시오.
3. SourceCommit 화면에서 리포지토리를 선택한 후 [코드로 이동] 버튼을 클릭해 주십시오.
   • 리포지토리 목록에서 리포지토리 이름을 클릭해도 됩니다.
4. 리포지토리 상세 기능 화면에서 [CLONE URL] 버튼을 클릭한 후 [HTTPS] 탭을 클릭해 주십시오.
5. Clone with HTTPS 영역에서 Git URL을 확인하고 [복사] 버튼을 클릭해 클립보드에 복사해 주십시오.
   
6. 로컬 PC에서 Git 클라이언트를 실행한 후 다음과 같이 리포지토리를 복제해 주십시오.
   • 계정 정보 입력창이 표시되면 HTTPS 접속용 Git 계정 설정 단계에서 설정한 계정 정보를 입력해 주십시오.
   • 해당 리포지토리의 복제본이 로컬 PC에 생성됩니다.

   $ git clone [https Git URL, 예: https://devtools.fin-ncloud.com/**********.git]
   

   참고

   • Git 클라이언트 접속 시 1분 이내에 잘못된 비밀번호를 10회 입력하면 해당 계정이 10분 동안 잠겨 사용할 수 없게 됩니다.
   • 비밀번호를 변경하는 경우 계정의 잠금이 해제됩니다.

SSH 접속으로 리포지토리 복제

SSH 접속을 이용한 리포지토리 복제 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼 콘솔에 접속해 주십시오.

2. Services > Developer Tools > SourceCommit 메뉴를 차례대로 클릭해 주십시오.

3. SourceCommit 화면에서 리포지토리를 선택한 후 [코드로 이동] 버튼을 클릭해 주십시오.

   • 리포지토리 목록에서 리포지토리 이름을 클릭해도 됩니다.

4. 리포지토리 상세 기능 화면에서 [CLONE URL] 버튼을 클릭한 후 [SSH] 탭을 클릭해 주십시오.

5. Clone with SSH 영역에서 Git URL을 확인하고 [복사] 버튼을 클릭해 클립보드에 복사해 주십시오.
   

6. 로컬 PC에서 Git 클라이언트를 실행한 후 다음과 같이 리포지토리를 복제해 주십시오.

   • 해당 리포지토리의 복제본이 로컬 PC에 생성됩니다.

    $ git clone [ssh Git URL, 예: ssh://devtools.fin-ncloud.com/**********.git]
   

   참고

   • 복수의 SSH 키를 사용 중인 경우, 다음 예와 같이 특정 SSH 키를 이용해 SSH 접속을 수행할 수 있습니다.

     $ git clone ssh://[특정 SSH 키]@devtools.fin-ncloud.com/123/**********.git
     

   • 다음과 같은 오류가 발생하는 경우, 예제를 참고하여 config 파일에 설정을 추가해 주십시오.

     $ git clone ssh://devtools.fin-ncloud.com/123/************.git 1108
     Cloning into '1108'...
     Unable to negotiate with 211.249.59.23 port 22: no matching host key type found
     Their offer: ssh-rsa
     fatal: Couls not read from remote repository.
     
     Please make sure you have the correct access rights and the regpository exists.
     

     config 파일 수정 예(마지막 2행 추가)

     $ vi ~/.ssh/config
     Host devtools.fin-ncloud.com
     User [콘솔에 등록된 SSH 키 값]
     IdentityFile ~/.ssh/id_sourcecommit
     HostkeyAlgorithms +ssh-rsa
     ​PubkeyAcceptedAlgorithms +ssh-rsa
     

로컬 PC의 파일 업로드(Push)

로컬 PC에 복제한 SourceCommit 리포지토리의 파일을 추가, 삭제, 또는 변경한 후, Git 클라이언트를 이용해 원격 리포지토리(SourceCommit 리포지토리)로 업로드(push)할 수 있습니다.

이 사용 가이드에서는 로컬 리포지토리의 모든 변경 사항에 대해 커밋을 생성한 후 원격 리포지토리로 업로드(push)하는 방법을 간략한 예제로 설명합니다. 각 Git 명령어 및 함께 사용할 수 있는 다양한 옵션에 대한 자세한 내용은 Git 공식 문서를 참고해 주십시오.

로컬 리포지토리의 변경 사항을 SourceCommit 리포지토리로 업로드하는 방법은 다음과 같습니다.

1. 리포지토리 복제(Clone) 단계에서 복제한 리포지토리 내의 파일을 로컬 PC에서 변경해 주십시오.

   • 파일을 수정하거나, 추가, 또는 삭제할 수 있습니다.

2. Git 클라이언트를 실행하고 다음 예제를 참고해 리포지토리를 초기화한 후 모든 변경 사항에 대해 커밋을 생성해 주십시오.

   • 로컬 리포지토리 초기화

     $ git init
     

   • 모든 변경 사항을 커밋에 추가

     $ git add -A
     

   • 커밋 생성

     $ git commit -m "Local changes"
     
     [master cb587d8] Local changes
     10 files changed, 76 insertions(+), 1 deletion(-)
     create mode 100644 Testscript_001.md
     create mode 100644 Testscript_002.md
     create mode 100644 Testscript_003.md
     create mode 100644 Testscript_004.md
     create mode 100644 Testscript_005.md
     create mode 100644 Testscript_006.md
     create mode 100644 Testscript_007.md
     create mode 100644 Testscript_008.md
     create mode 100644 list.bat
     

3. 로컬 리포지토리에 커밋된 변경 사항을 SourceCommit 리포지토리로 업로드(push)해 주십시오.

   • 업로드가 완료되면 SourceCommit 리포지토리에서 변경된 파일과 커밋 이력을 확인할 수 있습니다.

   $ git push
   
   Enumerating objects: 7, done.
   Counting objects: 100% (7/7), done.
   Delta compression using up to 8 threads
   Compressing objects: 100% (5/5), done.
   Writing objects: 100% (5/5), 1.64 KiB | 1.64 MiB/s, done.
   Total 5 (delta 1), reused 0 (delta 0), pack-reused 0
   To https://devtools.fin-ncloud.com/******/sample001.git
   7155f8d..cb587d8  master -> master