As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Console de depuração local
O componente do console de depuração local (aws.greengrass.LocalDebugConsole) fornece um painel local que exibe informações sobre seus dispositivos AWS IoT Greengrass principais e seus componentes. Você pode usar esse painel para depurar seu dispositivo principal e gerenciar componentes locais.
Recomendamos que você use este componente somente em ambientes de desenvolvimento, não em ambientes de produção. Este componente fornece acesso a informações e operações que você normalmente não precisará em um ambiente de produção. Siga o princípio do privilégio mínimo implantando este componente somente nos dispositivos principais em que você precisar dele.
Versões
Esse componente tem as seguintes versões:
-
2.4.x
-
2.3.x
-
2.2.x
-
2.1.x
-
2.0.x
Tipo
Este componente é um componente de plug-in (aws.greengrass.plugin). O núcleo do Greengrass executa esse componente na mesma Java Virtual Machine (JVM) do núcleo. O núcleo é reiniciado quando você altera a versão desse componente no dispositivo principal.
Esse componente usa o mesmo arquivo de log do núcleo do Greengrass. Para obter mais informações, consulte Monitore AWS IoT Greengrass logs.
Para obter mais informações, consulte Tipos de componente.
Sistema operacional
Esse componente pode ser instalado em dispositivos principais que executam os seguintes sistemas operacionais:
Requisitos
Esse componente tem os seguintes requisitos:
-
Você usa um nome de usuário e senha para entrar no painel. O nome de usuário, que é debug, é fornecido para você. Você deve usar o AWS IoT Greengrass CLI para criar uma senha temporária que autentique você com o painel em um dispositivo principal. Você deve ser capaz de usar o AWS IoT Greengrass CLI para usar o console de depuração local. Para obter mais informações, consulte os requisitos do Greengrass CLI. Para obter mais informações sobre como gerar a senha e fazer login, consulte Uso do componente do console de depuração local.
-
O componente do console de depuração local tem suporte para ser executado em umVPC.
Dependências
Quando você implanta um componente, AWS IoT Greengrass também implanta versões compatíveis de suas dependências. Isso significa que é preciso atender aos requisitos do componente e de todas as dependências dele para implantá-lo com êxito. Nesta seção, há uma lista de todas as dependências das versões lançadas desse componente e as restrições de versão semântica que definem as versões dos componentes para cada dependência. Também é possível visualizar as dependências de cada versão do componente no console do AWS IoT Greengrass. Na página de detalhes do componente, procure a lista de dependências.
- 2.4.4
-
A tabela a seguir lista as dependências da versão 2.4.4 deste componente.
- 2.4.3
-
A tabela a seguir lista as dependências da versão 2.4.3 desse componente.
- 2.4.1 – 2.4.2
-
A tabela a seguir lista as dependências das versões 2.4.1 a 2.4.2 desse componente.
- 2.4.0
-
A tabela a seguir lista as dependências da versão 2.4.0 desse componente.
- 2.3.0 and 2.3.1
-
A seguinte tabela lista as dependências das versões 2.3.0 e 2.3.1 desse componente.
- 2.2.9
-
A tabela a seguir lista as dependências da versão 2.2.9 desse componente.
- 2.2.8
-
A tabela a seguir lista as dependências da versão 2.2.8 desse componente.
- 2.2.7
-
A tabela a seguir lista as dependências da versão 2.2.7 desse componente.
- 2.2.6
-
A tabela a seguir lista as dependências da versão 2.2.6 desse componente.
- 2.2.5
-
A tabela a seguir lista as dependências da versão 2.2.5 desse componente.
- 2.2.4
-
A tabela a seguir lista as dependências da versão 2.2.4 desse componente.
- 2.2.3
-
A tabela a seguir lista as dependências da versão 2.2.3 desse componente.
- 2.2.2
-
A tabela a seguir lista as dependências da versão 2.2.2 desse componente.
- 2.2.1
-
A tabela a seguir lista as dependências da versão 2.2.1 desse componente.
- 2.2.0
-
A tabela a seguir lista as dependências da versão 2.2.0 desse componente.
- 2.1.0
-
A tabela a seguir lista as dependências da versão 2.1.0 desse componente.
- 2.0.x
-
A seguinte tabela lista as dependências da versão 2.0.x desse componente.
Para obter mais informações sobre as dependências dos componentes, consulte referência de fórmula do componente.
Configuração
Esse componente fornece os seguintes parâmetros de configuração que podem ser personalizados ao implantar o componente.
- v2.1.x - v2.4.x
-
httpsEnabled-
(Opcional) Você pode ativar a HTTPS comunicação para o console de depuração local. Se você habilitar a HTTPS comunicação, o console de depuração local criará um certificado autoassinado. Os navegadores da Web mostram avisos de segurança para sites que usam certificados autoassinados, portanto, você deve verificar o certificado manualmente. Em seguida, você pode ignorar o aviso. Para obter mais informações, consulte Uso.
Padrão: true
port-
(Opcional) A porta na qual fornecer o console de depuração local.
Padrão: 1441
websocketPort-
(Opcional) A porta do websocket a ser usada para o console de depuração local.
Padrão: 1442
bindHostname-
(Opcional) O nome do host a ser usado para o console de depuração local.
Se você executar o software AWS IoT Greengrass Core em um contêiner do Docker, defina esse parâmetro como0.0.0.0, para poder abrir o console de depuração local fora do contêiner do Docker.
Padrão: localhost
exemplo Exemplo: atualização da mesclagem de configuração
O exemplo de configuração a seguir especifica a abertura do console de depuração local em portas não padrão e a desativação. HTTPS
{
"httpsEnabled": false,
"port": "10441",
"websocketPort": "10442"
}
- v2.0.x
-
port-
(Opcional) A porta na qual fornecer o console de depuração local.
Padrão: 1441
websocketPort-
(Opcional) A porta do websocket a ser usada para o console de depuração local.
Padrão: 1442
bindHostname-
(Opcional) O nome do host a ser usado para o console de depuração local.
Se você executar o software AWS IoT Greengrass Core em um contêiner do Docker, defina esse parâmetro como0.0.0.0, para poder abrir o console de depuração local fora do contêiner do Docker.
Padrão: localhost
exemplo Exemplo: atualização da mesclagem de configuração
O exemplo de configuração a seguir especifica a abertura do console de depuração local em portas não padrão.
{
"port": "10441",
"websocketPort": "10442"
}
Uso
Para usar o console de depuração local, crie uma sessão no GreengrassCLI. Quando você cria uma sessão, o Greengrass CLI fornece um nome de usuário e uma senha temporária que você pode usar para entrar no console de depuração local.
Siga estas instruções para abrir o console de depuração local em seu dispositivo principal ou em seu computador de desenvolvimento.
- v2.1.x - v2.4.x
-
Nas versões 2.1.0 e posteriores, o console de depuração local usa HTTPS por padrão. Quando HTTPS ativado, o console de depuração local cria um certificado autoassinado para proteger a conexão. Seu navegador mostra um aviso de segurança quando você abre o console de depuração local devido a esse certificado autoassinado. Quando você cria uma sessão com o GreengrassCLI, a saída inclui as impressões digitais do certificado, para que você possa verificar se o certificado é legítimo e se a conexão é segura.
Você pode desativarHTTPS. Para obter mais informações, consulte Configuração local do console de depuração.
Para abrir o console de depuração local
-
(Opcional) Para visualizar o console de depuração local em seu computador de desenvolvimento, você pode encaminhar a porta do console. SSH No entanto, você deve primeiro ativar a AllowTcpForwarding opção no arquivo de SSH configuração do seu dispositivo principal. Essa opção é habilitada por padrão. Execute o comando a seguir em seu computador de desenvolvimento para visualizar o painel em localhost:1441 no computador de desenvolvimento.
ssh -L 1441:localhost:1441 -L 1442:localhost:1442 username@core-device-ip-address
-
Crie uma sessão para usar o console de depuração local. Ao criar uma sessão, você gera uma senha que usa para autenticar. O console de depuração local exige uma senha para aumentar a segurança, pois você pode usar esse componente para visualizar informações importantes e realizar operações no dispositivo principal. O console de depuração local também cria um certificado para proteger a conexão se você ativar HTTPS a configuração do componente. HTTPSestá habilitado por padrão.
Use o AWS IoT Greengrass CLI para criar a sessão. Esse comando gera uma senha aleatória de 43 caracteres que expira após 8 horas. Substitua /greengrass/v2C:\greengrass\v2 pelo caminho para a pasta AWS IoT Greengrass V2 raiz.
Linux or UnixWindows
- Linux or Unix
sudo /greengrass/v2
- Windows
C:\greengrass\v2\bin\greengrass-cli get-debug-password
A saída do comando se parece com o exemplo a seguir se você tiver configurado o console de depuração local para usoHTTPS. Você usa as impressões digitais do certificado para verificar se a conexão é segura ao abrir o console de depuração local.
Username: debug
Password: bEDp3MOHdj8ou2w5de_sCBI2XAaguy3a8XxREXAMPLE
Password expires at: 2021-04-01T17:01:43.921999931-07:00
The local debug console is configured to use TLS security. The certificate is self-signed so you will need to bypass your web browser's security warnings to open the console.
Before you bypass the security warning, verify that the certificate fingerprint matches the following fingerprints.
SHA-256: 15 0B 2C E2 54 8B 22 DE 08 46 54 8A B1 2B 25 DE FB 02 7D 01 4E 4A 56 67 96 DA A6 CC B1 D2 C4 1B
SHA-1: BC 3E 16 04 D3 80 70 DA E0 47 25 F9 90 FA D6 02 80 3E B5 C1
O componente de visualização de depuração cria uma sessão que dura 8 horas. Depois disso, você deverá gerar uma nova senha para visualizar o console de depuração local novamente.
-
Abra e faça login no painel. Visualize o painel em seu dispositivo principal do Greengrass ou em seu computador de desenvolvimento se você encaminhar a porta. SSH Execute um destes procedimentos:
-
Se você habilitou HTTPS no console de depuração local, que é a configuração padrão, faça o seguinte:
-
Abra https://localhost:1441 em seu dispositivo principal ou em seu computador de desenvolvimento se você tiver encaminhado a porta. SSH
Seu navegador pode mostrar um aviso de segurança sobre um certificado de segurança inválido.
-
Se seu navegador mostrar um aviso de segurança, verifique se o certificado é legítimo e ignore o aviso de segurança. Faça o seguinte:
-
Encontre a impressão digital SHA -256 ou SHA -1 do certificado e verifique se ela corresponde à impressão digital SHA -256 ou SHA -1 que o comando imprimiu anteriormente. get-debug-password Seu navegador pode fornecer uma ou ambas as impressões digitais. Consulte a documentação do seu navegador para ver o certificado e suas impressões digitais. Em alguns navegadores, a impressão digital do certificado é chamada de impressão digital.
Se a impressão digital do certificado não corresponder, acesse Passo 2 para criar uma nova sessão. Se a impressão digital do certificado ainda não corresponder, sua conexão pode estar insegura.
-
Se a impressão digital do certificado corresponder, ignore o aviso de segurança do seu navegador para abrir o console de depuração local. Consulte a documentação do seu navegador para ignorar o aviso de segurança do navegador.
-
Faça login no site usando o nome de usuário e a senha que o comando get-debug-password imprimiu anteriormente.
Abra o console de depuração local.
-
Se o console de depuração local mostrar um erro informando que ele não consegue se conectar ao WebSocket devido a uma falha no TLS handshake, você deve ignorar o aviso de segurança autoassinado do. WebSocket URL
Faça o seguinte:
-
Abra https://localhost:1442 no mesmo navegador em que você abriu o console de depuração local.
-
Verifique o certificado e ignore o aviso de segurança.
Seu navegador pode mostrar uma página HTTP 404 depois que você ignorar o aviso.
-
Abra https://localhost:1441 novamente.
O console de depuração local mostra informações sobre o dispositivo principal.
-
Se você tiver desativado HTTPS no console de depuração local, faça o seguinte:
-
Abra http://localhost:1441 em seu dispositivo principal ou abra-o em seu computador de desenvolvimento se você tiver encaminhado a porta. SSH
-
Faça login no site usando o nome de usuário e a senha que o comando get-debug-password imprimiu anteriormente.
Abra o console de depuração local.
- v2.0.x
-
Para abrir o console de depuração local
-
(Opcional) Para visualizar o console de depuração local em seu computador de desenvolvimento, você pode encaminhar a porta do console. SSH No entanto, você deve primeiro ativar a AllowTcpForwarding opção no arquivo de SSH configuração do seu dispositivo principal. Essa opção é habilitada por padrão. Execute o comando a seguir em seu computador de desenvolvimento para visualizar o painel em localhost:1441 no computador de desenvolvimento.
ssh -L 1441:localhost:1441 -L 1442:localhost:1442 username@core-device-ip-address
-
Crie uma sessão para usar o console de depuração local. Ao criar uma sessão, você gera uma senha que usa para autenticar. O console de depuração local exige uma senha para aumentar a segurança, pois você pode usar esse componente para visualizar informações importantes e realizar operações no dispositivo principal.
Use o AWS IoT Greengrass CLI para criar a sessão. Esse comando gera uma senha aleatória de 43 caracteres que expira após 8 horas. Substitua /greengrass/v2C:\greengrass\v2 pelo caminho para a pasta AWS IoT Greengrass V2 raiz.
Linux or UnixWindows
- Linux or Unix
sudo /greengrass/v2
- Windows
C:\greengrass\v2\bin\greengrass-cli get-debug-password
A saída do comando se parece com o exemplo a seguir.
Username: debug
Password: bEDp3MOHdj8ou2w5de_sCBI2XAaguy3a8XxREXAMPLE
Password will expire at: 2021-04-01T17:01:43.921999931-07:00
O componente de visualização de depuração cria uma sessão que dura 4 horas e, em seguida, você deve gerar uma nova senha para visualizar novamente o console de depuração local.
-
Abra http://localhost:1441 em seu dispositivo principal ou abra-o em seu computador de desenvolvimento se você tiver encaminhado a porta. SSH
-
Faça login no site usando o nome de usuário e a senha que o comando get-debug-password imprimiu anteriormente.
Abra o console de depuração local.
Arquivo de log local
Esse componente usa o mesmo arquivo de log do componente de núcleo do Greengrass.
- Linux
-
/greengrass/v2
- Windows
-
C:\greengrass\v2\logs\greengrass.log
Para exibir os logs desse componente
Changelog
A tabela a seguir descreve as alterações em cada versão do componente.
|
Versão
|
Alterações
|
|
2.4.4
|
Versão atualizada para a versão 2.14.0 do Greengrass nucleus.
|
|
2.4.3
|
Versão atualizada para o lançamento da versão 2.13.0 do núcleo do Greengrass.
- Correções de bugs e melhorias
-
|
|
2.4.2
|
- Correções de bugs e melhorias
-
|
|
2.4.1
|
Versão atualizada para o núcleo do Greengrass 2.12.0. |
|
2.4.0
|
|
|
2.3.1
|
Versão atualizada para o lançamento da versão 2.11.0 do núcleo do Greengrass. |
|
2.3.0
|
Versão atualizada para o lançamento da versão 2.10.0 do núcleo do Greengrass. |
|
2.2.7
|
Versão atualizada para o núcleo do Greengrass 2.9.0. |
|
2.2.6
|
Versão atualizada para o lançamento da versão 2.8.0 do núcleo do Greengrass. |
|
2.2.5
|
Versão atualizada para o lançamento da versão 2.7.0 do núcleo do Greengrass.
|
|
2.2.4
|
Versão atualizada para o lançamento da versão 2.6.0 do núcleo do Greengrass.
|
|
2.2.3
|
- Correções de bugs e melhorias
-
-
Corrige um problema que impedia a inicialização quando o componente não conseguia descriptografar o repositório de chaves que contém a chave privada. SSL
-
Versão atualizada para o lançamento da versão 2.5.0 do núcleo do Greengrass.
|
|
2.2.2
|
Versão atualizada para o lançamento da versão 2.4.0 do núcleo do Greengrass.
|
|
2.2.1
|
Versão atualizada para o lançamento da versão 2.3.0 do núcleo do Greengrass.
|
|
2.2.0
|
Versão atualizada para o lançamento do núcleo do Greengrass versão 2.2.0.
|
|
2.1.0
|
- Novos recursos
-
- Correções de bugs e melhorias
-
|
|
2.0.3
|
Versão inicial.
|
