Platform For AI:リモート接続: ProxyClient

ステップ 1: DSW ProxyClient のダウンロードとインストール

1. DSW ProxyClient ツールをダウンロードし、ユーザーのホームディレクトリに保存します。

   必要なディレクトリは、オペレーティングシステムによって異なります:

   • Windows: C:\Users\<username> などのユーザープロファイルフォルダーに保存します。

   • Linux: root ユーザーの場合は /root に、一般ユーザーの場合は /home/<username> に保存します。

   • macOS: /Users/<username> に保存します。

   <username> を実際のユーザー名に置き換えてください。

   各バージョンのダウンロードリンクは以下のとおりです:

   • Linux (x86-64)

   • macOS (x86-64)

   • macOS (ARM64)

   • Windows (x86-64)

2. コマンドラインで、クライアントファイルを実行可能にします。このステップは Windows では不要です。

   chmod 755 <proxyclient>

   <proxyclient> をダウンロードしたクライアントファイルの名前に置き換えてください。

3. 構成ファイルを生成します。

   1. 構成コマンドを実行します。

      # macOS, Linux
      ./proxyclient config
      # Windows
       proxyclient.exe config

      重要

      macOS で初めて ./proxyclient コマンドを実行すると、「"proxyclient" は開発元を確認できないため開けません。」というエラーメッセージが表示されることがあります。これを解決するには、[システム環境設定] > [セキュリティとプライバシー] に移動し、アプリケーションの実行を許可します。

   2. プロンプトに従って、構成ファイルのパスを設定します。

      構成ファイルの名前を入力します。パスを含めることもできます。

      説明

      • Enter キーを押して、デフォルトのパスとファイル名である ~/.proxyclientconfig を使用することをお勧めします。

      • カスタムパスとファイル名を指定することもできます。たとえば、Windows (x86-64) の場合: C:/Users/<username>/xxx/.proxyclientconfig。

      • カスタムパスを設定した場合は、ステップ 3 で ./proxyclient add コマンドを実行するときに -c または --config-file フラグを使用して指定する必要があります。

   3. プロンプトに従って、RegionId、AccessKey ID、AccessKey Secret、および STS Token パラメーターを設定します。

      次の表に、これらのパラメーターを示します。

      パラメーター	説明
      RegionId	リージョンの ID です。たとえば、中国 (上海) の場合は cn-shanghai です。リージョン ID の完全なリストについては、「リージョンとゾーン」をご参照ください。 重要 ここで構成するリージョン ID は、DSW インスタンスのリージョンと一致している必要があります。
      AccessKey ID	アカウントの AccessKey を入力します。Alibaba Cloud アカウントの AccessKey ID と AccessKey Secret を取得する方法については、「AccessKey ペアの作成」をご参照ください。
      AccessKey Secret
      STSToken	Alibaba Cloud アカウントまたは RAM ユーザーを使用している場合は、これを空のままにします。 RAM ロールとしてログインする場合は、一時的な ID 認証情報 (STS トークン) を提供する必要があります。セキュリティトークンサービス (STS) トークンを生成する方法については、「STS トークンの取得」をご参照ください。 重要 STS トークンの有効期限が切れていないことを確認してください。

ステップ 2: SSH 認証方式の設定

SSH キーペアまたはユーザー名とパスワードのいずれかを使用して、DSW インスタンスに接続できます。

ステップ 3: DSW インスタンスプロキシの追加

1. [インスタンス] ページで、接続するインスタンスを見つけ、次の図に示すようにインスタンス ID をコピーします。

   

2. ローカルのコマンドラインで、次のコマンドを実行して DSW インスタンスを SSH ターゲットホストとして追加します。

   前のステップでコピーしたインスタンス ID で <instance ID> を置き換えます。

   # macOS, Linux:
   ./proxyclient add -i=<instance ID>
   # Windows:
   proxyclient.exe add -i=<instance ID>

