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

Elastic Compute Service:Workbench CLI 認証情報の設定とインストール

最終更新日:Oct 31, 2026

ローカルの Linux、macOS、または Windows マシンに Workbench CLI をインストールした後、最小権限ポリシーを RAM ユーザーにアタッチし、すぐに使用できる認証情報アクセスのために AccessKey を生成して設定します。本番環境では、RamRoleArn、CredentialsCmd、または CredentialsURI に切り替えることで、認証情報の自動更新と最小権限を有効にできます。

制限事項

  • ターゲットインスタンスのオペレーティングシステム:Workbench CLI は、Secure Shell Protocol (SSH) 経由で Linux インスタンスにのみ接続でき、Windows インスタンスには接続できません。

  • ローカルマシンのオペレーティングシステム:Workbench CLI 自体は、Linux、macOS (amd64 / arm64)、および Windows (amd64) で実行されます。

  • ネットワーク接続性:ローカルマシンは、*.aliyuncs.com および Workbench のバックエンド WebSocket エンドポイントにアクセスできる必要があります。

重要

現在、Workbench CLI は Windows インスタンスをサポートしていません。Windows インスタンスに接続するには、「ワークベンチを使用した接続」をご参照ください。

ステップ 1:Workbench CLI のインストール

ローカルマシンのオペレーティングシステムに応じてインストールコマンドを選択します。インストールスクリプトは、アーキテクチャ (amd64 / arm64) を自動的に検出し、OSS CDN からバイナリをダウンロードし、SHA256 チェックサムを検証して、デフォルトのシステムパスにインストールします。

Linux または macOS

次のコマンドを実行して、Workbench CLI の最新バージョンをインストールします。

curl -fsSL https://workbench-cli.oss-cn-hangzhou.aliyuncs.com/install.sh | bash
説明

インストールスクリプトは自動的にチェックサムファイルをダウンロードし、インストールパッケージを検証します。検証に失敗した場合、インストールは中止されます。成功した場合、スクリプトは checksum OK と出力します。

インストール後、バイナリは /usr/local/bin/workbench に配置されます。macOS では、バイナリは自動的に再署名され、隔離属性が削除されます。ターゲットディレクトリに管理者権限が必要な場合、スクリプトは自動的に sudo を使用します。

Windows

PowerShell で次のコマンドを実行して、Workbench CLI の最新バージョンをインストールします。

irm https://workbench-cli.oss-cn-hangzhou.aliyuncs.com/install.ps1 | iex
説明

インストールスクリプトは自動的にチェックサムファイルをダウンロードし、インストールパッケージを検証します。検証に失敗した場合、インストールは中止されます。成功した場合、スクリプトは checksum OK と出力します。

インストール後、バイナリは C:\Program Files\workbench\ に配置され、インストールスクリプトは自動的に PATH 環境変数を設定します。デスクトップまたは Remote Desktop Protocol (RDP) セッションでインストールする場合、PATH はサインアウトして再度サインインした後にのみ有効になります。

インストールパッケージが他のチャネル (オフラインパッケージや内部ミラーなど) から取得された場合は、インストール前にインストールパッケージを検証して、その整合性とセキュリティを確保してください。

インストールの確認

インストール後、次のコマンドを実行して確認します。

workbench version

通常、現在のバージョン番号、コミット ID、ビルド日が出力されます。command not found と表示された場合は、通常、PATH が有効になっていないことが原因です。次の操作を実行できます。

  • Linux / macOS:ターミナルウィンドウを再度開くか、source ~/.bashrc (または ~/.zshrc) を実行して再試行します。

  • Windows:PowerShell ウィンドウを閉じて再度開き、新しい PATH を有効にします。

ステップ 2:Workbench CLI 用の最小権限を持つ AccessKey の準備

Workbench CLI は、AccessKey を使用して Alibaba Cloud API を呼び出します。このステップの目標は、Workbench CLI が必要とする最小限の権限のみを持つ AccessKey を取得し、次のステップでローカルマシンの CLI に設定できるようにすることです。推奨される手順は次のとおりです:RAM ユーザーの作成 → 最小権限の付与 → RAM ユーザー用の AccessKey の作成。

重要

