@scemoon/cdh 1.0.8 → 1.0.9-beta.2

package/ai-dlc-skill/providers/aliyun/cli/database.md

@@ -0,0 +1,263 @@
+# Aliyun CLI: Database (RDS & TableStore)
+
+## When to Use Database Commands
+
+| Goal | Command | Notes |
+|------|---------|-------|
+| List RDS instances | `aliyun rds DescribeDBInstances` | Check instances |
+| Create RDS database | `aliyun rds CreateDatabase` | Initialize DB |
+| Create RDS account | `aliyun rds CreateAccount` | Set credentials |
+| Connect to MySQL | `mysql` client | Direct SQL access |
+| TableStore operations | `ots` CLI or SDK | NoSQL operations |
+
+## Decision Tree for Database Operations
+
+```
+Need to work with database?
+├── RDS MySQL/PostgreSQL
+│   ├── List instances → aliyun rds DescribeDBInstances
+│   ├── Create database → aliyun rds CreateDatabase
+│   ├── Create account → aliyun rds CreateAccount
+│   ├── Run SQL → mysql/psql client
+│   └── Backup → mysqldump/pg_dump
+├── TableStore (OTS)
+│   ├── List instances → aliyunots ListInstance
+│   ├── List tables → ots listtable
+│   ├── Query data → SDK (no CLI for queries)
+│   └── Manage table → ots CLI
+└── Schema changes → Migration files + CLI
+```
+
+## RDS MySQL Operations
+
+### List RDS Instances
+
+```bash
+aliyun rds DescribeDBInstances --region cn-shanghai
+```
+
+Output:
+```json
+{
+  "Items": {
+    "DBInstance": [
+      {
+        "DBInstanceId": "rm-xxxxx",
+        "DBInstanceDescription": "MySQL Production",
+        "DBInstanceStatus": "Running",
+        "Engine": "MySQL",
+        "EngineVersion": "8.0",
+        "RegionId": "cn-shanghai"
+      }
+    ]
+  }
+}
+```
+
+### Create Database
+
+```bash
+aliyun rds CreateDatabase \
+  --DBInstanceId rm-xxxxx \
+  --DBName myapp \
+  --CharacterSetName utf8mb4
+```
+
+### Create Account
+
+```bash
+aliyun rds CreateAccount \
+  --DBInstanceId rm-xxxxx \
+  --AccountName appuser \
+  --AccountPassword 'StrongPass123!' \
+  --AccountType Normal
+```
+
+### Grant Privileges
+
+```bash
+aliyun rds GrantAccountPrivileges \
+  --DBInstanceId rm-xxxxx \
+  --AccountName appuser \
+  --DBName myapp \
+  --AccountPrivilege Select,Insert,Update,Delete
+```
+
+### Connect to MySQL
+
+```bash
+mysql -h rm-xxxxx.mysql.rds.aliyuncs.com \
+  -P 3306 \
+  -u appuser \
+  -p
+```
+
+### Backup Database
+
+```bash
+mysqldump -h rm-xxxxx.mysql.rds.aliyuncs.com \
+  -P 3306 \
+  -u appuser \
+  -p'mypassword' \
+  myapp > backup.sql
+```
+
+### Restore Database
+
+```bash
+mysql -h rm-xxxxx.mysql.rds.aliyuncs.com \
+  -P 3306 \
+  -u appuser \
+  -p'mypassword' \
+  myapp < backup.sql
+```
+
+## RDS PostgreSQL Operations
+
+### Connect to PostgreSQL
+
+```bash
+psql -h rm-xxxxx.pg.rds.aliyuncs.com \
+  -p 5432 \
+  -U appuser \
+  -d myapp
+```
+
+### Backup PostgreSQL
+
+```bash
+pg_dump -h rm-xxxxx.pg.rds.aliyuncs.com \
+  -p 5432 \
+  -U appuser \
+  -d myapp > backup.sql
+```
+
+## TableStore Operations
+
+### Install OTS CLI
+
+```bash
+pip install ots2
+```
+
+### List Instances
+
+```bash
+aliyun ots ListInstance --region cn-shanghai
+```
+
+### Create Instance
+
+```bash
+aliyun ots CreateInstance \
+  --InstanceName my-ots-instance \
+  --Description "My OTS Instance" \
+  --Region cn-shanghai
+```
+
+### List Tables
+
+```bash
+ots listtable --instance_name my-ots-instance
+```
+
+### Describe Table
+
+```bash
+ots describeTable \
+  --instance_name my-ots-instance \
+  --table_name users
+```
+
+### Create Table
+
+```bash
+ots createTable \
+  --instance_name my-ots-instance \
+  --table_meta '{
+    "tableName": "users",
+    "primaryKey": [
+      {"name": "user_id", "type": "STRING"}
+    ]
+  }'
+```
+
+### Update Table Throughput
+
+```bash
+ots updateTable \
+  --instance_name my-ots-instance \
+  --table_name users \
+  --reserved_throughput '{
+    "capacity_unit": {"read": 10, "write": 10}
+  }'
+```
+
+## Database Connection from Functions
+
+### From Function Compute (Node.js)
+
+```javascript
+const mysql = require('mysql2/promise');
+
+module.exports.handler = async (event, context) => {
+  const connection = await mysql.createConnection({
+    host: process.env.RDS_HOST,
+    port: process.env.RDS_PORT || 3306,
+    user: process.env.RDS_USER,
+    password: process.env.RDS_PASSWORD,
+    database: process.env.RDS_DATABASE
+  });
+
+  const [rows] = await connection.execute('SELECT * FROM users LIMIT 10');
+  await connection.end();
+
+  return { users: rows };
+};
+```
+
+### From Function Compute (Python)
+
+```python
+import pymysql
+import os
+
+def handler(event, context):
+    connection = pymysql.connect(
+        host=os.environ['RDS_HOST'],
+        port=int(os.environ.get('RDS_PORT', 3306)),
+        user=os.environ['RDS_USER'],
+        password=os.environ['RDS_PASSWORD'],
+        database=os.environ['RDS_DATABASE']
+    )
+
+    with connection.cursor() as cursor:
+        cursor.execute('SELECT * FROM users LIMIT 10')
+        rows = cursor.fetchall()
+
+    connection.close()
+    return {'users': rows}
+```
+
+### From SAE (Java Spring Boot)
+
+```properties
+# application.properties
+spring.datasource.url=jdbc:mysql://${RDS_HOST}:${RDS_PORT}/${RDS_DATABASE}
+spring.datasource.username=${RDS_USER}
+spring.datasource.password=${RDS_PASSWORD}
+spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
+```
+
+## Troubleshooting
+
+| Issue | Cause | Solution |
+|-------|-------|----------|
+| `Connection refused` | Wrong host/port | Check RDS endpoint |
+| `Access denied` | Wrong credentials | Verify username/password |
+| `Unknown database` | Database doesn't exist | Create database first |
+| `Table not found` | Migration not run | Run migrations |
+| `OTS throttle` | Throughput exceeded | Increase reserved capacity |
+| `OTS timeout` | Network or table issue | Check instance status |
+
+For detailed troubleshooting → `../best-practices/troubleshooting.md`

