バックアップストレージ

スナップショットデータを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へのアクセスに使用するアカウントは、アクセスキーを指定することで設定できます。1 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_CLIENT_SECRET $AZURE_TENANT_IDします。

  • 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_CLIENT_SECRET $AZURE_TENANT_IDされているかどうかを確認するだけです。

    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}"