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

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