Usar documentos do SSM do Systems Manager com o AWS FIS

Requisitos

Para ações que exigem que o Atendente SSM execute a ação no destino, você deve garantir o seguinte:

• O agente está instalado no destino. O Atendente SSM está instalado por padrão em algumas Amazon Machine Images (AMIs). Caso contrário, você pode instalar o Atendente SSM em suas instâncias. Para obter mais informações, consulte Instalar manualmente o Atendente SSM em instâncias do EC2 no Guia do usuário do AWS Systems Manager.

• O Systems Manager tem permissão para executar ações em suas instâncias. Você concede acesso usando um perfil da instância do IAM. Para obter mais informações, consulte Criar um perfil de instância do IAM para o Systems Manager e Anexar um perfil de instância do IAM a uma instância do EC2 no Guia do usuário do AWS Systems Manager.

• documentArn – obrigatório. O nome do recurso da Amazon (ARN) é o nome do documento do SSM.

• documentParameters – Condicional. Os parâmetros necessários e opcionais que o documento do SSM aceita. O formato é um objeto JSON com chaves que são strings e valores que são strings ou arrays de strings.

• documentVersion: optional. A versão do documento do SSM a ser executada.

Requisitos

• Os documentos do SSM pré-configurados fornecidos pelo AWS FIS são compatíveis somente com os seguintes sistemas operacionais:

  • Amazon Linux 2023, Amazon Linux 2, Amazon Linux

  • Ubuntu

  • RHEL 7, 8, 9

  • CentOS 8, 9

• Os documentos do SSM pré-configurados fornecidos pelo AWS FIS são compatíveis somente com instâncias do EC2. Eles não são compatíveis com outros tipos de nós gerenciados, como servidores on-premises.

• Action duration: para experimentos com uma única ação, a duração da ação é equivalente à duração do experimento. Com várias ações, a duração do experimento depende das durações individuais das ações e da ordem em que elas são executadas. O AWS FIS monitora cada ação até o fim da duração da ação.

• Parâmetro de documento DurationSeconds: a duração, especificada em segundos, pela qual o documento do SSM será executado.

• Action duration exceeds DurationSeconds: a execução do documento do SSM termina antes que a ação seja concluída. O AWS FIS espera até o fim da duração da ação para que as ações subsequentes sejam iniciadas.

• Action duration is shorter than DurationSeconds: o documento do SSM continua a execução após a conclusão da ação. Se a execução do documento do SSM ainda estiver em andamento e a duração da ação tiver expirado, o status da ação será definido como Concluído. O AWS FIS monitora a execução somente até o fim da duração da ação.

Parâmetros do documento

• DurationSeconds – obrigatório. A duração do teste de estresse da CPU, em segundos.

• CPU: optional. O número de estressores da CPU a usar. O padrão é 0, que usa todos os estressores da CPU.

• LoadPercent: optional. A porcentagem da carga da CPU de destino, de 0 (sem carga) a 100 (carga total). O padrão é 100.

• InstallDependencies: optional. Se o valor for True, o Systems Manager instalará as dependências necessárias nas instâncias de destino, caso elas ainda não estejam instaladas. O padrão é True. A dependência é stress-ng.

Parâmetros do documento

• DurationSeconds – obrigatório. A duração do teste de preenchimento de disco, em segundos.

• Percent: optional. A porcentagem do disco para alocar durante o teste de preenchimento do disco. O padrão é 95%.

• InstallDependencies: optional. Se o valor for True, o Systems Manager instalará as dependências necessárias nas instâncias de destino, caso elas ainda não estejam instaladas. O padrão é True. As dependências são atd e fallocate.

Parâmetros do documento

• DurationSeconds – obrigatório. A duração do teste de estresse de E/S, em segundos.

• Workers: optional. O número de funcionários que realizam uma combinação de operações de leitura/gravação sequenciais, aleatórias e mapeadas na memória, sincronização forçada e descarte de cache. Vários processos secundários realizam diferentes operações de E/S no mesmo arquivo. O padrão é um.

• Percent: optional. A porcentagem de espaço livre no sistema de arquivos a ser usada durante o teste de estresse de E/S. O padrão é 80%.

• InstallDependencies: optional. Se o valor for True, o Systems Manager instalará as dependências necessárias nas instâncias de destino, caso elas ainda não estejam instaladas. O padrão é True. A dependência é stress-ng.

