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á.

Configurar o software AWS IoT Greengrass principal

O software AWS IoT Greengrass Core fornece opções que você pode usar para configurar o software. Você pode criar implantações para configurar o software AWS IoT Greengrass Core em cada dispositivo principal.

Implemente o componente central do Greengrass

AWS IoT Greengrass fornece o software AWS IoT Greengrass Core como um componente que você pode implantar em seus dispositivos principais do Greengrass. Você pode criar uma implantação para aplicar a mesma configuração a vários dispositivos principais do Greengrass. Para ter mais informações, consulte Núcleo Greengrass e Atualize o software AWS IoT Greengrass principal (OTA).

Configurar o núcleo do Greengrass como um serviço do sistema

Você deve configurar o software AWS IoT Greengrass Core como um serviço do sistema no sistema inicial do seu dispositivo para fazer o seguinte:

Configurar o núcleo como um serviço do sistema (Linux)

Os dispositivos Linux oferecem suporte a diferentes sistemas de inicialização, como initd, systemd e systemV. Você usa o --setup-system-service true argumento ao instalar o software AWS IoT Greengrass Core para iniciar o núcleo como um serviço do sistema e configurá-lo para ser iniciado quando o dispositivo for inicializado. O instalador configura o software AWS IoT Greengrass Core como um serviço do sistema com o systemd.

Você também pode configurar manualmente o núcleo para ser executado como um serviço do sistema. O exemplo a seguir é um arquivo de serviço systemd.

[Unit]
Description=Greengrass Core

[Service]
Type=simple
PIDFile=/greengrass/v2/alts/loader.pid
RemainAfterExit=no
Restart=on-failure
RestartSec=10
ExecStart=/bin/sh /greengrass/v2/alts/current/distro/bin/loader

[Install]
WantedBy=multi-user.target

Depois de configurar o serviço do sistema, você pode executar os seguintes comandos para configurar a inicialização do dispositivo na inicialização e para iniciar ou parar o software AWS IoT Greengrass Core.

Configurar o núcleo como um serviço do sistema (Windows)

Você usa o --setup-system-service true argumento ao instalar o software AWS IoT Greengrass Core para iniciar o núcleo como um serviço do Windows e configurá-lo para ser iniciado quando o dispositivo for inicializado.

Depois de configurar o serviço, você pode executar os seguintes comandos para configurar a inicialização do dispositivo na inicialização e para iniciar ou parar o software AWS IoT Greengrass Core. Você deve executar o prompt de comando ou PowerShell como administrador para executar esses comandos.

Windows Command Prompt (CMD)

• Para verificar o status do serviço

  sc query "greengrass"

• Para permitir que o núcleo inicie quando o dispositivo for inicializado.

  sc config "greengrass" start=auto

• Para impedir que o núcleo inicie quando o dispositivo é inicializado.

  sc config "greengrass" start=disabled

• Para iniciar o software AWS IoT Greengrass Core.

  sc start "greengrass"

• Para parar o software AWS IoT Greengrass Core.

  sc stop "greengrass"

  nota

  Em dispositivos Windows, o software AWS IoT Greengrass Core ignora esse sinal de desligamento enquanto desliga os processos dos componentes do Greengrass. Se o software AWS IoT Greengrass Core ignorar o sinal de desligamento ao executar esse comando, aguarde alguns segundos e tente novamente.

PowerShell

• Para verificar o status do serviço

  Get-Service -Name "greengrass"

• Para permitir que o núcleo inicie quando o dispositivo for inicializado.

  Set-Service -Name "greengrass" -Status stopped -StartupType automatic

• Para impedir que o núcleo inicie quando o dispositivo é inicializado.

  Set-Service -Name "greengrass" -Status stopped -StartupType disabled

• Para iniciar o software AWS IoT Greengrass Core.

  Start-Service -Name "greengrass"

• Para parar o software AWS IoT Greengrass Core.

  Stop-Service -Name "greengrass"

  nota

  Em dispositivos Windows, o software AWS IoT Greengrass Core ignora esse sinal de desligamento enquanto desliga os processos dos componentes do Greengrass. Se o software AWS IoT Greengrass Core ignorar o sinal de desligamento ao executar esse comando, aguarde alguns segundos e tente novamente.

Controle a alocação de memória com opções JVM

Se você estiver executando AWS IoT Greengrass em um dispositivo com memória limitada, poderá usar as opções da máquina virtual Java (JVM) para controlar o tamanho máximo da pilha, os modos de coleta de lixo e as opções do compilador, que controlam a quantidade de memória que o software AWS IoT Greengrass Core usa. O tamanho da pilha no JVM determina a quantidade de memória que um aplicativo pode usar antes que a coleta de lixo ocorra ou antes que o aplicativo fique sem memória. O tamanho máximo da pilha especifica a quantidade máxima de memória que JVM pode ser alocada ao expandir a pilha durante atividades pesadas.

