Cloud Shell에서 열기

Cloud Shell에서 열기 기능을 사용하면 Cloud Shell에 클론된 Git 저장소가 포함된 Google Cloud Console을 열거나 커스텀 이미지로 Cloud Shell을 시작할 수 있는 링크를 게시할 수 있습니다. 사용자가 콘텐츠와 상호작용하는 데 도움이 되도록 터미널에 안내를 출력할 수도 있습니다.

Cloud Shell에서 열기 링크를 사용하면 개발자가 Google Cloud CLI를 다운로드하거나, 필요한 종속 항목을 설치하거나, 관련 소스 파일을 검색할 필요 없이 코드 샘플 및 API를 실험할 수 있습니다. 이 페이지에서는 Cloud Shell에서 열기 링크를 Git 저장소에 추가하는 방법을 설명합니다.

URL 매개변수

Cloud Shell에서 열기 링크는 버튼 이미지에 선택적으로 포함되며, Git 저장소에 있는 모든 디렉터리의 README.md에 추가할 수 있습니다. 이 링크는 Git 저장소의 루트 README.md 파일에 저장하는 것이 좋습니다.

필수 URL 매개변수

이 링크를 만들려면 shell.cloud.google.com과 같은 기본 URL(또는 console.cloud.google.com로 시작하는 Google Cloud 콘솔의 페이지)을 다음 필수 URL 매개변수와 함께 사용합니다.

URL 매개변수 설명 지원되는 값
cloudshell_git_repo

클론하려는 Git 저장소의 URL입니다.

저장소가 클론된 후 프로젝트 폴더의 루트가 열리고 왼쪽 탐색창에 콘텐츠가 표시됩니다.

Git 저장소의 유효한 URL이어야 합니다.

이 URL은 허용된 도메인(GitHub 또는 Bitbucket)과 경로로 구성됩니다. 대문자, 소문자, 숫자, 밑줄(_), 하이픈(-), 마침표(.), 슬래시(/)와 같은 문자를 사용할 수 있습니다.

선택적 URL 매개변수

또한 다음의 선택적 매개변수를 지정할 수도 있습니다.

URL 매개변수 설명 지원되는 값
cloudshell_git_branch Git 저장소에서 분기하여 클론합니다. cloudshell_git_repo가 지정된 경우에만 적용할 수 있습니다. 기본 분기는 master입니다. 저장소에서 유효한 임의의 분기여야 합니다. 대문자, 소문자, 숫자, 물결표(~), 밑줄(_), 하이픈(-), 마침표(.), 슬래시(/), 콜론(:)과 같은 문자를 사용할 수 있습니다.
cloudshell_image

세션 중에 맞춤설정된 환경을 실행하는 커스텀 Docker 이미지입니다. 이를 통해 사용자가 저장소 작업에 사용할 수 있는 Cloud Shell의 커스텀 도구를 제공할 수 있습니다.

이 매개변수를 지정하여 Cloud Shell에서 저장소를 열면 세션 종료 시 삭제되는 스크래치 홈 디렉터리가 있는 임시 환경이 생성됩니다.

Container Registry에서 호스팅되는 Docker 이미지의 URL이어야 합니다. Docker 이미지는 기본 Cloud Shell 이미지를 기반으로 하고 공개적으로 액세스할 수 있어야 합니다.

유효한 이미지를 만들려면 Cloud Shell에서 다음 명령어를 실행하여 시작할 수 있는 커스텀 이미지 만들기 튜터리얼을 사용합니다.

cloudshell launch-tutorial /google/devshell/tutorials/custom-image-tutorial.md

큰 이미지는 URL이 열려 있을 때 Cloud Shell VM으로 다운로드하는 데 다소 시간이 걸립니다.

cloudshell_open_in_editor

Cloud Shell 편집기에서 열 파일입니다. 반복하여 입력하면 여러 개의 파일이 열리도록 지정할 수 있습니다. 여러 개를 지정한 경우 입력한 순서대로 열립니다.

