프로젝트는 Google Cloud 리소스 계층 구조의 기본 운영 단위입니다. 프로젝트는 폴더 (또는 조직)와 가상 머신, 스토리지와 같은 리소스 사이에 있습니다. 이 페이지에서는 Cloud Resource Manager API 및 Google Cloud 콘솔을 사용하여Google Cloud 프로젝트를 만드는 방법을 설명합니다.
프로젝트의 주요 특징은 다음과 같습니다.
기본 서비스 컨테이너: 프로젝트는 모든Google Cloud 서비스 (API)가 사용 설정되고 Compute Engine 인스턴스나 BigQuery 데이터 세트와 같은 리소스가 생성되는 기본 수준입니다.
신뢰 경계: 프로젝트는 격리 레이어 역할을 합니다. 기본적으로 한 프로젝트의 리소스는 다른 프로젝트의 리소스에 액세스할 수 없으므로 다양한 애플리케이션 또는 환경에 대한 보안 경계가 설정됩니다.
결제 단위: 프로젝트는 비즈니스에서 조직 전체의 비용을 추적, 정리, 분리하는 기본 방법입니다.
정책 연결 지점: 정책은 폴더에서 상속되는 경우가 많지만, 프로젝트 수준은 일상적인 작업을 위해 개발자와 서비스 계정에 특정 권한(Identity and Access Management (IAM))이 부여되는 가장 일반적인 위치입니다.
시작하기 전에
리소스 계층 구조 개요에서 프로젝트 리소스를 참조하세요. 리소스 계층 구조 설정에 대한 안내는 Google Cloud 시작 영역의 리소스 계층 구조 결정을 참고하세요.
프로젝트에 사용되는 식별자는 다음과 같습니다.
프로젝트 이름: 인간이 읽을 수 있는 프로젝트 이름입니다.
프로젝트 이름에는 다음 요구사항이 적용됩니다.
- 길이는 4~30자여야 합니다.
- 문자, 숫자, 작은따옴표, 하이픈, 공백 또는 느낌표를 포함할 수 있습니다.
- 문자 또는 숫자로 끝나야 합니다.
프로젝트 이름은 Google API에서 사용되지 않습니다. 프로젝트 이름은 프로젝트 생성 도중이나 이후 언제든지 수정할 수 있습니다. 프로젝트 이름은 고유하지 않아도 됩니다.
프로젝트 ID: 프로젝트의 전역 고유 식별자입니다.
프로젝트 ID는 Google Cloud에서 프로젝트를 다른 모든 프로젝트와 구분하는 고유한 문자열입니다. 프로젝트 이름을 입력하면Google Cloud 콘솔에서 문자, 숫자, 하이픈의 조합으로 구성된 고유한 프로젝트 ID를 생성합니다. 생성된 프로젝트 ID를 사용합니다. 프로젝트를 만드는 동안 수정할 수 있습니다. 프로젝트를 만든 후에는 프로젝트 ID가 영구적으로 유지됩니다.
프로젝트 ID에는 다음 요구사항이 있습니다.
- 길이는 6~30자여야 합니다.
- 소문자, 숫자, 하이픈만 포함할 수 있습니다.
- 이름은 문자로 시작해야 합니다.
- 하이픈으로 끝나면 안 됩니다.
- 삭제된 프로젝트를 포함해서 사용 중이거나 이전에 사용된 ID를 사용할 수 없습니다.
google,ssl과 같은 제한된 문자열을 포함할 수 없습니다. 프로젝트 ID에undefined,null과 같은 문자열을 사용하지 마세요.
프로젝트 번호: 프로젝트 번호는 프로젝트에 대해 자동으로 생성되는 고유 식별자입니다. 프로젝트 번호를 찾으려면 프로젝트 식별을 참조하세요.
프로젝트 이름, 프로젝트 ID 또는 기타 리소스 이름에 개인 식별 정보 또는 보안 데이터와 같은 민감한 정보를 포함하지 마세요. 프로젝트 ID는 다른 여러 Google Cloud리소스의 이름에 표시됩니다. 프로젝트 또는 해당 리소스를 참조하면 프로젝트 ID와 리소스 이름이 노출됩니다.
프로젝트 만들기
프로젝트를 만들려면 resourcemanager.projects.create 권한이 있어야 합니다. 이 권한은 프로젝트 생성자 역할(roles/resourcemanager.projectCreator)과 같은 역할에 포함되어 있습니다.
프로젝트 생성자 역할은 새 조직 리소스의 전체 도메인과 무료 체험판 사용자에게 기본적으로 부여됩니다.
개인에게 이 역할을 부여하고 조직 리소스 전체 액세스를 제한하는 방법에 대한 자세한 내용은 기본 조직 역할 관리 페이지를 참고하세요.
상위 리소스를 지정하지 않으면 사용자 계정의 도메인에 따라 해당되는 경우 상위 리소스가 자동으로 선택됩니다.
Google Cloud 콘솔, Google Cloud CLI 또는 projects.create() 메서드를 사용하여 새 프로젝트를 만들 수 있습니다.
콘솔
새 프로젝트를 만들려면 다음을 수행합니다.
-
Google Cloud 콘솔에서 리소스 관리 페이지로 이동합니다.
나머지 단계는 Google Cloud 콘솔에 표시됩니다.
- 프로젝트 만들기를 클릭합니다.
- 새 프로젝트 창이 나타나면 프로젝트 이름을 입력하고 해당되는 결제 계정을 선택합니다. 프로젝트 이름은 문자, 숫자, 작은 따옴표, 하이픈, 공백 또는 느낌표만 포함할 수 있으며, 4~30자(영문 기준)여야 합니다.
- 상위 리소스 상자에 상위 조직 또는 폴더 리소스를 입력합니다. 이 리소스는 새 프로젝트의 계층적 상위 항목이 됩니다. 조직 없음 옵션을 선택할 수 있는 경우 이를 선택하여 자체 리소스 계층 구조의 최상위 수준으로 새 프로젝트를 만들 수 있습니다.
- 새 프로젝트 세부정보 입력을 마쳤으면 만들기를 클릭합니다.
gcloud
-
Google Cloud 콘솔에서 Cloud Shell을 활성화합니다.
Google Cloud 콘솔 하단에서 Cloud Shell 세션이 시작되고 명령줄 프롬프트가 표시됩니다. Cloud Shell은 Google Cloud CLI가 사전 설치된 셸 환경으로, 현재 프로젝트의 값이 이미 설정되어 있습니다. 세션이 초기화되는 데 몇 초 정도 걸릴 수 있습니다.
새 프로젝트를 만들려면
gcloud projects create명령어를 사용합니다.gcloud projects create PROJECT_ID여기서 PROJECT_ID는 만들려는 프로젝트의 ID입니다. 프로젝트 ID는 소문자로 시작해야 하고 ASCII 문자, 숫자, 하이픈만 포함해야 하며 6~30자(영문 기준) 사이여야 합니다.
조직 리소스 또는 폴더를 상위 요소로 하여 프로젝트를 만들려면
--organization또는--folder플래그를 사용합니다. 리소스에는 하나의 상위 요소만 있을 수 있으므로 이러한 플래그 중 하나만 사용할 수 있습니다.gcloud projects create PROJECT_ID --organization=ORGANIZATION_IDgcloud projects create PROJECT_ID --folder=FOLDER_ID
REST
projects.create() 메서드로 새 프로젝트를 만들 때는 프로젝트 ID에 특정 단어를 사용할 수 없습니다(예: google, null, undefined, ssl 등이 여기에 해당합니다.
제한된 단어를 사용하면 요청이 INVALID_ARGUMENT 오류와 함께 반환됩니다.
다음 요청은 프로젝트만 만들고 결제 계정과 자동으로 연결하지는 않습니다. 프로젝트에 연결된 결제 계정을 설정하거나 업데이트하려면 projects.updateBillingInfo 메서드를 사용합니다.
프로젝트 만들기 요청:
POST https://cloudresourcemanager.googleapis.com/v3/projects/
Authorization: *************
Content-Type: application/json
{
"projectId": "our-project-123",
"name": "my project",
"labels": {
"mylabel": "prod"
}
}
프로젝트 만들기 응답:
{
"name": "operations/pc.123456789",
}
가져오기 작업 요청:
GET https://cloudresourcemanager.googleapis.com/v3/operations/pc.123456789
Authorization: *************
Content-Type: application/json
가져오기 작업 응답:
{
"name": "operations/pc.123456789",
"done": true,
"response": {
"@type": "type.googleapis.com/google.cloudresourcemanager.v3.Project",
"projectNumber": "464036093014",
"projectId": "our-project-123",
"lifecycleState": "ACTIVE",
"name": "my project",
"labels": {
"mylabel": "prod"
},
"createTime": "2016-01-07T21:59:43.314Z"
}
}
프로젝트 생성 중에 태그 추가
태그를 사용하면 리소스 주석을 만들 수 있습니다. 프로젝트를 만들 때 태그를 추가할 수 있습니다. 태그를 추가하는 동안 태그 사용자 역할을 할당해야 합니다. 이 역할에 할당된 권한에 대한 자세한 내용은 리소스에서 태그 관리를 참조하세요. 다음 방법 중 하나를 통해서만 태그 키-값 쌍의 네임스페이스를 추가할 수 있습니다.
gcloud
프로젝트를 만드는 동안 태그를 추가하려면 다음 명령어를 실행합니다.
gcloud projects create PROJECT_ID --organization=ORGANIZATION_ID --tags=KEY_VALUE_PAIRS
다음을 바꿉니다.
- PROJECT_ID는 프로젝트의 고유 식별자입니다.
- ORGANIZATION_ID는 조직의 고유 식별자입니다.
- KEY_VALUE_PAIRS는 리소스에 할당할 수 있는 쉼표로 구분된 키-값 쌍 목록입니다. 쉼표로 구분된 키-값 쌍의 예시는
123/environment=production, 456/create=testresource입니다. 이 예시에서123및456는 태그 키가 정의된 조직 또는 폴더 리소스의 고유 식별자 (ID)입니다.
REST
다음 스니펫은 프로젝트를 만들고 여기에 태그를 추가하는 JSON 요청입니다.
POST https://cloudresourcemanager.googleapis.com/v3/projects/
Authorization: *************
Content-Type: application/json
{
"projectId": "our-project-456",
"name": "my project",
"parent": "organizations/123",
"tags": {
"key": "123/environment"
"value": "production"
},
"tags": {
"key": "123/costCenter"
"value": "marketing"
}
}
태그를 사용하여 프로젝트 환경 지정
태그를 사용하여 프로덕션, 스테이징, 개발과 같은 환경에 따라 프로젝트를 시각적으로 구분할 수 있습니다. 이렇게 하면 민감한 환경에서 작업할 때 오류를 방지하고 인식을 개선할 수 있습니다. 특정 태그 키-값 쌍이 있는 프로젝트를 선택하면 Google에서 Google Cloud 콘솔 프로젝트 선택 도구의 프로젝트에 시각적 표시기를 추가합니다. 이 표시기는 변경사항이 연결된 프로덕션 또는 비프로덕션 애플리케이션에 영향을 줄 수 있음을 알려줍니다. 태그는 프로젝트에서 상속되거나 프로젝트에 직접 설정될 수 있습니다.
이 기능을 사용하려면 다음 단계를 따르세요.
environment라는 태그 키를 만듭니다.- 사용하는 환경 카테고리에 대한 태그 값을 만듭니다. 다음 값이 지원되며 콘솔의 프로젝트 선택기에서 해당 배지에 매핑됩니다.
- Prod: Prod, prod, Production, production
- 개발: Dev, dev, Development, development
- 테스트: Test, test, Testing, testing, QA, qa, Quality assurance, quality assurance
- 스테이징: Staging, staging, Stage, stage
- 태그 바인딩을 만들어 프로젝트에 적절한 태그를 연결합니다.
프로젝트에 여러 환경 태그가 있는 경우 (예: 폴더에서 상속된 태그와 프로젝트에 직접 지정된 태그) 가장 구체적인 태그가 배지를 결정하는 데 사용됩니다.
서비스 계정을 사용하여 프로젝트 만들기
서비스 계정을 사용하여 프로젝트 생성을 자동화할 수 있습니다. 사용자 계정과 마찬가지로 서비스 계정에는 조직 리소스 내에서 프로젝트를 만들 수 있는 권한이 부여될 수 있습니다. 서비스 계정은 조직 리소스 외부에서 프로젝트를 만들 수 없으며 프로젝트를 만들 때 상위 리소스를 지정해야 합니다.
서비스 계정에서 gcloud CLI 또는 projects.create() 메서드를 사용하여 새 프로젝트를 만들 수 있습니다.
프로젝트 할당량 관리
사용자 또는 서비스 계정이 만들 수 있는 프로젝트 수에는 제한이 있습니다. 조직 리소스 외부에서 프로젝트를 만드는 경우 사용자 계정의 할당량이 사용됩니다. 조직 리소스 내에서 프로젝트를 만드는 경우 사용자 계정과 조직 리소스 모두에 대한 할당량이 확인됩니다. 둘 중 하나에 할당량이 남아 있으면 프로젝트를 만들 수 있습니다.
남은 프로젝트 할당량이 30개 미만이면 새 프로젝트 페이지에 남은 프로젝트 할당량을 보여주는 알림이 표시됩니다. 프로젝트 한도에 도달하면 프로젝트 한도 증가를 요청해야 더 많은 프로젝트를 만들 수 있습니다. 또는 리소스 관리 페이지에서 30일 후에 일부 프로젝트가 삭제되도록 예약할 수 있습니다. 사용자가 소프트 삭제한 프로젝트는 할당량에 포함됩니다. 이러한 프로젝트는 30일 후 완전히 삭제됩니다.
조직 할당량의 프로젝트에 추가 용량을 요청하려면 다음 단계를 따르세요.
할당량 및 시스템 한도 페이지로 이동합니다.
리소스 선택기에서 프로젝트 할당량을 늘릴 조직을 선택합니다.
필터 옵션에서 측정항목을 선택하고
cloudresourcemanager.googleapis.com/projects_count를 입력합니다.Cloud Resource Manager API를 선택하고 작업 더보기를 클릭한 다음 할당량 수정을 선택합니다.
할당량 변경 대화상자에서 새 할당량 값과 설명을 입력한 후 다음을 클릭합니다.
연락처 세부정보를 입력하고 요청 제출을 클릭합니다.
요청 접수 확인 이메일이 전송됩니다. 추가 지원이 필요한 경우 이 이메일에 회신해 주세요. 검토가 완료되면 요청의 승인 여부를 나타내는 이메일 알림이 전송됩니다.
조직이 없으며 할당량 내에서 프로젝트의 용량을 추가로 요청하려면 프로젝트 할당량 증가 요청 양식을 사용하세요.
할당량과 할당량 사용 이유에 대한 자세한 내용은 무료 체험판 프로젝트 할당량 요청 지원 페이지를 참고하세요. 결제 보고서에 대한 자세한 내용은 결제 보고서 지원 페이지를 참고하세요.
다음 단계
- 프로젝트 보기 및 업데이트에 대해 알아보세요.
- 프로젝트 삭제 및 복원에 대해 알아보세요.
- 리소스 계층 구조 내에서 프로젝트를 이동하는 방법을 알아봅니다.
- 한 조직 리소스에서 다른 조직 리소스로 프로젝트를 마이그레이션하는 방법을 알아봅니다.