すべてのプロダクト
Search
ドキュメントセンター

Alibaba Cloud Service Mesh:ASM CLI のインストールと使用

最終更新日:Jan 13, 2025

ASM CLI はコマンドラインツールです。aliyun servicemesh コマンドを ASM CLI で実行して、Service Mesh(ASM)が外部アクセスに提供するすべての API 操作を呼び出すことができます。

背景情報

ASM CLI は Alibaba Cloud Command Line Interface(CLI)に統合されています。統合された aliyun-cli リリースパッケージ をダウンロードすることで、最新バージョンの ASM CLI を取得できます。

ASM CLI のインストールと初期化

  1. ASM CLI をインストールします。

    1. 次のコマンドを実行して、ASM CLI のバージョンを指定します。この例では、最新バージョン 3.0.214 を使用しています。

      VERSION=3.0.214
    2. 次のコマンドを実行して、ASM CLI をダウンロードします。

      wget "https://github.com/aliyun/aliyun-cli/releases/download/v${VERSION}/aliyun-cli-linux-${VERSION}-amd64.tgz"
    3. 次のコマンドを実行して、ASM CLI を解凍します。

      tar xzvf aliyun-cli-linux-${VERSION}-amd64.tgz
    4. 次のコマンドを実行して、ASM CLI をインストールします。

      sudo mv aliyun /usr/local/bin
    5. 次のコマンドを実行して、ASM CLI がインストールされているかどうかを確認します。

      aliyun version 

      期待される出力:

      3.0.214

      ASM CLI のバージョンを示すメッセージが返された場合、ASM CLI はインストールされています。

  2. ASM CLI を初期化します。

    1. 次のコマンドを実行して、ASM CLI を初期化します。

      aliyun configure
    2. 次のコマンドを実行して、Alibaba Cloud アカウントの AccessKey ID を指定します。ACCESS_KEY_ID を Alibaba Cloud アカウントの AccessKey ID に置き換えます。

      Access Key Id []: {ACCESS_KEY_ID}
    3. 次のコマンドを実行して、Alibaba Cloud アカウントの AccessKey シークレットを指定します。ACCESS_KEY_SECRET を Alibaba Cloud アカウントの AccessKey シークレットに置き換えます。

      Access Key Secret []: {ACCESS_KEY_SECRET}
    4. 次のコマンドを実行して、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

    5. 次のコマンドを実行して、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"
      }
    }
  }
}