Para controlar a alocação de memória, crie uma nova implantação ou revise uma implantação existente que inclua o componente do núcleo e especifique suas JVM opções no parâmetro de jvmOptions configuração na configuração do componente do núcleo.

Dependendo dos seus requisitos, você pode executar o software AWS IoT Greengrass Core com alocação de memória reduzida ou com alocação mínima de memória.

Alocação de memória reduzida

Para executar o software AWS IoT Greengrass Core com alocação de memória reduzida, recomendamos que você use o seguinte exemplo de atualização de mesclagem de configuração para definir JVM opções na configuração do núcleo:

{
  "jvmOptions": "-XX:+UseSerialGC -XX:TieredStopAtLevel=1"
}

Alocação mínima de memória

Para executar o software AWS IoT Greengrass Core com alocação mínima de memória, recomendamos que você use o seguinte exemplo de atualização de mesclagem de configuração para definir JVM opções na configuração do núcleo:

{
  "jvmOptions": "-Xmx32m -XX:+UseSerialGC -Xint"
}

Esses exemplos de atualizações de mesclagem de configurações usam as seguintes JVM opções:

Para obter informações sobre como criar atualizações de mesclagem de configurações, consulteAtualizar configurações de componentes.

Configurar o usuário que executa os componentes

O software AWS IoT Greengrass principal pode executar processos de componentes como usuário e grupo do sistema diferente daquele que executa o software. Isso aumenta a segurança, porque você pode executar o software AWS IoT Greengrass Core como root ou como usuário administrador, sem conceder essas permissões aos componentes que são executados no dispositivo principal.

A tabela a seguir indica quais tipos de componentes o software AWS IoT Greengrass Core pode ser executado como usuário especificado por você. Para obter mais informações, consulte Tipos de componentes.

Você deve criar o usuário do componente antes de poder especificá-lo em uma configuração de implantação. Em dispositivos baseados em Windows, você também deve armazenar o nome de usuário e a senha do usuário na instância do gerenciador de credenciais da conta. LocalSystem Para obter mais informações, consulte Configurar um usuário componente em dispositivos Windows.

Ao configurar o usuário do componente em um dispositivo baseado em Linux, você também pode especificar um grupo. Você especifica o usuário e o grupo separados por dois pontos (:) no seguinte formato:user:group. Se você não especificar um grupo, o software AWS IoT Greengrass Core assumirá como padrão o grupo primário do usuário. Você pode usar o nome ou o ID para identificar o usuário e o grupo.

Em dispositivos baseados em Linux, você também pode executar componentes como um usuário do sistema que não existe, também chamado de usuário desconhecido, para aumentar a segurança. Um processo Linux pode sinalizar qualquer outro processo executado pelo mesmo usuário. Um usuário desconhecido não executa outros processos, então você pode executar componentes como um usuário desconhecido para evitar que os componentes sinalizem outros componentes no dispositivo principal. Para executar componentes como um usuário desconhecido, especifique uma ID de usuário que não exista no dispositivo principal. Você também pode especificar um ID de grupo que não existe para ser executado como um grupo desconhecido.

Você pode configurar o usuário para cada componente e para cada dispositivo principal.

Configurar um usuário componente em dispositivos Windows

Configurar o usuário padrão do componente

Você pode usar uma implantação para configurar o usuário padrão em um dispositivo principal. Nessa implantação, você atualiza a configuração do componente do núcleo.

Crie uma implantação que especifique a seguinte atualização de configuração para o aws.greengrass.Nucleus componente.

Linux

{
  "runWithDefault": {
    "posixUser": "ggc_user:ggc_group"
  }
}

Windows

{
  "runWithDefault": {
    "windowsUser": "ggc_user"
  }
}

nota

O usuário que você especificar deve existir, e o nome de usuário e a senha desse usuário devem ser armazenados na instância do gerenciador de credenciais da LocalSystem conta em seu dispositivo Windows. Para obter mais informações, consulte Configurar um usuário componente em dispositivos Windows.

O exemplo a seguir define uma implantação para um dispositivo baseado em Linux que é configurado ggc_user como usuário padrão e ggc_group como grupo padrão. A atualização da merge configuração requer um JSON objeto serializado.

{
  "components": {
    "aws.greengrass.Nucleus": {
      "version": "2.13.0",
      "configurationUpdate": {
        "merge": "{\"runWithDefault\":{\"posixUser\":\"ggc_user:ggc_group\"}}"
      }
    }
  }
}

