Google Apps Script 프로젝트 배포는 웹 앱, Google Workspace 부가기능 또는 API 실행 파일로 사용할 수 있는 스크립트 버전입니다. 배포를 만들고 관리하면 코드를 반복하고, 변경사항을 추적하고, 사용자가 액세스하는 코드 버전을 제어할 수 있습니다.
배포에는 두 가지 유형이 있습니다.
- 헤드 배포: 항상 현재 프로젝트 코드와 동기화됩니다.
- 버전이 지정된 배포: 특정 프로젝트 버전에 연결됩니다.
헤드 배포
헤드 배포는 현재 프로젝트 코드입니다. Apps Script 프로젝트를 만들면 시스템에서 해당 프로젝트의 헤드 배포를 자동으로 만듭니다.
헤드 배포는 항상 가장 최근에 저장된 코드와 동기화됩니다. 예를 들어 버전이 지정된 배포를 만든 후 코드를 수정하면 버전이 지정된 배포는 그대로 유지되지만 헤드 배포에는 변경사항이 반영됩니다.
헤드 배포를 사용하여 코드를 테스트합니다. 공용으로는 헤드 배포를 사용하지 마세요.
Apps Script 프로젝트마다 하나의 최신 버전 배포만 있습니다. 헤드 배포를 사용하려면 스크립트 프로젝트에 대한 읽기 액세스 권한이 있어야 합니다.
버전이 지정된 배포
버전이 지정된 배포는 특정 버전의 프로젝트 코드를 사용할 수 있도록 합니다. 이를 통해 사용자는 코드를 변경하고 개선하는 동안 작동하는 버전을 계속 사용할 수 있습니다.
공개용 애플리케이션을 게시할 때는 항상 버전이 지정된 배포를 사용하세요. 한 번에 여러 활성 버전이 지정된 배포가 있을 수 있습니다.
중요: 버전이 지정된 배포의 소유권은 이전할 수 없습니다. 스크립트 프로젝트의 소유권을 이전해도 기존 버전이 지정된 배포의 소유자는 변경되지 않습니다. 관리자가 배포 소유자의 계정을 삭제하면 배포에서 스크립트 오류가 발생할 수 있습니다.
버전이 지정된 배포 만들기
부가기능, 편집기 부가기능, Chat 앱 또는 API 실행 파일의 버전을 배포하려면 먼저 Apps Script의 Google Cloud 프로젝트 연결을 기본 프로젝트에서 표준 프로젝트로 전환해야 합니다.
버전이 지정된 배포를 만들려면 다음 단계를 따르세요.
- Apps Script 프로젝트를 엽니다. <<../_common/snippets/create-new-deployment.md>>
각 새 배포는 라이브러리로 공유할 수 있습니다. 스크립트를 라이브러리로 공유하면 배포 설명이 라이브러리 사용자에게 표시됩니다.
버전이 지정된 배포 보기
Apps Script 프로젝트의 배포를 보려면 상단에서 배포 > 배포 관리를 클릭합니다.
특정 버전의 코드를 보려면 이전 버전 보기를 참고하세요.
버전이 지정된 배포 수정
버전이 지정된 배포를 수정하여 설명이나 버전을 변경할 수 있습니다. 배포를 수정하려면 다음 단계를 따르세요.
- Apps Script 프로젝트를 엽니다.
- 배포 > 배포 관리를 클릭합니다.
- 활성 배포를 선택하고 수정 을 클릭합니다.
- 변경한 다음 배포를 클릭합니다.
보관된 배포를 수정하려면 다시 배포한 후 위의 단계를 따르세요.
프로젝트 코드의 변경사항을 배포하려면 새 버전을 만들고 새 버전을 사용하도록 배포를 수정하세요. 배포는 모든 사용자에 대해 새 버전을 자동으로 사용합니다.
배포 ID 찾기
모든 배포에는 연결된 문자열 ID가 있습니다. 이 ID를 찾는 방법은 다음과 같습니다.
- Apps Script 프로젝트를 엽니다.
- 오른쪽 상단에서 배포 > 배포 관리를 클릭합니다.
- 활성 배포를 선택하여 ID를 확인합니다.
배포 ID는 활성 배포에만 표시됩니다.
배포 테스트
배포를 테스트하는 방법은 빌드하는 앱의 유형에 따라 다릅니다.
Google Workspace 부가기능
부가기능 배포를 테스트하려면 부가기능 테스트를 참고하세요.
편집자 부가기능
Editor 부가기능 배포를 테스트하려면 Editor 부가기능 테스트를 참고하세요.
웹 앱
웹 앱 배포를 테스트하려면 웹 앱 배포 테스트를 참고하세요.
Google Chat 앱
채팅 앱 배포를 테스트하려면 스크립트의 버전이 지정된 배포를 만들어 배포 ID에 액세스하세요.
배포 ID를 확인한 후 Chat API 구성에서 ID를 지정하고 단계에 따라 양방향 기능을 테스트합니다.
API 실행 파일
API 실행 파일 배포를 테스트하려면 버전이 지정된 배포를 만드세요. 배포를 만든 후 다음 단계를 따르세요.
- Apps Script 프로젝트의 오른쪽 상단에서 배포 > 테스트 배포를 클릭합니다.
- '유형 선택' 옆에 있는
> API 실행 파일을 클릭합니다. - URL을 복사하여 API 실행 파일 배포를 테스트합니다.
버전이 지정된 배포 보관처리
버전이 지정된 배포는 삭제할 수 없습니다. 대신 보관처리할 수 있습니다.
버전이 지정된 배포를 보관처리하려면 다음 단계를 따르세요.
- Apps Script 프로젝트를 엽니다.
- 배포 > 배포 관리를 클릭합니다.
- 배포를 선택하고 배포 보관 을 클릭합니다.
보관처리된 배포 재배포
- Apps Script 프로젝트를 엽니다.
- 오른쪽 상단에서 배포 > 배포 관리를 클릭합니다.
- 보관됨에서 배포를 선택하고 수정 > 배포를 클릭합니다.