ASM CLI はコマンドラインツールです。aliyun servicemesh コマンドを ASM CLI で実行して、Service Mesh(ASM)が外部アクセスに提供するすべての API 操作を呼び出すことができます。
背景情報
ASM CLI は Alibaba Cloud Command Line Interface(CLI)に統合されています。統合された aliyun-cli リリースパッケージ をダウンロードすることで、最新バージョンの ASM CLI を取得できます。
ASM CLI のインストールと初期化
ASM CLI をインストールします。
次のコマンドを実行して、ASM CLI のバージョンを指定します。この例では、最新バージョン 3.0.214 を使用しています。
VERSION=3.0.214次のコマンドを実行して、ASM CLI をダウンロードします。
wget "https://github.com/aliyun/aliyun-cli/releases/download/v${VERSION}/aliyun-cli-linux-${VERSION}-amd64.tgz"次のコマンドを実行して、ASM CLI を解凍します。
tar xzvf aliyun-cli-linux-${VERSION}-amd64.tgz次のコマンドを実行して、ASM CLI をインストールします。
sudo mv aliyun /usr/local/bin次のコマンドを実行して、ASM CLI がインストールされているかどうかを確認します。
aliyun version期待される出力:
3.0.214ASM CLI のバージョンを示すメッセージが返された場合、ASM CLI はインストールされています。
ASM CLI を初期化します。
次のコマンドを実行して、ASM CLI を初期化します。
aliyun configure次のコマンドを実行して、Alibaba Cloud アカウントの AccessKey ID を指定します。ACCESS_KEY_ID を Alibaba Cloud アカウントの AccessKey ID に置き換えます。
Access Key Id []: {ACCESS_KEY_ID}次のコマンドを実行して、Alibaba Cloud アカウントの AccessKey シークレットを指定します。ACCESS_KEY_SECRET を Alibaba Cloud アカウントの AccessKey シークレットに置き換えます。
Access Key Secret []: {ACCESS_KEY_SECRET}次のコマンドを実行して、ASM CLI を使用するリージョンを指定します(例:cn-hangzhou)。
Default Region Id []: cn-hangzhou表 1. 利用可能なリージョン
リージョン
リージョン ID
エンドポイント
中国 (杭州)
cn-hangzhou
https://servicemesh.aliyuncs.com
中国 (北京)
cn-beijing
中国 (上海)
cn-shanghai
米国 (シリコンバレー)
us-west-1
シンガポール
ap-southeast-1
中国 (深圳)
cn-shenzhen
中国 (張家口)
cn-zhangjiakou
次のコマンドを実行して、ASM CLI で使用する言語を指定します。
Default Output Format [json]: json (Only support json) Default Language [zh|en] en: en
ASM CLI の使用
ASM のすべての API 操作については、機能別の操作一覧 をご参照ください。次の例では、DescribeServiceMeshDetail 操作を呼び出して、ASM CLI の使用方法を示します。DescribeServiceMeshDetail 操作は、ASM インスタンスの詳細を照会するために使用されます。次のコードでは、ServiceMeshId パラメーターを照会する ASM インスタンスの ID に設定します。
aliyun servicemesh DescribeServiceMeshDetail --ServiceMeshId c9e8589cc0afa430c80bc1541b6d6xxxx{
"RequestId": "fac9c43c-0f78-45a9-b212-b48c9c4fxxxx",
"ServiceMesh": {
"Clusters": [
"c4d810b9cc91e4170958c674419c2xxxx"
],
"Endpoints": {
"IntranetApiServerEndpoint": "https://192.168.0.xxx:6443",
"IntranetPilotEndpoint": "192.168.0.xxx:15012",
"PublicApiServerEndpoint": "https://39.105.207.xxx:6443",
"PublicPilotEndpoint": "39.105.121.xxx:15012"
},
"ServiceMeshInfo": {
"CreationTime": "2020-08-03T15:39:45+08:00",
"ErrorMessage": "",
"Name": "bj",
"RegionId": "cn-beijing",
"ServiceMeshId": "c9e8589cc0afa430c80bc1541b6d6xxxx",
"State": "running",
"UpdateTime": "2020-09-08T14:20:33+08:00",
"Version": "v1.6.8.0-g36ddadd7-aliyun"
},
"Spec": {
"LoadBalancer": {
"ApiServerLoadbalancerId": "lb-2ze3ng35hedvvsnfkxxxx",
"ApiServerPublicEip": true,
"PilotPublicEip": true,
"PilotPublicLoadbalancerId": "lb-2zenjnpcwgm99ecr0xxxx"
},
"MeshConfig": {
"Audit": {
"Enabled": true,
"Project": "mesh-log-c9e8589cc0afa430c80bc1541b6d6xxxx"
},
"CustomizedZipkin": false,
"EnableLocalityLB": false,
"IncludeIPRanges": "*",
"OPA": {
"Enabled": false
},
"OutboundTrafficPolicy": "ALLOW_ANY",
"Pilot": {
"TraceSampling": 100
},
"Telemetry": true,
"Tracing": true
},
"Network": {
"SecurityGroupId": "sg-2zegx3q19bmgefu0xxxx",
"VSwitches": [
"vsw-2zergbfy911jjxkiwxxxx"
],
"VpcId": "vpc-2zebfarsa6f57itxfxxxx"
}
}
}
}