Cloud Shell에서 비공개 튜토리얼 만들기

Cloud Shell은 비공개 튜토리얼 만들기를 지원하므로 특별히 잠재고객별로 튜토리얼을 설계할 수 있습니다.

Cloud Shell에서 쓰기 튜토리얼 가이드 를 사용하여 튜토리얼을 작성하고 튜토리얼 스타일 가이드에 자세히 설명된 권장사항을 따른 후에는 비공개 Git 저장소에서 튜토리얼을 호스팅하여 사용자에게 제공할 수 있습니다.

원하는 Git 저장소 호스팅 서비스를 사용할 수 있습니다. 이 가이드에서는 Secure Source Manager(에서 호스팅되는 리전별로 배포된 단일 테넌트 관리 소스 코드 저장소 Google Cloud)를 사용하여 단계를 보여줍니다.

비공개 Git 저장소 만들기

Secure Source Manager 인스턴스는 사용 가능한 Google Cloud 리전에 배포되며 인스턴스 URI를 통해 액세스할 수 있습니다. 저장소는 웹 인터페이스 또는 Secure Source Manager API를 사용하여 Secure Source Manager 인스턴스에서 생성됩니다.

비공개 튜토리얼을 호스팅할 Secure Source Manager 저장소를 만들려면 다음 단계를 완료하세요.

  1. Cloud Shell 터미널을 시작합니다. 독립형 Cloud Shell 세션의 경우 shell.cloud.google.com을 사용합니다.

  2. Secure Source Manager 인스턴스가 없는 경우 Secure Source Manager 인스턴스를 만듭니다.

    gcloud source-manager instances create INSTANCE_ID \
    --region=LOCATION

    다음을 바꿉니다.

    • INSTANCE_ID: Secure Source Manager 인스턴스의 ID입니다.
    • LOCATION: 인스턴스를 만드는 리전입니다(예: us-central1).

    인스턴스를 만드는 데 최대 60분이 걸릴 수 있습니다.

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

    INSTANCE_ID-PROJECT_NUMBER.LOCATION.sourcemanager.dev

    PROJECT_NUMBER를 인스턴스의 Google Cloud 프로젝트 번호로 바꿉니다.

  4. 비공개 저장소를 만듭니다.

    gcloud source-manager repos create REPO_ID \
    --instance=INSTANCE_ID \
    --region=LOCATION

    REPO_ID를 Secure Source Manager 저장소의 ID로 바꿉니다.

    저장소를 만드는 데 필요한 권한에 대한 자세한 내용은 필수 역할을 참조하세요.

  5. Secure Source Manager 인증 도우미를 전역 Git 구성에 추가합니다. 자세한 내용은 사용자 인증 정보 설정을 참조하세요.

  6. 저장소를 Cloud Shell에 클론합니다.

    git clone https://INSTANCE_ID-PROJECT_NUMBER-git.LOCATION.sourcemanager.dev/PROJECT_ID/REPO_ID.git

    PROJECT_ID를 인스턴스의 Google Cloud 프로젝트 ID로 바꿉니다.

  7. 튜토리얼 파일을 로컬에서 생성된 저장소로 이동합니다.

    mv PATH_TO_TUTORIAL REPO_ID/PATH_TO_TUTORIAL

    PATH_TO_TUTORIAL을 비공개 튜토리얼의 경로로 바꿉니다.

  8. 로컬 저장소로 이동합니다.

    cd REPO_ID

  9. 튜토리얼 파일을 추가, 커밋, 푸시합니다.

    git add .
git commit -m "Add private tutorial to Secure Source Manager"
git push origin main

  10. 웹 인터페이스에서 Secure Source Manager 저장소를 볼 수 있습니다. 자세한 내용은 저장소 나열 및 보기를 참조하세요.

사용자가 튜토리얼에 접근할 수 있도록 사용자가 튜토리얼에 액세스하는 방법을 정의할 수 있는 Cloud Shell의 Cloud Shell에서 열기 기능을 사용할 수 있습니다. 링크를 맞춤설정하는 방법에 대한 자세한 내용은 Cloud Shell에서 열기 가이드를 참조하세요.

Secure Source Manager 저장소에서 호스팅되는 튜토리얼의 경우 저장소의 HTTPS URL을 사용하여 cloudshell_git_repo 매개변수를 정의해야 합니다. 예를 들면 다음과 같습니다.

https://ssh.cloud.google.com/cloudshell/editor?cloudshell_git_repo=https://INSTANCE_ID-PROJECT_NUMBER-git.LOCATION.sourcemanager.dev/PROJECT_ID/REPO_ID.git

이 링크를 버튼으로 스타일 지정하고 문서에 삽입하여 사용자가 찾을 수 있도록 할 수 있습니다. 예를 들면 다음과 같습니다.

[![Open in Cloud Shell](https://gstatic.com/cloudssh/images/open-btn.svg)](https://ssh.cloud.google.com/cloudshell/editor?cloudshell_git_repo=https://INSTANCE_ID-PROJECT_NUMBER-git.LOCATION.sourcemanager.dev/PROJECT_ID/REPO_ID.git)

부가기능 도구로 튜토리얼 맞춤설정

사용자에게 튜토리얼에서 사용할 수 있는 커스텀 도구를 제공하여 비공개 튜토리얼 환경을 추가로 맞춤설정할 수 있습니다.

따라서 사용자에게 제공되는 모든 추가 패키지와 커스텀 구성이 포함된 커스텀 Cloud Shell 환경으로 작동하는 Docker 이미지를 만들 수 있습니다.