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

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

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

비공개 튜토리얼 호스팅

튜토리얼을 비공개로 설정하려면 호스팅하기 위한 비공개 Git 저장소가 필요합니다. 원하는 Git 저장소 호스팅 서비스를 사용할 수 있습니다. 이 가이드에서는 Google Cloud에서 호스팅되는 비공개 Git 저장소인 Cloud Source Repositories를 사용합니다.

비공개 튜토리얼을 호스팅할 Cloud Source Repositories 저장소를 만들려면 다음 안내를 따르세요.

  1. Cloud Shell 터미널을 시작합니다. 독립형 Cloud Shell 세션의 경우 shell.cloud.google.com을 사용합니다.
  2. 비공개 저장소를 만듭니다.

    gcloud source repos create REPO_NAME
    
  3. 저장소를 Cloud Shell에 클론합니다.

    gcloud source repos clone REPO_NAME
    
  4. 튜토리얼 파일을 로컬에서 생성된 저장소로 이동합니다.

    mv PATH/TO/TUTORIAL REPO_NAME/PATH/TO/TUTORIAL
    
  5. 로컬 저장소로 이동합니다.

    cd REPO_NAME
    
  6. 커밋할 튜토리얼을 추가합니다.

    git add .
    
  7. 파일을 이 작업의 기록을 설명하는 주석이 포함된 저장소로 커밋합니다.

    git commit -m "Add private tutorial to Cloud Source Repositories"
    
  8. git push 명령어를 사용하여 로컬 저장소 콘텐츠를 Cloud Source Repositories에 추가합니다.

    git push origin master
    
  9. Google Cloud Console에서 저장소와 해당 콘텐츠를 봅니다.

    Cloud Source Repositories 열기

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

Cloud Source Repositories 저장소에서 호스팅되는 튜토리얼의 경우 저장소의 URL을 사용하여 cloudshell_git_repo 매개변수를 정의해야 합니다.

cloudshell_git_repo가 정의된 링크 예시는 다음과 같습니다.

https://ssh.cloud.google.com/cloudshell/editor?cloudshell_git_repo=https://source.developers.google.com/p/project_name/r/repo_name

사용자가 링크를 쉽게 찾을 수 있도록 이 링크 스타일을 버튼으로 지정하여 문서에 삽입할 수 있습니다.

[![Open in Cloud Shell](https://gstatic.com/cloudssh/images/open-btn.svg)](https://ssh.cloud.google.com/cloudshell/editor?cloudshell_git_repo=https://source.developers.google.com/p/project_name/r/repo_name)

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

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

따라서 사용자에게 제공되는 모든 추가 패키지와 커스텀 구성이 포함된 커스텀 Cloud Shell 환경으로 작동하는 Docker 이미지를 만들 수 있습니다. 커스텀 컨테이너 이미지를 만들고 이 컨테이너 이미지를 참조하도록 Cloud Shell에서 열기 링크를 업데이트하는 방법에 대한 자세한 내용은 컨테이너 이미지 맞춤설정 가이드를 참조하세요.