Git 클라이언트 사용
    • PDF

    Git 클라이언트 사용

    • PDF

    기사 요약

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

    참고
    • 원활한 사용 환경을 확보하기 위해 Git 클라이언트를 상위 버전으로 업데이트해 주십시오. (v1.8.4.3 이상 권장)
    • 콘솔에서 변경 사항을 병합하거나 리포지토리를 삭제하는 등의 SourceCommit 관리를 수행하려면 SourceCommit 고객 계정이나 '쓰기'(WRITE) 권한 이상의 권한을 가진 서브 계정으로 콘솔에 로그인해 주십시오. 서브 계정의 권한 부여 방법은 Sub Account 사용 가이드를 참조해 주십시오.

    Git 자격 증명 발급

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

    참고
    • 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 계정 설정] 탭을 클릭해 주십시오.
      sourcecommit-use_client1_ko

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

      • 콘솔에 로그인 시 사용한 서브 계정 이름이 사용자 이름으로 사용됩니다.
    6. PasswordConfirm password 입력란에 비밀번호를 입력하고 [적용] 버튼을 클릭해 주십시오.

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

    GIT SSH 접속 설정

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

    주의

    금융 클라우드 정책 상 NCP 서버 내부에서는 SSH를 통한 접속이 불가능합니다.
    NCP 서버 내에서 접근 시에는 HTTPS를 통해 접속해주십시오.

    참고

    Windows 운영 체제를 사용하는 경우 Git Bash 에뮬레이터를 사용해 주십시오.

    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 퍼블릭 키 등록 영역에 복사한 퍼블릭 키를 붙여넣기 한 후 [등록] 버튼을 클릭해 주십시오.
      sourcecommit-use_client2_ko

      • 등록된 SSH 퍼블릭 키 영역에 SSH 키 항목이 표시됩니다.
        sourcecommit-use_client2a_ko
      • 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 접속을 이용한 리포지토리 복제 방법은 다음과 같습니다.

    참고

    HTTPS 연결을 통해 SourceCommit 리포지토리를 복제하려면 먼저 HTTPS 자격 증명을 발급해 주십시오. 자세한 내용은 HTTPS 접속용 Git 계정 설정을 참고해 주십시오.

    1. 네이버 클라우드 플랫폼 콘솔에 접속해 주십시오.
    2. Services > Developer Tools > SourceCommit 메뉴를 차례대로 클릭해 주십시오.
    3. SourceCommit 화면에서 리포지토리를 선택한 후 [코드로 이동] 버튼을 클릭해 주십시오.
      • 리포지토리 목록에서 리포지토리 이름을 클릭해도 됩니다.
    4. 리포지토리 상세 기능 화면에서 [CLONE URL] 버튼을 클릭한 후 [HTTPS] 탭을 클릭해 주십시오.
    5. Clone with HTTPS 영역에서 Git URL을 확인하고 [복사] 버튼을 클릭해 클립보드에 복사해 주십시오.
      sourcecommit-use_client3_ko
    6. 로컬 PC에서 Git 클라이언트를 실행한 후 다음과 같이 리포지토리를 복제해 주십시오.
      • 계정 정보 입력창이 표시되면 HTTPS 접속용 Git 계정 설정 단계에서 설정한 계정 정보를 입력해 주십시오.
      • 해당 리포지토리의 복제본이 로컬 PC에 생성됩니다.
      $ git clone [https Git URL, 예: https://devtools.fin-ncloud.com/**********.git]
      
      참고
      • Git 클라이언트 접속 시 1분 이내에 잘못된 비밀번호를 10회 입력하면 해당 계정이 10분 동안 잠겨 사용할 수 없게 됩니다.
      • 비밀번호를 변경하는 경우 계정의 잠금이 해제됩니다.

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

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

    참고

    SSH 연결을 통해 SourceCommit 리포지토리를 복제하려면 먼저 SSH 키를 등록하고 config 파일을 작성해야 합니다. 자세한 내용은 GIT SSH 접속 설정을 참고해 주십시오.

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

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

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

      • 리포지토리 목록에서 리포지토리 이름을 클릭해도 됩니다.
    4. 리포지토리 상세 기능 화면에서 [CLONE URL] 버튼을 클릭한 후 [SSH] 탭을 클릭해 주십시오.

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

    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
      

    이 문서가 도움이 되었습니까?

    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.