package/ai-dlc-skill/providers/aliyun/cli/functions.md

@@ -0,0 +1,263 @@
+# Aliyun CLI: Function Compute (fun)
+
+## When to Use Function Commands
+
+| Goal | Command | Notes |
+|------|---------|-------|
+| Deploy a function | `fun deploy` | Main deployment command |
+| Invoke a function | `fun invoke` | For testing |
+| View logs | `fun logs` | Real-time logs |
+| List functions | `fun list` | Show all functions |
+| Delete function | `fun remove` | Removes function + triggers |
+| Init template | `fun init` | Create new project |
+
+**For shared environments (preview/staging/production), always use `deploy_stack` instead.**
+
+## Decision Tree for Function Operations
+
+```
+Need to work with Function Compute?
+├── Deploying to shared env → deploy_stack --preview --provider aliyun
+├── Deploying to personal dev → fun deploy
+├── Testing/debugging function → fun invoke
+├── Viewing logs → fun logs
+├── Checking status → fun list
+└── Deleting function → fun remove (dev only)
+```
+
+## Deploy Functions
+
+### Standard Deployment with template.yml
+
+```bash
+fun deploy --template template.yml
+```
+
+### Deploy Specific Function
+
+```bash
+fun deploy --function hello --service my-service
+```
+
+### Deploy All Functions
+
+```bash
+fun deploy
+```
+
+### Options
+
+| Option | Description |
+|--------|-------------|
+| `--template <file>` | Use specific template file |
+| `--function <name>` | Deploy specific function |
+| `--service <name>` | Deploy to specific service |
+| `--skip-existing` | Don't overwrite existing |
+| `--use-remote` | Force remote build |
+
+## Init New Function
+
+```bash
+# HTTP trigger template
+fun init --template-name http-trigger-nodejs14 my-function
+
+# Event trigger template
+fun init --template-name event-nodejs14 my-function
+
+# Custom runtime
+fun init --template-name custom-container my-function
+```
+
+### Generated template.yml Example
+
+```yaml
+ROSTemplateFormatVersion: '2015-09-01'
+Transform: Alibaba Cloud Resource Orchestration Service (ROS)
+Resources:
+  my-service:
+    Type: Alibaba Cloud::Function Compute::Service
+    Properties:
+      ServiceName: my-service
+      Description: My service
+  hello:
+    Type: Alibaba Cloud::Function Compute::Function
+    Properties:
+      ServiceName: my-service
+      FunctionName: hello
+      Runtime: nodejs14
+      Handler: index.handler
+      MemorySize: 128
+      Timeout: 60
+      CodeUri: ./
+```
+
+## Invoke Functions
+
+### Sync Invocation
+
+```bash
+fun invoke --function hello --service my-service
+```
+
+### With Event Data
+
+```bash
+fun invoke --function hello --service my-service \
+  --event '{"key": "value"}'
+```
+
+### Async Invocation
+
+```bash
+fun invoke --function hello --service my-service --async
+```
+
+## View Logs
+
+### Recent Logs
+
+```bash
+fun logs --function hello --service my-service
+```
+
+### Logs with Limit
+
+```bash
+fun logs --function hello --service my-service --tail 100
+```
+
+### Follow Logs (tail -f)
+
+```bash
+fun logs --function hello --service my-service --tail --follow
+```
+
+### Filter Logs
+
+```bash
+fun logs --function hello --service my-service | grep ERROR
+```
+
+## List Functions
+
+### List All Services
+
+```bash
+fun list services
+```
+
+### List Functions in Service
+
+```bash
+fun list functions --service my-service
+```
+
+Output:
+```
+Functions in service: my-service
+┌──────────────┬────────────┬─────────┬───────────────┐
+│ Name         │ Runtime    │ Memory  │ Timeout       │
+├──────────────┼────────────┼─────────┼───────────────┤
+│ hello        │ nodejs14   │ 128MB   │ 60s           │
+│ api-users    │ python3.9  │ 256MB   │ 30s           │
+└──────────────┴────────────┴─────────┴───────────────┘
+```
+
+## Function Details
+
+```bash
+fun info --function hello --service my-service
+```
+
+Shows:
+- Runtime version
+- Memory limit
+- Timeout
+- Handler
+- Environment variables
+- Last modification time
+
+## Delete Function
+
+```bash
+fun remove --function hello --service my-service
+```
+
+**Warning:** Deletes function and all associated triggers. Cannot be undone.
+
+## Local Invoke
+
+Test function locally without deployment:
+
+```bash
+fun local invoke --function hello --service my-service --event '{"test": true}'
+```
+
+## Build Remotely
+
+For functions with complex dependencies:
+
+```bash
+fun deploy --use-remote --service my-service --function hello
+```
+
+## Common Workflows
+
+### Workflow: Deploy New Function
+
+```bash
+# 1. Initialize project
+fun init --template-name http-trigger-nodejs14 hello
+
+# 2. Edit code
+cd hello
+vim index.js
+
+# 3. Deploy
+fun deploy
+
+# 4. Test
+fun invoke --function hello --service hello
+```
+
+### Workflow: Update Function Config
+
+```yaml
+# Edit template.yml
+function:
+  name: hello
+  memorySize: 512  # Increase memory
+  timeout: 120     # Increase timeout
+
+# Redeploy
+fun deploy --function hello --service my-service
+```
+
+### Workflow: Debug Function Error
+
+```bash
+# 1. Get recent logs
+fun logs --function hello --service my-service --tail 50
+
+# 2. Invoke with test event
+fun invoke --function hello --service my-service --event '{"debug": true}'
+
+# 3. Check detailed logs
+fun logs --function hello --service my-service | grep -i error
+
+# 4. Local invoke for faster iteration
+fun local invoke --function hello --service my-service --event '{}'
+```
+
+## Troubleshooting
+
+| Issue | Cause | Solution |
+|-------|-------|----------|
+| `Function not found` | Wrong name or service | `fun list functions` to verify |
+| `Deploy failed: timeout` | Slow build or network | Check build logs, use `--use-remote` |
+| `Invoke timeout` | Function taking too long | Increase timeout in template |
+| `Memory exceeded` | Memory limit too low | Increase memory in template |
+| `Permission denied` | RAM role missing | Check function compute permissions |
+| `Build failed` | Dependency error | Check package.json, use remote build |
+
+For detailed troubleshooting → `../best-practices/troubleshooting.md`