建立專案

專案是 Google Cloud資源階層中的基本作業單位，可讓您整理、隔離及控管雲端資源。專案位於資料夾 (或組織資源) 與服務資源 (例如虛擬機器和儲存空間) 之間，可協助您管理各環境的 API、帳單和權限。如要建立及管理專案，可以使用 Google Cloud 控制台、Google Cloud CLI 或 Cloud Resource Manager API。

專案的主要特性

專案的主要特徵如下：

  • 主要服務容器：專案是基礎層級，您可以在此啟用 Google Cloud 服務 (API)，並建立 Compute Engine 執行個體或 BigQuery 資料集等資源。

  • 信任範圍：專案可做為隔離層。根據預設，某個專案中的資源無法存取其他專案中的資源，這有助於為不同的應用程式或環境建立安全 perimeter。

  • 計費單位：專案是追蹤、整理及區分整個組織費用的主要方式。

  • 政策附加點：雖然專案會繼承資料夾和組織資源的政策，但專案層級是最常見的地方，您可以在這裡授予開發人員和服務帳戶特定的 Identity and Access Management (IAM) 權限，以便執行日常工作。

事前準備

請參閱資源階層總覽，瞭解專案資源。如需設定資源階層結構的指引，請參閱「決定 Google Cloud 登陸區的資源階層結構」。

專案會使用下列 ID：

  • 專案名稱：人類可讀的專案名稱。

    專案名稱必須符合下列規定：

    • 長度必須介於 4 到 30 個字元之間。
    • 可以使用英文字母、數字、單引號、連字號、空格或驚嘆號。
    • 結尾須為英文字母或數字。

    Google API 無法辨識專案名稱。在建立專案期間或之後，您隨時可以編輯專案名稱。專案名稱不一定要是專屬名稱

  • 專案 ID：專案的全域專屬 ID。

    專案 ID 是不重複的字串，用於區分 Google Cloud中的專案。輸入專案名稱後，Google Cloud 控制台會產生專屬專案 ID，可能由英文字母、數字和連字號組成。請使用系統產生的專案 ID，但您可以在建立專案時編輯 ID。專案建立後，專案 ID 即無法變更。

    專案 ID 必須符合下列規定：

    • 長度必須介於 6 到 30 個字元之間。
    • 只能使用小寫英文字母、數字和連字號。
    • 開頭必須是英文字母。
    • 結尾不得為連字號。
    • 不得為使用中或先前使用過的 ID，包括已刪除的專案。
    • 不得包含 google 和 ssl 等受限字串。請避免在專案 ID 中使用 undefined 和 null 等字串。

  • 專案編號：專案編號是系統自動產生的專案專屬 ID。如要查看專案編號，請參閱「識別專案」。

請勿在專案名稱、專案 ID 或其他資源名稱中加入機密資訊，例如個人識別資訊或安全資料。專案 ID 會顯示在許多其他 Google Cloud資源的名稱中。參照專案或其資源會公開專案 ID 和資源名稱。

建立專案

您必須具備 resourcemanager.projects.create 權限，才能建立專案。專案建立者角色 (roles/resourcemanager.projectCreator) 等角色具備這項權限。

如要瞭解如何授予個人角色，以及限制整個組織資源的存取權，請參閱「管理預設組織角色」頁面。

如未指定上層資源，系統會根據使用者帳戶的網域，自動選取適用的上層資源。

您可以使用 Google Cloud 控制台、Google Cloud CLI 或 projects.create() 方法建立新專案。

控制台

如要建立新專案，請執行下列步驟：

  1. 前往 Google Cloud 控制台的「Manage resources」(管理資源) 頁面。

    前往「Manage Resources」(管理資源) 頁面

    其餘步驟會顯示在 Google Cloud 控制台。

  2. 按一下「Create project」(建立專案)。
  3. 在顯示的「New project」(新增專案) 視窗中，輸入專案名稱並選取適當的帳單帳戶。專案名稱只能由英文字母、數字、單引號、連字號、空格或驚嘆號組成，而且長度必須介於 4 至 30 個字元之間。
  4. 在「Parent resource」(上層資源) 方塊中，輸入上層組織或資料夾資源，該資源將成為新專案的階層父項。 如果系統顯示「No organization」(無組織) 這個選項，只要選取該選項即可建立新專案，做為其資源階層的頂層。
  5. 輸入新專案的詳細資料後，按一下「Create」(建立)。

