クラウドアシスタントクライアントは、ECS インスタンス上でクラウドアシスタントスクリプトを実行するために使用します。 このトピックでは、クラウドアシスタントクライアントのインストール方法を説明します。

始める前に

  • 管理者としてクラウドアシスタントクライアントをインストールおよび管理する必要があります。 管理者のユーザー名は、Linux インスタンスの場合は root で、Windows インスタンスの場合は system です。
  • クラウドアシスタントクライアントをインストールする前に、インスタンスタイプとオペレーティングシステムがクラウドアシスタントをサポートしていることを確認してください。 詳細については、「クラウドアシスタント」の『利用制限』のセクションをご参照ください。

このタスクについて

2017 年 12 月 2 日以降にパブリックイメージから作成された ECS インスタンスには、クラウドアシスタントクライアントがプレインストールされています。 2017 年 12 月 1 日以前に作成された ECS インスタンスの場合、クラウドアシスタントクライアントを手動でインストールする必要があります。
このトピックでは、3 つのインストール方法を説明します。

ダウンロードリンクからクライアントをインストールする (Windows インスタンス)

  1. システムユーザーとして ECS インスタンスにリモート接続を確立します。 詳細については、「概要」をご参照ください。
  2. クラウドアシスタントインストールファイルをダウンロードします。 ダウンロードリンク: クラウドアシスタントクライアント
  3. インストールファイルをダブルクリックし、手順に従ってクライアントをインストールします。
    Windows インスタンスのデフォルトのインストールパスはC:\ProgramData\aliyun\assist\です。
  4. インスタンスがクラシックネットワークにある場合、インストールディレクトリにregion-idという名のファイルを作成します。 ファイルには、.txtまたは.confなどの拡張子を加えないでください。 region-idファイルにはcn-hangzhouなどインスタンスのリージョン ID を入力します。 リージョン ID の詳細については、「リージョンとゾーン」をご参照ください
    Windows では、region-idファイルに拡張子が付いているかどうかを確認する場合、既知のファイルタイプの拡張子を隠す機能を無効にする必要があります。

ダウンロードリンクからクライアントをインストールする (Linux インスタンス)

インスタンスのオペレーティングシステムに基づいて、次のクラウドアシスタントクライアントのインストール方法からいずれか 1 つを選択します。
  • RPM パッケージを使用してクライアントをインストールします。 この方法は、CentOS、Red Hat Enterprise Linux (RHEL)、および SUSE Linux などのオペレーティングシステムに適用できます。
    1. クラウドアシスタントクライアントの RPM パッケージをダウンロードします。
      wget "https://aliyun-client-assist.oss-accelerate.aliyuncs.com/linux/aliyun_assist_latest.rpm"
    2. クラウドアシスタントクライアントをインストールします。
      rpm -ivh --force aliyun_assist_latest.rpm
    3. インスタンスのオペレーティングシステムが Red Hat の場合、次の手順を実行します。
      1. qemu-ga サービスを停止します。
        systemctl stop qemu-guest-agent
        systemctl disable qemu-guest-agent
      2. クラウドアシスタントを再起動します。
        systemctl restart aliyun.service
    4. インスタンスがクラシックネットワークにある場合、 インストールディレクトリにregion-idという名のファイルを作成します。 ファイルには、.txtまたは.confなどの拡張子を加えないでください。 region-idファイルにはcn-hangzhouなどインスタンスのリージョン ID を入力します。 リージョン ID の詳細については、「リージョンとゾーン」をご参照ください
  • Debian パッケージを使用してクライアントをインストールします。 この方法は、Debian や Ubuntu などのオペレーティングシステムに適用できます。
    1. クラウドアシスタントクライアントの Debian パッケージをダウンロードします。
      wget "https://aliyun-client-assist.oss-accelerate.aliyuncs.com/linux/aliyun_assist_latest.deb"
    2. 必要に応じて設定します。 クラウドアシスタントクライアントの以前のバージョンをアンインストールします。
      dpkg -r aliyun-assist
    3. クラウドアシスタントクライアントをインストールします。
      dpkg -i aliyun_assist_latest.deb
    4. インスタンスがクラシックネットワークにある場合、 インストールディレクトリにregion-idという名のファイルを作成します。 ファイルには、.txtまたは.confなどの拡張子を加えないでください。 region-idファイルにはcn-hangzhouなどインスタンスのリージョン ID を入力します。 リージョン ID の詳細については、「リージョンとゾーン」をご参照ください
  • ソースコードをコンパイルしてクライアントをインストールします。
    1. クラウドアシスタントクライアントのソースコードをダウンロードします。
      git clone https://github.com/aliyun/aliyun_assist_client
    2. ソースコードディレクトリにアクセスします。
    3. cmake .コマンドを実行し、コンパイルファイルを生成します。
      コンパイル中にCMAKE_MINIMUM_REQUIREDエラーの報告があった場合、 CMake の公式ウェブサイトに移動し、CMake サービスを V3.1 以降に更新します。
    4. makeコマンドを実行してコンパイルをスタートします。
    5. インスタンスがクラシックネットワークにある場合、 インストールディレクトリにregion-idという名のファイルを作成します。 ファイルには、.txtまたは.confなどの拡張子を加えないでください。 region-idファイルにはcn-hangzhouなどインスタンスのリージョン ID を入力します。 リージョン ID の詳細については、「リージョンとゾーン」をご参照ください
    6. aliyun-service -dコマンドを実行してクラウドアシスタントクライアントをインストールします。
