저장소 만들기 및 클론

저장소 만들기 및 클론

Secure Source Manager에서 저장소를 만들고 로컬 머신에 클론합니다.

시작하기 전에

1. Secure Source Manager 인스턴스를 만들거나 액세스 권한을 요청합니다. 자세한 내용은 Secure Source Manager 인스턴스 만들기를 참고하세요.

2. Install the Google Cloud CLI.

3. If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

4. To initialize the gcloud CLI, run the following command:

   gcloud init

5. alpha Google Cloud CLI 구성요소를 설치합니다.

   gcloud components install alpha

필요한 역할

저장소를 만드는 데 필요한 권한을 얻으려면 관리자에게 다음 IAM 역할을 부여해 달라고 요청하세요.

• Secure Source Manager 인스턴스 저장소 생성자 역할 (roles/securesourcemanager.instanceRepositoryCreator) Secure Source Manager 인스턴스
• 인스턴스 프로젝트의 Secure Source Manager 저장소 생성자 역할 (roles/securesourcemanager.repoCreator)

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

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

참고: 프로젝트의 Secure Source Manager 관리자 역할(roles/securesourcemanager.admin) 또는 소유자 (roles/owner)의 IAM 기본 역할에도 저장소를 만들고 클론할 수 있는 권한이 포함되어 있습니다. 프로덕션 환경에서는 관리자 역할 또는 기본 역할을 부여하지 말아야 하지만 개발 환경 또는 테스트 환경에서는 부여해도 됩니다.

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

저장소 만들기

웹 인터페이스

1. 웹 인터페이스를 통해 Secure Source Manager 인스턴스에 액세스하려면 다음 URL을 브라우저 주소 표시줄에 복사합니다.

   INSTANCE_ID-PROJECT_NUMBER.LOCATION.sourcemanager.dev

   다음을 바꿉니다.

   • INSTANCE_ID을 인스턴스 이름으로 바꿉니다.
   • PROJECT_NUMBER를 인스턴스의 Google Cloud 프로젝트 번호로 바꿉니다. 프로젝트 식별에 대한 자세한 내용은 프로젝트 식별을 참고하세요.
   • LOCATION을 인스턴스의 리전으로 바꿉니다.

2. 필요한 경우 Secure Source Manager 사용자 인증 정보를 사용하여 인증합니다.

3. 탐색 메뉴 오른쪽 상단에 있는 + 새 저장소 만들기 아이콘을 클릭합니다.

4. 저장소 세부정보를 작성합니다.

   1. 저장소 ID: 저장소 이름을 입력합니다.

      참고: 저장소 ID는 리소스 이름 지정 규칙을 따라야 합니다. 소문자, 숫자 또는 대시만 포함해야 하며 문자로 시작해야 합니다. 저장소를 만든 후에는 변경할 수 없습니다.

   2. 설명: 선택사항입니다. 저장소 설명입니다.

      주의: 설명이나 기타 유사한 리소스 필드에 민감한 데이터나 식별 데이터를 입력하지 마세요. 이 필드는 Google Cloud 개인정보처리방침에 따라 서비스 데이터로 처리됩니다.

   3. 저장소 초기화: 선택사항입니다. 저장소를 초기화하고 .gitignore, 라이선스, README 파일을 추가하려면 이 옵션을 선택하세요.

   4. .gitignore: 선택사항. 드롭다운 메뉴 템플릿을 사용하여 추적하지 않을 파일을 선택합니다.

   5. license: 선택사항입니다. 드롭다운 메뉴에서 일반 라이선스를 선택합니다.

   6. 기본 브랜치: 기본 브랜치의 이름입니다.

5. 제출을 클릭합니다.

저장소가 Secure Source Manager 인스턴스에 생성됩니다.

새 저장소를 만들면 저장소 관리자 역할 (roles/securesourcemanager.repoAdmin)이 부여됩니다. 새 IAM 권한이 전파되는 데 최대 2분이 걸릴 수 있으므로 생성 후 저장소에 액세스하려고 할 때 권한 오류가 표시되면 몇 분 정도 기다린 후 다시 시도하세요.

생성한 저장소는 Secure Source Manager 웹 인터페이스의 내 저장소 페이지에 나열됩니다.

사용자 인증 정보 설정

다음 명령어를 실행하여 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

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

