Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Configurar el software AWS IoT Greengrass principal

El software AWS IoT Greengrass Core ofrece opciones que puede utilizar para configurar el software. Puede crear implementaciones para configurar el software AWS IoT Greengrass principal en cada dispositivo principal.

Implemente el componente núcleo de Greengrass

AWS IoT Greengrass proporciona el software AWS IoT Greengrass Core como un componente que puede implementar en sus dispositivos principales de Greengrass. Puede crear una implementación para aplicar la misma configuración a varios dispositivos principales de Greengrass. Para obtener más información, consulte Núcleo de Greengrass y Actualice el software AWS IoT Greengrass principal (OTA).

Configurar el núcleo de Greengrass como un servicio del sistema

Debe configurar el software AWS IoT Greengrass Core como un servicio del sistema en el sistema de inicio del dispositivo para hacer lo siguiente:

Configure el núcleo como un servicio del sistema (Linux)

Los dispositivos Linux admiten diferentes sistemas de inicio, como initd, systemd y SystemV. El --setup-system-service true argumento se utiliza al instalar el software AWS IoT Greengrass Core para iniciar el núcleo como un servicio del sistema y configurarlo para que se inicie al arrancar el dispositivo. El instalador configura el software AWS IoT Greengrass Core como un servicio del sistema con systemd.

También puede configurar manualmente el núcleo para que se ejecute como un servicio del sistema. En el siguiente ejemplo se muestra un archivo de servicio para 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

Tras configurar el servicio del sistema, puede ejecutar los siguientes comandos para configurar el inicio del dispositivo al arrancar y para iniciar o detener el software AWS IoT Greengrass principal.

Configure el núcleo como un servicio del sistema (Windows)

El --setup-system-service true argumento se utiliza al instalar el software AWS IoT Greengrass Core para iniciar el núcleo como un servicio de Windows y configurarlo para que se inicie cuando se inicie el dispositivo.

Tras configurar el servicio, puede ejecutar los siguientes comandos para configurar el inicio del dispositivo al arrancar y para iniciar o detener el software AWS IoT Greengrass Core. Debe ejecutar la línea de comandos o PowerShell como administrador para ejecutar estos comandos.

Windows Command Prompt (CMD)

• Para comprobar el estado del servicio

  sc query "greengrass"

• Para permitir que el núcleo se inicie al arrancar el dispositivo.

  sc config "greengrass" start=auto

• Para impedir que el núcleo se inicie al arrancar el dispositivo.

  sc config "greengrass" start=disabled

• Para iniciar el software AWS IoT Greengrass Core.

  sc start "greengrass"

• Para detener el software AWS IoT Greengrass Core.

  sc stop "greengrass"

  nota

  En los dispositivos Windows, el software AWS IoT Greengrass Core ignora esta señal de apagado mientras cierra los procesos de los componentes de Greengrass. Si el software AWS IoT Greengrass Core ignora la señal de apagado al ejecutar este comando, espere unos segundos e inténtelo de nuevo.

PowerShell

• Para comprobar el estado del servicio

  Get-Service -Name "greengrass"

• Para permitir que el núcleo se inicie al arrancar el dispositivo.

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

• Para impedir que el núcleo se inicie al arrancar el dispositivo.

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

• Para iniciar el software AWS IoT Greengrass Core.

  Start-Service -Name "greengrass"

• Para detener el software AWS IoT Greengrass Core.

  Stop-Service -Name "greengrass"

  nota

  En los dispositivos Windows, el software AWS IoT Greengrass Core ignora esta señal de apagado mientras cierra los procesos de los componentes de Greengrass. Si el software AWS IoT Greengrass Core ignora la señal de apagado al ejecutar este comando, espere unos segundos e inténtelo de nuevo.

Controle la asignación de memoria con las opciones de JVM

Si utilizas un dispositivo con memoria limitada, puedes usar las opciones de la máquina virtual Java (JVM) para controlar el tamaño máximo del montón, los modos de recolección de basura y las opciones del compilador, que controlan la cantidad de memoria que AWS IoT Greengrass utiliza el software Core. AWS IoT Greengrass El tamaño del montón de la JVM determina la cantidad de memoria que puede utilizar una aplicación antes de que se produzca la recolección de elementos no utilizados o antes de que la aplicación se quede sin memoria. El tamaño de montón máximo especifica la cantidad máxima de memoria que la JVM puede asignar al ampliar el montón durante un periodo de actividad intensa.