Alibaba Cloud アカウント (root ユーザー) の AK/SK を使用して CLI を設定しないでください。Alibaba Cloud アカウントの AccessKey は、そのアカウント配下のすべてのクラウドリソースに対する操作権限を持っています。漏洩した場合、すべての資産が公開されます。常に、必要最小限の権限のみを持つ RAM ユーザーの AccessKey を使用してください。

説明

Workbench CLI が必要とする最小権限を満たす RAM ユーザーが既にある場合は、ステップ 1 から 3 をスキップして、ステップ 4:RAM ユーザー用の AccessKey の作成から直接開始してください。

  1. RAM ユーザーの作成。RAM コンソールにログインし、[ID] > [ユーザー] ページに移動します。[ユーザーの作成] をクリックします。作成ページで、[ユーザーログイン名] と [表示名] を入力し、[OK] をクリックします。

    この時点では AccessKey を作成しないでください。AccessKey は、権限付与が完了した後のステップ 4 で作成します。

  2. カスタムポリシーの作成。RAM コンソールで、[権限] > [ポリシー] ページに移動し、[ポリシーの作成] をクリックし、[スクリプトエディター] モードに切り替えて、次の JSON を貼り付け、[OK] をクリックします。

    {
      "Version": "1",
      "Statement": [
        {
          "Effect": "Allow",
          "Action": [
            "ecs-workbench:*"
          ],
          "Resource": "*"
        },
        {
          "Effect": "Allow",
          "Action": [
            "ecs:DescribeInstances",
            "ecs:DescribeCloudAssistantStatus",
            "ecs:StartTerminalSession"
          ],
          "Resource": "*"
        },
        {
          "Effect": "Allow",
          "Action": "ram:CreateServiceLinkedRole",
          "Resource": "*",
          "Condition": {
            "StringEquals": {
              "ram:ServiceName": "workbench.ecs.aliyuncs.com"
            }
          }
        }
      ]
    }

    次の表に、ポリシー内の各アクションの目的を示します。

    アクション

    目的

    ecs:DescribeInstances

    workbench list ecs でインスタンスリストを照会します。

    ecs:DescribeCloudAssistantStatus

    ターゲットインスタンスのクラウドアシスタントエージェントのステータスを確認します。

    ecs:StartTerminalSession

    ECS インスタンスとのターミナルセッションを確立します。

    ecs-workbench:LoginECSInstance

    Workbench チャネルを介したパスワードなしのログイン (connect、exec、upload、download で使用)。

    ecs-workbench:ChatMessages

    セッション内 AI エージェントアシスタント (/agent モード) に必要な権限。

    ecs-workbench:EndSessions

    Workbench セッションを閉じます (session close および自動セッションクリーンアップによって呼び出されます)。

    ram:CreateServiceLinkedRole

    初回使用時に Workbench サービスリンクロールを作成し、Condition を使用して作成を workbench.ecs.aliyuncs.com サービスのサービスリンクロールに制限します。

    上記のポリシーは、デフォルトですべてのインスタンスへのアクセスを許可します。範囲を特定のインスタンスに絞るには、インスタンスレベルの権限付与をサポートする操作に対してのみインスタンス ARN を使用し、必要に応じて Statement を分割して Resource を変更します。

    "Resource": "acs:ecs:<region>:<account-id>:instance/<instance-id>"
    説明

    ecs-workbench:ChatMessages と ram:CreateServiceLinkedRole は、インスタンス ARN による絞り込みをサポートしておらず、"Resource": "*" のままである必要があります。

  3. RAM ユーザーへのポリシーの付与。ステップ 1 で作成した RAM ユーザーの詳細ページに移動し、[権限] タブをクリックします。[権限の付与] をクリックし、前のステップで作成したカスタムポリシーを選択して、権限付与を完了します。手順については、「RAM ユーザーの権限の管理」をご参照ください。

  4. RAM ユーザーの AccessKey の作成。 RAM ユーザーの詳細ページで、[認証情報] > [AccessKey] タブに移動し、[AccessKey の作成] をクリックします。 表示されたページで、[CLI で AccessKey を使用] を選択し、[AccessKey を作成する必要があることを確認します] を選択して、[続行] をクリックします。 詳細については、「AccessKey ペアの作成」をご参照ください。

    重要

    AccessKey Secret は作成時に一度しか表示されず、ページを閉じると二度と表示できません。AccessKey ID と AccessKey Secret は、すぐにパスワードマネージャーやキーストアに保存してください。紛失した場合は、新しい AccessKey ペアを作成するしかありません。

    AccessKey は長期的な認証情報であり、一度漏洩すると長期間悪用される可能性があります。本番環境では、ステップ 3 の設定が完了したらすぐに、RamRoleArn などの自動更新される認証情報モードに切り替えてください。詳細については、「その他の設定方法」セクションをご参照ください。