次のリストには、Linux インスタンスのデフォルトのインストールパスが示されています。
  • CoreOS: /opt/local/share/aliyun-assist/
  • その他のオペレーティングシステム: /usr/local/share/aliyun-assist/。 その他のオペレーティングシステム: Ubuntu、Debian、Red Hat、SUSE Linux Enterprise Server、openSUSE、Aliyun Linux。

Alibaba Cloud CLI for Windows または Linux インスタンスを使用してクライアントをインストール

Red Hat システムは、API 操作を呼び出して行うインストールをサポートしていません。 ダウンロードリンクを使用した場合のみクライアントをインストールできます。 詳細については、「ダウンロードリンクからクライアントをインストールする (Linux インスタンス)」をご参照ください。
  1. クライアントアシスタントクライアントが ECS インスタンスにインストールされたかどうかを問い合わせるDescribeCloudAssistantStatus操作を呼び出します。
    aliyun ecs DescribeCloudAssistantStatus --RegionId TheRegionId --InstanceId.1 i-bp1g6zv0ce8og******p --output cols=CloudAssistantStatus rows=InstanceCloudAssistantStatusSet.InstanceCloudAssistantStatus[]
    CloudAssistantStatus=trueが返された場合、クラウドアシスタントクライアントはすでにインスタントにインストールされています。 そうでない場合は、次のステップに進みます。
  2. クラウドアシスタントクライアントをインストールするInstallCloudAssistantための操作を呼び出します。
    aliyun ecs InstallCloudAssistant --RegionId TheRegionId --InstanceId.1 i-bp1g6zv0ce8og******p
  3. ECS インスタンスを再起動するためのRebootInstance操作を呼び出します。
    aliyun ecs RebootInstance --InstanceId i-bp1g6zv0ce8og******p
  4. インスタンスがクラシックネットワークにある場合、インスタンス内にリージョン宣言を追加します。
    1. root または system のユーザーとして ECS インスタンスに接続します。 詳細については、「概要」をご参照ください。
    2. クラウドアシスタントのバージョンを表示します。 Linux インスタンスの場合、次ののコマンドを実行します。 Windows インスタンスについては、「 クラウドアシスタントクライアント更新の有効化または無効化」をご参照ください 。
      aliyun-service -v
      クラウドアシスタントのバージョンが V1.0.1.400 以降の場合、クライアントがインストールされています。 それ以外の場合は、次のステップに進みます。
    3. インストールディレクトリにregion-idという名のファイルを作成します。 ファイルには、.txtまたは.confなどの拡張子を加えないでください。 region-idファイルにはcn-hangzhouなどインスタンスのリージョン ID を入力します。 リージョン ID の詳細については、「リージョンとゾーン」をご参照ください
      Windows では、region-idファイルに拡張子が付いているかどうかを確認する場合、既知のファイルタイプの拡張子を隠す機能を無効にする必要があります。