在云上，主要有以下兩種方式用于集成云服務(wù)，實現(xiàn)可重復(fù)基礎(chǔ)設(shè)施。

通過OpenAPI和原生工具集成云服務(wù)

云計算的客戶，從訪問云資源的方式上，通常分為兩大類，通過控制臺可視化界面操作的普通群體、通過OpenAPI和其原生工具集成的開發(fā)者群體。前者更適合簡單上云和管理云資源的客戶，而后者則更適合需要自動化管理和復(fù)雜業(yè)務(wù)集成的開發(fā)者們。

控制臺提供了圖形化的界面，讓用戶可以通過簡單的操作完成對云資源的管控。例如，運維人員通過控制臺創(chuàng)建、配置和監(jiān)控云服務(wù)器、數(shù)據(jù)庫、存儲等資源，查看和處理系統(tǒng)告警和日志，業(yè)務(wù)人員可以通過控制臺訪問應(yīng)用程序和查看業(yè)務(wù)數(shù)據(jù)等等。總之，這類用戶一般不需要編寫代碼，通過相對簡單的操作即可與云資源交互。

然而，API被人讀、被機器讀并最終被機器執(zhí)行。 API是抽象的，但也需要具象的方式才能被人類更高效的集成使用。

OpenAPI用戶在不同階段需要關(guān)注的原則和建議主要包括OpenAPI規(guī)范、API的質(zhì)量和穩(wěn)定性、API的使用效率、API的性能和效率、API版本和變更、API的安全性和可靠性、錯誤信息和日志記錄等，以便于更好地評估、使用和維護API，提升使用效率。

OpenAPI的探索與評估

1. 探索匹配業(yè)務(wù)需求的OpenAPI：云服務(wù)商原則上應(yīng)該提供和控制臺能力完全對等的OpenAPI原子能力，而每個OpenAPI都具備詳細的文檔，包括API的功能描述、業(yè)務(wù)參數(shù)、錯誤碼等信息。開發(fā)者通過平臺提供的API探索工具或查閱文檔來選定符合需求的OpenAPI。

2. 評估自身業(yè)務(wù)場景與能力支撐：哪部分業(yè)務(wù)自動化？開發(fā)資源投入成本？業(yè)務(wù)技術(shù)架構(gòu)是否符合標準？開發(fā)者在實際業(yè)務(wù)場景中權(quán)衡取舍，通過OpenAPI找到云業(yè)務(wù)自動化、效率、投入成本與產(chǎn)出之間的最優(yōu)解。

OpenAPI的調(diào)試與集成

1. 調(diào)試OpenAPI：測試OpenAPI的請求以驗證其是否滿足業(yè)務(wù)需求，以確保API功能符合預(yù)期、響應(yīng)穩(wěn)定、設(shè)計規(guī)范，更是為了準備更深一步的集成與穩(wěn)定上線。在OpenAPI調(diào)試過程中，通常需要學(xué)習參數(shù)結(jié)構(gòu)、參數(shù)組合、Endpoint規(guī)范、報錯原因診斷等等。通過云廠商官方提供的API調(diào)試工具可以最大化開箱即用的體驗。

2. 選擇合適的原生開發(fā)工具：云廠商面向不同的階段、場景、能力的開發(fā)者提供了諸多一方工具，選擇合適的開發(fā)工具可以極大的提升OpenAPI的使用效率。例如，SDK降低了開發(fā)者需要編寫復(fù)雜的代碼來實現(xiàn)調(diào)用API的成本，而無需了解底層的實現(xiàn)細節(jié)；CLI用于通過命令行界面管理和操作云資源；Terraform用于管理復(fù)雜的基礎(chǔ)設(shè)施環(huán)境，跨多個云服務(wù)提供商、多個地域、多個賬號等。

3. 遵循OpenAPI供應(yīng)商的要求：根據(jù)流控配額等相關(guān)的服務(wù)端限制，合理管控API調(diào)用量，避免超額調(diào)用導(dǎo)致的額外費用或服務(wù)中斷，或根據(jù)業(yè)務(wù)流量估算，提前規(guī)劃配額提升或限流容災(zāi)方案。

OpenAPI的運維與治理

1. 關(guān)注API變更與版本迭代升級：持續(xù)關(guān)注API的變更與新發(fā)布便于及時根據(jù)API的變化而做出業(yè)務(wù)響應(yīng)。同時在必要時快速調(diào)整代碼提升服務(wù)可用率，降低可能出現(xiàn)有損變更帶來的業(yè)務(wù)穩(wěn)定性負面影響。

2. 跟蹤調(diào)用日志與錯誤信息：

   • 所有OpenAPI的請求都是可被審計的，API網(wǎng)關(guān)可以記錄、存儲和查詢API的請求和響應(yīng)信息。這些信息包括請求和返回參數(shù)、請求時間、狀態(tài)碼、響應(yīng)時間等，可以用于監(jiān)控API的性能和安全性。

   • 通過API的調(diào)用記錄，可以幫助開發(fā)者了解API的使用情況，為API的優(yōu)化和改進提供參考。此外，這部分審計信息還可以用于追蹤API的訪問記錄，幫助企業(yè)合規(guī)管理，保證API的安全性，協(xié)助企業(yè)進行應(yīng)急響應(yīng)和安全排查。關(guān)注API的請求日志是保證API安全和優(yōu)化API使用的重要手段之一。

通過資源化方式集成云服務(wù)

通過OpenAPI的方式集成云服務(wù)往往會遇到以下挑戰(zhàn)：

