Google Distributed Cloud（GDC）エアギャップ アプライアンス プロジェクトは、API の管理、共同編集者の追加と削除、GDC リソースに対する権限の管理など、すべての GDC サービスの作成、有効化、使用の基礎となります。
このページでは、GDC コンソール、gdcloud CLI、kubectl CLI を使用して GDC プロジェクトを管理する方法について説明します。
始める前に
プロジェクトとそのリソースを表示または管理する前に、必要な権限をリクエストして環境を準備する必要があります。
IAM ロールをリクエストする
組織の IAM 管理者に連絡して、実行する必要があるタスクに基づいて次のロールをリクエストします。
- プロジェクト編集者（
project-editor）: 既存のプロジェクトとそのリソースを更新、表示、削除します。 - プロジェクト閲覧者（
project-viewer）: 既存のプロジェクトとそのリソースを表示します。
環境を準備する
コンポーネントをインストールするの説明に沿って、
kubectlCLI をインストールします。kubeconfig ファイルを生成して、
kubectlアクセスを構成します。
プロジェクトの詳細を表示
プロジェクトのメタデータを表示して、ラベルやネットワーク設定などの現在の構成を確認できます。
コンソール
ナビゲーション メニューを開き、[プロジェクト] を選択します。
詳細を表示するプロジェクトをクリックします。
gdcloud
特定のプロジェクトのメタデータを一覧表示するには、次のコマンドを実行します。
gdcloud projects describe PROJECT_ID
PROJECT_ID は、プロジェクトの固有識別子に置き換えます。
プロジェクト リソースを確認する
プロジェクト リソースをチェックして、組織内のリソースのセグメンテーションをモニタリングできます。プロジェクトごとに定義してプロジェクト間の境界を提供するユーザーとグループのアクセス ポリシーを確認することもできます。
プロジェクト内のロール バインディングを一覧表示する
プロジェクトのロール バインディングを一覧表示するには、次のコマンドを実行します。
kubectl get rolebindings -n PROJECT_NAMESPACE
ロール バインディングの詳細については、リソースへのアクセス権を付与するをご覧ください。
プロジェクトまたは組織を選択する
GDC コンソールでは、プロジェクト ピッカーを使用してプロジェクトまたは組織を選択し、その親リソースにネストされているサービス リソースを操作できます。たとえば、仮想マシン（VM）はプロジェクト スコープです。
プロジェクト選択ツールは、子リソースのコンテキストが変更されると、最新の親リソース タイプ間で自動的に切り替わります。たとえば、プロジェクト選択ツールで組織が選択されているときにプロジェクト スコープのリソースにアクセスすると、最後に使用したプロジェクトが自動的に選択され、リソース スコープがシームレスに変更されます。同様に、組織を対象にしたリソースにアクセスすると、組織が自動的に選択されます。
親リソースにネストされている GDC リソースを操作するには、まず作業する組織またはプロジェクトを選択する必要があります。
ダッシュボードで、プロジェクト選択ツールのプルダウンをクリックします。
表示された [プロジェクト] ウィンドウで、プロジェクトまたは組織を選択します。
[開く] をクリックします。
プロジェクトを更新する
プロジェクト名やデータ漏洩防止など、作成後に更新できるプロジェクトの構成のサブセットがあります。プロジェクトの使用状況に応じて、これらの構成を更新できます。
たとえば、次の手順でプロジェクトの名前を編集できます。
コンソール
ナビゲーション メニューを開き、[プロジェクト] を選択します。
編集するプロジェクトをクリックします。
[プロジェクトの表示名] フィールドの横にある [編集] 編集 をクリックします。
更新したプロジェクト名を指定して、[保存] をクリックします。
gdcloud
次のコマンドを実行します。
gdcloud projects update PROJECT_ID --name=PROJECT_NAME
次の変数を置き換えます。
PROJECT_ID: プロジェクトの固有識別子。PROJECT_NAME: プロジェクトの新しい名前。
--name パラメータは、編集可能な任意のプロジェクト フィールドに置き換えることができます。その他のオプションについては、gdcloud projects update --help を実行してください。
組織内のプロジェクトを表示する
管理者は、IAM ロールでアクセスが許可されているプロジェクトのみを表示および一覧表示できます。組織の IAM 管理者ロールは、組織内のすべてのプロジェクトを表示または一覧表示できます。
コンソール
組織内のすべてのプロジェクトを表示するには、コンソールのナビゲーション メニューに移動して、[プロジェクト] を選択します。
gdcloud
組織内でアクセスできるすべてのプロジェクトを表示するには、次のコマンドを実行します。
gdcloud projects list
アクセス権のないプロジェクトを一覧表示することはできません。