Browse Source

chore(abp): upgradeabp framework to 8.3.0.

(cherry picked from commit 239ad14390)
pull/1049/head
colin 1 year ago
committed by feijie
parent
commit
9b35e8cf9f
  1. 163
      aspnet-core/framework/cloud-aliyun/LINGYUN.Abp.Aliyun/README.EN.md
  2. 163
      aspnet-core/framework/cloud-aliyun/LINGYUN.Abp.Aliyun/README.md
  3. 6
      common.props

163
aspnet-core/framework/cloud-aliyun/LINGYUN.Abp.Aliyun/README.EN.md

@ -6,12 +6,12 @@ Reference: [Alibaba Cloud API Documentation](https://help.aliyun.com/document_de
## Features ## Features
* Provides basic SDK integration for Alibaba Cloud services - Provides basic SDK integration for Alibaba Cloud services
* Supports Alibaba Cloud RAM (Resource Access Management) authentication - Supports Alibaba Cloud RAM (Resource Access Management) authentication
* Supports STS Token access - Supports STS Token access
* Supports Alibaba Cloud SMS service - Supports Alibaba Cloud SMS service
* Supports Alibaba Cloud Object Storage Service (OSS) - Supports Alibaba Cloud Object Storage Service (OSS)
* Provides distributed cache support for optimizing high concurrency scenarios - Provides distributed cache support for optimizing high concurrency scenarios
## Module Reference ## Module Reference
@ -27,50 +27,56 @@ public class YouProjectModule : AbpModule
### Authentication Configuration ### Authentication Configuration
* **AliyunSettingNames.Authorization.RegionId** - **AliyunSettingNames.Authorization.RegionId**
* Description: Alibaba Cloud service region
* Type: Optional
* Default value: default
* Example: oss-cn-hangzhou
* **AliyunSettingNames.Authorization.AccessKeyId** - Description: Alibaba Cloud service region
* Description: AccessKey ID of Alibaba Cloud RAM account - Type: Optional
* Type: Required - Default value: default
* How to get: Access Alibaba Cloud Console - Access Control - Example: oss-cn-hangzhou
* **AliyunSettingNames.Authorization.AccessKeySecret** - **AliyunSettingNames.Authorization.AccessKeyId**
* Description: AccessKey Secret of RAM account
* Type: Required - Description: AccessKey ID of Alibaba Cloud RAM account
* How to get: Access Alibaba Cloud Console - Access Control - Type: Required
- How to get: Access Alibaba Cloud Console - Access Control
- **AliyunSettingNames.Authorization.AccessKeySecret**
- Description: AccessKey Secret of RAM account
- Type: Required
- How to get: Access Alibaba Cloud Console - Access Control
### STS Token Configuration ### STS Token Configuration
* **AliyunSettingNames.Authorization.UseSecurityTokenService** - **AliyunSettingNames.Authorization.UseSecurityTokenService**
* Description: Whether to use STS Token access
* Type: Optional - Description: Whether to use STS Token access
* Default value: false - Type: Optional
* Recommendation: Recommended to enable for improved security - Default value: false
- Recommendation: Recommended to enable for improved security
* **AliyunSettingNames.Authorization.RamRoleArn**
* Description: Alibaba Cloud RAM role ARN - **AliyunSettingNames.Authorization.RamRoleArn**
* Type: Required when STS Token is enabled
* Format: acs:ram::$accountID:role/$roleName - Description: Alibaba Cloud RAM role ARN
- Type: Required when STS Token is enabled
* **AliyunSettingNames.Authorization.RoleSessionName** - Format: acs:ram::$accountID:role/$roleName
* Description: Custom token name
* Type: Optional - **AliyunSettingNames.Authorization.RoleSessionName**
* Usage: For access auditing
- Description: Custom token name
* **AliyunSettingNames.Authorization.DurationSeconds** - Type: Optional
* Description: Token expiration time - Usage: For access auditing
* Type: Optional
* Default value: 3000 - **AliyunSettingNames.Authorization.DurationSeconds**
* Unit: Seconds
- Description: Token expiration time
* **AliyunSettingNames.Authorization.Policy** - Type: Optional
* Description: Permission policy - Default value: 3000
* Type: Optional - Unit: Seconds
* Format: JSON string
- **AliyunSettingNames.Authorization.Policy**
- Description: Permission policy
- Type: Optional
- Format: JSON string
### SMS Service Configuration ### SMS Service Configuration
@ -94,44 +100,45 @@ public class YouProjectModule : AbpModule
The module supports the following Alibaba Cloud regions: The module supports the following Alibaba Cloud regions:
* China Regions - China Regions
* North China 1 (Qingdao) - cn-qingdao
* North China 2 (Beijing) - cn-beijing - North China 1 (Qingdao) - cn-qingdao
* North China 3 (Zhangjiakou) - cn-zhangjiakou - North China 2 (Beijing) - cn-beijing
* North China 5 (Hohhot) - cn-huhehaote - North China 3 (Zhangjiakou) - cn-zhangjiakou
* East China 1 (Hangzhou) - cn-hangzhou - North China 5 (Hohhot) - cn-huhehaote
* East China 2 (Shanghai) - cn-shanghai - East China 1 (Hangzhou) - cn-hangzhou
* South China 1 (Shenzhen) - cn-shenzhen - East China 2 (Shanghai) - cn-shanghai
* South China 2 (Heyuan) - cn-heyuan - South China 1 (Shenzhen) - cn-shenzhen
* South China 3 (Guangzhou) - cn-guangzhou - South China 2 (Heyuan) - cn-heyuan
* Southwest 1 (Chengdu) - cn-chengdu - South China 3 (Guangzhou) - cn-guangzhou
- Southwest 1 (Chengdu) - cn-chengdu
* Hong Kong and International Regions
* Hong Kong - cn-hongkong - Hong Kong and International Regions
* US (Silicon Valley) - us-west-1 - Hong Kong - cn-hongkong
* US (Virginia) - us-east-1 - US (Silicon Valley) - us-west-1
* Japan (Tokyo) - ap-northeast-1 - US (Virginia) - us-east-1
* South Korea (Seoul) - ap-northeast-2 - Japan (Tokyo) - ap-northeast-1
* Singapore - ap-southeast-1 - South Korea (Seoul) - ap-northeast-2
* Australia (Sydney) - ap-southeast-2 - Singapore - ap-southeast-1
* Malaysia (Kuala Lumpur) - ap-southeast-3 - Australia (Sydney) - ap-southeast-2
* Indonesia (Jakarta) - ap-southeast-5 - Malaysia (Kuala Lumpur) - ap-southeast-3
* Philippines (Manila) - ap-southeast-6 - Indonesia (Jakarta) - ap-southeast-5
* Thailand (Bangkok) - ap-southeast-7 - Philippines (Manila) - ap-southeast-6
* India (Mumbai) - ap-south-1 - Thailand (Bangkok) - ap-southeast-7
* Germany (Frankfurt) - eu-central-1 - India (Mumbai) - ap-south-1
* UK (London) - eu-west-1 - Germany (Frankfurt) - eu-central-1
* UAE (Dubai) - me-east-1 - UK (London) - eu-west-1
- UAE (Dubai) - me-east-1
## Performance Optimization ## Performance Optimization
* In high concurrency scenarios, it is recommended to enable distributed caching to improve performance - In high concurrency scenarios, it is recommended to enable distributed caching to improve performance
* When using STS Token, the token will be automatically cached until expiration - When using STS Token, the token will be automatically cached until expiration
* It is recommended to set DurationSeconds reasonably to avoid frequent token refreshes - It is recommended to set DurationSeconds reasonably to avoid frequent token refreshes
## Related Modules ## Related Modules
* [LINGYUN.Abp.Aliyun.SettingManagement](../LINGYUN.Abp.Aliyun.SettingManagement/README.md) - Provides configuration management functionality - [LINGYUN.Abp.Aliyun.SettingManagement](../LINGYUN.Abp.Aliyun.SettingManagement/README.md) - Provides configuration management functionality
* [LINGYUN.Abp.Aliyun.Features](../LINGYUN.Abp.Aliyun.Features/README.md) - Provides feature management functionality - [LINGYUN.Abp.Aliyun.Features](../LINGYUN.Abp.Aliyun.Features/README.md) - Provides feature management functionality
[查看中文文档](README.md) [查看中文文档](README.md)

163
aspnet-core/framework/cloud-aliyun/LINGYUN.Abp.Aliyun/README.md

@ -6,12 +6,12 @@
## 功能特性 ## 功能特性
* 提供阿里云服务的基础SDK集成 - 提供阿里云服务的基础 SDK 集成
* 支持阿里云RAM(访问控制)认证 - 支持阿里云 RAM(访问控制)认证
* 支持STS Token访问 - 支持 STS Token 访问
* 支持阿里云短信服务(SMS) - 支持阿里云短信服务(SMS)
* 支持阿里云对象存储(OSS) - 支持阿里云对象存储(OSS)
* 提供分布式缓存支持,优化高并发场景 - 提供分布式缓存支持,优化高并发场景
## 模块引用 ## 模块引用
@ -27,50 +27,56 @@ public class YouProjectModule : AbpModule
### 认证配置 ### 认证配置
* **AliyunSettingNames.Authorization.RegionId** - **AliyunSettingNames.Authorization.RegionId**
* 说明:阿里云服务区域
* 类型:可选
* 默认值:default
* 示例:oss-cn-hangzhou
* **AliyunSettingNames.Authorization.AccessKeyId** - 说明:阿里云服务区域
* 说明:阿里云RAM账号的AccessKey ID - 类型:可选
* 类型:必须 - 默认值:default
* 获取方式:访问阿里云控制台-访问控制 - 示例:oss-cn-hangzhou
* **AliyunSettingNames.Authorization.AccessKeySecret** - **AliyunSettingNames.Authorization.AccessKeyId**
* 说明:RAM账号的AccessKey Secret
* 类型:必须 - 说明:阿里云 RAM 账号的 AccessKey ID
* 获取方式:访问阿里云控制台-访问控制 - 类型:必须
- 获取方式:访问阿里云控制台-访问控制
- **AliyunSettingNames.Authorization.AccessKeySecret**
- 说明:RAM 账号的 AccessKey Secret
- 类型:必须
- 获取方式:访问阿里云控制台-访问控制
### STS Token 配置 ### STS Token 配置
* **AliyunSettingNames.Authorization.UseSecurityTokenService** - **AliyunSettingNames.Authorization.UseSecurityTokenService**
* 说明:是否使用STS Token访问
* 类型:可选 - 说明:是否使用 STS Token 访问
* 默认值:false - 类型:可选
* 建议:建议开启,提高安全性 - 默认值:false
- 建议:建议开启,提高安全性
* **AliyunSettingNames.Authorization.RamRoleArn**
* 说明:阿里云RAM角色ARN - **AliyunSettingNames.Authorization.RamRoleArn**
* 类型:启用STS Token时必须
* 格式:acs:ram::$accountID:role/$roleName - 说明:阿里云 RAM 角色 ARN
- 类型:启用 STS Token 时必须
* **AliyunSettingNames.Authorization.RoleSessionName** - 格式:acs:ram::$accountID:role/$roleName
* 说明:用户自定义令牌名称
* 类型:可选 - **AliyunSettingNames.Authorization.RoleSessionName**
* 用途:用于访问审计
- 说明:用户自定义令牌名称
* **AliyunSettingNames.Authorization.DurationSeconds** - 类型:可选
* 说明:用户令牌的过期时间 - 用途:用于访问审计
* 类型:可选
* 默认值:3000 - **AliyunSettingNames.Authorization.DurationSeconds**
* 单位:秒
- 说明:用户令牌的过期时间
* **AliyunSettingNames.Authorization.Policy** - 类型:可选
* 说明:权限策略 - 默认值:3000
* 类型:可选 - 单位:秒
* 格式:JSON字符串
- **AliyunSettingNames.Authorization.Policy**
- 说明:权限策略
- 类型:可选
- 格式:JSON 字符串
### 短信服务配置 ### 短信服务配置
@ -94,44 +100,45 @@ public class YouProjectModule : AbpModule
本模块支持以下阿里云区域: 本模块支持以下阿里云区域:
* 中国区域 - 中国区域
* 华北1(青岛)- cn-qingdao
* 华北2(北京)- cn-beijing - 华北 1(青岛)- cn-qingdao
* 华北3(张家口)- cn-zhangjiakou - 华北 2(北京)- cn-beijing
* 华北5(呼和浩特)- cn-huhehaote - 华北 3(张家口)- cn-zhangjiakou
* 华东1(杭州)- cn-hangzhou - 华北 5(呼和浩特)- cn-huhehaote
* 华东2(上海)- cn-shanghai - 华东 1(杭州)- cn-hangzhou
* 华南1(深圳)- cn-shenzhen - 华东 2(上海)- cn-shanghai
* 华南2(河源)- cn-heyuan - 华南 1(深圳)- cn-shenzhen
* 华南3(广州)- cn-guangzhou - 华南 2(河源)- cn-heyuan
* 西南1(成都)- cn-chengdu - 华南 3(广州)- cn-guangzhou
- 西南 1(成都)- cn-chengdu
* 香港及海外区域
* 香港 - cn-hongkong - 香港及海外区域
* 美国(硅谷)- us-west-1 - 香港 - cn-hongkong
* 美国(弗吉尼亚)- us-east-1 - 美国(硅谷)- us-west-1
* 日本(东京)- ap-northeast-1 - 美国(弗吉尼亚)- us-east-1
* 韩国(首尔)- ap-northeast-2 - 日本(东京)- ap-northeast-1
* 新加坡 - ap-southeast-1 - 韩国(首尔)- ap-northeast-2
* 澳大利亚(悉尼)- ap-southeast-2 - 新加坡 - ap-southeast-1
* 马来西亚(吉隆坡)- ap-southeast-3 - 澳大利亚(悉尼)- ap-southeast-2
* 印度尼西亚(雅加达)- ap-southeast-5 - 马来西亚(吉隆坡)- ap-southeast-3
* 菲律宾(马尼拉)- ap-southeast-6 - 印度尼西亚(雅加达)- ap-southeast-5
* 泰国(曼谷)- ap-southeast-7 - 菲律宾(马尼拉)- ap-southeast-6
* 印度(孟买)- ap-south-1 - 泰国(曼谷)- ap-southeast-7
* 德国(法兰克福)- eu-central-1 - 印度(孟买)- ap-south-1
* 英国(伦敦)- eu-west-1 - 德国(法兰克福)- eu-central-1
* 阿联酋(迪拜)- me-east-1 - 英国(伦敦)- eu-west-1
- 阿联酋(迪拜)- me-east-1
## 性能优化 ## 性能优化
* 在高并发场景下,建议开启分布式缓存以提高性能 - 在高并发场景下,建议开启分布式缓存以提高性能
* 使用STS Token时,Token会自动缓存到过期前 - 使用 STS Token 时,Token 会自动缓存到过期前
* 建议合理设置DurationSeconds,避免过于频繁的Token刷新 - 建议合理设置 DurationSeconds,避免过于频繁的 Token 刷新
## 相关模块 ## 相关模块
* [LINGYUN.Abp.Aliyun.SettingManagement](../LINGYUN.Abp.Aliyun.SettingManagement/README.md) - 提供配置管理功能 - [LINGYUN.Abp.Aliyun.SettingManagement](../LINGYUN.Abp.Aliyun.SettingManagement/README.md) - 提供配置管理功能
* [LINGYUN.Abp.Aliyun.Features](../LINGYUN.Abp.Aliyun.Features/README.md) - 提供功能管理功能 - [LINGYUN.Abp.Aliyun.Features](../LINGYUN.Abp.Aliyun.Features/README.md) - 提供功能管理功能
[点击查看英文文档](README.EN.md) [点击查看英文文档](README.EN.md)

6
common.props

@ -11,7 +11,6 @@
<RepositoryType>git</RepositoryType> <RepositoryType>git</RepositoryType>
<RepositoryUrl>https://github.com/colinin/abp-next-admin</RepositoryUrl> <RepositoryUrl>https://github.com/colinin/abp-next-admin</RepositoryUrl>
<GeneratePackageOnBuild Condition="$(AssemblyName.StartsWith('LINGYUN'))">true</GeneratePackageOnBuild> <GeneratePackageOnBuild Condition="$(AssemblyName.StartsWith('LINGYUN'))">true</GeneratePackageOnBuild>
<Configurations>Debug;Release;PostgreSQL</Configurations>
</PropertyGroup> </PropertyGroup>
<ItemGroup> <ItemGroup>
@ -36,9 +35,4 @@
<OutputPath>$(SolutionDir)LocalNuget</OutputPath> <OutputPath>$(SolutionDir)LocalNuget</OutputPath>
</PropertyGroup> </PropertyGroup>
<PropertyGroup Condition="'$(Configuration)|$(Platform)'=='PostgreSQL|AnyCPU'">
<DefineConstants>POSTGRESQL</DefineConstants>
<OutputPath>$(SolutionDir)LocalNuget</OutputPath>
</PropertyGroup>
</Project> </Project>
Loading…
Cancel
Save