TencentCloud Manager

SKILL.md

# TencentCloud-Manager - 腾讯云资源统一管理技能

## 📋 技能说明

**腾讯云资源统一管理入口**，提供 CVM 云服务器、Lighthouse 轻量应用服务器、COS 对象存储的创建、配置和运维管理。

### 入口组件

本技能是腾讯云管理的**统一入口**。你也可以直接使用各分支技能：

| 技能 | 说明 | 引用 |
|------|------|------|
| tencentcloud-cvm | CVM 云服务器管理 | `from tencentcloud_cvm import CVMManager` |
| tencentcloud-lighthouse | Lighthouse 轻量服务器管理 | `from tencentcloud_lighthouse import LighthouseManager` |
| tencentcloud-cos | COS 对象存储管理 | `from tencentcloud_cos import COSManager` |
| tencentcloud-ops | CVM + COS 运维工具包 | `from tencentcloud_ops import CVMManager, COSManager` |

### 核心功能

✅ **资源创建与配置**
- CVM 云服务器实例管理
- Lighthouse 轻量服务器管理
- COS 存储桶与文件管理

✅ **运维管理**
- 实例启停与重启
- 监控与状态查询
- 生命周期管理
- 批量操作

✅ **成本优化**
- 促销方案查询与对比
- 存储类型成本估算
- 资源配置建议

✅ **安全管理**
- 子用户权限配置
- 凭证外部化管理
- 操作审计日志

---

## 💰 价格参考

> ⚠️ **注意**: 以下价格为参考区间（更新于 2026-03-29），实际价格以腾讯云官网实时查询为准。

### CVM 云服务器

| 方案类型 | 2 核 4G 参考 | 特点 |
|----------|-------------|------|
| 新人特惠 | ~¥150-200/年 | 限新用户 |
| 按量付费 | ~¥120-150/月 | 灵活 |
| 竞价实例 | ~¥30-50/月 | 最高 90% OFF |

### Lighthouse 轻量服务器

| 方案类型 | 2 核 2G 参考 | 特点 |
|----------|-------------|------|
| 新人特惠 | ~¥80-120/年 | 限新用户 |
| 包年包月 | ~¥400-500/年 | 价格稳定 |

### COS 对象存储

| 存储类型 | 参考价格 | 适用 |
|----------|---------|------|
| 标准存储 | ~¥0.12-0.15/GB/月 | 频繁访问 |
| 低频存储 | ~¥0.07-0.09/GB/月 | 不常访问 |
| 归档存储 | ~¥0.02-0.04/GB/月 | 长期保存 |

### 查询实时价格

```python
from tencentcloud_manager import TencentCloudManager

tcm = TencentCloudManager()

# 查询 CVM 促销
tcm.show_promotions(service='cvm')

# 查询 Lighthouse 促销
tcm.show_promotions(service='lighthouse')
```

---

## ⚠️ 前置配置 (必须完成)

### 步骤 1: 创建腾讯云子用户

1. 访问 https://console.cloud.tencent.com/cam/capi
2. 登录腾讯云账号
3. 创建子用户（如：`resource-manager`）
4. 复制 SecretId 和 SecretKey

### 步骤 2: 配置子用户权限

**推荐策略**: 创建自定义策略，授予最小必要权限

#### CVM 管理权限

```json
{
  "version": "2.0",
  "statement": [
    {
      "effect": "allow",
      "action": [
        "cvm:Describe*", "cvm:RunInstances", "cvm:StartInstances",
        "cvm:StopInstances", "cvm:RestartInstances", "cvm:ModifyInstancesAttribute",
        "cvm:RenewInstances", "vpc:DescribeSecurityGroups", "vpc:CreateSecurityGroup"
      ],
      "resource": "*"
    }
  ]
}
```

#### Lighthouse 管理权限

```json
{
  "version": "2.0",
  "statement": [
    {
      "effect": "allow",
      "action": [
        "lighthouse:Describe*", "lighthouse:CreateInstance",
        "lighthouse:StartInstances", "lighthouse:StopInstances",
        "lighthouse:RestartInstances", "lighthouse:ModifyInstancesAttribute",
        "lighthouse:RenewInstance"
      ],
      "resource": "*"
    }
  ]
}
```

#### COS 管理权限

```json
{
  "version": "2.0",
  "statement": [
    {
      "effect": "allow",
      "action": [
        "name/cos:GetBucket", "name/cos:PutBucket", "name/cos:ListBucket",
        "name/cos:GetObject", "name/cos:PutObject", "name/cos:DeleteObject",
        "name/cos:PutBucketLifecycle", "name/cos:GetBucketLifecycle"
      ],
      "resource": "*"
    }
  ]
}
```

### 步骤 3: 配置凭证到.env 文件

```bash
cp skills/tencentcloud-manager/config/.env.example \
   skills/tencentcloud-manager/config/.env

vim skills/tencentcloud-manager/config/.env
```

```bash
TENCENT_SECRET_ID=AKIDxxxxxxxxxxxxxxxxxxxxxxxxxx
TENCENT_SECRET_KEY=xxxxxxxxxxxxxxxxxxxxxxxxxx
TENCENT_REGION=ap-singapore
RESOURCE_PREFIX=resource
BUDGET_ALERT=100
```

### 步骤 4: 安装依赖

```bash
pip3 install --break-system-packages \
  tencentcloud-sdk-python \
  cos-python-sdk-v5 \
  python-dotenv
```

---

## 🚀 快速开始

### 方式 1: 使用统一入口

