バックアップストレージ

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

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

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

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

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

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

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

tiup 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とsas-token指定すると、指定されたアカウント名と共有アクセス署名 (SAS) トークンを使用して認証が実行されます。SAS トークンには&文字が含まれていることに注意してください。これを URI に追加する前に%26としてエンコードする必要があります。パーセントエンコードを使用してsas-token全体を直接エンコードすることもできます。

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

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

• 方法 3: バックアップと復元に 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 にバックアップします。

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