Configurar limites de recursos do sistema para componentes

Você pode configurar a quantidade máxima CPU e o RAM uso que os processos de cada componente podem usar no dispositivo principal.

A tabela a seguir mostra os tipos de componentes que oferecem suporte aos limites de recursos do sistema. Para obter mais informações, consulte Tipos de componentes.

Você pode configurar os limites de recursos do sistema para cada componente e para cada dispositivo principal.

Configurar limites padrão de recursos do sistema

Você pode implantar o componente Greengrass nucleus para configurar os limites padrão de recursos do sistema para um dispositivo principal. Para configurar os limites padrão de recursos do sistema, crie uma implantação que especifique a seguinte atualização de configuração para o aws.greengrass.Nucleus componente.

{
  "runWithDefault": {
    "systemResourceLimits": {
      "cpu": cpuTimeLimit,
      "memory": memoryLimitInKb
    }
  }
}

O exemplo a seguir define uma implantação que configura o limite de CPU tempo em2, o que equivale a 50% de uso em um dispositivo com 4 CPU núcleos. Este exemplo também configura o uso da memória para 100 MB.

{
  "components": {
    "aws.greengrass.Nucleus": {
      "version": "2.13.0",
      "configurationUpdate": {
        "merge": "{\"runWithDefault\":{\"systemResourceLimits\":\"cpus\":2,\"memory\":102400}}}"
      }
    }
  }
}

Conectar-se à porta 443 ou por meio de um proxy de rede

AWS IoT Greengrass os dispositivos principais se comunicam AWS IoT Core usando o protocolo MQTT de mensagens com autenticação TLS do cliente. Por convenção, TLS usa MQTT a porta 8883 em excesso. No entanto, como medida de segurança, ambientes restritivos podem limitar o tráfego de entrada e saída a um pequeno intervalo de portas. TCP Por exemplo, um firewall corporativo pode abrir a porta 443 para HTTPS tráfego, mas fechar outras portas usadas para protocolos menos comuns, como a porta 8883 para MQTT tráfego. Outros ambientes restritivos podem exigir que todo o tráfego passe por um proxy antes de se conectar à Internet.

Para habilitar a comunicação nesses cenários, AWS IoT Greengrass fornece as seguintes opções de configuração:

Configurar MQTT pela porta 443

Você pode configurar MQTT pela porta 443 em dispositivos principais existentes ou ao instalar o software AWS IoT Greengrass Core em um novo dispositivo principal.

Configure MQTT pela porta 443 em dispositivos principais existentes

Você pode usar uma implantação para configurar MQTT pela porta 443 em um dispositivo de núcleo único ou em um grupo de dispositivos principais. Nessa implantação, você atualiza a configuração do componente do núcleo. O núcleo reinicia quando você atualiza sua mqtt configuração.

Para configurar MQTT pela porta 443, crie uma implantação que especifique a seguinte atualização de configuração para o aws.greengrass.Nucleus componente.

{
  "mqtt": {
    "port": 443
  }
}

O exemplo a seguir define uma implantação que é configurada MQTT pela porta 443. A atualização da merge configuração requer um JSON objeto serializado.

{
  "components": {
    "aws.greengrass.Nucleus": {
      "version": "2.13.0",
      "configurationUpdate": {
        "merge": "{\"mqtt\":{\"port\":443}}"
      }
    }
  }
}

Configure MQTT pela porta 443 durante a instalação

Você pode configurar MQTT pela porta 443 ao instalar o software AWS IoT Greengrass Core em um dispositivo principal. Use o argumento --init-config do instalador para configurar MQTT pela porta 443. Você pode especificar esse argumento ao instalar com provisionamento manual, provisionamento defrota ou provisionamento personalizado.

Configurar HTTPS pela porta 443

Esse recurso requer a Núcleo Greengrass versão v2.0.4 ou posterior.

Você pode configurar HTTPS pela porta 443 em dispositivos principais existentes ou ao instalar o software AWS IoT Greengrass Core em um novo dispositivo principal.

Configure HTTPS pela porta 443 em dispositivos principais existentes

Você pode usar uma implantação para configurar HTTPS pela porta 443 em um dispositivo de núcleo único ou em um grupo de dispositivos principais. Nessa implantação, você atualiza a configuração do componente do núcleo.

Para configurar HTTPS pela porta 443, crie uma implantação que especifique a seguinte atualização de configuração para o aws.greengrass.Nucleus componente.

{
  "greengrassDataPlanePort": 443
}

O exemplo a seguir define uma implantação que é configurada HTTPS pela porta 443. A atualização da merge configuração requer um JSON objeto serializado.

