複数のリポジトリからの同期
このチュートリアルでは、新しい Google Kubernetes Engine(GKE)クラスタを作成し、Config Sync を使用して Anthos Config Management サンプル リポジトリの構成ファイルと同期します。
たとえば、コンプライアンス チームは、組織内の全員が内部ルールに従うようにすることが任務であるとします。その内部ルールを適用するために、コンプライアンス チームでは、構成ファイルを作成して、サンプル リポジトリに追加しました。組織内の各クラスタは、そのリポジトリと同期する必要があり、お客様がクラスタの作成と同期を担当しているとします。
始める前に
-
Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads. Google Cloud Console の [プロジェクト セレクタ] ページで、Google Cloud プロジェクトを選択または作成します。
Google Cloud Console の [プロジェクト セレクタ] ページで、Google Cloud プロジェクトを選択または作成します。
環境を準備する
以降のセクションでは、Config Sync で使用できるクラスタを作成して構成します。
クラスタの作成
Config Sync で使用できるクラスタを作成するには、次の手順を行います。
Google Cloud Console で、Google Kubernetes Engine のページに移動します。
GKE を初めて使用する場合は、[有効にする] をクリックして Kubernetes Engine API を有効にします。
[add_box作成] をクリックします。
[Standard] セクションで [構成] をクリックします。
[クラスタの基本] セクションで、[名前] フィールドに
cs-cluster
を追加します。他のフィールドはすべてデフォルト値のままにします。左側のメニューで、[クラスタ] の下にある [セキュリティ] を選択します。
[セキュリティ] ページで、[Workload Identity を有効にする] チェックボックスをオンにします。他のフィールドはすべてデフォルト値のままにします。
[作成] をクリックします。クラスタの作成には、数分かかる場合があります。
自身に管理者権限を付与する
クラスタを作成したら、自身に GKE Hub 管理者を付与します。
Google Cloud コンソールの [IAM] ページに移動します。
[追加] をクリックします。
[新しいプリンシパル] フィールドに、Google Cloud への登録に使用したメールアドレスを入力します。
[ロールを選択] プルダウン リストで、[GKE Hub 管理者] を検索して選択します。
[保存] をクリックします。
Anthos Config Management を有効にする
Anthos Config Management を有効にするには、次の手順を行います。
Google Cloud コンソールで、[構成管理] ページに移動します。
[CONFIG MANAGEMENT を設定] をクリックします。
Config Management API を有効にするには、[次へ] をクリックします。[次へ] をクリックすると、[構成管理の登録済みクラスタを選択する] ページが表示され、クラスタを登録できます。
クラスタの登録
クラスタの作成後に、クラスタをフリートに登録します。
- [構成管理の登録済みクラスタを選択する] ページで、[このプロジェクトの未登録のクラスタ] テーブルを探し、
cs-cluster
を見つけます。 [
cs-cluster
] の横にある [登録] をクリックします。クラスタが正常に登録されると、[構成管理の登録済みクラスタを選択する] テーブルに表示されます。
クラスタを構成する
クラスタが作成されたので、Anthos Config Management サンプル リポジトリの config-sync-quickstart
ディレクトリの構成ファイルと同期するように Config Sync を構成できます。
Google Cloud Console で Config Sync を構成するには、次の手順を行います。
- [構成管理の登録済みクラスタを選択する] テーブルで、
cs-cluster
を選択し、[次へ] をクリックします。 - 表示された [Config Sync] ページで、Anthos Config Management バージョン 1.7.0 以降を選択します。このバージョンは、デフォルトで複数のリポジトリからの同期を有効にします。
- [Config Sync を有効にする] のチェックボックスをオンのままにします。
- [URL] フィールドに
https://github.com/GoogleCloudPlatform/anthos-config-management-samples
を追加します。 - [認証タイプ] プルダウン リストで、[なし] を選択します。
- [ブランチ] フィールドに
main
を追加します。 - デフォルト値の
HEAD
を使用しているため、[タグ / commit] フィールドは空白のままにします。 - [構成ディレクトリ] フィールドに、
config-sync-quickstart/multirepo/root
を追加します。 - デフォルト値の 15 秒と
HTTPS
をそれぞれ使用するため、[同期の待機時間] と [Git プロキシ] は空白のままにします。 - [ソース形式] プルダウン リストで、[非構造化] を選択します。非構造化形式を使用することをおすすめします。この形式では、自分が一番使いやすい方法で構成ファイルを整理できます。
- [次へ] をクリックします。
[Policy Controller を有効にする] チェックボックスをオフにして、[完了] をクリックします。
[構成管理] メニューに戻ります。数分後、[Config Sync のステータス] 列の
cs-cluster
の横に同期済みと表示されます。
以上で Config Sync がリポジトリと同期し、常にクラスタの状態をリポジトリの構成ファイルに一致させるようになります。
Config Sync のインストールを調べてテストする
以降のセクションでは、Cloud Shell を使用して Config Sync のインストールを確認して、マネージド オブジェクトの変更を試みます。
Cloud Shell を開く
Cloud Shell を起動するには、以下に記載するコマンドを実行します。
Google Cloud Console に移動します。
コンソールの右上隅にある [Cloud Shell をアクティブにする] ボタン をクリックします。
コンソールの下部にあるフレーム内で Cloud Shell セッションが開きます。このシェルを使用して、
gcloud
、nomos
、kubectl
の各コマンドを実行します。続くセクションでコマンドを使用するには、次のコマンドを実行して
kubectl
コマンドライン アクセス権を構成します。gcloud container clusters get-credentials cs-cluster \ --zone ZONE \ --project PROJECT_ID
次のように置き換えます。
ZONE
: クラスタを作成したゾーンPROJECT_ID
: プロジェクト ID
予想される出力:
Fetching cluster endpoint and auth data. kubeconfig entry generated for cs-cluster.
クラスタとリポジトリを調べる
config-sync-quickstart
ディレクトリには、ClusterRole、CustomResourceDefinition、モニタリング用 Prometheus Operator の構成、Rolebinding、Namespace、RepoSync があります。リポジトリから読み取るように Config Sync が構成されるとすぐに、これらの構成ファイルが適用されます。
Config Sync で管理されるオブジェクトの app.kubernetes.io/managed-by
ラベルは configmanagement.gke.io
に設定されています。
Config Sync が管理する Namespace を一覧表示するには、次のコマンドを実行します。
kubectl get ns -l app.kubernetes.io/managed-by=configmanagement.gke.io
予想される出力:
NAME STATUS AGE
gamestore Active 58s
monitoring Active 58s
これらの Namespace が作成される元となった構成ファイルは、GitHub の Anthos Config Management リポジトリの /config-sync-quickstart/multirepo/ フォルダに移動して確認できます。
ClusterRole、Reposync、CRD、Rolebindings などの他のオブジェクトも同様の方法で確認できます。
マネージド オブジェクトを手動で変更しようとした場合
Config Sync は、アドミッション Webhook による管理対象オブジェクトのミューテーションを回避します。
Config Sync が管理する Kubernetes オブジェクトを手動で変更して競合する変更を行おうとすると、エラーが発生します。
この動作をテストするには、gamestore
名前空間を削除してみます。
kubectl delete namespace gamestore
予想される出力:
error: admission webhook "v1.admission-webhook.configsync.gke.io" denied the request: requester is not authorized to delete managed resources
クリーンアップ
Config Sync の構成ファイルの変更のチュートリアルを行う場合は、まだクリーンアップしないでください。このクイックスタートは、そのチュートリアルの前提条件になります。また、クリーンアップの手順は、そちらにも記載されています。
チュートリアルを行わない場合は、ここで使用したクラスタを削除してクリーンアップします。
Google Cloud コンソールの GKE メニューに移動します。
cs-cluster
の横にある [操作](more_vert) をクリックし、[削除](delete)をクリックします。確認するメッセージが表示されたら、もう一度 [削除] をクリックします。
次のステップ
- 構成ファイルの変更、テスト、同期に関するチュートリアルに取り組む。
- 構成ファイルについて詳細を確認する。
- 構成ファイルの検証について詳細を確認する。