建立專案,在機構內將資源分組,為資源提供生命週期和政策界線。
事前準備
如要取得建立專案所需的權限,請要求機構 IAM 管理員授予您專案建立者角色 (project-creator
)。
以下是專案的識別資訊:
專案名稱:專案的可理解文字名稱。
專案名稱不會用於任何 GDC API。您可以在建立專案期間或之後隨時編輯專案名稱。專案名稱不必是專屬名稱。
專案名稱必須符合下列規定:
- 長度介於 4 到 30 個半形字元。
- 包含小寫英文字母、數字、半形句號或連字號。
專案 ID:專案的全域專屬 ID。
專案 ID 是用來區別專案與 GDC 中所有其他專案的專屬字串。您只能在建立專案時修改專案 ID。
專案 ID 必須符合下列規定:
- 長度介於 6 到 30 個半形字元。
- 包含小寫英文字母、數字和連字號。
- 以英文字母開頭。
- 開頭不得為
g-
前置字元,例如g-project
。 - 結尾不得為連字號。
- 結尾不得為
-cluster
或-system
字串。-system
後置字串保留給 GDC 建立的專案。 - 不得正在使用或曾使用過,包括已刪除的專案。
專案編號:系統自動為專案產生的專屬 ID。
請勿在專案名稱、專案 ID 或其他資源名稱中加入機密資訊。許多其他 GDC 資源的名稱都會使用專案 ID,任何對專案或相關資源的參照都會公開專案 ID 和資源名稱。
建立新專案
您可以建立專案,以提供服務資源的邏輯分組。舉例來說,您可以建立不同的專案,分別存放開發、測試和正式環境的資源。
如要取得建立專案所需的權限,請要求機構 IAM 管理員授予您專案建立者角色。如要進一步瞭解如何授予權限,請參閱「授予及撤銷存取權」。
控制台
如要使用 GDC 控制台建立新專案,請完成下列步驟:
- 按一下導覽選單中的「專案」。
- 按一下 [Add project] (新增專案)。
- 在「專案名稱」欄位中輸入專案名稱。
- 點選「下一步」。
選取要附加至專案的現有叢集,按一下 [Next] (下一步)。
選用:設定專案的網路功能。清除「Enable data exfiltration protection」(啟用資料外洩防護) 核取方塊,即可停用所有傳送至貴機構內其他專案的出站流量。
點選「下一步」。
在「Review」(查看) 部分,查看摘要並點選「Create」(建立)。
如要確認新專案是否可用,控制台會顯示訊息:
Project PROJECT_NAME successfully created
。
gdcloud
如要使用 gdcloud CLI 建立新專案,請完成下列步驟:
確認已安裝 gdcloud CLI。詳情請參閱 gcloud CLI 總覽頁面。
如要建立專案,請執行下列指令:
gdcloud projects create --name PROJECT_ID
將
PROJECT_ID
替換為新專案的專屬 ID。如要確認新專案是否可用,請執行下列指令:
gdcloud projects list
API
如要直接使用 API 建立新專案,請將自訂資源套用至 GDC 執行個體:
如要使用 kubectl
CLI 建立新專案,請完成下列步驟:
建立及套用
Project
自訂資源:kubectl apply -f - <<EOF apiVersion: resourcemanager.gdc.goog/v1 kind: Project metadata: namespace: platform name: PROJECT_NAME EOF
將
PROJECT_NAME
替換為您的專案名稱。確認新專案是否可用:
kubectl get namespaces