バックアップ リポジトリを作成する

このページでは、Google Distributed Cloud(GDC)のエアギャップ環境で仮想マシン(VM)のバックアップ リポジトリを作成する方法について説明します。

バックアップまたはスナップショットを作成する前に、複数のバックアップまたはスナップショット間で共有できるバックアップ リポジトリを 1 つ以上定義する必要があります。バックアップ リポジトリは、バックアップの保存場所または取得場所をバックアップ システムに指示します。VM のバックアップ リポジトリは Management API サーバーに制限されています。

始める前に

バックアップ リポジトリを作成する前に、基盤となるストレージをプロビジョニングし、必要な権限を構成する必要があります。

バックアップ リポジトリを作成する

GDC コンソールまたは API を使用してリポジトリを作成します。

コンソール

  1. GDC コンソールにログインします。
  2. ナビゲーション メニューで、[Backup for Virtual Machines] > [リポジトリ] をクリックします。
  3. [リポジトリを作成] をクリックします。
  4. リポジトリ名と説明(省略可)を入力します。
  5. [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'
    
  6. [バケット名] フィールドに、バケットの完全修飾ドメイン名を入力します。この名前は、GDC コンソールの [バケットの詳細] ページで確認できます。また、Bucket カスタム リソースから値を取得するには、次のコマンドを実行します。

    kubectl get Bucket BUCKET_NAME -n NAMESPACE -o json | jq -r '.status.fullyQualifiedName'
    
  7. [バケット リージョン] フィールドに、バケットが作成されたリージョンを入力します。バケット カスタム リソースから値を取得するには、次のコマンドを実行します。

    kubectl get Bucket BUCKET_NAME -n NAMESPACE -o json | jq -r '.status.region'
    
  8. [アクセスキー ID] フィールドと [アクセスキー] フィールドに、アクセスキー ID とシークレット アクセスキーを入力します。これらの認証情報の取得の詳細については、ストレージ バケットへのアクセス権を付与して取得するをご覧ください。

  9. [作成] をクリックします。

API

S3 認証情報を使用して BackupRepository カスタム リソースを作成します。

  1. 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: オブジェクト ストレージへのアクセスに使用されるサービス アカウントの名前。
  2. FQDN やエンドポイントなどのバケットの詳細を取得するには、出力から fullyQualifiedName 値と zonalEndpoints 値を抽出します。

    kubectl get buckets -n PROJECT_NAME BUCKET_NAME -o yaml
    
  3. Management 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 サーバーに作成します。

次のステップ