ステップ 3:ローカル CLI での AccessKey ペアの設定

次のコマンドを実行し、プロンプトに従ってステップ 2 で取得した AccessKey ID と AccessKey Secret を入力します。

workbench config

設定が完了すると、認証情報は ~/.workbench/config.json に保存され、ファイル権限は自動的に 0600 (現在のユーザーのみ読み書き可能) に設定されます。ファイル内容の例:

{
  "current": "default",
  "profiles": {
    "default": {
      "mode": "AK",
      "access_key_id": "LTAI...",
      "access_key_secret": "..."
    }
  }
}

次のコマンドを実行して、接続が機能することを確認します (実際のリージョンに合わせて cn-hangzhou を置き換えてください):

workbench list ecs -r cn-hangzhou

正常な状態では、リージョン内のインスタンスのリストが返されます。InvalidAccessKeyId や NoPermission などのエラーが返された場合は、「よくある質問」セクションをご参照ください。

(オプション) インターフェイス言語の設定

Workbench CLI は、インターフェイス言語として中国語 (zh) と英語 (en) をサポートしています。デフォルトでは、インターフェイス言語は中国語です。次のコマンドを実行して切り替えます。

workbench config set language en   # 英語に切り替える
workbench config set language zh   # 中国語に戻す

また、workbench config のインタラクティブな設定フローで言語を設定したり、~/.workbench/config.json を直接編集して、対応するプロファイルに language フィールドを追加することもできます。

{
  "current": "default",
  "profiles": {
    "default": {
      "mode": "AK",
      "language": "en"
    }
  }
}

変更後、再接続時に有効になります。デーモンを再起動する必要はありません。

(オプション) 複数プロファイルの管理

複数の Alibaba Cloud アカウントまたは複数の認証情報セットを切り替える必要がある場合は、プロファイル機能を使用して、毎回認証情報を再設定する手間を省きます。すべてのプロファイルは同じ ~/.workbench/config.json ファイルに保存され、current フィールドがアクティブなプロファイルを示します。

workbench config --profile prod          # prod プロファイルの作成または編集
workbench config list                    # すべてのプロファイルを一覧表示 (* はアクティブなプロファイルを示す)
workbench config get --profile prod      # 指定したプロファイルの詳細を表示
workbench config switch --profile prod   # アクティブなプロファイルを切り替える
workbench config delete --profile old    # プロファイルを削除 (アクティブなプロファイルは削除不可)
workbench exec -i i-xxx -c "hostname" --profile prod   # このコマンドのみ、指定したプロファイルを使用

複数プロファイルを持つ config.json の例:

{
  "current": "default",
  "profiles": {
    "default": {
      "mode": "AK",
      "access_key_id": "LTAI...",
      "access_key_secret": "..."
    },
    "prod": {
      "mode": "RamRoleArn",
      "access_key_id": "LTAI...",
      "access_key_secret": "...",
      "ram_role_arn": "acs:ram::123456:role/prod",
      "role_session_name": "workbench"
    }
  }
}
説明

設定ファイルがまだ古いフラット形式 (profiles フィールドがない) の場合、CLI は最初の実行時に自動的に新しい形式に移行し、既存の認証情報を default という名前のプロファイルに保存します。手動での操作は不要です。

その他の設定方法

静的な AccessKey は長期的な認証情報であり、一度漏洩すると長期間悪用される可能性があります。本番環境や、より厳しいセキュリティ要件が適用される場合は、他の 6 つのモードのいずれかに切り替えてください。

モード

適用シナリオ

設定コマンド

AK (このトピックのステップ 2 から 3)

静的な AccessKey。開発環境ですばやく開始できます。

workbench config --mode AK

StsToken

一時的なセキュリティ認証情報 (AccessKey ペアと Security Token Service (STS) トークン)。既に STS 一時認証情報を持っている場合に適しています。

workbench config --mode StsToken

RamRoleArn

本番環境に推奨:低権限の AK が高権限の RAM ロールを引き受け、STS 一時認証情報が自動的に更新されます。

