2024基于統(tǒng)一開發(fā)平臺服務接入指南

NSF接入指 API網關接入指 API網關簽名認證流 簽名流 計算簽 API網關JWT認證流 CICD接入指 APM接入指 Redis開發(fā)規(guī)范說 RDSMySQL開發(fā)規(guī) 開發(fā)約 開發(fā)建 TCC模 FMT模 XA模 TCC、FMT和XA模式對 同庫模 基于SDK的方式使 環(huán)境要 Jar包的獲取和使 術語/NSFNSF（NewServiceFramework）是新一代微服務治理框APIAPIAPI發(fā)布、管理、運維、售NCSNCS（NewContainerService）新一代容器云平臺，覆Kubernetes容器編排系統(tǒng)。APM為云計算的應用性能管理（ApplicationCICD專注微服務架構下的應用持續(xù)集成(Continuousintegration)、持續(xù)交付(ContinuousDelivery)方案，提供可視JWT（JsonWebToken）是為了在網絡應用環(huán)境間傳遞JsonJWT的聲明一般APP/WEBAPP/WEB容器云webconsole鏡像倉庫基于CNCF開源項目HaborHabor對所有Docker鏡像都是支持的，包括windowsDockerDocker微服務NSFJava組件和框架如下表表格1JDK1.6、JDK1.7、JDK~gRPCspringbootgRPCSpring1.5.8~SpringCloud-SpringCloud-boot1.x、boot2.0.x、boot2.1.x、boot2.2.x及以上的版本;feignAPIAPIAPInsf2018-07-nsfheader中標準表示，并需要使用UTC時間，格式為：YYYY-MM-DDThh:mm:ssZ。如：2017-09-06T11:00:00Z（2017961900秒）則認為X-NSF-Date參數合法，否則則認為X-NSF-Date參數非法。headerheader;HostheaderX-NSF-Signature請求頭以外的所有公共參數是必須簽名算法版本，1.0HMAC-SHA256出哪一步驟發(fā)生了錯誤從而進行進一步修改。Boolean類型。AccessKeykey/valueURL5header,后跟換行符（header之間使用換行符連接headerhost:headerheaderheaderheadername/value使用:header后都加6header,header使用“;”連接，后7:SHA256HTTPShashAccessSercret1String2Sign作為加密哈API網關JWT生成API網關能識別的JWT的前提是有一個由頒發(fā)的外部認證的JWT訪問APIJWT。RS256HS256HS256header為：JWTpayload，payloadissclaimJWTID（issclaimheader中，但是會優(yōu)先查詢nbfpayloadclaimAPIJWTJWT有效期內，則也會導致認證失敗。最后使用JWTJWTJWTRS256RSA密鑰對的私鑰，APIRSAHS256、密鑰c5dd504725d843218db209ffca5d82f3JWT為：keyAuthorizationJWTJWT。CICDCICD專注微服務架構下的應用持續(xù)集成、持續(xù)交付方案，是平臺的開發(fā)流程管理系統(tǒng)，核心功能是流水線管理和部署平臺。CICD兼容業(yè)內主流的開發(fā)工具、框架、中間件、測試工具等，用戶可以快速接入。CICD流水線代碼檢出階段支持的版本管理工具如表12表1Gitlab、HTTPS、表2JDK1.7、JDK1.8JDK1.8、JDK1.118.12-CICD流水線質量檢測階段有單元測試、集成測試和代碼檢測，其中單元測表3Mvn3.5-Gradle6-Docker的版本也有要求，可以提前給團隊提需求進行定制（默KubernetesDocker版本）。KubernetesKubernetesKubernetes1.13.12APMJDK1.6、JDK1.7、7.x、8.x、2.5.2-JDK1.6、JDK1.7、7.x、8.x、2.5.2-apachehttpclient3、httpclient4、commonsSQL2.0.0-1.4.0-2.7.0-1.2.4、2、0.9.3、ElasticsearchRedisRedisRediscluster.14可RedisRedis服務的不RedisRedis中，對于低頻冷數據可以使用MySQL/ElasticSearch等基于磁盤的存儲方式，不僅節(jié)省內存成本，而且數據量Redis32Database來使用，以自然數來做區(qū)分，如果不選keykeykeyRedisCachekey一定要設置超時的超時長短要根據業(yè)務綜合評估，而不是越長越好。(key長期有RedisKEYSRediskey數量較多時，操作效率極低（時間復雜度Hash、SetHASHField，往往使HGETALLField擴張HGETALL滿等問題（O(N)）,Hash結構；或者如果大部分都是獲取所有屬性的操作,String類型SMEMBERSSET結構類型時也是相同的情況。列表（List），集合（Set），有序集合（SortedSet）,Bitmap,HyperLogLog和地K-V、計數類；Hash可以用作對象等，包含較多屬性的信息；List可以用作消息隊列、粉絲/關注列表等；Set可以用于推薦；SortedSet可以用如果必須確保關鍵性的數據可以被放入到Redis的實例中，強烈建議將其try/exceptRedis客戶端采用的都是“發(fā)送即忘”策略，因此經常需要考慮一個key是否真正被放到Redis數據庫中了。極限情況會造成宿主機宕機。請確保使用了正確的Redis客戶端連接池配置。Redis當作存儲來使用。rediscluster能夠支持水平擴容，但是數據遷移過程中可能會帶來業(yè)務swap，RedisswapOOM風clusterdowncluster-require-full-coveragenoslotRedis數據剔除算法不能完全保證正確性，可能會把設置了過期時間但還未Redismaxmemory上限。RDSMySQLRDSMySQLMGR(MySQLGroupReplication)的集MGRMGRInnoDBNull的唯一鍵，否則雖然能夠創(chuàng)建表，但在寫入數據時會直接報MGRIPv4MGR集群MGR集群中,locktables、unlocktables、get_lock、release_lock等表鎖MGR集群中，節(jié)點間的通信比較頻繁，過大的事務會導致節(jié)點間的MySQL的系統(tǒng)參數group_replication_transaction_size_limit150MB左右。MGR集群中，一個事務需要在大多數節(jié)點中達成一致后才能提交，MGR150MB，一個大事務盡可以拆分成若干個小事務，deletefromxx_tablewherecreate_time=IDMySQLID1MGR7insertIDMySQL本身來ID列。GTXS@GtxsTransactionGTXSGTXSXIDGTXSID，javaXA個分布式事務生成一個全局唯一的分布式事務ID。BranchIdGTXSID，它是事務分支的唯一標識。XIDBranchId事務分組:每個GTXS應用都需要申請一個事務分組名稱，這個唯分組唯一Id。TCCFMTFramework-Management-TransactionTCCFMTXAXA，GTXSXAX