{
  "components": {
    "aws.greengrass.Nucleus": {
      "version": "2.13.0",
      "configurationUpdate": {
        "merge": "{\"greengrassDataPlanePort\":443}"
      }
    }
  }
}

Configure HTTPS pela porta 443 durante a instalação

Você pode configurar HTTPS pela porta 443 ao instalar o software AWS IoT Greengrass Core em um dispositivo principal. Use o argumento --init-config do instalador para configurar HTTPS pela porta 443. Você pode especificar esse argumento ao instalar com provisionamento manual, provisionamento defrota ou provisionamento personalizado.

Configurar um proxy de rede

Siga o procedimento nesta seção para configurar os dispositivos principais do Greengrass para se conectarem à Internet por meio de um proxy de HTTPS rede HTTP ou. Para obter mais informações sobre os endpoints e portas que os dispositivos principais usam, consultePermitir o tráfego de dispositivos por meio de um proxy ou firewall.

Configurar um proxy de rede nos dispositivos principais existentes

Você pode usar uma implantação para configurar um proxy de rede em um dispositivo de núcleo único ou em um grupo de dispositivos principais. Nessa implantação, você atualiza a configuração do componente do núcleo. O núcleo reinicia quando você atualiza sua networkProxy configuração.

Para configurar um proxy de rede, crie uma implantação para o aws.greengrass.Nucleus componente que mescla a seguinte atualização de configuração. Essa atualização de configuração contém o networkProxy objeto.

{
  "networkProxy": {
    "noProxyAddresses": "http://192.168.0.1,www.example.com",
    "proxy": {
      "url": "https://my-proxy-server:1100"
    }
  }
}

O exemplo a seguir define uma implantação que configura um proxy de rede. A atualização da merge configuração requer um JSON objeto serializado.

{
  "components": {
    "aws.greengrass.Nucleus": {
      "version": "2.13.0",
      "configurationUpdate": {
        "merge": "{\"networkProxy\":{\"noProxyAddresses\":\"http://192.168.0.1,www.example.com\",\"proxy\":{\"url\":\"https://my-proxy-server:1100\",\"username\":\"Mary_Major\",\"password\":\"pass@word1357\"}}}"
      }
    }
  }
}

Configurar um proxy de rede durante a instalação

Você pode configurar um proxy de rede ao instalar o software AWS IoT Greengrass Core em um dispositivo principal. Use o argumento --init-config do instalador para configurar o proxy de rede. Você pode especificar esse argumento ao instalar com provisionamento manual, provisionamento defrota ou provisionamento personalizado.

Permita que o dispositivo principal confie em um HTTPS proxy

Ao configurar um dispositivo principal para usar um HTTPS proxy, você deve adicionar a cadeia de certificados do servidor proxy à do dispositivo principal para permitir que ele confie no HTTPS proxy. Caso contrário, o dispositivo principal poderá encontrar erros ao tentar rotear o tráfego por meio do proxy. Adicione o certificado CA do servidor proxy ao arquivo de certificado de CA raiz da Amazon do dispositivo principal.

O networkProxy objeto

Use o objeto networkProxy para especificar informações sobre o proxy de rede. Esse objeto contém as seguintes informações:

Use um certificado de dispositivo assinado por uma CA privada

Se você estiver usando uma autoridade de certificação (CA) privada personalizada, você deve definir o núcleo greengrassDataPlaneEndpoint do Greengrass como. iotdata Você pode definir essa opção durante a implantação ou instalação usando o argumento do --init-config instalador.

Você pode personalizar o endpoint do plano de dados do Greengrass ao qual o dispositivo se conecta. Você pode definir essa opção de configuração iotdata para definir o endpoint do plano de dados do Greengrass como o mesmo endpoint de dados de IoT, que você pode especificar com o. iotDataEndpoint

Definir MQTT tempos limite e configurações de cache

No AWS IoT Greengrass ambiente, os componentes podem ser usados MQTT para se comunicar com AWS IoT Core. O software AWS IoT Greengrass Core gerencia MQTT mensagens para componentes. Quando o dispositivo principal perde a conexão com o Nuvem AWS, o software armazena as MQTT mensagens em cache para tentar novamente mais tarde, quando a conexão for restaurada. Você pode definir configurações como o tempo limite das mensagens e o tamanho do cache. Para obter mais informações, consulte os parâmetros mqtt e os parâmetros de mqtt.spooler configuração do componente do núcleo do Greengrass.

AWS IoT Core impõe cotas de serviço em seu agente de MQTT mensagens. Essas cotas podem se aplicar às mensagens que você envia entre os dispositivos principais e. AWS IoT Core Para obter mais informações, consulte cotas do serviço de agente de AWS IoT Core mensagens no Referência geral da AWS.