集成概覽
本文介紹了容器鏡像服務(wù)ACR的使用方法，包括通過(guò)可視化界面、OpenAPI在線調(diào)試、阿里云SDK、Terraform以及資源編排（ROS）等方式進(jìn)行調(diào)用。
OpenAPI介紹
為了能夠讓開(kāi)發(fā)者快速高效地學(xué)習(xí)和使用云產(chǎn)品OpenAPI，阿里云為用戶提供OpenAPI網(wǎng)站。它是一款集OpenAPI智能搜索、文檔、在線調(diào)試、SDK獲取、CodeSample、調(diào)用出錯(cuò)診斷、調(diào)用統(tǒng)計(jì)為一體的產(chǎn)品。您可以在OpenAPI門(mén)戶中調(diào)用阿里云各云產(chǎn)品開(kāi)放的OpenAPI，查看OpenAPI請(qǐng)求和返回結(jié)果。此外，OpenAPI門(mén)戶會(huì)自動(dòng)生成相應(yīng)的SDK調(diào)用示例，幫助您快速使用阿里云產(chǎn)品。更多信息，請(qǐng)參見(jiàn)什么是OpenAPI。
版本說(shuō)明
API 版本號(hào) | 說(shuō)明 |
推薦使用 |
在線調(diào)試
容器鏡像服務(wù)在OpenAPI門(mén)戶提供API調(diào)試等功能。在調(diào)用前，您需要了解容器鏡像提供的版本、接入點(diǎn)說(shuō)明、集成方式等信息。
調(diào)試入口
調(diào)試API入口為：https://next.api.aliyun.com/api/cr/2018-12-01/GetInstance
接入點(diǎn)說(shuō)明
本產(chǎn)品在多個(gè)地域均部署管控服務(wù)，可使用Region化域名，格式為cr.{regionId}.aliyuncs.com。如果想要獲得更快的響應(yīng)速度，也可使用VPC域名，格式為cr-vpc.{regionId}.aliyuncs.com。更多接入點(diǎn)信息請(qǐng)參見(jiàn)服務(wù)接入點(diǎn)。
用戶身份
您阿里云賬號(hào)登錄OpenAPI網(wǎng)站后，OpenAPI默認(rèn)使用您的阿里云賬號(hào)進(jìn)行在線OpenAPI調(diào)試。阿里云賬號(hào)擁有所有API的訪問(wèn)權(quán)限，風(fēng)險(xiǎn)很高。強(qiáng)烈建議您創(chuàng)建并使用RAM用戶進(jìn)行API訪問(wèn)或日常運(yùn)維。請(qǐng)根據(jù)業(yè)務(wù)的實(shí)際情況按需分配權(quán)限后進(jìn)行接口調(diào)用。RAM用戶需具備操作容器鏡像資源的權(quán)限。具體操作，請(qǐng)參見(jiàn)授予RAM用戶系統(tǒng)策略。
用戶身份 | 支持情況 |
支持 | |
RAM 用戶（推薦） | 支持 |
RAM角色（推薦） | 支持 |
集成方式
SDK是最易于集成，且支持度最好的OpenAPI調(diào)用方式，推薦您選擇使用SDK。
集成方式總覽
調(diào)用方式 | 支持情況 |
阿里云SDK（推薦） | 支持 |
支持 | |
支持 | |
支持 | |
支持 |
阿里云 SDK
阿里云為開(kāi)發(fā)者提供了多種編程語(yǔ)言（Java、C#、Go、Python、Node.js/TypeScript、PHP、C++ 等）的SDK。開(kāi)發(fā)者只需要集成SDK，通過(guò)SDK暴露的方法直接調(diào)用OpenAPI 。SDK統(tǒng)一封裝了簽名邏輯、超時(shí)機(jī)制、重試機(jī)制，并根據(jù)文檔返回結(jié)構(gòu)化Response對(duì)象，易于開(kāi)發(fā)。更多關(guān)于阿里云SDK的介紹，請(qǐng)參見(jiàn)阿里云SDK。
支持在OpenAPI通過(guò)阿里云SDK調(diào)用容器鏡像服務(wù)。支持語(yǔ)言及依賴安裝方法請(qǐng)參見(jiàn)容器鏡像服務(wù)SDK。
阿里云CLI
阿里云命令行工具可以幫您在使用命令行終端時(shí)，使用aliyun命令與阿里云服務(wù)進(jìn)行交互，管理云服務(wù)資源。有關(guān)阿里云CLI的更多詳細(xì)信息，請(qǐng)參見(jiàn)什么是阿里云CLI。
Terraform
Terraform 是一種開(kāi)源工具，用于安全高效地預(yù)覽，配置和管理云基礎(chǔ)架構(gòu)和資源。它與阿里云的資源編排服務(wù)的運(yùn)行機(jī)制類似，通過(guò)將模板轉(zhuǎn)化為內(nèi)部數(shù)據(jù)后完成OpenAPI調(diào)用。更多詳情，請(qǐng)參見(jiàn)什么是Terraform。
快速使用Terraform編排容器鏡像服務(wù)，請(qǐng)參見(jiàn)Terraform集成示例。
Terraform支持ACR的資源編排如下。
資源名稱
描述
創(chuàng)建容器鏡像服務(wù)企業(yè)版的同步規(guī)則。
創(chuàng)建容器鏡像服務(wù)企業(yè)版實(shí)例。
創(chuàng)建容器鏡像服務(wù)企業(yè)版命名空間。
創(chuàng)建容器鏡像服務(wù)企業(yè)版鏡像倉(cāng)庫(kù)。
鏡像流水線資源配置。
Chart命名空間資源配置。
Chart倉(cāng)庫(kù)資源配置。
管理網(wǎng)絡(luò)訪問(wèn)控制。
容器鏡像服務(wù)企業(yè)版與VPC集成配置。
自定義封裝API調(diào)用
原生HTTP調(diào)用需要您自己實(shí)現(xiàn)簽名算法，并構(gòu)建自定義請(qǐng)求，發(fā)起HTTP調(diào)用。有關(guān)簽名機(jī)制的更多詳細(xì)信息，請(qǐng)參見(jiàn)自定義HTTP封裝。