Git 소스 코드 관리 사용

Secure Source Manager는 모든 Git SCM 클라이언트 명령어를 지원하며 풀 요청 및 문제 추적 기능이 내장되어 있습니다. HTTPS와 SSH 인증이 모두 지원됩니다.

필요한 역할

Git을 사용하여 Secure Source Manager 저장소와 상호작용하는 데 필요한 권한을 얻으려면 관리자에게 다음 IAM 역할을 부여해 달라고 요청하세요.

• Secure Source Manager 인스턴스 접근자 (roles/securesourcemanager.instanceAccessor) Secure Source Manager 인스턴스에 대한 권한
• 저장소를 클론하려면 저장소에 대한 Secure Source Manager 저장소 리더 (roles/securesourcemanager.repoReader) 권한이 있어야 합니다.
• 저장소에 푸시하려면 저장소의 Secure Source Manager 저장소 작성자 (roles/securesourcemanager.repoWriter)가 있어야 합니다.

역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

커스텀 역할이나 다른 사전 정의된 역할을 통해 필요한 권한을 얻을 수도 있습니다.

Secure Source Manager 역할 부여에 대한 자세한 내용은 IAM으로 액세스 제어 및 사용자에게 인스턴스 액세스 권한 부여를 참고하세요.

Git 및 Google Cloud CLI 설치

1. Git을 설치합니다.

2. Git 설치 프로그램에서 사용자 인증 정보 도우미 선택을 묻는 메시지가 표시되면 없음 (사용자 인증 정보 도우미 사용 안함)을 선택합니다.

3. gcloud CLI를 설치합니다.

4. HTTPS로 Git을 사용하려면 gcloud CLI 버전 395.0.0 이상이 필요합니다. 다음 명령어를 실행하여 gcloud CLI 버전을 확인합니다.

   gcloud --version
   

5. gcloud CLI를 업데이트하려면 다음 명령어를 실행합니다.

   gcloud components update
   

6. 업데이트 후 gcloud init를 실행하여 gcloud CLI를 초기화합니다.

   자세한 내용은 구성요소 업데이트에 관한 gcloud CLI 문서를 참고하세요.

사용자 인증 정보 설정

서드 파티 ID 공급업체와 직원 ID 제휴를 사용하여 Secure Source Manager에 인증하는 경우 이 섹션을 완료할 필요가 없습니다. 대신 직원 ID 풀 로그인 구성을 만들어야 합니다.

다음 명령어를 실행하여 Secure Source Manager 인증 도우미를 전역 Git 구성에 추가합니다.

Linux

git config --global credential.'https://*.*.sourcemanager.dev'.helper gcloud.sh

이전 버전의 Git에서는 와일드 카드를 지원하지 않을 수 있습니다. 와일드 카드 없이 인증 도우미를 추가하려면 다음 명령어를 실행합니다.

git config --global credential.'https://INSTANCE_ID-PROJECT_NUMBER-git.LOCATION.sourcemanager.dev'.helper gcloud.sh

다음을 바꿉니다.

• INSTANCE_ID을 Secure Source Manager 인스턴스 이름으로 바꿉니다.
• PROJECT_NUMBER를 프로젝트 번호로 바꿉니다. 프로젝트 번호를 찾는 데 도움이 필요하면 프로젝트 식별을 참고하세요.
• LOCATION을 인스턴스의 리전으로 바꿉니다. 리전에 대한 자세한 내용은 위치를 참고하세요.

Windows

git config --global credential.https://*.*.sourcemanager.dev.helper gcloud.cmd

이전 버전의 Git에서는 와일드 카드를 지원하지 않을 수 있습니다. 와일드 카드 없이 인증 도우미를 추가하려면 다음 명령어를 실행합니다.

git config --global credential.https://INSTANCE_ID-PROJECT_NUMBER-git.LOCATION.sourcemanager.dev.helper gcloud.cmd

다음을 바꿉니다.

• INSTANCE_ID을 Secure Source Manager 인스턴스 이름으로 바꿉니다.
• PROJECT_NUMBER를 프로젝트 번호로 바꿉니다. 프로젝트 번호를 찾는 데 도움이 필요하면 프로젝트 식별을 참고하세요.
• LOCATION을 인스턴스의 리전으로 바꿉니다. 리전에 대한 자세한 내용은 위치를 참고하세요.

인증 도우미는 Secure Source Manager와 함께 Git 명령어를 사용할 때 gcloud CLI를 사용하여Google Cloud 사용자 인증 정보를 가져옵니다.

초기 사용자 인증 정보 설정 후 다시 인증하려면 다음 gcloud CLI 명령어를 실행합니다.

gcloud auth login

참고: 일부 시스템에서는 인증 도우미가 가져온 사용자 인증 정보를 Git 구성에 *credential*.helper=store과 유사한 행을 추가하여 저장하려고 할 수 있습니다. Secure Source Manager 사용자 인증 정보는 수명이 짧으므로 인증 오류가 발생합니다. 이 문제를 해결하려면 전역, 시스템 또는 로컬 저장소 Git 구성 파일에서 해당 줄을 삭제하세요.

직원 ID 풀 로그인 구성 만들기

서드 파티 ID 공급업체를 사용하여 직원 ID 제휴로 Secure Source Manager에 인증하는 경우가 아니면 이 섹션을 완료하지 않아도 됩니다.

gcloud CLI 명령어 또는 Git 명령어를 사용하여 직원 ID 풀 사용자 인증 정보로 Secure Source Manager 인스턴스를 인증하려면 직원 ID 풀로 로그인 구성을 만들어야 합니다.

직원 ID 풀 로그인 구성을 만들려면 직원 ID 제휴를 위한 단기 토큰 가져오기의 안내에 따라 gcloud CLI로 브라우저 기반 로그인을 만드세요.

인증 후 Git 명령어를 사용하여 Secure Source Manager 인스턴스와 상호작용할 수 있습니다. 직원 ID 풀의 세션 기간이 만료되면 재인증해야 합니다.

저장소 클론

다음 명령어를 실행하여 저장소를 클론합니다.

git clone REPOSITORY_URL

여기서 REPOSITORY_URL은 클론할 저장소 페이지 상단에 표시되는 HTTPS 또는 SSH URL입니다.

기존 저장소를 Secure Source Manager로 푸시

원격으로 작동하는 Secure Source Manager 저장소를 만들어야 푸시할 수 있습니다.

기존 Git 저장소를 비어 있는 Secure Source Manager 저장소로 푸시하려면 Secure Source Manager 저장소를 원격으로 추가하고 푸시해야 합니다.

1. Secure Source Manager 저장소를 원격으로 설정하려면 다음 명령어를 실행합니다.

   git remote add origin REPOSITORY_URL
   

   여기서 REPOSITORY_URL은 저장소 페이지 상단에 표시되는 HTTPS 또는 SSH URL입니다.

2. 저장소로 푸시하려면 다음 명령어를 실행합니다.

   git push -u origin main
   

Git 소스 코드 관리에 관한 자세한 내용은 Git 문서를 참고하세요.

다음 단계

• Git 소스 코드 관리 자세히 알아보기
• 저장소 나열 및 보기