バックアップ ストレージ

• scheme : gcsまたはgs

• host : bucket name

• parameters :

  • credentials-file : 移行ツール ノードの資格情報 JSON ファイルへのパスを指定します。
  • storage-class : アップロードされたオブジェクトのstorageクラスを指定します (たとえば、 STANDARDまたはCOLDLINE )
  • predefined-acl : アップロードされたオブジェクトの事前定義された ACL を指定します (たとえば、 privateまたはproject-private )

• scheme : azureまたはazblob

• host : container name

• parameters :

  • account-name :storageのアカウント名を指定します。
  • account-key : アクセスキーを指定します。
  • access-tier : アップロードされたオブジェクトのアクセス層を指定します (例: Hot 、 Cool 、またはArchive )。デフォルトの値はHotです。

スナップショット データを GCS にバックアップする

./br backup full --pd "${PD_IP}:2379" \
--storage "gcs://external/backup-20220915?credentials-file=${credentials-file-path}"

GCS からスナップショット データを復元する

./br restore full --pd "${PD_IP}:2379" \
--storage "gcs://external/backup-20220915?credentials-file=${credentials-file-path}"

スナップショット データを Azure Blob Storage にバックアップする

./br backup full -u "${PD_IP}:2379" \
--storage "azure://external/backup-20220915?account-name=${account-name}&account-key=${account-key}"

Azure Blob Storage のスナップショット バックアップ データからtestデータベースを復元する

./br restore db --db test -u "${PD_IP}:2379" \
--storage "azure://external/backup-20220915account-name=${account-name}&account-key=${account-key}"

アクセス キーを指定することで、GCS へのアクセスに使用するアカウントを構成できます。 credentials-fileパラメータを指定すると、指定されたcredentials-fileを使用して認証が実行されます。 URL でキーを指定する以外に、次の方法もサポートされています。

• BR は、環境変数$GOOGLE_APPLICATION_CREDENTIALSで指定されたパスにあるファイルを読み取ります
• BR はファイルを読み取ります~/.config/gcloud/application_default_credentials.json 。
• クラスターが GCE または GAE で実行されている場合、 BR はメタデータサーバーから資格情報を取得します。

• 方法 1: アクセス キーを指定する

  URL にaccount-nameとaccount-keyを指定すると、指定したアクセス キーとシークレット アクセス キーを使用して認証が行われます。 URL でキーを指定する方法の他に、 BR は環境変数$AZURE_STORAGE_KEYからキーを読み取ることもできます。

• 方法 2: バックアップと復元に Azure AD を使用する

  BRが実行されているノードで、環境変数$AZURE_CLIENT_ID 、 $AZURE_TENANT_ID 、および$AZURE_CLIENT_SECRETを構成します。

  • TiUPを使用してクラスターを起動すると、TiKV は systemd サービスを使用します。次の例は、TiKV 用に前述の 3 つの環境変数を構成する方法を示しています。

    ノート：

    この方法を使用する場合は、手順 3 で TiKV を再起動する必要があります。クラスターを再起動できない場合は、方法 1: バックアップと復元用のアクセス キーを指定します。

    1. このノードの TiKV ポートが24000 、つまり systemd サービスの名前がtikv-24000であるとします。

       systemctl edit tikv-24000
       

    2. TiKV 構成ファイルを編集して、3 つの環境変数を構成します。

       [Service]
       Environment="AZURE_CLIENT_ID=aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa"
       Environment="AZURE_TENANT_ID=aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa"
       Environment="AZURE_CLIENT_SECRET=aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
       

    3. 構成をリロードし、TiKV を再起動します。

       systemctl daemon-reload
       systemctl restart tikv-24000
       

  • コマンド ラインで開始された TiKV およびBRの Azure AD 情報を構成するには、次のコマンドを実行して、環境変数$AZURE_CLIENT_ID 、 $AZURE_TENANT_ID 、および$AZURE_CLIENT_SECRETが動作環境で構成されているかどうかを確認するだけで済みます。

    echo $AZURE_CLIENT_ID
    echo $AZURE_TENANT_ID
    echo $AZURE_CLIENT_SECRET
    

  • BRを使用してデータを Azure Blob Storage にバックアップします。

    ./br backup full -u "${PD_IP}:2379" \
    --storage "azure://external/backup-20220915?account-name=${account-name}"