IBM Bluemix API Connect
Chang-Yen Huang
Bluemix 上有非常多的服務,但若是想在Bluemix 上使用現有的 API 服務,或是想建立自己的 API 在 Bluemix 上該怎麼辦呢 ?
概觀 Bluemix API Connect 是將 IBM API Management 與
IBM Strongloop 整合的服務
API Management 提供建立、執行、管理 API 及建立安全性認證等服務
Strongloop 是 Node.js 的 Framework ,可以直觀且快速的在 Node 中開發 REST API ,並建立或連接到資料庫
概觀 使用 Strongloop 跟隨指示建立 Loopback Application
概觀 使用 Strongloop 建立 Loopback Application 後即可開
啟 API Designer 對 API 做詳細的控管並測試及發佈 API
若要建立 Strongloop 應用程式可參考此網頁教學
也可以使用 API Manager 將既有的 API 服務連結至 Bluemix 做管理
概觀
建置步驟
系統需求
安裝需求的軟體後於 Bluemix Catalog 自訂 API 中選擇並建立 API Connect
開啟命令提示字元,然後輸入下列指令安裝 API Connect Developer Toolkit:npm install -g apiconnect
建立 API Connect LoopBack 應用程式 :apic loopback 輸入完後將會出現以下畫面,隨著指示輸入名稱並選擇 hello-world
以建立範例程式
輸入指令以切換工作目錄 : cd demo 輸入以下指令以開啟 API Designer : apic edit API Designer 是 Developer Toolkit 內的圖形使用者介面,並提
供建立及配置 API 、離線執行的功能。
輸入 Bluemix 帳號以登入 API Designer
登入後即可看到方才建立的 API
按一下發佈 > 新增及管理目標 > 新增 IBM Bluemix 目標。
選取您要在其中發佈的 Bluemix 地區,並登入 API Connect 。 選取 Bluemix 組織。 顯示型錄清單。選取 Sandbox 。 按下一步。
在「選取 Bluemix 應用程式」視窗中,鍵入 "demo-application" ,然後按一下新增圖示。 即會顯示 API 頁面。
按一下 demo-application ,然後按一下儲存。 即會顯示主視窗。
按一下發佈,然後選取您剛剛新增的目標。 即會顯示「發佈選項」視窗。
選取發佈應用程式。此選項會在 Bluemix 上建立 NodeJS 應用程式。
按一下發佈。
已啟動 API Designer 的主控台會顯示數個訊息。如果已順利發佈應用程式,則最終訊息會與下列類似:
記下此資訊。
接下來,您必須使用發佈期間所傳回的值來修改「產品」定義。 在 API Designer 使用者介面中,按一下 API 。 選取 demo 。 按一下組合。 在「組合」編輯器中,按一下過濾器原則圖示。 選取 DataPower 閘道原則。 按兩下呼叫。
使用剛才所擷取的值,來更新下列欄位。 插入 API 目標 URL 。您必須指定安全通訊協定 HTTPS 。例如:
插入 API 呼叫 tls-profile 。例如:
按一下儲存,以儲存 API 。
按一下發佈,然後選取下列選項: 編譯打包或發佈產品:選取此項目,您可以選擇僅編譯打包或發佈
「產品」,並建立它與應用程式的關聯。 選取特定產品 Demo
API Manager 可讓您發佈 API 產品,因此應用程式開發人員可以進行存取。您也可以使用 API Manager 來管理 API ,方法是配置鑑別測量、設定速率限制,以及強制執行原則。
使用 API Manager 發佈 API
於 API Connect 中啟動 API Manager 要連結既有的 API 服務至 Bluemix 則可直接匯入 Swagger
檔建立,並使用 API Manager 做控管及測試
進入 API Manager 候選擇選單中的草稿
選擇 API > 新增 > 匯入 Swagger 2.0 並選擇在前一節中建立的 demo.yaml 檔案demo.yaml 位於 Strongloop 建立的資料夾目錄中的 Definitoins 中
選擇產品 > 新增 > 新建產品在標題欄位中,鍵入 "New-Demo-Product"
於左側選擇 API 欄位
點選新增 API 至產品
於 API處點選新增 API 至產品
選擇剛才建立的 demo API
1. 選擇計劃的預設方案
2. 將方案的名稱變更為 “ Our-Demo-Plan“ ,並確定已選取 demo API
3. 設定完成後點選右上角儲存
於左側選單選擇儀表板後點選新增 > 新增型錄
將型錄命名為 "Our Demo Catalog"
選擇 Our Demo Catalog 並點選設定分頁
選擇入口網站並將入口往站配置更改為 IBM Developer Portal
將使用者登錄改為 SAML
選擇開發人員分頁後新增 Bluemix 組織新增 Bluemix 使用者 E-Mail
回到草稿 > 產品 >New-Demo-Product於右上角點選發佈到 Our Demo Catalog回到 Our Demo Catalog 即可看到發佈的產品於產品右邊選單中點選發佈
於彈出的視窗中的對象選擇自定 > 自行輸入欲允許的使用對象帳號
發佈完成後“ demo” 產品即會處於「已發佈」狀態回到 Bluemix 「儀表板」,您將會看到在 Bluemix 中執行的 "demo-application“
"demo" 產品會發佈至 Our Demo Catalog 。登入 Bluemix 組織的所有人都可以訂閱它,而且它可供指定的組織或社群使用。所選取群組內的應用程式開發人員可以在「產品」內看到及使用 API 。