지정된 파일은 오른쪽 편집기 탭에 열리며, 열려 있는 프로젝트의 파일당 1개의 탭이 열립니다.

파일 경로는 현재 디렉터리를 기준으로 합니다. working_dir 매개변수를 입력한 경우 이러한 파일 경로는 working_dir을 기준으로 처리됩니다.

대문자, 소문자, 숫자, 물결표(~), 밑줄(_), 하이픈(-), 마침표(.), 슬래시(/), 콜론(:)으로 구성된 모든 유효한 파일 경로입니다.
cloudshell_print

Git 저장소의 파일로, 보통 사용자의 다음 단계를 안내하기 위해 터미널에 인쇄되는 지침으로 구성되어 있습니다. 파일 경로는 현재 디렉터리를 기준으로 합니다.

working_dir 매개변수를 입력한 경우 이 파일 경로는 working_dir를 기준으로 처리됩니다.

대문자, 소문자, 숫자, 물결표(~), 밑줄(_), 하이픈(-), 마침표(.), 슬래시(/), 콜론(:)으로 구성된 모든 유효한 파일 경로입니다.
cloudshell_tutorial

Git 저장소의 튜토리얼 마크다운 파일로, 프로젝트에서 사용자를 안내하는 튜토리얼로 실행할 지침으로 구성되어 있습니다. 파일 경로는 현재 디렉터리를 기준으로 합니다.

유효한 파일 이름과 함께 적절한 형식을 갖춘 튜토리얼 마크다운 파일이어야 합니다.

cloudshell_working_dir(지원 중단됨)

이 매개변수는 지원 중단되었습니다. 대신 cloudshell_workspace를 사용하세요.

대문자, 소문자, 숫자, 물결표(~), 밑줄(_), 하이픈(-), 마침표(.), 슬래시(/), 콜론(:)으로 구성된 모든 유효한 파일 경로입니다.
cloudshell_workspace Cloud Shell용 작업 디렉터리 지정된 디렉터리에서 터미널이 열립니다. Cloud Shell 편집기에서 디렉터리가 작업공간으로 열립니다. 클론된 저장소를 기준으로 한 유효한 파일 경로입니다. 매개변수 값을 비워 두거나 .를 사용하여 클론된 저장소의 루트를 지정할 수 있습니다. 저장소가 지정되지 않으면 경로는 Cloud Shell 홈 디렉터리 기준입니다. 대문자, 소문자, 숫자, 물결표(~), 밑줄(_), 하이픈(-), 마침표(.), 슬래시(/), 콜론(:)과 같은 문자를 사용할 수 있습니다.
ephemeral 이 매개변수를 지정하여 Cloud Shell에서 저장소를 열면 세션 종료 시 삭제되는 스크래치 홈 디렉터리가 있는 임시 환경이 생성됩니다. 자세한 내용은 임시 모드 선택을 참조하세요.

true, false

show

터미널 또는 Cloud Shell 편집기만 사용하거나 둘 다 사용하여 엽니다.

ide, terminal, ide%2Cterminal

예시

Cloud Shell에서 샘플 Git 저장소를 여는 버튼을 삽입하려면 저장소의 README.md 파일에 다음 마크다운을 포함합니다.

  [![Open in Cloud Shell](https://gstatic.com/cloudssh/images/open-btn.svg)](https://shell.cloud.google.com/cloudshell/editor?cloudshell_git_repo=http://path-to-repo/sample.git)

동일한 기능을 웹사이트에 삽입하려면 다음과 같은 HTML 스니펫을 사용합니다.

  <a href="https://shell.cloud.google.com/cloudshell/editor?cloudshell_git_repo=http://path-to-repo/sample.git">
  <img alt="Open in Cloud Shell" src ="https://gstatic.com/cloudssh/images/open-btn.svg">
  </a>

Cloud Shell에서 열기 링크의 동작을 구체적으로 정의하려면 아래 양식을 사용하여 Cloud Shell에서 저장소를 여는 데 필요한 매개변수를 실험해 보세요.