このページでは、Google Distributed Cloud(GDC)のエアギャップ環境で仮想マシン(VM)のバックアップ リポジトリを作成する方法について説明します。
バックアップまたはスナップショットを作成する前に、複数のバックアップまたはスナップショット間で共有できるバックアップ リポジトリを 1 つ以上定義する必要があります。バックアップ リポジトリは、バックアップの保存場所または取得場所をバックアップ システムに指示します。VM のバックアップ リポジトリは Management API サーバーに制限されています。
始める前に
バックアップ リポジトリを作成する前に、基盤となるストレージをプロビジョニングし、必要な権限を構成する必要があります。
- オブジェクト ストレージ バケットと S3 互換のエンドポイント。
- バケットへのアクセス権が付与されたサービス アカウントと、その S3 認証情報。
必要な IAM ロール:
- 組織のバックアップ管理者: ユーザー クラスタのバックアップ プランや復元プランなどのバックアップ リソースを管理します。
- Secret 閲覧者: プロジェクト内の Kubernetes Secret を表示します。
組織の IAM 管理者に、組織のバックアップ管理者(
organization-backup-admin)ロールとシークレット閲覧者(secret-viewer)ロールを付与するよう依頼します。詳細については、ロールの定義をご覧ください。
バックアップ リポジトリを作成する
GDC コンソールまたは API を使用してリポジトリを作成します。
コンソール
- GDC コンソールにログインします。
- ナビゲーション メニューで、[Backup for Virtual Machines] > [リポジトリ] をクリックします。
- [リポジトリを作成] をクリックします。
- リポジトリ名と説明(省略可)を入力します。
[S3 URI エンドポイント] フィールドに、オブジェクト ストレージ サイトの完全修飾ドメイン名を含むエンドポイント(
https://objectstorage.ORG.ZONE.DOMAIN.SUFFIX:PORTなど)を入力します。例:https://objectstorage.org-1.zone1.google.gdch.test。Bucketカスタム リソースから値を取得するには、次のコマンドを実行します。kubectl get Bucket BUCKET_NAME -n NAMESPACE -o json | jq -r '.status.endpoint'[バケット名] フィールドに、バケットの完全修飾ドメイン名を入力します。この名前は、GDC コンソールの [バケットの詳細] ページで確認できます。また、
Bucketカスタム リソースから値を取得するには、次のコマンドを実行します。kubectl get Bucket BUCKET_NAME -n NAMESPACE -o json | jq -r '.status.fullyQualifiedName'[バケット リージョン] フィールドに、バケットが作成されたリージョンを入力します。バケット カスタム リソースから値を取得するには、次のコマンドを実行します。
kubectl get Bucket BUCKET_NAME -n NAMESPACE -o json | jq -r '.status.region'[アクセスキー ID] フィールドと [アクセスキー] フィールドに、アクセスキー ID とシークレット アクセスキーを入力します。これらの認証情報の取得の詳細については、ストレージ バケットへのアクセス権を付与して取得するをご覧ください。
[作成] をクリックします。
API
S3 認証情報を使用して BackupRepository カスタム リソースを作成します。
S3 認証情報を含む Secret の名前を取得します。
export PROJECT_NAME=PROJECT_NAME export SA_NAME=SA_NAME kubectl get secrets --namespace $PROJECT_NAME -o json | jq -r --arg USER_NAME "${SA_NAME:?}" '.items[] | select( (.metadata.annotations."object.gdc.goog/subject"==$USER_NAME)) | .metadata.name'コマンドから返されたシークレット名を記録し、次のステップで
SECRET_NAMEとして使用してください。次のように置き換えます。
PROJECT_NAME: プロジェクトの名前。SA_NAME: オブジェクト ストレージへのアクセスに使用されるサービス アカウントの名前。
FQDN やエンドポイントなどのバケットの詳細を取得するには、出力から
fullyQualifiedName値とzonalEndpoints値を抽出します。kubectl get buckets -n PROJECT_NAME BUCKET_NAME -o yamlManagement API サーバー内に
BackupRepositoryを作成します。apiVersion: backup.gdc.goog/v1 kind: BackupRepository metadata: name: REPOSITORY_NAME spec: secretReference: namespace: PROJECT_NAME name: SECRET_NAME endpoint: ENDPOINT type: "S3" s3Options: bucket: BUCKET_FQDN region: REGION forcePathStyle: FORCE_PATH_STYLE importPolicy: IMPORT_POLICY次のように置き換えます。
REPOSITORY_NAME: バックアップ リポジトリの名前。PROJECT_NAME: プロジェクトの名前。SA_NAME: オブジェクト ストレージへのアクセスに使用されるサービス アカウントの名前。SECRET_NAME:kubectl get secretsコマンドから返された Secret の名前。ENDPOINT: ストレージ システムの完全修飾ドメイン名(例:https://objectstorage.google.gdch.test)。typeフィールドでは、S3の値のみがサポートされています。BUCKET_FQDN: バケットの完全修飾名。REGION: バケットが作成されたリージョン。FORCE_PATH_STYLE:forcePathStyleフィールドを使用して、オブジェクトのパス スタイル URL を強制的に適用します。このフィールドの値はtrueまたはfalseにする必要があります。IMPORT_POLICY: 次のいずれかに設定します。ReadWrite: このリポジトリは、バックアップ、バックアップ プラン、復元のスケジュール設定や作成に使用できます。ReadOnly: このリポジトリは、バックアップのインポートと表示にのみ使用できます。このリポジトリでは新しいバックアップやリソースを作成できませんが、復元では読み取り専用バックアップを使用して参照できます。バックアップ リポジトリを ReadOnly として使用できる頻度に制限はありません。
BackupRepositoryは、同じ名前の読み取り / 書き込みが有効なBackupRepositoryリソースを Management API サーバーに作成します。