Para controlar la asignación de memoria, cree una nueva implementación o revise una implementación existente que incluya el componente núcleo y especifique las opciones de JVM en el parámetro de configuración de la jvmOptions configuración del componente núcleo.

Según sus requisitos, puede ejecutar el software AWS IoT Greengrass Core con una asignación de memoria reducida o con una asignación de memoria mínima.

Asignación de memoria reducida

Para ejecutar el software AWS IoT Greengrass Core con una asignación de memoria reducida, le recomendamos que utilice el siguiente ejemplo de actualización de combinación de configuraciones para configurar las opciones de JVM en su configuración de núcleo:

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

Asignación mínima de memoria

Para ejecutar el software AWS IoT Greengrass Core con una asignación de memoria mínima, le recomendamos que utilice el siguiente ejemplo de actualización de combinación de configuraciones para configurar las opciones de JVM en su configuración de núcleo:

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

En estos ejemplos de actualizaciones de combinación de configuraciones se utilizan las siguientes opciones de JVM:

Para obtener información sobre la creación de actualizaciones de combinaciones de configuraciones, consulteActualizar las configuraciones de los componentes.

Configure el usuario que ejecuta los componentes

El software AWS IoT Greengrass Core puede ejecutar procesos de componentes como un usuario y un grupo del sistema distintos del que ejecuta el software. Esto aumenta la seguridad, ya que puede ejecutar el software AWS IoT Greengrass principal como usuario root o como usuario administrador, sin conceder esos permisos a los componentes que se ejecutan en el dispositivo principal.

En la siguiente tabla se indican los tipos de componentes que el software AWS IoT Greengrass principal puede ejecutar como usuario que especifique. Para obtener más información, consulte Tipos de componentes.

Debe crear el usuario del componente antes de poder especificarlo en una configuración de despliegue. En los dispositivos basados en Windows, también debe almacenar el nombre de usuario y la contraseña del usuario en la instancia del administrador de credenciales de la LocalSystem cuenta. Para obtener más información, consulte Configure un usuario de componentes en dispositivos Windows.

Al configurar el usuario del componente en un dispositivo basado en Linux, también puede especificar un grupo si lo desea. Especifique el usuario y el grupo separados por dos puntos (:) en el siguiente formato:. user:group Si no especifica ningún grupo, el software AWS IoT Greengrass Core utilizará de forma predeterminada el grupo principal del usuario. Puede usar el nombre o el ID para identificar al usuario y al grupo.

En los dispositivos basados en Linux, también puede ejecutar componentes del sistema como un usuario del sistema que no existe (también denominado usuario desconocido) para aumentar la seguridad. Un proceso de Linux puede indicar cualquier otro proceso que ejecute el mismo usuario. Un usuario desconocido no ejecuta otros procesos, por lo que puede ejecutar componentes como un usuario desconocido para evitar que los componentes señalen otros componentes del dispositivo principal. Para ejecutar los componentes como un usuario desconocido, especifique un ID de usuario que no exista en el dispositivo principal. También puede especificar un ID de grupo que no existe para que se ejecute como un grupo desconocido.

Puede configurar el usuario para cada componente y para cada dispositivo principal.

Configure un usuario de componentes en dispositivos Windows

Configure el usuario del componente predeterminado

Puede usar una implementación para configurar el usuario predeterminado en un dispositivo principal. En esta implementación, se actualiza la configuración de los componentes del núcleo.

Cree una implementación que especifique la siguiente actualización de configuración para el aws.greengrass.Nucleus componente.

Linux

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

Windows

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

nota

El usuario que especifique debe existir y el nombre de usuario y la contraseña de este usuario deben estar almacenados en la instancia del administrador de credenciales de la LocalSystem cuenta del dispositivo Windows. Para obtener más información, consulte Configure un usuario de componentes en dispositivos Windows.