workbench config --mode RamRoleArn

CredentialsCmd

外部プログラムから動的に認証情報を取得し、企業が既に使用している認証情報ディストリビューションまたはシークレット管理システムと統合します。

workbench config --mode CredentialsCmd

CredentialsURI

メタデータサービスやサイドカーなどの HTTP サービスから動的に認証情報を取得します。

workbench config --mode CredentialsURI

EcsRamRole

CLI は、RAM ロールにバインドされた ECS インスタンス上で実行され、インスタンスメタデータサービス (IMDS) から自動的に認証情報を取得します。

workbench config --mode EcsRamRole

AliyunCLI

ローカルマシンに既に設定されている Alibaba Cloud CLI の認証情報 (~/.aliyun/config.json) を再利用し、固定の AK/SK をディスクに保存しません。

workbench config --mode AliyunCLI

STS 一時認証情報の使用 (StsToken)

このモードは、STS から取得した一時的なセキュリティ認証情報 (AccessKey ID + AccessKey Secret + STS トークン) で直接認証します。既に一時的な認証情報を持っている場合に使用します。一時的な認証情報には有効期限があり、期限が切れた後は再度設定する必要があります。認証情報を自動的に更新するには、「RAM ロールの使用 (RamRoleArn)」をご参照ください。

設定方法

workbench config --mode StsToken

プロンプトに従って、次の情報を順番に入力します。

  • Access Key ID:一時的な AccessKey ID。

  • AccessKey Secret:一時的な AccessKey Secret。

  • STS Token:一時的なアクセス認証情報。

設定結果のプレビュー

設定が完了したら、~/.workbench/config.json を確認して認証情報の設定結果を検証できます。完全な設定例は次のとおりです。

{
  "current": "default",
  "profiles": {
    "default": {
      "mode": "StsToken",
      "access_key_id": "STS.LTAI...",
      "access_key_secret": "...",
      "sts_token": "..."
    }
  }
}

RAM ロールの使用 (RamRoleArn)

このモードは、低権限の AccessKey を使用して高権限の RAM ロールを引き受けるシナリオに適しています。CLI は自動的に STS AssumeRole を呼び出して一時的な認証情報を取得し、有効期限が切れる前に更新します。RAM ロールの引き受けの詳細については、「RAM ロールの引き受け」をご参照ください。

設定方法

workbench config --mode RamRoleArn

プロンプトに従って、次の情報を順番に入力します。

  • Access Key ID:AliyunSTSAssumeRoleAccess 権限を持つ AccessKey ID。

  • Access Key Secret:AccessKey ID に対応する シークレットキー。

  • RAM Role ARN:引き受ける RAM ロールの ARN (形式:acs:ram::<account-id>:role/<role-name>)

  • Role Session Name:セッション識別子。監査ログに使用されます (デフォルト:workbench-session)。

設定結果のプレビュー

設定が完了したら、~/.workbench/config.json を確認して認証情報の設定結果を検証できます。

config.json を手動で編集することで、高度なフィールド (クロスアカウントの混乱した使節の問題の防止に使用される expired_seconds、sts_region、external_id など) を追加できます。STS の仕組みの詳細については、「STS とは」をご参照ください。

完全な設定例は次のとおりです。

{
  "current": "default",
  "profiles": {
    "default": {
      "mode": "RamRoleArn",
      "access_key_id": "LTAI...",
      "access_key_secret": "...",
      "ram_role_arn": "acs:ram::123456789:role/WorkbenchRole",
      "role_session_name": "workbench-session"
    }
  }
}

外部コマンド認証情報の使用 (CredentialsCmd)

このモードは、aliyun-zerotrust-credential-provider やカスタムスクリプトなどの外部認証情報ツールを介して動的に認証情報を取得するシナリオに適しています。CLI は認証情報が必要になるたびに、設定されたコマンドを実行し、そのコマンドの JSON 出力を認証情報として解析します。

設定方法

workbench config --mode CredentialsCmd

