refactor: re-organise doc structure

docs/en-gb/blogs/minio-admin-guide.md

@@ -0,0 +1,200 @@
+---
+title: MinIO Administration Guide for New Versions
+tags:
+  - minio
+  - storage
+  - s3
+  - devops
+  - cheatsheet
+author:
+  name: Zihlu Wang
+  email: real@zihluwang.me
+---
+
+In newer versions, MinIO has removed administrative functionality from the Web UI. You now need to use the **MinIO Client (mc)** command-line tool for all management operations.
+
+## Installing MinIO Client (mc)
+
+### Windows:
+
+```powershell
+# Download mc.exe
+Invoke-WebRequest -Uri "https://dl.min.io/client/mc/release/windows-amd64/mc.exe" -OutFile "mc.exe"
+
+# Or using Chocolatey
+choco install minio-client
+```
+
+### Linux/macOS:
+
+```bash
+# Linux
+wget https://dl.min.io/client/mc/release/linux-amd64/mc
+chmod +x mc
+sudo mv mc /usr/local/bin/
+
+# macOS
+brew install minio/stable/mc
+```
+
+## Configuring the MinIO Client
+
+```bash
+# Add a MinIO server alias
+mc alias set myminio http://localhost:9000 minioadmin minioadmin
+
+# Verify the connection
+mc admin info myminio
+```
+
+## User Management
+
+### Creating Users
+
+```bash
+# Create a new user
+mc admin user add myminio newuser newpassword
+
+# List all users
+mc admin user list myminio
+```
+
+### Creating Access Keys and Secret Keys
+
+```bash
+# Create a service account for a user (generates AccessKey/SecretKey)
+mc admin user svcacct add myminio newuser
+
+# Or specify custom AccessKey and SecretKey
+mc admin user svcacct add myminio newuser --access-key "MYACCESSKEY123" --secret-key "MYSECRETKEY456"
+
+# View a user's service accounts
+mc admin user svcacct list myminio newuser
+```
+
+## Permission Management
+
+### Creating Policies
+
+```bash
+# Create a policy file policy.json
+cat > policy.json << EOF
+{
+  "Version": "2012-10-17",
+  "Statement": [
+    {
+      "Effect": "Allow",
+      "Action": [
+        "s3:GetObject",
+        "s3:PutObject",
+        "s3:DeleteObject"
+      ],
+      "Resource": [
+        "arn:aws:s3:::mybucket/*"
+      ]
+    }
+  ]
+}
+EOF
+
+# Add the policy
+mc admin policy add myminio mypolicy policy.json
+
+# Assign the policy to a user
+mc admin policy set myminio mypolicy user=newuser
+```
+
+## Bucket Management
+
+```bash
+# Create a bucket
+mc mb myminio/mybucket
+
+# List buckets
+mc ls myminio
+
+# Set bucket policy
+mc policy set public myminio/mybucket
+```
+
+## Common Administration Commands
+
+```bash
+# View server information
+mc admin info myminio
+
+# View server configuration
+mc admin config get myminio
+
+# Restart the server
+mc admin service restart myminio
+
+# View logs
+mc admin logs myminio
+
+# View statistics
+mc admin prometheus metrics myminio
+```
+
+## Practical Script Example
+
+Create an administration script `setup-minio.sh`:
+
+```bash
+#!/bin/bash
+
+MINIO_ALIAS="myminio"
+MINIO_URL="http://localhost:9000"
+ADMIN_USER="minioadmin"
+ADMIN_PASS="minioadmin"
+
+# Configure the MinIO client
+mc alias set $MINIO_ALIAS $MINIO_URL $ADMIN_USER $ADMIN_PASS
+
+# Create an application user
+APP_USER="appuser"
+APP_PASS="apppassword"
+mc admin user add $MINIO_ALIAS $APP_USER $APP_PASS
+
+# Create a service account and retrieve AccessKey/SecretKey
+echo "Creating service account for $APP_USER..."
+CREDENTIALS=$(mc admin user svcacct add $MINIO_ALIAS $APP_USER --json)
+ACCESS_KEY=$(echo $CREDENTIALS | jq -r '.accessKey')
+SECRET_KEY=$(echo $CREDENTIALS | jq -r '.secretKey')
+
+echo "Generated credentials:"
+echo "Access Key: $ACCESS_KEY"
+echo "Secret Key: $SECRET_KEY"
+
+# Create a bucket
+mc mb $MINIO_ALIAS/app-bucket
+
+# Set a read-only policy
+mc policy set download $MINIO_ALIAS/app-bucket
+```
+
+## Web Console Access
+
+Although administrative functionality has been removed, you can still access the MinIO Console via:
+
+```bash
+# Launch the MinIO Console (if installed separately)
+mc admin console myminio
+```
+
+Alternatively, specify the console address when starting the MinIO server:
+
+```bash
+minio server /data --console-address ":9001"
+```
+
+## Summary
+
+Managing the new MinIO relies entirely on the `mc` command-line tool:
+
+1. **Install the mc client**
+2. **Configure the server alias**
+3. **Use `mc admin` commands for user, permission, and bucket management**
+4. **Generate AccessKeys/SecretKeys via `mc admin user svcacct`**
+
+While this approach requires command-line operations, it provides more powerful and flexible management capabilities, particularly suited for automated deployment and script-based management.