Conectar a uma instância Cloud Phone usando ADB - Cloud Phone: Central de Documentação do Alibaba Cloud

Configure e conecte-se a uma instância Cloud Phone usando o Android Debug Bridge (ADB).

Pré-requisitos

Crie ou importe um par de chaves no console do Cloud Phone e vincule-o à instância Cloud Phone de destino. Para mais informações, consulte Gerenciar pares de chaves.
Salve o arquivo de chave privada adbkey no diretório a seguir para ativar o logon via ADB.
- Diretório no macOS: ~/.android
- Diretório no Windows: %USERPROFILE%\.android
Execute os comandos a seguir para reiniciar o serviço ADB local.
```
adb kill-server
```
```
adb start-server
```

Procedimento

Nota

Se a instância Cloud Phone estiver em um grupo de instâncias com Shared Network, apenas conexões ADB via VPC são compatíveis.
Se a instância Cloud Phone pertencer a um grupo com VPC, use o ADB com um clique (recomendado), uma conexão ADB via VPC ou uma conexão ADB pela Internet.

ADB com um clique (recomendado)

Pré-requisitos

Ative o acesso à Internet para a rede VPC da instância. Para mais informações, consulte Gerenciar acesso à Internet para uma rede VPC.

Procedimento

Faça logon no console do Cloud Phone.
No painel de navegação à esquerda, escolha Manage Resource > Instance.
Na página Instance, localize a instância de destino, clique em ⋮ na coluna Actions, e selecione One-click ADB.
No painel One-click ADB Connection, clique em Create ADB Connection.

Nota
Se o acesso à Internet não estiver ativado na rede VPC, clique em Activate Now na caixa de diálogo exibida.
A conexão ADB é criada automaticamente após alguns instantes. Clique em ⋮ ao lado de ADB Connection Mode para copiar o comando.

Próximos passos

O ADB com um clique estabelece a conexão, mas não configura os grupos de segurança. Permita tráfego TCP de entrada na porta 5555 do endereço de source para a instância Cloud Phone. Para mais informações, consulte Conexão ADB pela Internet.

Conexão ADB via VPC

Conecte-se a uma instância do Elastic Desktop Service (EDS) na mesma VPC da instância Cloud Phone.
Execute o comando a seguir para conectar-se à instância Cloud Phone.
```
adb connect <192.168.XX.XX>:5555
```
Nota
Substitua <192.168.XX.XX> pelo endereço IP privado do Cloud Phone.
Como encontrar o endereço IP privado
1. Faça logon no console do Cloud Phone.
2. No painel de navegação à esquerda, escolha Manage Resource > Instance.
3. Na página Instance, localize a instância Cloud Phone desejada e copie o valor na coluna Private IP Address.

Conexão ADB pela Internet

Para conectar-se a uma instância Cloud Phone pela Internet usando ADB, crie uma entrada DNAT e configure o grupo de segurança.

Crie um gateway nat da Internet na VPC da instância Cloud Phone. Para mais informações, consulte Habilitar acesso à Internet para uma instância Cloud Phone. Se já existir um gateway nat da Internet, ignore esta etapa.
Crie uma entrada DNAT no gateway nat da Internet com uma regra de mapeamento de portas.
1. Faça logon no console do gateway NAT.
2. Na página NAT Gateway, localize a instância do gateway nat da Internet de destino e clique em Configure DNAT na coluna Actions.
3. Na aba DNAT management, clique em Create DNAT entry.
4. Na página Create DNAT entry, configure os seguintes parâmetros:
  - Select EIP: Selecione um elastic IP address (EIP) disponível. Anote este EIP para usá-lo durante a conexão.
  - Select private IP address: Escolha Manual Input e insira o endereço IP privado da instância Cloud Phone.
    Como encontrar o endereço IP privado
    Faça logon no console do Cloud Phone.
    
    No painel de navegação à esquerda, escolha Manage Resource > Instance.
    
    Na página Instance, localize a instância Cloud Phone desejada e copie o valor na coluna Private IP Address.
  - Specific port: Insira as portas pública e privada para mapeamento, por exemplo, 1000:5555.
Modifique as regras do grupo de segurança policy para abrir a porta 5555 para acesso público.
1. Faça logon no console do ECS.
2. No painel de navegação à esquerda, escolha Network & security > Elastic network interfaces.
3. Na página Elastic network card, clique em id da interface de rede elástica de destino. Em seguida, na seção Basic Information, clique em id do primeiro grupo de segurança.
  
  Nota
  A interface de rede elástica possui dois grupos de segurança: vda e policy. Modifique o grupo policy. Clique em um id de grupo de segurança para visualizar seu nome.
4. Na página de detalhes do grupo de segurança, clique em Inbound, selecione Add rule e defina as seguintes configurações:
  - Action: Allow
  - Priority: 1
  - Protocol type: Custom TCP
  - Port range: 5555/5555
  - Source: 0.0.0.0/0
    
    Nota
    Essa configuração permite que todos os endereços IP acessem a porta 5555. Para maior segurança, especifique o endereço IP público do dispositivo local.
Execute o comando a seguir para conectar-se à instância Cloud Phone:
```
adb connect <Public IP>:<DNAT public port>
```
Nota
Substitua <PublicIPAddress> pelo EIP da entrada DNAT e <DNATPublicPort> pela porta pública. Neste exemplo, a porta é 1000.

Perguntas frequentes

Falha na conexão com o gateway NAT

Verifique o formato do comando:

adb connect <Public IP>:<DNAT public port>

Se o comando estiver correto, valide os itens a seguir:
- Existe uma entrada DNAT configurada para o gateway nat da Internet.
- O endereço IP público e a porta estão corretos.
- As regras do grupo de segurança permitem tráfego na porta especificada.
- A tabela de rotas da VPC está configurada corretamente, o próximo salto da rota é o gateway nat da Internet e o gateway possui uma entrada SNAT.

Falha na autenticação ADB

Verifique se há um par de chaves vinculado à instância e se você baixou o arquivo adbkey correspondente para o diretório correto no computador local.
Após vincular o par de chaves à instância e salvar a chave privada no diretório adequado, reinicie o serviço ADB:
```
adb kill-server
```
```
adb start-server
```