Parâmetros do documento

• ProcessName – obrigatório. O nome do processo a interromper.

• Signal: optional. O sinal a ser enviado junto com o comando. Os valores possíveis são SIGTERM (que o receptor pode optar por ignorar) e SIGKILL (que não pode ser ignorado). O padrão é SIGTERM.

• InstallDependencies: opcional. Se o valor for True, o Systems Manager instalará as dependências necessárias nas instâncias de destino, caso elas ainda não estejam instaladas. O padrão é True. A dependência é killall.

Parâmetros do documento

• DurationSeconds – obrigatório. A duração do teste de estresse de memória, em segundos.

• Workers: optional. O número de estressores da memória virtual. O padrão é um.

• Percent – obrigatório. A porcentagem de memória virtual a ser usada durante o teste de estresse de memória.

• InstallDependencies: optional. Se o valor for True, o Systems Manager instalará as dependências necessárias nas instâncias de destino, caso elas ainda não estejam instaladas. O padrão é True. A dependência é stress-ng.

Parâmetros do documento

• Protocol – obrigatório. O protocolo. Os valores possíveis são tcp e udp.

• Port – obrigatório. O número da porta.

• TrafficType: optional. O tipo de tráfego. Os valores possíveis são ingress e egress. O padrão é ingress.

• DurationSeconds – obrigatório. A duração do teste de buraco negro da rede, em segundos.

• InstallDependencies: optional. Se o valor for True, o Systems Manager instalará as dependências necessárias nas instâncias de destino, caso elas ainda não estejam instaladas. O padrão é True. As dependências são atd, dig e iptables.

Parâmetros do documento

• Interface: optional. A interface de rede. O padrão é eth0.

• DelayMilliseconds: opcional. O atraso, em milissegundos. O padrão é 200.

• DurationSeconds – obrigatório. A duração do teste de latência da rede, em segundos.

• InstallDependencies: optional. Se o valor for True, o Systems Manager instalará as dependências necessárias nas instâncias de destino, caso elas ainda não estejam instaladas. O padrão é True. As dependências são atd, dig e tc.

Parâmetros do documento

• Interface: optional. A interface de rede. O padrão é eth0.

• DelayMilliseconds: opcional. O atraso, em milissegundos. O padrão é 200.

• JitterMilliseconds: optional. O jitter, em milissegundos. O padrão é 10.

• Sources – obrigatório. As fontes, separadas por vírgulas. Os valores possíveis são: um endereço IPv4, um bloco CIDR IPv4, um nome de domínio e DYNAMODB e S3. Se você especificar DYNAMODB ouS3, isso se aplica somente ao endpoint regional na região atual.

• TrafficType: optional. O tipo de tráfego. Os valores possíveis são ingress e egress. O padrão é ingress.

• DurationSeconds – obrigatório. A duração do teste de latência da rede, em segundos.

• InstallDependencies: optional. Se o valor for True, o Systems Manager instalará as dependências necessárias nas instâncias de destino, caso elas ainda não estejam instaladas. O padrão é True. As dependências são atd, dig, jq e tc.

Parâmetros do documento

• Interface: optional. A interface de rede. O padrão é eth0.

• LossPercent: opcional. A porcentagem de perda de pacotes. O padrão é 7%.

• DurationSeconds – obrigatório. A duração do teste de perda de pacotes de rede, em segundos.

• InstallDependencies: optional. Se o valor for True, o Systems Manager instalará as dependências necessárias nas instâncias de destino. O padrão é True. As dependências são atd, dig e tc.

Parâmetros do documento

• Interface: optional. A interface de rede. O padrão é eth0.

• LossPercent: opcional. A porcentagem de perda de pacotes. O padrão é 7%.

• Sources – obrigatório. As fontes, separadas por vírgulas. Os valores possíveis são: um endereço IPv4, um bloco CIDR IPv4, um nome de domínio e DYNAMODB e S3. Se você especificar DYNAMODB ouS3, isso se aplica somente ao endpoint regional na região atual.

• TrafficType: optional. O tipo de tráfego. Os valores possíveis são ingress e egress. O padrão é ingress.

• DurationSeconds – obrigatório. A duração do teste de perda de pacotes de rede, em segundos.

• InstallDependencies: optional. Se o valor for True, o Systems Manager instalará as dependências necessárias nas instâncias de destino. O padrão é True. As dependências são atd, dig, jq e tc.