プロンプトに従って、次の情報を入力します。

  • Process Command — 外部認証情報コマンドの完全なパスとパラメーター。外部認証情報コマンドは、次の要件を満たす必要があります。

    • 終了コードは 0 である必要があります。ゼロ以外の終了コードは失敗として扱われます。

    • 標準出力は JSON 形式である必要があります。次の 2 つの形式がサポートされています。

      AK 形式 (静的認証情報):

      {
        "mode": "AK",
        "access_key_id": "<AccessKeyID>",
        "access_key_secret": "<AccessKeySecret>"
      }

      StsToken 形式 (一時認証情報):

      {
        "mode": "StsToken",
        "access_key_id": "<AccessKeyID>",
        "access_key_secret": "<AccessKeySecret>",
        "sts_token": "<SecurityToken>"
      }

例 1:aliyun-zerotrust-credential-provider の使用

aliyun-zerotrust-credential-provider は、Alibaba Cloud のゼロトラスト認証情報コマンドラインインターフェイスです。

workbench config --mode CredentialsCmd
# Process Command の入力:
# /usr/local/bin/aliyun-zerotrust-credential-provider --app-name=myapp --role=acs:ram::123456789:role/WorkbenchRole

設定が完了したら、~/.workbench/config.json を確認して認証情報の設定結果を検証できます。完全な設定例は次のとおりです。

{
  "current": "default",
  "profiles": {
    "default": {
      "mode": "CredentialsCmd",
      "process_command": "/usr/local/bin/aliyun-zerotrust-credential-provider --app-name=myapp --role=acs:ram::123456789:role/WorkbenchRole"
    }
  }
}

例 2:カスタムスクリプトの使用

出力形式を満たしていれば、スクリプトを認証情報ソースとして記述できます。

#!/bin/bash
# ~/.workbench/get-creds.sh
# Vault または他のキー管理システムから認証情報を取得
vault read -format=json secret/aliyun | jq '{
  mode: "StsToken",
  access_key_id: .data.access_key_id,
  access_key_secret: .data.access_key_secret,
  sts_token: .data.security_token
}'

認証情報 URI の使用 (CredentialsURI)

このモードは、自己管理型の認証情報ディストリビューションサービス、ECS インスタンスメタデータサービス、サイドカー認証情報エンドポイントなどのシナリオに適しています。CLI は、設定された URL に HTTP GET リクエストを送信して動的に一時認証情報を取得し、有効期限が切れる前に自動的に認証情報を更新します。

設定方法

workbench config --mode CredentialsURI

プロンプトに従って、次の情報を入力します。

  • Credentials URI:認証情報サービスの HTTP/HTTPS アドレス。認証情報サービスのレスポンスは、次の要件を満たす必要があります。

    • レスポンスのステータスコードは 200 である必要があります

    • レスポンスボディは次の形式を使用します。

      {
        "Code": "Success",
        "AccessKeyId": "<AccessKeyID>",
        "AccessKeySecret": "<AccessKeySecret>",
        "SecurityToken": "<SecurityToken>",
        "Expiration": "2026-01-01T12:00:00Z" 
      }
      重要

      Code フィールドは、厳密に Success (大文字と小文字を区別) である必要があります。Expiration は ISO 8601 形式であり、SDK は有効期限が切れる前に自動的に認証情報を再取得します。

設定結果のプレビュー

設定が完了したら、~/.workbench/config.json を確認して認証情報の設定結果を検証できます。完全な設定例は次のとおりです。

{
  "current": "default",
  "profiles": {
    "default": {
      "mode": "CredentialsURI",
      "credentials_uri": "http://localhost:8080/credentials"
    }
  }
}

ECS インスタンスの RAM ロールの使用 (EcsRamRole)

