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á. # Systems Manager Agent O componente AWS Systems Manager Agent (`aws.greengrass.SystemsManagerAgent`) instala o Systems Manager Agent, para que você possa gerenciar dispositivos principais com o Systems Manager. O Systems Manager é um AWS serviço que você pode usar para visualizar e controlar sua infraestrutura AWS, incluindo EC2 instâncias da Amazon, servidores locais e máquinas virtuais (VMs) e dispositivos periféricos. O Systems Manager permite visualizar dados operacionais, automatizar tarefas operacionais e manter a segurança e a conformidade. Para obter mais informações, consulte [O que é AWS Systems Manager?](https://docs.aws.amazon.com/systems-manager/latest/userguide/what-is-systems-manager.html) e [Sobre o Systems Manager Agent](https://docs.aws.amazon.com/systems-manager/latest/userguide/prereqs-ssm-agent.html) no *Guia AWS Systems Manager do Usuário*. As ferramentas e os recursos do Systems Manager são chamados de *recursos*. Os dispositivos principais do Greengrass oferecem suporte a todos os recursos do Systems Manager. Para obter mais informações sobre esses recursos e como usar o Systems Manager para gerenciar dispositivos principais, consulte [Recursos do Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/features.html) no *Guia do usuário do AWS Systems Manager *. **Topics** + [Versões](#systems-manager-agent-component-versions) + [Tipo](#systems-manager-agent-component-type) + [Sistema operacional](#systems-manager-agent-component-os-support) + [Requisitos](#systems-manager-agent-component-requirements) + [Dependências](#systems-manager-agent-component-dependencies) + [Configuração](#systems-manager-agent-component-configuration) + [Arquivo de log local](#systems-manager-agent-component-log-file) + [Consulte também](#systems-manager-agent-component-see-also) + [Changelog](#systems-manager-agent-component-changelog) ## Versões Esse componente tem as seguintes versões: + 1.3.x + 1.2.x + 1.1.x + 1.0.x ## Tipo Esse é um componente genérico (`aws.greengrass.generic`). O [Greengrass nucleus](greengrass-nucleus-component.md) executa os scripts do ciclo de vida do componente. Para obter mais informações, consulte [Tipos de componente](develop-greengrass-components.md#component-types). ## Sistema operacional Esse componente pode ser instalado somente nos dispositivos principais do Linux. ## Requisitos Esse componente tem os seguintes requisitos: + Um dispositivo principal do Greengrass executado em uma plataforma Linux de 64 bits: Armv8 () AArch64 ou x86\$164. + Você deve ter uma função de serviço AWS Identity and Access Management (IAM) que o Systems Manager possa assumir. Essa função deve incluir a política SSMManaged InstanceCore gerenciada pela [Amazon](https://console.aws.amazon.com/iam/home#/policies/arn:aws:iam::aws:policy/AmazonSSMManagedInstanceCore) ou uma política personalizada que defina permissões equivalentes. Para obter mais informações, consulte [Criar um perfil de serviço do IAM para dispositivos de borda](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-setting-up-edge-devices.html#systems-manager-setting-up-edge-devices-service-role) no *Guia do usuário do AWS Systems Manager *. Ao implantar esse componente, você deve especificar o nome desse perfil no parâmetro de configuração `SSMRegistrationRole`. + O [perfil do dispositivo do Greengrass](device-service-role.md) deve permitir as ações `ssm:AddTagsToResource` e `ssm:RegisterManagedInstance`. O perfil do dispositivo também deve permitir a ação `iam:PassRole` do perfil de serviço do IAM que atende ao requisito anterior. No exemplo a seguir, a política do IAM concede estas permissões. ``` { "Version": "2012-10-17", "Statement": [ { "Action": [ "iam:PassRole" ], "Effect": "Allow", "Resource": [ "arn:aws:iam::account-id:role/SSMServiceRole" ] }, { "Action": [ "ssm:AddTagsToResource", "ssm:RegisterManagedInstance" ], "Effect": "Allow", "Resource": "*" } ] } ``` ### Endpoints e portas Esse componente precisa ser capaz de realizar solicitações de saída para os endpoints e portas a seguir, além dos endpoints e portas necessários para a operação básica. Para obter mais informações, consulte [Permitir o tráfego de dispositivos por meio de um proxy ou firewall](allow-device-traffic.md). | Endpoint | Porta | Obrigatório | Description | | --- | --- | --- | --- | | `ec2messages.region.amazonaws.com` | 443 | Sim | Comunicar-se com o serviço Systems Manager na Nuvem AWS. | | `ssm.region.amazonaws.com` | 443 | Sim | Registrar o dispositivo principal como um nó gerenciado do Systems Manager. | | `ssmmessages.region.amazonaws.com` | 443 | Sim | Comunicar-se com o Session Manager, um recurso do Systems Manager, na Nuvem AWS. | Para obter mais informações, consulte [Referência: ec2messages, ssmmessages e outras chamadas de API](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-setting-up-messageAPIs.html) no *Guia do usuário do AWS Systems Manager *. ## 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](#systems-manager-agent-component-changelog) 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](https://console.aws.amazon.com//greengrass). Na página de detalhes do componente, procure a lista de **dependências**. A tabela a seguir lista as dependências das versões 1.0.0 a 1.3.0 desse componente. | Dependência | Versões compatíveis | Tipo de dependência | | --- | --- | --- | | [Token Exchange Service](token-exchange-service-component.md) | >=2.0.0 <3.0.0 | Rígido | Para obter mais informações sobre as dependências dos componentes, consulte [referência de fórmula do componente](component-recipe-reference.md#recipe-reference-component-dependencies). ## Configuração Esse componente fornece os seguintes parâmetros de configuração que podem ser personalizados ao implantar o componente. `SSMRegistrationRole` A função de serviço do IAM que o Systems Manager pode assumir e que inclui a política SSMManaged InstanceCore gerenciada da [Amazon](https://console.aws.amazon.com/iam/home#/policies/arn:aws:iam::aws:policy/AmazonSSMManagedInstanceCore) ou uma política personalizada que define permissões equivalentes. Para obter mais informações, consulte [Criar um perfil de serviço do IAM para dispositivos de borda](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-setting-up-edge-devices-service-role.html) no *Guia do usuário do AWS Systems Manager *. `SSMOverrideExistingRegistration` (Opcional) Se o dispositivo principal já executa o Systems Manager Agent registrado com uma ativação híbrida, você pode substituir o registro existente do Systems Manager Agent do dispositivo. Defina essa opção como `true` para registrar o dispositivo principal como um nó gerenciado usando o Systems Manager Agent fornecido por esse componente. Essa opção se aplica somente aos dispositivos registrados com uma ativação híbrida. Se o dispositivo principal for executado em uma EC2 instância da Amazon com o Systems Manager Agent instalado e uma função de perfil de instância configurada, o ID do nó gerenciado existente da EC2 instância da Amazon começará com`i-`. Quando você instala o componente Systems Manager Agent, o agente registra um novo nó gerenciado com um ID que começa com `mi-` em vez de `i-`. Depois disso, você pode usar o nó gerenciado com o ID que começa com `mi-` para gerenciar o dispositivo principal com o Systems Manager. Padrão: `false` `SSMResourceTags` (Opcional) As tags que serão adicionadas ao nó gerenciado do Systems Manager que esse componente cria para o dispositivo principal. Você pode usar essas tags para gerenciar grupos de dispositivos principais com o Systems Manager. Por exemplo, você pode executar um comando em todos os dispositivos que tenham uma tag que você especifica. Especifique uma lista em que cada tag seja um objeto com `Key` e `Value`. Por exemplo, o valor `SSMResourceTags` a seguir instrui esse componente a definir a tag **Owner** como **richard-roe** no nó gerenciado do dispositivo principal. ``` [ { "Key": "Owner", "Value": "richard-roe" } ] ``` O componente vai ignorar essas tags se o nó gerenciado já existir e se `SSMOverrideExistingRegistration` for `false`. **Example Exemplo: atualização da mesclagem de configuração** O exemplo de configuração a seguir especifica o uso de um perfil de serviço chamado `SSMServiceRole` para permitir que o dispositivo principal se registre e comunique com o Systems Manager. ``` { "SSMRegistrationRole": "SSMServiceRole", "SSMOverrideExistingRegistration": false, "SSMResourceTags": [ { "Key": "Owner", "Value": "richard-roe" }, { "Key": "Team", "Value": "solar" } ] } ``` ## Arquivo de log local O software Systems Manager Agent grava os logs em uma pasta fora da pasta raiz do Greengrass. Para obter mais informações, consulte [Como visualizar os logs do Systems Manager Agent](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-agent-logs.html) no *Guia do usuário do AWS Systems Manager *. O componente Systems Manager Agent usa scripts de shell para instalar, iniciar e interromper o Systems Manager Agent. Você encontra a saída desses scripts no arquivo de log a seguir. ``` /greengrass/v2/logs/aws.greengrass.SystemsManagerAgent.log ``` **Para exibir os logs desse componente** + Execute o comando a seguir no dispositivo principal para visualizar o arquivo de log desse componente em tempo real. `/greengrass/v2`Substitua pelo caminho para a pasta AWS IoT Greengrass raiz. ``` sudo tail -f /greengrass/v2/logs/aws.greengrass.SystemsManagerAgent.log ``` ## Consulte também + [Gerencie os principais dispositivos do Greengrass com AWS Systems Manager](manage-with-systems-manager.md) + [O que é o AWS Systems Manager?](https://docs.aws.amazon.com/systems-manager/latest/userguide/what-is-systems-manager.html) no *AWS Systems Manager Guia do usuário* + [Sobre o Systems Manager Agent](https://docs.aws.amazon.com/systems-manager/latest/userguide/prereqs-ssm-agent.html) no *Guia do usuário do AWS Systems Manager * ## Changelog A tabela a seguir descreve as alterações em cada versão do componente. | **Versão** | **Alterações** | | --- | --- | | 1.3.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/greengrass/v2/developerguide/systems-manager-agent-component.html) | | 1.2.4 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/greengrass/v2/developerguide/systems-manager-agent-component.html) | | 1.2.3 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/greengrass/v2/developerguide/systems-manager-agent-component.html) | | 1.1.0 | Esta versão contém correções de bugs e melhorias. | | 1.0.0 | Versão inicial. |