gcloud

  1. 在 Google Cloud 控制台啟用 Cloud Shell。

    啟用 Cloud Shell

    Google Cloud 控制台底部會開啟 Cloud Shell 工作階段，並顯示指令列提示。Cloud Shell 是已安裝 Google Cloud CLI 的殼層環境，並已設定適用於您目前專案的值。工作階段可能要幾秒鐘的時間才能初始化。

  2. 如要建立新專案，請使用 gcloud projects create 指令：

    gcloud projects create PROJECT_ID

    其中 PROJECT_ID 是要建立的專案 ID。專案 ID 只能使用 ASCII 字母、數字和連字號，開頭須為小寫英文字母，長度須介於 6 至 30 個字元之間。

    如要建立以組織資源或資料夾為父項的專案，請使用 --organization 或 --folder 旗標。每個資源只能有一個父項，所以只能使用其中一個標記。

    gcloud projects create PROJECT_ID --organization=ORGANIZATION_ID

    gcloud 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 是專案的專屬 ID。
  • ORGANIZATION_ID 是組織的專屬 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 控制台專案挑選器中，為該專案新增視覺指標。這項指標會提醒您，任何變更都可能影響相關聯的正式環境或非正式環境應用程式。標記可由專案繼承，或直接在專案上設定。

如要使用這項功能，請按照下列步驟操作：

  1. 建立標記鍵，並命名為 environment。
  2. 為您使用的環境類別建立標記值。支援下列值，並對應至控制台專案挑選器中的相應徽章：
    • Prod：Prod、prod、Production、production
    • 開發人員：Dev、dev、Development、development
    • 測試：Test、test、Testing、testing、QA、qa、Quality assurance、quality assurance
    • 測試：Staging、staging、Stage、stage
  3. 建立標記繫結，將適當的標記附加至專案。

如果專案有多個環境標記 (例如一個繼承自資料夾，另一個直接位於專案)，系統會使用最明確的標記來決定徽章。

使用服務帳戶建立專案

您可以使用服務帳戶自動建立專案。與使用者帳戶一樣，服務帳戶也可以獲得在組織資源中建立專案的權限。服務帳戶不得在組織資源外建立專案，且建立專案時必須指定上層資源。服務帳戶可以使用 gcloud CLI 或 projects.create() 方法建立新專案。

管理專案配額

任何使用者或服務帳戶能建立的專案數量是有限的。如果您在組織資源外建立專案，系統會使用使用者帳戶的配額。如果您在組織資源中建立專案，系統會檢查使用者帳戶和組織資源的配額。只要其中一個配額未用盡，就能建立專案。

如果配額中剩餘的專案數量少於 30 個，「New Project」(新增專案) 頁面會顯示通知，指出配額中剩餘的專案數量。達到專案數量上限後，如要建立更多專案，必須要求提高專案數量上限。或者，您也可以在「Manage Resources」(管理資源) 頁面中，安排在 30 天後刪除某些專案。使用者虛刪除的專案會計入配額。30 天後，系統就會徹底刪除這些專案。

如要為組織配額中的專案申請額外容量，請按照下列步驟操作：

  1. 前往「配額與系統限制」頁面。

    前往「Quotas & System Limits」(配額與系統限制) 頁面

  2. 在資源選取器中，選取要提高專案配額的組織。

  3. 在「Filter」(篩選器) 選項中，選取「Metric」(指標) 並輸入 cloudresourcemanager.googleapis.com/projects_count。

  4. 選取「Cloud Resource Manager API」，按一下 「More actions」(更多動作)，然後選取 「Edit quota」(編輯配額)。

  5. 在「Quota changes」(配額變更) 對話方塊中，輸入新的配額值和說明，然後按一下「Next」(下一步)。

  6. 輸入聯絡資料，然後按一下「提交要求」。

我們會發送電子郵件通知，確認已收到您的要求。如需進一步協助，請回覆該電子郵件。審查完畢後，我們會傳送電子郵件，通知您要求是否獲准。

如果您沒有組織，且想為配額中的專案要求額外容量，請使用要求提高專案配額表單。

後續步驟