CLI が Alibaba Cloud ECS インスタンス上で実行され、そのインスタンスに RAM ロールがアタッチされているシナリオに適用されます。CLI は、インスタンスメタデータサービス (IMDS http://100.100.100.200) から自動的に一時的な STS 認証情報を取得し、AccessKey は不要です。IMDS は、有効期限が切れる前に自動的に認証情報を更新します。

重要

Alibaba Cloud ECS/ECI インスタンスでのみ利用可能です。ECS 以外の環境 (ローカルマシン、他のクラウド) は IMDS にアクセスできないため、このモードでは認証情報の取得に失敗します。その場合は、AK、RamRoleArn、CredentialsURI などのモードを使用してください。

設定方法

workbench config --mode EcsRamRole

プロンプトに従って、次の情報を入力します。

  • RAM Role Name:インスタンスにアタッチされた RAM ロールの名前。空にすることができます。空の場合、CLI は IMDS を介して現在インスタンスにアタッチされているロールを自動的に検出します (公式の Alibaba Cloud CLI のオプションの --ram-role-name の動作と一致)。

  • IMDSv2 強制モード (y/n):デフォルトは y (IMDSv2 強制を有効にする) です。インスタンスが古く、IMDSv2 をサポートしていない場合は、n と回答して IMDSv1 にフォールバックします。

設定が完了したら、通常どおりコマンドを使用します。認証情報の取得と更新は完全に自動です。

設定結果のプレビュー

設定が完了したら、~/.workbench/config.json を確認して認証情報の設定結果を検証できます。

設定ファイルのフィールド:

  • mode:固定値 EcsRamRole

  • role_name (オプション):空のままにすると自動検出

  • disable_imds_v1 (オプション):省略または true は IMDSv2 強制 (デフォルト) を意味し、false は IMDSv1 フォールバックが許可されることを意味します

完全な設定例は次のとおりです。

  • 最小構成の例 (自動ロール検出 + IMDSv2 強制):

    {
      "current": "default",
      "profiles": {
        "default": {
          "mode": "EcsRamRole"
        }
      }
    }
  • ロール名を指定し、IMDSv1 フォールバックを許可する:

    {
      "current": "default",
      "profiles": {
        "default": {
          "mode": "EcsRamRole",
          "role_name": "ECSAdmin",
          "disable_imds_v1": false
        }
      }
    }

Alibaba Cloud CLI 認証情報の再利用 (AliyunCLI)

マシンに Alibaba Cloud CLI がインストールされ、設定されている場合、Workbench に別の AccessKey ID と AccessKey Secret を保存することなく、その認証情報設定を直接再利用できます。

前提条件

  • Alibaba Cloud CLI がインストールされ、設定されている (aliyun configure)。

  • 設定ファイルが ~/.aliyun/config.json にあるか、ALIBABA_CLOUD_CONFIG_FILE を介して指定されている。Workbench はこの設定ファイルのみを読み取り、その内容を変更しません。

説明

AK、StsToken、RamRoleArn、EcsRamRole、OIDC、CloudSSO、OAuth、ChainableRamRoleArn などの Alibaba Cloud CLI モードがサポートされています。動的認証情報 ( `RamRoleArn` など) の場合、一時的な Security Token Service トークンは自動的に更新されます。

設定方法

workbench config --mode AliyunCLI

プロンプトに従って、次の情報を入力します。

  • aliyun_profile(オプション):再利用する Alibaba Cloud CLI プロファイルの名前。空のままにすると、現在の Alibaba Cloud CLI プロファイルが使用されます。

設定結果のプレビュー

設定が完了したら、~/.workbench/config.json を確認して認証情報の設定結果を検証できます。完全な設定例は次のとおりです。

{
  "current": "default",
  "profiles": {
    "default": {
      "mode": "AliyunCLI",
      "aliyun_profile": "wb-sub-01"
    }
  }
}

Workbench CLI のアップグレード

Workbench CLI は、ワンステップでの自己アップグレードをサポートしています。次のコマンドを実行して、最新バージョンにアップグレードします。

workbench upgrade

アップグレードプロセスは、最新バージョンのバイナリを自動的にダウンロードして検証し、現在のバージョンを置き換えます。

説明

バイナリが管理者権限を必要とするディレクトリ (Linux または macOS の /usr/local/bin など) にインストールされている場合は、sudo workbench upgrade を使用してください。

アンインストール

Workbench CLI は、システムサービスを登録したり、システム設定を変更したりしません。アンインストールするには、デーモンを停止し、バイナリを削除し、(オプションで) ローカルの設定ディレクトリを削除します。

Linux または macOS

次のコマンドを順番に実行します。

workbench daemon stop
sudo rm -f /usr/local/bin/workbench
rm -rf ~/.workbench

3 番目のコマンド (~/.workbench を削除) はオプションで、すべてのローカル認証情報と設定ファイルを削除します。

Windows

PowerShell で次のコマンドを順番に実行します。

workbench daemon stop
Remove-Item "$env:ProgramFiles\workbench" -Recurse -Force

# クラウドアシスタントシナリオでインストール中に作成された項目を削除:shim
Remove-Item "$env:SystemRoot\System32\workbench.cmd" -Force -ErrorAction SilentlyContinue

Remove-Item "$env:USERPROFILE\.workbench" -Recurse -Force

# インストールスクリプト (リモートデスクトップシナリオ) がユーザー PATH に追加した workbench パスを削除
$path = [Environment]::GetEnvironmentVariable("Path", "User")
if ($path -match "workbench") {
    $cleaned = ($path -split ";" | Where-Object { $_ -notmatch "workbench" }) -join ";"
    [Environment]::SetEnvironmentVariable("Path", $cleaned, "User")
}

.workbench ディレクトリの削除はオプションで、すべてのローカル認証情報と設定ファイルを削除します。

説明

上記コマンドは、ローカル CLI とローカル認証情報のみをクリーンアップします。クラウド上の RAM ユーザーと AccessKey は削除されません。それらも削除するには、RAM コンソールにログインして、対応する RAM ユーザーを削除するか、AccessKey を無効にしてください。

よくある質問

インストール後に workbench を実行すると command not found が返される

原因:インストールスクリプトが PATH に追加したディレクトリが、現在のシェルセッションで有効になっていません。

解決策:

  • Linux または macOS:ターミナルを再度開くか、source ~/.bashrc (または ~/.zshrc) を実行するか、絶対パス /usr/local/bin/workbench version を使用して確認します。

  • Windows:PowerShell ウィンドウを閉じて再度開きます。

workbench config を実行すると設定ファイルの権限エラーが返される

原因:CLI は、同じマシン上の他のユーザーが認証情報を読み取るのを防ぐため、~/.workbench/config.json の権限が広すぎる場合 (0644 やグループ読み取り可能など) に拒否します。

解決策:Linux または macOS で、次のコマンドを実行して権限を修正します。

chmod 600 ~/.workbench/config.json

workbench list ecs が InvalidAccessKeyId.NotFound または IncompleteSignature を返す

原因:通常、次のいずれかです。

  • 設定時に入力した AccessKey ID または AccessKey Secret が正しくない (先頭または末尾にスペースがある、完全にコピーされていないなど)。

  • 対応する AccessKey が RAM コンソールで無効化または削除されている。

解決策:workbench config を再実行し、AccessKey ID と AccessKey Secret が同じペアに属し、完全で、余分なスペースが含まれていないことを確認するか、RAM コンソールで AccessKey のステータスが [有効] であることを確認します。

インストールパッケージの検証

インストールパッケージが他のチャネル (オフラインパッケージや内部ミラーなど) から取得された場合は、その SHA256 値を計算し、公式ソースから提供されたチェックサムと比較することで、パッケージの整合性とセキュリティを検証します。

Linux または macOS

次のコマンドを実行して、インストールパッケージの SHA256 チェックサムを計算します。

shasum -a 256 workbench-linux-amd64.tar.gz
# Linux ではこのコマンドも使用できます:sha256sum workbench-linux-amd64.tar.gz

Windows

次のコマンドを実行して、インストールパッケージの SHA256 チェックサムを計算します。

Get-FileHash .\workbench-windows-amd64.zip -Algorithm SHA256

出力を下の表の SHA256 列の対応する値と比較します。一致する場合、パッケージは完全であり、改ざんされていません。

v1.0.4 チェックサム

プラットフォーム

インストールパッケージ

SHA256

macOS amd64

workbench-darwin-amd64.tar.gz

4db6730792ba729975b097cc2ca4dafa92dca8e0a2733a99fedce3edc90c1408

macOS arm64

workbench-darwin-arm64.tar.gz

b37dc8b34a73b86987a7de5ea0666ff7b5586b87aae68caa8662e3964774b870

Linux amd64

workbench-linux-amd64.tar.gz

41ffee737fa6ae9dfea0d8a47ae2b06275b1ff202ad3e0b7efe8eeed8164a2ab

Linux arm64

workbench-linux-arm64.tar.gz

8c72ba59e5c5aab087de5b054d2a8310acdbd5ba37818e0ab8a8d275b580f062

Windows amd64

workbench-windows-amd64.zip

8637da8ed8133ffdb4cfba88e60e809003ea6c39f0cc601d325c871c726d3e41

説明

チェックサムは、展開された Workbench バイナリではなく、圧縮されたパッケージ自体に適用されます。完全なチェックサムファイルは、https://workbench-cli.oss-cn-hangzhou.aliyuncs.com/releases/v1.0.4/checksums.sha256 で確認できます。

参考資料