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에서 다음 명령어를 실행하여 시작할 수 있는 커스텀 이미지 만들기 튜터리얼을 사용합니다.
큰 이미지는 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
|
Cloud Shell용 작업 디렉터리 지정된 디렉터리에서 터미널이 열립니다. Cloud Shell 편집기에서 디렉터리가 작업공간으로 열립니다. | 클론된 저장소를 기준으로 한 유효한 파일 경로입니다. 매개변수 값을 비워 두거나 . 를 사용하여 클론된 저장소의 루트를 지정할 수 있습니다. 저장소가 지정되지 않으면 경로는 Cloud Shell 홈 디렉터리 기준입니다. 대문자, 소문자, 숫자, 물결표(~), 밑줄(_), 하이픈(-), 마침표(.), 슬래시(/), 콜론(:)과 같은 문자를 사용할 수 있습니다.
|
ephemeral |
이 매개변수를 지정하여 Cloud Shell에서 저장소를 열면 세션 종료 시 삭제되는 스크래치 홈 디렉터리가 있는 임시 환경이 생성됩니다. 자세한 내용은 임시 모드 선택을 참조하세요. |
|
show
|
터미널 또는 Cloud Shell 편집기만 사용하거나 둘 다 사용하여 엽니다. |
|
예시
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에서 열기 링크의 동작을 구체적으로 정의하려면 아래 양식을 사용하여 Cloud Shell에서 저장소를 여는 데 필요한 매개변수를 실험해 보세요.