このドキュメントでは、Google Distributed Cloud(GDC)エアギャップの Managed Harbor Service(MHS)の概要について説明します。
MHS は、オープンソースの Harbor プロジェクトをベースにしたフルマネージドの Container Registry です。MHS を GDC 環境に統合すると、手動メンテナンスなしで、隔離された環境でコンテナ アーティファクトのライフサイクルを管理するための安全でスケーラブルな方法が提供されます。
この概要では、GDC プロジェクトと Harbor インスタンス プロジェクトの関係など、GDC エアギャップで MHS を操作するために必要な基本的なコンセプトについて説明します。また、インフラストラクチャ レベルの Identity and Access Management(IAM)ロールとレジストリ レベルのロールベース アクセス制御(RBAC)の間の管理境界、自動ガベージ コレクションやサービス パフォーマンス制限などのコア機能についても詳しく説明します。
このドキュメントは、GDC で MHS を使用して管理するプラットフォーム管理者またはアプリケーション オペレーター グループのデベロッパーを対象としています。詳細については、GDC エアギャップの対象ユーザーのドキュメントをご覧ください。
GDC での Managed Harbor Service の仕組み
運用プレーン
GDC MHS は、ネットワーク アーキテクチャの 2 つの異なる機能レイヤで動作します。各レイヤで特定のオペレーションが有効になります。
- 管理プレーン レイヤ: Harbor レジストリ インスタンスを作成、削除できます。
- データプレーン レイヤ: Harbor インスタンスでコンテナ イメージを push および pull できます。
GDC プロジェクトと Harbor インスタンス プロジェクトの違い
Managed Harbor Service には、2 つの異なるプロジェクト タイプがあります。これらのエンティティ間の相互作用を理解することで、適切なレイヤでリソースとアクセス制御を管理できます。
GDC プロジェクト: インフラストラクチャ管理の組織部門。これを使用して、VM やクラスタなどの他の GDC リソースとともに Harbor レジストリ インスタンスを管理します。
- 制限: GDC プロジェクトに含めることができる Harbor インスタンスは 1 つのみです。ただし、この単一インスタンスを複数の GDC プロジェクト間で共有して、環境の一元化されたレジストリを提供できます。
- アクセス: インスタンスの作成、管理、管理タスクには、GDC プロジェクト レベルの IAM ロールが必要です。
Harbor インスタンス プロジェクト: Harbor インスタンス内に存在するアーティファクト管理の論理グループ。これを使用して、コンテナ イメージとリポジトリレベルのアクセスを整理します。
- 制限: Harbor インスタンスは複数の Harbor プロジェクトをサポートします。これらを個々のチームまたはユーザーに割り当てて、共有レジストリ内でマルチテナンシーを有効にできます。
- アクセス: リポジトリの管理、管理タスクの実行、プロジェクト内のアーティファクト アクセスの制御を行うには、レジストリ固有の RBAC ロールが必要です。
機能
Harbor は、Cloud Native Computing Foundation(CNCF)のクラウドネイティブな卒業したオープンソース プロジェクトで、Kubernetes と Docker に組み込みの Container Registry ソリューションを提供します。マネージド サービス統合を使用すると、Harbor インスタンスをデプロイして、GDC にアーティファクトを保存して管理できます。MHS には次の機能があります。
- Harbor インスタンスは、GDC によって自動的にプロビジョニングされ、管理されます。
- Harbor は認証のために IAM と統合されています。
- Harbor は、プロジェクト サービス アカウントを介したプログラマティック アクセスをサポートし、自動化されたワークロードを可能にします。
- Harbor インスタンスは、新しい安定版にアップグレードできます。
- Harbor は、GDC のコンプライアンスと品質の要件を満たすように強化されています。
- Harbor インスタンスはゾーンリソースです。1 つのゾーンにデプロイされますが、GDC デプロイ ユニバース内の任意のゾーンからアクセスできます。
MHS のロールベース アクセス制御
GDC は、Managed Harbor Service(MHS)のロールベース アクセス制御(RBAC)を、GDC プロジェクト レベルと Harbor レジストリ プロジェクト レベルの 2 つの異なるレイヤで適用します。
プロジェクト サービス アカウントは、IAM によって発行された有効期間の短い ID トークンを使用して、プログラムで認証を行います。これにより、Harbor ロボット アカウントを手動で作成して管理する必要がなくなります。サービス アカウントの IAM ロールは Harbor インスタンスとのやり取りを許可しますが、特定のデータ オペレーションを認可するには、対応する Harbor レジストリ プロジェクト ロールを割り当てる必要があります。
レジストリへのアクセスを制御するには、プラットフォーム レベルとリポジトリ レベルの両方で権限を構成します。
GDC プロジェクト アクセスの IAM ロール
GDC は、IAM ロールを使用してプロジェクト レベルの権限を管理します。これらのロールをユーザーとプロジェクト サービス アカウントの両方に割り当てて、Harbor インスタンスへのアクセスを制御できます。
- プラットフォーム管理者とユーザーの場合: 手順ドキュメントで特定のタスクに関連する必要なロールを特定し、IAM 組織管理者にアクセス権をリクエストします。詳細については、アクセス権の付与と取り消しをご覧ください。
- サービス アカウントの場合: プロジェクトのサービス アカウントに同じ IAM ロールを付与して、レジストリ インスタンス管理やアーティファクトのデプロイなどの自動化されたワークロードのプログラム認証を有効にします。
- インフラストラクチャ オペレーター向け: GDC MHS サービス マニュアルを参照して、特定の運用タスクに必要な IAM ロールを正確に判断します。
Harbor プロジェクト アクセスのレジストリロール
Harbor プロジェクトは、IAM ロールとは独立して動作する独自の RBAC メカニズムのセットを使用します。リポジトリとアーティファクトを管理するには、ユーザーとプロジェクト サービス アカウントの両方に、Harbor プロジェクト レベルで直接割り当てられた必要なロールが必要です。
Harbor の特定のロールと権限の詳細については、Harbor ドキュメントのユーザー アクセスの管理をご覧ください。
パフォーマンス
Google は、システムの上限で指定された上限をサポートするように MHS をテストして検証しています。
実際のパフォーマンスの上限は、これより高くなる可能性があります。
ガベージ コレクション
MHS を使用してレジストリからイメージを追加および削除すると、未使用のデータが時間の経過とともに蓄積される可能性があります。ストレージ リソースの負荷を軽減するため、MHS は 12 時間ごとにガベージ コレクションを自動的に実行します。ガベージ コレクションを手動で構成する必要はありません。
次のステップ
コンテナ イメージの管理を開始するようにワークスペースとプロジェクトを構成します。