샘플 저장소 설정

샘플 저장소는 개발자가 애플리케이션을 개발할 때 사용할 수 있도록 생성한 커스텀 샘플이 포함된 Git 저장소입니다.

즉, 조직 또는 팀 내에서 조직에 맞게 Cloud Code로 샘플 저장소를 설정하여 다른 사람이 사용할 수 있는 시작 애플리케이션, 서비스, 인프라 구성을 제공할 수 있습니다. 이렇게 하면 새로운 프로젝트를 조직이 선호하는 기술 스택 및 표준에 맞추는 데 도움이 되며 개발 주기 초기에 권장사항을 통합하도록 장려할 수 있습니다.

샘플 저장소는 이전에 만든 샘플 애플리케이션의 기존 저장소이거나 다른 사람이 사용할 수 있는 새로운 샘플 세트일 수 있습니다. 샘플 설명자 파일을 저장소에 추가하기만 하면 Cloud Code로 가져올 수 있습니다.

준비가 되면 샘플 저장소를 팀과 간편하게 공유할 수 있습니다. Cloud Code를 설정하고 사용할 샘플 저장소의 Git URL이 있어야 합니다. 비공개 Git 저장소의 경우 저장소에 대한 액세스 권한이 있는 구성원만 기본 커스텀 샘플을 사용할 수 있습니다.

샘플 저장소를 설정하는 방법의 예시를 보려면 이 저장소를 참조하세요.

새 샘플 저장소 만들기

사용할 완전히 새로워진 샘플 저장소를 만들려면 다음 단계를 수행합니다.

  1. 새 Git 저장소를 만듭니다.

    Git 저장소는 로컬 머신에 원격으로 또는 라이브로 호스팅될 수 있습니다. 이 예시에서는 완전히 새로워진 GitHub 저장소인 'custom-sample-repo'를 사용합니다.

    'custom-sample-repo'로 채워진 저장소 이름 필드가 있는 GitHub 저장소 생성 인터페이스

  2. 이 저장소에 샘플 디렉터리를 추가합니다.

    샘플 디렉터리에는 모든 항목이 포함될 수 있으며 저장소 내 원하는 곳 어디에든 위치할 수 있습니다. 이 예시에서는 샘플 디렉터리 'hello-world' 및 'kubernetes-custom-sample' 두 개가 'custom-sample-repo'에 추가되었습니다.

    커스텀 샘플 사용 방법에 대한 안내가 포함된 readme 파일이 권장됩니다.

    'hello-world' 및 'kubernetes-custom-sample'이라는 두 가지 기본 샘플 디렉터리가 있는 'custom-sample-repo'

  3. 샘플 설명자 파일을 만듭니다.

    샘플 설명자 파일은 애플리케이션을 올바르게 만들기 위해 샘플에 대한 정보를 Cloud Code에 제공합니다. 이 파일의 이름은 루트 디렉터리에 있는 .cctemplate이어야 하며 샘플 설명어 파일 스키마 섹션에 정의된 스키마가 있어야 합니다.

기존 저장소 사용

기존 저장소를 사용하려면 여전히 샘플 설명자 파일을 만들어야 합니다. 이 파일은 애플리케이션을 올바르게 만들기 위해 샘플에 대한 정보를 Cloud Code에 제공합니다.

샘플 설명어 파일의 이름은 루트 디렉터리에 있는 .cctemplate이어야 하며 샘플 설명어 파일 스키마 섹션에 스키마가 정의되어 있어야 합니다.

샘플 설명자 스키마

설명 유형
metadata Cloud Code에서 읽기에 사용되는 메타데이터입니다. 메타데이터 스키마를 준수합니다. 메타데이터
템플릿 저장소에 포함된 샘플의 배열입니다. 이 배열의 객체는 샘플 스키마를 준수해야 합니다. 배열<Sample>
이름(선택사항) 샘플 저장소 이름입니다. 문자열

예시

{
   "metadata":{
      "version":"1"
   },
   "name": "My Sample Repository",
   "templates":[
      {
         "path":"/path/to/sample1_location",
         "name":"My Sample 1",
         "description":"The first sample of its name."
      },
      {
         "path":"/path/to/sample2_location",
         "name":"My Sample 2",
         "description":"The sequel."
      }
   ]
}

샘플 스키마

설명 유형
경로 저장소 내에서 샘플의 위치입니다.

경로는 저장소 루트에서 발생한 것으로 해석됩니다.

문자열
이름 샘플 이름

이는 애플리케이션을 기반으로 하는 샘플을 선택할 때 IDE에 표시됩니다.

문자열
설명(선택사항) 샘플 설명입니다.

이는 애플리케이션을 기반으로 하는 샘플을 선택할 때 IDE에 표시됩니다.

문자열

예시

{
   "path":"path/to/sample1",
   "name":"My Sample 1",
   "description":"The first sample of its name."
}

메타데이터 스키마

설명 유형
버전 사용 중인 샘플 스키마의 버전입니다. 현재 유일하게 유효한 버전은 1입니다. 문자열

예시

{
   "version":"1"
}

지원 받기

IntelliJ IDE에서 의견을 제출하거나 문제를 신고하려면 Tools(도구) > Cloud Code > Help / About(도움말 / 정보) > Submit feedback or report an issue(의견 제출 또는 문제 신고)로 이동하여 GitHub에 문제를 신고하거나 Stack Overflow에서 질문합니다.

Google Cloud Slack 커뮤니티에 속한 #cloud-code 채널에도 가입할 수 있습니다.