使用 Azure 和 SwaggerHub 進行 API 管理

  2016 年 8 月 25 日

Gartner 預測,到 2020 年,前 100 大軟體供應商中有 30% 將採用純雲端模式,而雲端很快將成為軟體應用程式的預設部署模式。考慮到雲端基礎架構可帶來的優勢,例如更好的軟體整合、可擴展性、易於存取和低成本等,這並不令人意外。組織和團隊現在正迅速切換到使用 IaaS 和 PaaS 工具的雲端基礎架構和部署模型,而不是在未來才被迫「趕上」。Microsoft Azure 就是這樣一個用於建置、部署和管理應用程式的雲端運算和基礎架構平台。Azure 的 API 管理系統讓使用者可以管理和監控 API 程式,將它們公開給合作夥伴和消費者,同時靈活地隨著傳入的負載進行擴展。使用 Azure 的 API 管理系統的最大優勢是,它可讓您將後端服務與任何技術堆疊連接,同時提供豐富、近乎即時的分析,以及具有自動產生模擬、程式碼片段和 API 目錄的健全開發人員入口網站。 azure image 利用 Azure API 功能最有效的方式是透過 Swagger。這就是 SwaggerHub 在最新的 Azure API 管理整合中可以提供協助的地方!透過此整合,您可以在 SwaggerHub 上設計 API 並管理其基礎架構,利用其強大的 API 開發功能,同時在 Azure API 入口網站中部署並保持同步。

運作方式

若要使用 Microsoft Azure API 管理整合,您需要一個 Azure 帳戶,以及一個在 Azure 雲端上執行的 API 管理服務實例。就像 SwaggerHub 上的其他整合,例如 GitHub SyncSmartBear VirtServerAmazon Gateway 一樣,Microsoft Azure 整合可以從 API 的右上角新增。 管理整合 新增後,可以設定下列欄位,以允許 SwaggerHub 將定義與 Azure API 管理平台同步。

    • 名稱:整合的名稱,將顯示在 SwaggerHub 中。
    • Azure API 管理服務實例名稱:這是 Azure 上 API 管理實例的名稱,SwaggerHub 會將定義匯出到其中。如需更多資訊,請參閱這裡。
    • Azure API 識別碼:這是一個選填欄位,可讓您將 Azure 上現有的 API 與 SwaggerHub API 定義同步。這需要 Azure 上現有 API 的唯一識別碼。
    • 管理 API 存取權杖:用於提供安全存取 Azure API 閘道的存取權杖。如需產生存取權杖的資訊,請參閱這裡。

azure integration 就是這樣!現在,每次您在 SwaggerHub 上儲存 API 時,定義都會在 Azure API 閘道上同步和更新。若要查看整合的實際運作情形,請查看這段簡短的螢幕錄影!

最後說明

成功設計、部署和管理 API 需要許多工具和服務,這些工具和服務觸及軟體應用程式開發流程的不同方面。SwaggerHub 現在可以作為您 API 定義的集中式資訊來源,同時使其與 GitHub 或 BitBucket 等原始碼控制工具保持同步,使用 Webhooks 觸發建置流程中的事件,最後使用 Azure API 管理或 AWS Lambda 整合部署和管理 API 的後端。立即在 SwaggerHub 上試用!如果您對新的整合有任何建議,或希望看到您的產品與 SwaggerHub 整合,請在這裡提出功能要求。