```python
from tencentcloud_manager import TencentCloudManager

tcm = TencentCloudManager()

# 查看所有可用服务
tcm.show_services()

# 查询促销方案
tcm.show_promotions(service='lighthouse')

# 创建资源
instance = tcm.create_resource(
    service='lighthouse',
    plan_id='new-2c4g',
    instance_name='my-server'
)
```

### 方式 2: 直接使用各服务管理器

```python
from tencentcloud_cvm import CVMManager
cvm = CVMManager()
cvm.show_promotions()

from tencentcloud_lighthouse import LighthouseManager
lh = LighthouseManager()
lh.show_blueprints()

from tencentcloud_cos import COSManager
cos = COSManager()
cos.create_bucket(bucket_name='my-bucket')
```

---

## 📚 Cookbook - 常用场景

### 场景 1: 创建个人博客服务器

```python
from tencentcloud_manager import TencentCloudManager

tcm = TencentCloudManager()

# 查看促销方案
tcm.show_promotions(service='lighthouse')

# 创建轻量服务器（使用 WordPress 镜像）
instance = tcm.create_resource(
    service='lighthouse',
    plan_id='new-1c1g',
    blueprint_id='bp-wordpress',
    instance_name='my-blog',
    period=12
)

print(f"服务器已创建：{instance['PublicAddress']}")
```

**预估成本**: ~¥60-80/年（新人特惠）

---

### 场景 2: 创建数据采集服务器

```python
tcm = TencentCloudManager()

# 创建 CVM 实例（按量付费）
instance = tcm.create_resource(
    service='cvm',
    plan_id='payg-2c4g',
    image_id='img-ubuntu-2204',
    instance_name='data-collector',
    system_disk_size=100,
    bandwidth=5
)

# 设置定时关机
tcm.schedule_shutdown(
    service='cvm',
    instance_id=instance['InstanceId'],
    shutdown_time='23:00',
    timezone='Asia/Shanghai'
)
```

**预估成本**: ~¥130-180/月（按实际使用计费）

---

### 场景 3: 配置对象存储并设置生命周期

```python
# 创建存储桶
bucket = tcm.create_cos_bucket(
    bucket_name='my-data-bucket',
    region='ap-singapore',
    storage_class='STANDARD'
)

# 上传文件
tcm.upload_to_cos(
    bucket=bucket['bucket'],
    local_path='/tmp/data.parquet',
    key='data/2024/03/29/data.parquet'
)

# 设置生命周期
tcm.set_cos_lifecycle(
    bucket=bucket['bucket'],
    rules=[
        {
            'id': 'data-lifecycle',
            'prefix': 'data/',
            'transitions': [
                {'days': 7, 'storage_class': 'STANDARD_IA'},
                {'days': 30, 'storage_class': 'ARCHIVE'}
            ]
        }
    ]
)
```

**预估成本**: ~¥35-50/月（生命周期优化后）

---

### 场景 4: 批量管理服务器

```python
# 查询所有实例
instances = tcm.list_all_instances()

# 批量开机
for inst in instances:
    if inst['state'] == 'STOPPED':
        tcm.start_resource(inst['service'], inst['id'])

# 批量关机
for inst in instances:
    if inst['state'] == 'RUNNING':
        tcm.stop_resource(inst['service'], inst['id'])
```

---

### 场景 5: 监控资源成本

```python
# 查询所有资源成本
cost_report = tcm.get_cost_report()

print(f"总月成本：¥{cost_report['total_monthly_cost']}")

# 成本优化建议
suggestions = tcm.get_cost_optimization_suggestions()
for suggestion in suggestions:
    print(f"💡 {suggestion}")
```

---

## 🔒 安全最佳实践

### 1. 使用子用户凭证

❌ **不要**使用主账号密钥：
```python
SECRET_ID = "AKID 主账号密钥"  # 危险！
```

✅ **使用子用户密钥**：
```python
from dotenv import load_dotenv
load_dotenv('config/.env')
SECRET_ID = os.getenv('TENCENT_SECRET_ID')
```

### 2. 最小权限原则

只授予必要的权限：
- 开发环境：只读权限 + 创建权限
- 生产环境：只读权限 + 启停权限
- 避免：财务权限、用户管理权限

### 3. 定期轮换密钥

每 90 天轮换一次密钥。

### 4. 启用操作审计

```python
tcm = TencentCloudManager(enable_audit=True)
```

---

## 📈 运维管理

### 日常巡检

```python
# 检查所有实例状态
instances = tcm.list_all_instances()
for inst in instances:
    status = tcm.get_resource_status(inst['service'], inst['id'])
    if status['state'] != 'RUNNING':
        print(f"⚠️  实例异常：{inst['name']}")

# 检查即将到期的资源
expiring = tcm.get_expiring_resources(days=30)
for resource in expiring:
    print(f"⏰ 即将到期：{resource['name']}")
```

---

## 📚 相关文档

- [CVM API 文档](https://cloud.tencent.com/document/api/213)
- [Lighthouse API 文档](https://cloud.tencent.com/document/api/1170)
- [COS API 文档](https://cloud.tencent.com/document/api/436)
- [子用户权限配置](https://cloud.tencent.com/document/product/598/10603)

---

## 🆘 故障排除

### 问题 1: 凭证验证失败

```bash
cat config/.env
python3 src/verify_config.py
```

### 问题 2: 权限不足

```bash
tccli cam ListAttachedUserPolicies --AttachUin <UIN>
```

### 问题 3: 创建失败

```bash
tccli cvm DescribeAccountQuota
```