ADBキーペアを使用してクラウドフォンに接続する - Cloud Phone

このトピックでは、Android Debug Bridge (ADB) を使用してクラウドフォンに接続する方法について説明します。

前提条件

クラウドフォンコンソールでキーペアが作成またはインポートされていること。キーペアはクラウドフォンにバインドされています。詳細については、キーペアの管理を参照してください。
オンプレミス環境からクラウドフォンへの ADB 接続を確実に行うために、adbkey（秘密鍵）ファイルが OS の種類に基づいて次のディレクトリのいずれかに保存されていること。
- macOS: ~/.android
- Windows: %USERPROFILE%\.android
オンプレミス環境で ADB プロセスが再起動されていること。ADB プロセスを再起動するには、次のコマンドを実行します。
```
adb kill-server
```
```
adb start-server
```

手順

説明

接続先のクラウドフォンのインスタンスグループが共有ネットワークを使用している場合、仮想プライベートクラウド (VPC) 経由でのみ ADB 接続を確立できます。
接続先のクラウドフォンのインスタンスグループが VPC を使用している場合、VPC またはインターネット経由で ADB 接続を確立できます。

VPC 経由の ADB 接続

指定された VPC 内にある Alibaba Cloud Workspace の Elastic Compute Service (ECS) インスタンスまたはクラウドコンピュータにログオンします。
次のコマンドを実行して、目的のクラウドフォンに接続します。
```
adb connect <192.168.XX.XX>:5555
```
説明
<192.168.XX.XX> をクラウドフォンのプライベート IP アドレスに置き換えます。
クラウドフォンのプライベート IP アドレスを照会するにはどうすればよいですか?
1. クラウドフォンコンソールにログオンします。
2. 左側のナビゲーションペインで、インスタンスをクリックします。
3. インスタンス ページで、目的のクラウドフォンを見つけ、プライベート IP アドレス列の値をコピーします。

インターネット経由の ADB 接続

インターネット経由でオンプレミスデバイスから ADB キーペアを使用してクラウドフォンにアクセスするには、Destination Network Address Translation (DNAT) エントリを設定し、セキュリティグループ設定を変更します。

目的のクラウドフォンが属する VPC にインターネット NAT ゲートウェイを作成します。詳細については、クラウドフォンがインターネットにアクセスする方法を参照してください。インターネット NAT ゲートウェイが既に存在する場合は、この手順をスキップします。
インターネット NAT ゲートウェイの DNAT エントリを作成し、ポートマッピングルールを設定します。
1. NAT ゲートウェイコンソールにログオンします。
2. インターネット NAT ゲートウェイページで、目的のインターネット NAT ゲートウェイを見つけ、アクション列のDNAT の設定をクリックします。
3. DNAT 管理タブで、DNAT エントリの作成をクリックします。
4. DNAT エントリの作成ページで、ビジネス要件に基づいて次のパラメータを設定します。
  - EIP を選択: エラスティック IP アドレス (EIP) を選択して記録します。クラウドフォンに接続するコマンドを実行するときに、EIP が必要です。
  - プライベート IP アドレスを選択: 手動入力を選択し、クラウドフォンのプライベート IP アドレスを入力します。
    クラウドフォンのプライベート IP アドレスを照会するにはどうすればよいですか?
    クラウドフォンコンソールにログオンします。
    左側のナビゲーションペインで、インスタンスをクリックします。
    インスタンス ページで、目的のクラウドフォンを見つけ、プライベート IP アドレス列の値をコピーします。
  - カスタムポート: マップするパブリックポートとプライベートポートを入力します。マッピングポートの例: 1000:5555。
エラスティックネットワークインターフェース (ENI) の policy セキュリティグループを変更して、インターネットからのトラフィックがポート 5555 を通過できるようにします。
1. ECS コンソールにログオンします。
2. 左側のナビゲーションペインで、ネットワークとセキュリティ > エラスティックネットワークインターフェース を選択します。
3. エラスティックネットワークインターフェースページで、ENI を見つけて ID をクリックします。基本情報セクションで、最初のセキュリティグループを見つけて ID をクリックします。
  説明
  この例では、ENI には vda と policy という名前の 2 つのセキュリティグループがあります。policy セキュリティグループのルールを変更する必要があります。セキュリティグループ ID をクリックすると、セキュリティグループ名が表示されます。
4. セキュリティグループの詳細タブのインバウンドタブで、ルールの追加をクリックして、次のルールを追加します。
  - アクション: 許可。
  - 優先度: 1。
  - プロトコルタイプ: カスタム TCP。
  - ポート範囲: 5555/5555。
  - 認証オブジェクト: 0.0.0.0/0。
    説明
    このルールでは、すべての IP アドレスからのトラフィックがポート 5555 を通過することを許可します。ネットワークセキュリティを強化するには、ADB コマンドを実行するオンプレミスデバイスのパブリック IP アドレスを入力できます。
次のコマンドを実行して、目的のクラウドフォンに接続します。
```
adb connect <パブリック IP アドレス>:<DNAT パブリックポート>
```
説明
<パブリック IP アドレス> を DNAT エントリに関連付けられた EIP に、<DNAT パブリックポート> を DNAT エントリのパブリックポート (この例ではポート 1000) に置き換えます。

FAQ

インターネット経由で ADB を使用してクラウドフォンに接続するときに、ネットワーク障害またはタイムアウトの問題が発生した場合はどうすればよいですか?

実行するコマンドが次のコマンドと同じかどうかを確認します。
```
adb connect <パブリック IP アドレス>:<DNAT パブリックポート>
```
コマンドが正しい場合は、次の手順を実行して問題をトラブルシューティングします。
- インターネットに接続された DNAT エントリが作成されているかどうかを確認します。
- パブリック IP アドレスとポートが正しいかどうかを確認します。
- セキュリティグループで対応するポートが有効になっているかどうかを確認します。
- 使用する VPC のルートテーブルが正しいかどうかを確認します。ルートテーブルのネクストホップは、SNAT エントリが設定されているインターネットに接続された NAT ゲートウェイである必要があります。
問題が解決しない場合は、チケットを送信して、Alibaba Cloud テクニカルサポートに連絡してください。

ADB を使用してクラウドフォンに接続するときに認証エラーが発生した場合はどうすればよいですか?

クラウドフォンにキーペアがバインドされているか、adbkey ファイルがダウンロードされてオンプレミスディレクトリに保存されているかを確認します。
キーペアがクラウドフォンにバインドされていて、adbkey ファイルが正しいディレクトリに保存されている場合は、次のコマンドを実行して、オンプレミス環境で ADB プロセスを再起動します。
```
adb kill-server
```
```
adb start-server
```