プロジェクトを作成する

このページでは、環境内でリソースをグループ化するための Google Distributed Cloud（GDC）エアギャップ アプライアンス プロジェクトを作成する方法について説明します。プロジェクトは、リソースのライフサイクルとポリシーの境界を提供し、複数のユーザー グループが GDC リソースを個別に管理できるようにします。

このページは、環境内のリソースの管理を担当するプラットフォーム管理者グループ内の IT 管理者、セキュリティ エンジニア、ネットワーク管理者などを対象としています。

始める前に

プロジェクトの作成に必要な権限を取得するには、組織 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 とリソース名が公開されます。

新しいプロジェクトを作成

プロジェクトを作成して、サービス リソースを論理的にグループ化できます。たとえば、開発環境、テスト環境、本番環境のリソースを保持するために、個別のプロジェクトを作成できます。

プロジェクトの作成に必要な権限を取得するには、組織 IAM 管理者にプロジェクト作成者ロールの付与を依頼してください。権限の付与の詳細については、 アクセス権の付与と取り消しをご覧ください。

コンソール

GDC コンソールを使用して新しいプロジェクトを作成する手順は次のとおりです。

1. ナビゲーション メニューで [プロジェクト] をクリックします。
2. [プロジェクトを追加] をクリックします。
3. [プロジェクト名] フィールドにプロジェクト名を入力します。
4. [次へ] をクリックします。

5. プロジェクトに接続する既存のクラスタを選択します。[次へ] をクリックします。

   **重要:** クラスタは少なくとも 1 つのプロジェクトに接続する必要があります。

6. 省略可: プロジェクトのネットワーク機能を構成します。[データ漏洩保護を有効にする] チェックボックスをオフにして、組織内の他のプロジェクトへのすべての下り（外向き）トラフィックを無効にします。

7. [次へ] をクリックします。

8. [確認] セクションで概要を確認し、[作成] をクリックします。

9. 新しいプロジェクトが使用可能であることを確認するには、 コンソールに Project PROJECT_NAME successfully created というメッセージが表示されます。

gdcloud

gdcloud CLI を使用して新しいプロジェクトを作成する手順は次のとおりです。

1. gdcloud CLI がインストールされていることを確認します。詳細については、gdcloud CLI の概要 ページをご覧ください。

2. プロジェクトを作成するには:

   gdcloud projects create PROJECT_ID
   

   PROJECT_ID は、新しいプロジェクトの一意の識別子に置き換えます。

3. 新しいプロジェクトが使用可能であることを確認するには、次を実行します。

   gdcloud projects list
   

API

API を直接使用して新しいプロジェクトを作成するには、カスタム リソースを GDC インスタンスに適用します。

kubectl CLI を使用して新しいプロジェクトを作成する手順は次のとおりです。

1. Project カスタム リソースを作成して適用します。

   kubectl apply -f - <<EOF
   apiVersion: resourcemanager.gdc.goog/v1
   kind: Project
   metadata:
       namespace: platform
       name: PROJECT_NAME
   EOF
   

   PROJECT_NAME は、実際のプロジェクト名で置き換えます。

2. 新しいプロジェクトが使用可能であることを確認します。

   kubectl get namespaces