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

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