• API數(shù)量多：隨著阿里云服務(wù)不斷更新和擴展，API的數(shù)量也越來越多。這是一件好事情，說明阿里云的服務(wù)能力在不斷增強。但對于開發(fā)者來說，需要花費更多的時間和精力來學(xué)習和理解各種API的用法和功能，同時也需要更多的測試和調(diào)試，以確保集成的正確性和穩(wěn)定性。

• 集成復(fù)雜：阿里云服務(wù)的不斷增加和更新，也意味著集成的復(fù)雜性也在不斷增加。開發(fā)者需要考慮如何將多個API集成在一起，如何處理各種數(shù)據(jù)格式和協(xié)議的轉(zhuǎn)換，以及如何處理異常情況等。這些都需要耗費更多的時間和精力。

• 維護困難：隨著API的增加和集成的復(fù)雜性增加，維護也變得更加困難。開發(fā)者需要時刻保持對阿里云服務(wù)的了解和掌握，以及對集成的系統(tǒng)進行監(jiān)控和維護。同時，如果阿里云服務(wù)發(fā)生變化，開發(fā)者也需要及時更新和調(diào)整集成系統(tǒng)，以確保系統(tǒng)的穩(wěn)定性和可用性。這些都需要很高的技術(shù)能力和精力投入。

在云上，推薦使用資源化的方式集成云服務(wù)，降低集成成本。具體的實現(xiàn)手段主要有以下兩種：

云控制API

云控制 API（Cloud Control API）提供阿里云面向資源的企業(yè)級集成一站式解決方案. 降低企業(yè)和生態(tài)伙伴提高集成效率, 降低維護成本。高階開發(fā)者需要一套標準化API來避免對多種云服務(wù)的OpenAPI業(yè)務(wù)差異化的理解成本，并能夠在后續(xù)運維過程中保持持續(xù)集成狀態(tài)。

云控制 API是一款免費的OpenAPI開發(fā)者工具套件。讓開發(fā)者能夠使用一致的CreateResource、UpdateResource、 ListResources、DeleteResource 和一個開發(fā)者工具包來管理和集成阿里云上百款產(chǎn)品。通過云控制API，開發(fā)者可以通過CRUDL的標準化API和1個SDK即可集成上百款阿里云服務(wù)。 這也意味著當增加新產(chǎn)品或新特性的時候，可以用近乎0的學(xué)習成本和開發(fā)成本即可快速持續(xù)集成云上業(yè)務(wù)。

Terraform

Terraform是一款流行的基礎(chǔ)設(shè)施即代碼工具，可以編寫可復(fù)用的代碼模塊，簡化重復(fù)性工作。支持多云平臺，可在多個云服務(wù)商的云平臺上部署基礎(chǔ)設(shè)施。通過Terraform語言描述的代碼可讀性高，易于維護。并在代碼化過程中支持模擬環(huán)境，可以在本地或者CI/CD環(huán)境中測試基礎(chǔ)設(shè)施代碼。而且Terraform社區(qū)活躍，擁有大量的第三方模塊和插件。

但企業(yè)同時也要關(guān)注其帶來的一些諸如配置復(fù)雜、學(xué)習成本高、大規(guī)模部署速度慢等一些限制條件。 在進行技術(shù)路徑選擇的時候需要權(quán)衡學(xué)習成本和部署速度等因素。 在組織內(nèi)推廣這些方式時，往往會受到一些阻力?；诖罅靠蛻魧嵺`，推薦從以下幾個方面入手：

轉(zhuǎn)變思維方式

如果團隊成員已經(jīng)習慣了手動管理基礎(chǔ)設(shè)施，他們更傾向于直接實施所有變更。例如，他們可能會通過SSH連接到服務(wù)器并執(zhí)行一些命令。然而，遷移到基礎(chǔ)設(shè)施即代碼則需要改變思維方式，因為現(xiàn)在更改是通過間接方式進行的：首先編輯代碼并提交，然后讓某些自動化過程來部署更改。此新增加的“間接方式”可能會受到團隊成員的抵觸。對于簡單的任務(wù)而言，這種方式可能比直接實施部署更為緩慢，尤其是在團隊成員仍在學(xué)習新的自動化工具的初期，差距更加明顯。

升級開發(fā)模式

面向過程到面向?qū)ο蟮拈_發(fā)模式升級；與龐大的OpenAPI細粒度集成體驗不同，資源化的設(shè)計理念初衷是降低開發(fā)者理解OpenAPI之間關(guān)系的成本。組織不論是自己封裝資源對象，還是通過云服務(wù)商提供的一套描述性的、面向?qū)ο蟮慕y(tǒng)一的界面/產(chǎn)品都是可以的。

提升開發(fā)效率

將業(yè)務(wù)抽象成基礎(chǔ)設(shè)施代碼，意味著運維團隊需要花費大部分時間來編寫大量代碼，如業(yè)務(wù)模塊、測試模塊等。盡管有些運維工程師喜歡編碼且樂于接受改變，但其他工程師可能會發(fā)現(xiàn)這是一個艱難的任務(wù)。許多運維工程師和系統(tǒng)管理員已經(jīng)習慣了手動進行更改，偶爾會寫一些簡短的腳本，但接近全職地進行軟件開發(fā)工作，可能需要學(xué)習新的技能或需要直接雇用新人。

降低學(xué)習成本

組織如果通過自己基于云服務(wù)提供方的OpenAPI提升集成效率/降低學(xué)習成本，是一個費時費力且收益不高的方式?？梢圆捎迷品?wù)商直接提供的資源化集成能力（如：云控制API、CADT、ROS等）；也可以采用開源社區(qū)的熱度較高的產(chǎn)品（如：Terrafrom、Ansible等）來直接減少這一環(huán)。

與此同時，對于內(nèi)部常見的集成問題，通過知識記錄、分享、培訓(xùn)等多種形式也可以有效提升學(xué)習效率和效果。