El siguiente ejemplo define una implementación para un dispositivo basado en Linux que se configura ggc_user como usuario y ggc_group grupo predeterminados. La actualización de merge configuración requiere un objeto JSON serializado.

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

Configure los límites de recursos del sistema para los componentes

Puede configurar la cantidad máxima de uso de CPU y RAM que los procesos de cada componente pueden usar en el dispositivo principal.

En la siguiente tabla se muestran los tipos de componentes que admiten los límites de recursos del sistema. Para obtener más información, consulte Tipos de componentes.

Puede configurar los límites de recursos del sistema para cada componente y para cada dispositivo principal.

Configure los límites de recursos del sistema predeterminados

Puede implementar el componente núcleo de Greengrass para configurar los límites de recursos del sistema predeterminados para un dispositivo principal. Para configurar los límites de recursos del sistema predeterminados, cree una implementación que especifique la siguiente actualización de configuración para el aws.greengrass.Nucleus componente.

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

El siguiente ejemplo define una implementación que configura el límite de tiempo de la CPU en2, lo que equivale al 50% de uso en un dispositivo con 4 núcleos de CPU. En este ejemplo también se configura el uso de memoria en 100 MB.

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

Realizar la conexión en el puerto 443 o a través de un proxy de red

AWS IoT Greengrass los dispositivos principales se comunican AWS IoT Core mediante el protocolo de mensajería MQTT con autenticación de cliente TLS. Convencionalmente, MQTT sobre TLS utiliza el puerto 8883. Sin embargo, como medida de seguridad, los entornos restrictivos podrían limitar el tráfico de entrada y salida a un pequeño rango de puertos TCP. Por ejemplo, el firewall de una compañía podría abrir el puerto 443 para el tráfico HTTPS, pero cerrar otros puertos que se utilizan para protocolos menos frecuentes, como, por ejemplo, el puerto 8883 para tráfico MQTT. Otros entornos restrictivos pueden requerir que todo el tráfico pase por un proxy antes de conectarse a Internet.

Para habilitar la comunicación en estos escenarios, AWS IoT Greengrass proporciona las siguientes opciones de configuración:

Configure MQTT a través del puerto 443

Puede configurar MQTT a través del puerto 443 en los dispositivos principales existentes o al instalar el software AWS IoT Greengrass Core en un dispositivo principal nuevo.

Configure MQTT a través del puerto 443 en los dispositivos principales existentes

Puede usar una implementación para configurar MQTT a través del puerto 443 en un dispositivo de un solo núcleo o en un grupo de dispositivos principales. En esta implementación, se actualiza la configuración de los componentes del núcleo. El núcleo se reinicia al actualizar su mqtt configuración.

Para configurar MQTT a través del puerto 443, cree una implementación que especifique la siguiente actualización de configuración para el aws.greengrass.Nucleus componente.

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

El siguiente ejemplo define una implementación que configura MQTT a través del puerto 443. La actualización merge de configuración requiere un objeto JSON serializado.

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

Configure MQTT a través del puerto 443 durante la instalación

Puede configurar MQTT a través del puerto 443 al instalar el software AWS IoT Greengrass Core en un dispositivo principal. Utilice el argumento del --init-config instalador para configurar MQTT a través del puerto 443. Puede especificar este argumento al realizar la instalación con aprovisionamiento manual, aprovisionamiento de flota o aprovisionamiento personalizado.

Configure HTTPS a través del puerto 443

Esta función requiere la Núcleo de Greengrass versión 2.0.4 o posterior.

Puede configurar HTTPS a través del puerto 443 en los dispositivos principales existentes o al instalar el software AWS IoT Greengrass Core en un dispositivo principal nuevo.

Configure HTTPS a través del puerto 443 en los dispositivos principales existentes

Puede usar una implementación para configurar HTTPS a través del puerto 443 en un dispositivo de un solo núcleo o en un grupo de dispositivos principales. En esta implementación, se actualiza la configuración de los componentes del núcleo.

Para configurar HTTPS a través del puerto 443, cree una implementación que especifique la siguiente actualización de configuración para el aws.greengrass.Nucleus componente.

{
  "greengrassDataPlanePort": 443
}

El siguiente ejemplo define una implementación que configura HTTPS a través del puerto 443. La actualización merge de configuración requiere un objeto JSON serializado.

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