3. .ssh/config ファイルの内容を表示して、プロキシ設定が適用されていることを確認します。

   # macOS, Linux
   cat .ssh/config
   
   # Windows。ローカルのコマンドラインで、ユーザーのホームディレクトリに移動し、次のコマンドを使用して設定ファイルの内容を表示します。設定ファイルをダブルクリックして開くこともできます。
   explorer .ssh\config

4. オプション: example_id_rsa など、キーペアにカスタムファイル名を使用した場合は、~/.ssh/config ファイルを変更する必要があります。次の例に示すように、IdentityFile ディレクティブを使用して秘密鍵ファイルへのパスを指定します。

   Host dsw-b7a2765b267e****
       HostName dsw-b7a2765b267e****
       User root
       ProxyCommand ~/proxyclient connect --region-id=cn-hangzhou --instance-id=dsw-b7a2765b267e**** --config-file=***
       ServerAliveInterval 30
       IdentityFile ~/.ssh/example_id_rsa

ステップ 4: DSW インスタンスへのリモート接続

ssh <instance ID>

# ローカルファイルをリモートインスタンスにコピーします。
scp local_file_path root@<DSW instance ID>:<remote_file_path>
# ローカルディレクトリをリモートインスタンスにコピーします。
scp -r local_dir root@<DSW instance ID>:<remote_dir>
# リモートインスタンスからローカルマシンにファイルをコピーします。
scp root@<DSW instance ID>:<remote_file_path> <local_file_path>
# リモートインスタンスからローカルマシンにディレクトリをコピーします。
scp -r root@<DSW instance ID>:<remote_dir> <local_dir>

Q: DSW インスタンスへの「Direct SSH」経由の接続と「ProxyClient」メソッドの違いは何ですか？

Q: RAM ユーザーの AccessKey を使用すると、DSW インスタンスへの ProxyClient 接続が失敗するのはなぜですか？

RAM ユーザーの AccessKey を使用して ProxyClient 経由で接続する場合、Alibaba Cloud アカウントが RAM ユーザーに paidsw:GetToken 権限を付与していることを確認する必要があります。そうでない場合、認証は失敗します。権限を追加するには、次のステップを実行します:

Q: ProxyClient で DSW インスタンスに接続する際の「接続タイムアウト」エラーを修正するにはどうすればよいですか？

接続タイムアウトエラーは、多くの場合、ProxyClient 構成ファイルの RegionId と DSW インスタンスの実際のリージョンとの不一致が原因です。これを解決するには、構成ファイル (デフォルトは ~/.proxyclientconfig) を開き、RegionId の値が DSW インスタンスが配置されているリージョン (例: cn-shanghai) と完全に一致することを確認します。

Q: DSW インスタンスに複数のユーザーを作成して、個別の SSH ログインを行う方法はありますか？

いいえ、DSW は分離された SSH ログインのための複数ユーザーの作成をネイティブにサポートしていません。デフォルトでは、DSW インスタンスは SSH アクセス用に root ユーザーのみを提供します。インスタンスのオペレーティングシステム内で手動で新しいユーザーを作成しようとすることはできますが、これは公式にサポートまたは推奨されている構成ではありません。

Q: VSCode から SSH 経由で DSW インスタンスに接続した後、/mnt/workspace 内のプロジェクトファイルにアクセスするにはどうすればよいですか？

プロジェクトファイルは /mnt/workspace にありますが、これは SSH 経由で最初に接続したときのデフォルトディレクトリ (/root) ではありません。IDE からこのフォルダを手動で開く必要があります。

VSCode でこれを行うには:

1. DSW インスタンスに接続した後、[ファイル] > [フォルダーを開く...] に移動します。

2. 表示されるダイアログボックスで、/mnt/workspace と入力し、[OK] をクリックします。

3. プロジェクトファイルが VSCode Explorer のサイドバーに表示されます。