저장소 클론

1. Secure Source Manager 웹 인터페이스에서 저장소 페이지로 이동합니다.

2. 저장소 페이지 상단의 HTTPS URL을 복사합니다.

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

   git clone REPOSITORY_URL
   

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

   빈 저장소 복제에 관한 경고는 무시해도 됩니다.

저장소로 푸시

1. 터미널 창에서 디렉터리를 클론된 저장소로 변경합니다.

   cd REPOSITORY_NAME
   

   여기서 REPOSITORY_NAME은 저장소 이름입니다.

2. 빈 README 파일을 만듭니다.

   touch README.md
   

3. README 파일을 Git에 추가하고 커밋 메시지를 만듭니다.

   git add README.md
   git commit -m "initial commit"
   

4. 원격 저장소에 변경사항을 푸시합니다.

   git push -u origin main
   

   Git이 기본 브랜치의 파일을 origin 원격으로 푸시합니다. 출력은 다음과 비슷합니다.

   Enumerating objects: 3, done.
   Counting objects: 100% (3/3), done.
   Writing objects: 100% (3/3), 211 bytes | 211.00 KiB/s, done.
   Total 3 (delta 0), reused 0 (delta 0), pack-reused 0
   remote: . Processing 1 references
   remote: Processed 1 references in total
   To https://instance-id-123456789012-git.us-central1.sourcemanager.dev/my-project/my-repo.git
   * [new branch]      main -> main
   branch 'main' set up to track 'origin/main'.
   

Secure Source Manager에서 파일 보기

Secure Source Manager 웹 인터페이스에서 저장소 이름을 클릭합니다.

저장소 페이지가 열리고 README.md 파일이 <> 코드 탭에 표시됩니다.

삭제

이 페이지에서 사용한 리소스 비용이 Google Cloud 계정에 청구되지 않도록 하려면 다음 단계를 수행합니다.

저장소를 삭제하기 전에 보관할 파일을 다른 위치에서 사용할 수 있는지 확인합니다.

요청 데이터를 사용하기 전에 다음을 바꿉니다.

• PROJECT_ID: Secure Source Manager가 실행되는 Google Cloud 프로젝트의 프로젝트 ID입니다.
• LOCATION: 인스턴스가 있는 리전입니다. 지원되는 위치에 대한 자세한 내용은 위치를 참고하세요.
• REPOSITORY_ID: 저장소 ID입니다.

HTTP 메서드 및 URL:

DELETE https://securesourcemanager.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/repositories/REPOSITORY_ID

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

cURL(Linux, macOS, Cloud Shell)

참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하거나 gcloud CLI에 자동으로 로그인하는 Cloud Shell을 사용하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

다음 명령어를 실행합니다.

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://securesourcemanager.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/repositories/REPOSITORY_ID"

PowerShell(Windows)

참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

다음 명령어를 실행합니다.

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://securesourcemanager.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/repositories/REPOSITORY_ID" | Select-Object -Expand Content

다음과 비슷한 JSON 응답이 표시됩니다.

"name":"operations/cc3ea26c-9b57-11ed-be0a-2e3b5910efef","metadata":{"@type":"type.googleapis.com/google.cloud.securesourcemanager.v1.OperationMetadata","createTime":"2023-01-23T19:54:49.904779921Z","endTime":"2023-01-23T19:54:50.947030402Z","target":"projects/my-project/locations/us-central1/repositories/my-repo","verb":"delete","apiVersion":"v1"},"done":true,"response":{"@type":"type.googleapis.com/google.protobuf.Empty"}
```

응답은 다음과 유사합니다.

{"name":"operations/cc3ea26c-9b57-11ed-be0a-2e3b5910efef","metadata":{"@type":"type.googleapis.com/google.cloud.securesourcemanager.v1.OperationMetadata","createTime":"2023-01-23T19:54:49.904779921Z","endTime":"2023-01-23T19:54:50.947030402Z","target":"projects/my-project/locations/us-central1/repositories/my-repo","verb":"delete","apiVersion":"v1"},"done":true,"response":{"@type":"type.googleapis.com/google.protobuf.Empty"}

다음 단계

• Secure Source Manager 웹 인터페이스에서 저장소를 나열하고 확인합니다.
• Secure Source Manager의 pull 요청 및 문제를 사용합니다.