Configure HTTPS a través del puerto 443 durante la instalación

Puede configurar HTTPS a través del puerto 443 al instalar el software AWS IoT Greengrass Core en un dispositivo principal. Utilice el argumento del --init-config instalador para configurar HTTPS a través del puerto 443. Puede especificar este argumento al realizar la instalación con aprovisionamiento manual, aprovisionamiento de flota o aprovisionamiento personalizado.

Configure un proxy de red

Siga el procedimiento de esta sección para configurar los dispositivos principales de Greengrass para que se conecten a Internet a través de un proxy de red HTTP o HTTPS. Para obtener más información sobre los puntos finales y los puertos que utilizan los dispositivos principales, consulte. Permitir el tráfico del dispositivo a través de un proxy o firewall

Configure un proxy de red en los dispositivos principales existentes

Puede usar una implementación para configurar un proxy de red en un dispositivo de un solo núcleo o en un grupo de dispositivos principales. En esta implementación, se actualiza la configuración de los componentes del núcleo. El núcleo se reinicia al actualizar su networkProxy configuración.

Para configurar un proxy de red, cree una implementación para el aws.greengrass.Nucleus componente que combine la siguiente actualización de configuración. Esta actualización de configuración contiene el objeto NetworkProxy.

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

El siguiente ejemplo define una implementación que configura un proxy de red. La actualización merge de configuración requiere un objeto JSON serializado.

{
  "components": {
    "aws.greengrass.Nucleus": {
      "version": "2.12.6",
      "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\"}}}"
      }
    }
  }
}

Configure un proxy de red durante la instalación

Puede configurar un proxy de red al instalar el software AWS IoT Greengrass Core en un dispositivo principal. Utilice el argumento del --init-config instalador para configurar el proxy de red. Puede especificar este argumento al realizar la instalación con aprovisionamiento manual, aprovisionamiento de flota o aprovisionamiento personalizado.

Habilite el dispositivo principal para que confíe en un proxy HTTPS

Al configurar un dispositivo principal para que utilice un proxy HTTPS, debe añadir la cadena de certificados del servidor proxy al dispositivo principal para que pueda confiar en el proxy HTTPS. De lo contrario, el dispositivo principal podría encontrar errores al intentar enrutar el tráfico a través del proxy. Añada el certificado de CA del servidor proxy al archivo de certificado de CA raíz de Amazon del dispositivo principal.

El objeto NetworkProxy

Utilice el objeto networkProxy para especificar información sobre el proxy de red. Este objeto contiene la siguiente información:

Utilice un certificado de dispositivo firmado por una entidad emisora de certificados privada

Si utiliza una autoridad de certificación (CA) privada personalizada, debe establecer el 'núcleogreengrassDataPlaneEndpoint' de Greengrass en. iotdata Puede configurar esta opción durante el despliegue o la instalación mediante el argumento del --init-config instalador.

Puede personalizar el punto final del plano de datos de Greengrass al que se conecta el dispositivo. Puede configurar esta opción de configuración iotdata para establecer el punto final del plano de datos de Greengrass en el mismo punto final que el punto final de datos de IoT, que puede especificar con. iotDataEndpoint

Configure los tiempos de espera y los ajustes de caché de MQTT

En el AWS IoT Greengrass entorno, los componentes pueden utilizar MQTT para comunicarse con ellos. AWS IoT Core El software AWS IoT Greengrass Core gestiona los mensajes MQTT de los componentes. Cuando el dispositivo principal pierde la conexión con el Nube de AWS, el software almacena en caché los mensajes MQTT para volver a intentarlo más tarde cuando se restablezca la conexión. Puede configurar ajustes como los tiempos de espera de los mensajes y el tamaño de la memoria caché. Para obtener más información, consulte mqtt los parámetros de mqtt.spooler configuración del componente núcleo de Greengrass.

AWS IoT Core impone cuotas de servicio a su agente de mensajes MQTT. Estas cuotas pueden aplicarse a los mensajes que envíe entre los dispositivos principales y. AWS IoT Core Para obtener más información, consulta las cuotas de servicio de AWS IoT Core Message Broker en Referencia general de AWS.