From 4636869d6d31c1b8806ddb9aaed0e2c16d48cc34 Mon Sep 17 00:00:00 2001 From: takaidohigasi Date: Thu, 24 Jul 2025 07:11:44 +0900 Subject: [PATCH 1/6] [pingcap/tidb#46609] support s3 profile for dumpling --- dumpling-overview.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/dumpling-overview.md b/dumpling-overview.md index ce71524570c1a..32cf679d820b7 100644 --- a/dumpling-overview.md +++ b/dumpling-overview.md @@ -233,7 +233,7 @@ export AWS_ACCESS_KEY_ID=${AccessKey} export AWS_SECRET_ACCESS_KEY=${SecretKey} ``` -Dumpling also supports reading credential files from `~/.aws/credentials`. For more information about URI parameter descriptions, see [URI Formats of External Storage Services](/external-storage-uri.md). +Dumpling also supports reading credential files from `~/.aws/credentials`, and profile option. For more information about URI parameter descriptions, see [URI Formats of External Storage Services](/external-storage-uri.md). ```shell tiup dumpling -u root -P 4000 -h 127.0.0.1 -r 200000 -o "s3://${Bucket}/${Folder}" From 075514a715604030de8800a9032215222fd4317e Mon Sep 17 00:00:00 2001 From: takaidohigasi Date: Thu, 24 Jul 2025 07:16:38 +0900 Subject: [PATCH 2/6] Update dumpling-overview.md Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com> --- dumpling-overview.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/dumpling-overview.md b/dumpling-overview.md index 32cf679d820b7..aa7cbd4b6f602 100644 --- a/dumpling-overview.md +++ b/dumpling-overview.md @@ -233,7 +233,7 @@ export AWS_ACCESS_KEY_ID=${AccessKey} export AWS_SECRET_ACCESS_KEY=${SecretKey} ``` -Dumpling also supports reading credential files from `~/.aws/credentials`, and profile option. For more information about URI parameter descriptions, see [URI Formats of External Storage Services](/external-storage-uri.md). +Dumpling also supports reading credential files from `~/.aws/credentials` and using AWS profiles. For more information about URI parameter descriptions, see [URI Formats of External Storage Services](/external-storage-uri.md). ```shell tiup dumpling -u root -P 4000 -h 127.0.0.1 -r 200000 -o "s3://${Bucket}/${Folder}" From 4b35d6b305b44d21c3a1ae64ecca9a1c2b8e8309 Mon Sep 17 00:00:00 2001 From: takaidohigasi Date: Fri, 22 Aug 2025 08:01:13 +0900 Subject: [PATCH 3/6] Update dumpling-overview.md Co-authored-by: Grace Cai --- dumpling-overview.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/dumpling-overview.md b/dumpling-overview.md index aa7cbd4b6f602..676445548db70 100644 --- a/dumpling-overview.md +++ b/dumpling-overview.md @@ -233,7 +233,7 @@ export AWS_ACCESS_KEY_ID=${AccessKey} export AWS_SECRET_ACCESS_KEY=${SecretKey} ``` -Dumpling also supports reading credential files from `~/.aws/credentials` and using AWS profiles. For more information about URI parameter descriptions, see [URI Formats of External Storage Services](/external-storage-uri.md). +Dumpling also supports reading credential files from `~/.aws/credentials` and authenticating with AWS profiles. For more information about URI parameter descriptions, see [URI Formats of External Storage Services](/external-storage-uri.md). ```shell tiup dumpling -u root -P 4000 -h 127.0.0.1 -r 200000 -o "s3://${Bucket}/${Folder}" From 231993176fb9f7606aa5e250b9bf1ea82a23dd25 Mon Sep 17 00:00:00 2001 From: takaidohigasi Date: Fri, 22 Aug 2025 08:37:20 +0900 Subject: [PATCH 4/6] add example usage for profile and default config --- dumpling-overview.md | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/dumpling-overview.md b/dumpling-overview.md index 32cf679d820b7..aeb1b4ddd8ab4 100644 --- a/dumpling-overview.md +++ b/dumpling-overview.md @@ -235,7 +235,16 @@ export AWS_SECRET_ACCESS_KEY=${SecretKey} Dumpling also supports reading credential files from `~/.aws/credentials`, and profile option. For more information about URI parameter descriptions, see [URI Formats of External Storage Services](/external-storage-uri.md). +To use the default credentials: + +```shell +tiup dumpling -u root -P 4000 -h 127.0.0.1 -r 200000 -o "s3://${Bucket}/${Folder}" +``` + +To use a specific AWS profile: + ```shell +export AWS_PROFILE=my-profile tiup dumpling -u root -P 4000 -h 127.0.0.1 -r 200000 -o "s3://${Bucket}/${Folder}" ``` From 511f7cfc37869120f964633fdf78c41cc85ee385 Mon Sep 17 00:00:00 2001 From: takaidohigasi Date: Fri, 22 Aug 2025 08:47:25 +0900 Subject: [PATCH 5/6] docs: clarify that dumpling reads AWS credentials from ~/.aws/credentials MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Update the example to explicitly mention that default credentials are read from ~/.aws/credentials 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude --- dumpling-overview.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/dumpling-overview.md b/dumpling-overview.md index 9242513dbe112..deb7cffc9ec92 100644 --- a/dumpling-overview.md +++ b/dumpling-overview.md @@ -235,7 +235,7 @@ export AWS_SECRET_ACCESS_KEY=${SecretKey} Dumpling also supports reading credential files from `~/.aws/credentials` and authenticating with AWS profiles. For more information about URI parameter descriptions, see [URI Formats of External Storage Services](/external-storage-uri.md). -To use the default credentials: +To use the default credentials from `~/.aws/credentials`: ```shell tiup dumpling -u root -P 4000 -h 127.0.0.1 -r 200000 -o "s3://${Bucket}/${Folder}" From 870cc2c5e145221d8d552a81ced42b116374cf1d Mon Sep 17 00:00:00 2001 From: takaidohigasi Date: Tue, 26 Aug 2025 11:50:29 +0900 Subject: [PATCH 6/6] fix s3 option example --- dumpling-overview.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/dumpling-overview.md b/dumpling-overview.md index deb7cffc9ec92..883b464d1fdb7 100644 --- a/dumpling-overview.md +++ b/dumpling-overview.md @@ -244,8 +244,7 @@ tiup dumpling -u root -P 4000 -h 127.0.0.1 -r 200000 -o "s3://${Bucket}/${Folder To use a specific AWS profile: ```shell -export AWS_PROFILE=my-profile -tiup dumpling -u root -P 4000 -h 127.0.0.1 -r 200000 -o "s3://${Bucket}/${Folder}" +tiup dumpling -u root -P 4000 -h 127.0.0.1 -r 200000 -o "s3://${Bucket}/${Folder}" --s3.profile=my.profile ``` ### Filter the exported data