バックアップストレージ

• 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を使用して実行されます。 URI でキーを指定する以外に、次のメソッドもサポートされています。

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

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

  URIにaccount-nameとaccount-keyを指定した場合は、指定したアクセスキーとシークレットアクセスキーを使用して認証が行われます。 BR は、URI でキーを指定する方法以外に、環境変数$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}"