fix: use s3cmd replace aws cli

Author: u-u-z

.github/workflows/deploy.yml

@@ -38,53 +38,57 @@ jobs:
           git commit -m "Deploy $GITHUB_SHA to gh-pages"
           git push --force --set-upstream origin gh-pages
           
-      - name: Setup AWS CLI  
+      - name: Install and Configure s3cmd
         run: |
-          pip install awscli
-          mkdir -p ~/.aws
-          echo "[default]" > ~/.aws/credentials
-          echo "aws_access_key_id = ${{ secrets.S3_ACCESS_KEY }}" >> ~/.aws/credentials
-          echo "aws_secret_access_key = ${{ secrets.S3_SECRET_KEY }}" >> ~/.aws/credentials
-          echo "[default]" > ~/.aws/config
-          echo "region = ${{ secrets.S3_REGION }}" >> ~/.aws/config
+          # Install s3cmd
+          pip install s3cmd
           
-      - name: Deploy to S3-compatible storage with progress
+          # Extract domain from endpoint URL (remove https:// if present)
+          ENDPOINT=$(echo "${{ secrets.S3_ENDPOINT_URL }}" | sed 's/https:\/\///')
+          
+          # Create s3cmd config file
+          cat > ~/.s3cfg << EOF
+          [default]
+          access_key = ${{ secrets.S3_ACCESS_KEY }}
+          secret_key = ${{ secrets.S3_SECRET_KEY }}
+          host_base = ${ENDPOINT}
+          host_bucket = ${ENDPOINT}
+          use_https = True
+          check_ssl_certificate = False
+          check_ssl_hostname = False
+          # Enable verbose output and progress meter
+          verbose = True
+          progress_meter = True
+          EOF
+          
+      - name: Deploy to S3-compatible storage with s3cmd
         run: |
           # Navigate to where the built files are
           cd gh-pages
           
-          # Print bucket name for verification (with secrets masked)
-          echo "Using bucket: ${S3_BUCKET_NAME_MASKED}"
-          echo "Using endpoint: ${S3_ENDPOINT_URL_MASKED}"
+          # Print info about deployment
+          echo "Using s3cmd to upload to S3-compatible storage"
+          echo "Bucket: ${S3_BUCKET_NAME_MASKED}"
           
-          # Verify bucket exists
-          echo "Verifying bucket exists..."
-          if aws s3 ls "s3://${{ secrets.S3_BUCKET_NAME }}/" \
-            --endpoint-url=${{ secrets.S3_ENDPOINT_URL }} \
-            --no-verify-ssl; then
+          # Test bucket access
+          echo "Testing bucket access..."
+          if s3cmd ls s3://${{ secrets.S3_BUCKET_NAME }}/; then
             echo "✅ Bucket exists and is accessible"
           else
             echo "❌ Bucket does not exist or is not accessible"
             exit 1
           fi
           
-          # First, remove all existing files in the bucket to ensure clean deployment
+          # First, remove all existing files in the bucket
           echo "Clearing existing files from bucket..."
-          aws s3 rm "s3://${{ secrets.S3_BUCKET_NAME }}/" \
-            --recursive \
-            --endpoint-url=${{ secrets.S3_ENDPOINT_URL }} \
-            --no-verify-ssl
+          s3cmd del --recursive --force s3://${{ secrets.S3_BUCKET_NAME }}/
           
-          # Sync all files to S3 bucket with progress reporting
+          # Upload all files with progress display
           echo "Uploading files to S3-compatible storage..."
-          aws s3 sync . "s3://${{ secrets.S3_BUCKET_NAME }}/" \
-            --exclude ".git/*" \
-            --endpoint-url=${{ secrets.S3_ENDPOINT_URL }} \
-            --no-verify-ssl \
-            --debug
+          s3cmd sync --verbose --progress --exclude=".git/*" \
+            --no-check-md5 ./ s3://${{ secrets.S3_BUCKET_NAME }}/
             
           echo "Successfully deployed to S3-compatible storage"
         env:
-          # Mask sensitive data in logs but still make output readable
+          # Mask sensitive data in logs
           S3_BUCKET_NAME_MASKED: "${{ secrets.S3_BUCKET_NAME }}"
-          S3_ENDPOINT_URL_MASKED: "${{ secrets.S3_ENDPOINT_URL }}"

README.md

@@ -11,32 +11,31 @@
 1. 安装最新版本的 mdbook
 2. 构建静态网站
 3. 部署到 GitHub Pages
-4. 使用 AWS CLI 将文件上传到兼容 S3 的对象存储服务
+4. 使用 s3cmd 将文件上传到兼容 S3 的对象存储服务
 
 ### 配置对象存储部署
 
 要启用对象存储部署功能，需要在 GitHub 仓库中设置以下 Secrets：
 
 1. `S3_ACCESS_KEY` - 对象存储服务的访问密钥（AK）
 2. `S3_SECRET_KEY` - 对象存储服务的秘密访问密钥（SK）
-3. `S3_REGION` - 区域名称（例如 `cn-east-3`）
-4. `S3_ENDPOINT_URL` - 对象存储服务的端点（例如 `https://obs.cn-east-3.myhuaweicloud.com`）
-5. `S3_BUCKET_NAME` - 存储桶名称（必须提前创建）
+3. `S3_ENDPOINT_URL` - 对象存储服务的端点（例如 `obs.cn-east-3.myhuaweicloud.com`）
+4. `S3_BUCKET_NAME` - 存储桶名称（必须提前创建）
 
 可以在 GitHub 仓库的 Settings → Secrets and variables → Actions 页面中添加这些 secrets。
 
 **部署流程说明**：
 
-1. 部署流程使用标准 AWS CLI 与兼容 S3 的存储服务通信：
-   - 安装最新版本的 AWS CLI
-   - 进行验证，确保存储桶存在和可访问
-   - 提供详细的进度显示
+1. 部署流程使用轻量级的 s3cmd 工具与兼容 S3 的存储服务通信：
+   - 配置简单，仅需几个基本参数
+   - 提供内置的进度显示功能
+   - 对第三方S3兼容服务有良好支持
 
 2. 每次部署前会：
    - 清空目标存储桶中的所有现有文件
    - 排除不需要的文件（如 `.git` 目录）
-   - 使用 `--debug` 参数显示详细上传过程和进度
+   - 实时显示上传进度
 
 3. 如果对接华为云 OBS 或其他 S3 兼容服务，请确保：
    - 存储桶已创建并配置正确的访问权限
-   - 区域和端点 URL 与服务提供商的文档一致
+   - 端点 URL 格式正确（不要包含协议前缀 `https://`）