프로젝트는 Google Cloud 리소스 계층 구조의 기본 운영 단위입니다. 프로젝트는 폴더 (또는 조직)와 가상 머신, 스토리지와 같은 리소스 사이에 존재합니다. 이 페이지에서는 Cloud Resource Manager API 및 Google Cloud 콘솔을 사용하여 Google Cloud 프로젝트를 만드는 방법을 설명합니다.
프로젝트의 주요 특징은 다음과 같습니다.
기본 서비스 컨테이너: 프로젝트는 모든 Google Cloud 서비스 (API)가 사용 설정되고 Compute Engine 인스턴스 또는 BigQuery 데이터 세트와 같은 리소스가 생성되는 기본 수준입니다.
신뢰 경계: 프로젝트는 격리 계층 역할을 합니다. 기본적으로 한 프로젝트의 리소스는 다른 프로젝트의 리소스에 액세스할 수 없으므로 다양한 애플리케이션 또는 환경에 대한 보안 경계가 설정됩니다.
결제 단위: 프로젝트는 기업이 조직 전체에서 비용을 추적, 구성, 분리하는 기본 방법입니다.
정책 연결 지점: 정책은 폴더에서 상속되는 경우가 많지만 프로젝트 수준은 개발자와 서비스 계정에 일상적인 작업을 위한 특정 권한(Identity and Access Management (IAM))이 부여되는 가장 일반적인 위치입니다.
시작하기 전에
리소스 계층 구조 개요에서 프로젝트 리소스를 참조하세요. 리소스 계층 구조 설정에 대한 안내는 시작 영역의 리소스 계층 구조 결정을 참조하세요. Google Cloud
T프로젝트에 사용되는 식별자는 다음과 같습니다.
프로젝트 이름: 인간이 읽을 수 있는 프로젝트 이름입니다.
프로젝트 이름은 Google API에서 사용되지 않습니다. 프로젝트 이름은 프로젝트 생성 도중이나 이후 언제든지 수정할 수 있습니다. 프로젝트 이름은 고유하지 않아도 됩니다.
프로젝트 ID: 전역에서 고유한 프로젝트 식별자입니다.
프로젝트 ID는 에서 프로젝트를 다른 모든 프로젝트와 구분하는 고유한 문자열입니다. Google Cloud프로젝트 이름을 입력하면 Google Cloud 콘솔에서 문자, 숫자, 하이픈의 조합으로 구성될 수 있는 고유한 프로젝트 ID를 생성합니다. 생성된 프로젝트 ID를 사용하지만 프로젝트를 만드는 동안 수정할 수 있습니다. 프로젝트를 만든 후에는 프로젝트 ID가 영구적으로 유지됩니다.
프로젝트 ID에는 다음과 같은 요구사항이 있습니다.
- 길이는 6~30자(영문 기준)여야 합니다.
- 소문자, 숫자, 하이픈만 포함할 수 있습니다.
- 이름은 문자로 시작해야 합니다.
- 하이픈으로 끝나면 안 됩니다.
- 사용 중이거나 이전에 사용된 적이 없어야 합니다. 여기에는 삭제된 프로젝트가 포함됩니다.
google및ssl과 같은 제한된 문자열을 포함할 수 없습니다. 프로젝트 ID에undefined및null과 같은 문자열을 사용하지 마세요.
프로젝트 번호: 프로젝트 번호는 프로젝트에 대해 자동으로 생성되는 고유 식별자입니다.
프로젝트 이름, 프로젝트 ID 또는 기타 리소스 이름에 개인 식별 정보 또는 보안 데이터와 같은 민감한 정보를 포함하지 마세요. 프로젝트 ID는 다른 여러 Google Cloud 리소스의 이름에 표시됩니다. 프로젝트 또는 해당 리소스를 참조하면 프로젝트 ID와 리소스 이름이 노출됩니다.
프로젝트 만들기
프로젝트를 만들려면 resourcemanager.projects.create 권한이 있어야 합니다. 이 권한은 프로젝트 생성자 역할(roles/resourcemanager.projectCreator)과 같은 역할에 포함되어 있습니다.
프로젝트 생성자 역할은 새 조직 리소스의 전체 도메인과 무료 체험판 사용자에게 기본적으로 부여됩니다.
개인에게 이 역할을 부여하고 조직 리소스 전체 액세스를 제한하는 방법에 대한 자세한 내용은 기본 조직 역할 관리 페이지를 참조하세요.
상위 리소스를 지정하지 않으면 사용자 계정의 도메인에 따라 해당되는 경우 상위 리소스가 자동으로 선택됩니다.
콘솔, Google Cloud CLI 또는 메서드를 사용하여 새 프로젝트를 만들 수 있습니다. Google Cloud projects.create()
콘솔
새 프로젝트를 만들려면 다음을 수행합니다.
-
Google Cloud 콘솔에서 리소스 관리 페이지로 이동합니다.
나머지 단계는 Google Cloud 콘솔에 표시됩니다.
- 페이지 상단의 조직 선택 드롭다운 목록에서 프로젝트를 만들려는 조직 리소스를 선택합니다. 무료 체험판 사용자인 경우에는 이 목록이 나타나지 않으므로, 이 단계를 건너뜁니다.
- 프로젝트 만들기를 클릭합니다.
- 나타나는 새 프로젝트 창에 프로젝트 이름을 입력하고 해당되는 결제 계정을 선택합니다. 프로젝트 이름은 문자, 숫자, 작은 따옴표, 하이픈, 공백 또는 느낌표만 포함할 수 있으며, 4~30자(영문 기준)여야 합니다.
- 위치 상자에 상위 조직 또는 폴더 리소스를 입력합니다. 이 리소스 는 새 프로젝트의 계층적 상위 항목이 됩니다. 조직 없음 옵션을 선택할 수 있는 경우 이를 선택하여 새 리소스 자체의 최상위 수준으로 새 프로젝트를 만들 수 있습니다.
- 새 프로젝트 세부정보 입력을 마쳤으면 만들기 를 클릭합니다.
gcloud
-
콘솔에서 Cloud Shell을 활성화합니다. Google Cloud
콘솔 하단에 Cloud Shell 세션이 시작되고 명령줄 프롬프트가 표시됩니다. Google Cloud 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`). 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입니다.
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, 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를 선택하고 추가 작업을 클릭한 후 할당량 수정을 선택합니다.
할당량 변경사항 대화상자에서 새 할당량 값과 설명을 입력한 후 다음 을 클릭합니다.
연락처 세부정보를 입력하고 요청 제출 을 클릭합니다.
요청이 접수되었음을 알리는 이메일이 전송됩니다. 추가 지원이 필요한 경우 이 이메일에 회신해 주세요. 검토 후 요청의 승인 여부를 나타내는 이메일 알림이 전송됩니다.
조직이 없고 할당량의 프로젝트에 대한 추가 용량을 요청하려면 프로젝트 할당량 증가 요청 양식을 사용하세요.
할당량 및 할당량이 사용되는 이유에 대한 자세한 내용은 무료 체험판 프로젝트 할당량 요청 지원 페이지를 참조하세요. 결제 보고서에 대한 자세한 내용은 결제 보고서 지원 페이지를 참조하세요.
다음 단계
- 프로젝트 보기 및 업데이트에 대해 알아봅니다.
- 프로젝트 삭제 및 복원에 대해 알아봅니다.
- 리소스 계층 구조 내에서 프로젝트를 이동하는 방법을 알아봅니다.
- 한 조직 리소스에서 다른 조직 리소스로 프로젝트를 마이그레이션하는 방법을 알아봅니다.