Notificações AMI do AMS com SNS - Guia do usuário avançado do AMS

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

Notificações AMI do AMS com SNS

O AMS fornece um serviço de notificação da AMI. Você pode usá-lo para assinar um tópico do Amazon Simple Notification Service (SNS) que notifica você quando as atualizações da AMI do AMS forem lançadas. Você pode optar por receber notificações somente para o AMS AMIs que você usa, ou você pode se inscrever para receber notificações de atualização para todos os AMS AMIs. Para obter mais informações sobre tópicos do SNS, consulte O que é o Amazon Simple Notification Service?

Sempre que AMIs são lançados, enviamos notificações aos assinantes do tópico correspondente; esta seção descreve como assinar as notificações da AMI do AMS.

Exemplo de mensagem

{
  "Type" : "Notification",
  "MessageId" : "example messageId",
  "TopicArn" : "arn:aws:sns:us-east-1:591688410472:customer-ams-windows2019",
  "Subject" : "New AMS AMIs are Now Available",
  "Message" : "{"v1": {"Message": "A new version of the AMS Amazon Machine Images has been released. You are now able to launch new EC2 stacks from these AMIs. 
  Please use this time to update any dependencies such as CloudFormation or Autoscaling groups. Release Notes Windows - Contains latest Windows Patches: 
  Microsoft Windows Server 2008 R2 Datacenter - (KB2819745, KB3018238, KB4507004, KB4507437) Microsoft Windows Server 2016 Datacenter Security Enhancedn - (KB4509091, KB4507459) 
  Microsoft Windows Server 2016 Datacentern - (KB4509091, KB4507459) Microsoft Windows Server 2012 R2 Security Enhancedn - (KB3191564, KB3003057, KB3013172, KB3185319, KB4504418, 
  KB4506996, KB4507463) Microsoft Windows Server 2012 R2 Standardn - (KB3003057, KB3013172, KB3185319, KB4504418, KB4506996, KB4507463) Linux - Contains latest Linux patches - 
  All AMIs now force domainjoin-cli leave before domainjoin-cli join for better stability in the domain join process.", "images": 
  {"images": {"image_name": "customer-ams-windows2019-2021.08-1", "image_id": "ami-05dfa45396fddaa5e"}}, "region": "us-east-1"}}",
  "Timestamp" : "2021-09-03T19:05:57.882Z",
  "SignatureVersion" : "1",
  "Signature" : "example sig",
  "SigningCertURL" : "example url",
  "UnsubscribeURL" : "example url"
}

Possíveis tópicos da AMI do AMS para se inscrever:

  • TUDO: Usecustomer-ams-all-amis. A assinatura deste tópico notifica você quando qualquer um dos AMS AMIs é atualizado.

  • AMS AWS Linux AMIs: Para Amazon Linux, use customer-ams-amazon1 customer-ams-amazon1-security-enhanced e. Para Amazon Linux 2, use customer-ams-amazon2 customer-ams-amazon2-security-enhanced e.

  • AMS SUSE Linux AMIs: Use customer-ams-sles12 oucustomer-ams-sles15.

  • AMS AWS RedHat AMIs: Usecustomer-ams-rhel8,customer-ams-rhel8-security-enhanced,customer-ams-rhel7,customer-ams-rhel7-security-enhanced.

  • AMS AWS CentOs AMIs: Usocustomer-ams-centos7,customer-ams-centos7-security-enhanced.

  • AMS Ubuntu AMIs: Usecustomer-ams-ubuntu18.

  • AMS AWS Windows AMIs: Usecustomer-ams-windows2019,customer-ams-windows2019-security-enhanced,customer-ams-windows2016,customer-ams-windows2016-security-enhanced,customer-ams-windows2012,customer-ams-windows2012r2,customer-ams-windows2012r2-security-enhanced,customer-ams-windows2022.

Para assinar as novas notificações de AMI do AMS usando o console do Amazon SNS:

  1. Abra o console do Amazon SNS no Painel.

  2. No canto superior direito, mude para a região da AWS da AMIs qual você está se inscrevendo.

  3. No painel de navegação esquerdo, escolha Assinaturas e, em seguida, escolha Criar assinatura.

  4. Forneça as informações a seguir:

    1. ARN do tópico: arn:aws:sns:{REGION}:287847593866:{AMS_AMI_NAME} onde REGION é a região selecionada da AWS (onde a notificação do SNS foi criada) e AMS_AMI_NAME é a AMI sobre a qual você deseja receber notificações. Exemplos:

      • Para assinar notificações do novo AMS Amazon Linux AMIs na região us-east-1 da AWS, use este tópico ARN =. arn:aws:sns:us-east-1:287847593866:customer-ams-amazon1

      • Para assinar notificações do novo AMS Window Server 2016 AMIs na região us-west-2 da AWS, use este tópico ARN = arn:aws:sns:us-west-2:287847593866:customer-ams-windows2016

    2. Em Protocol (Protocolo), escolha Email.

    3. Em Endpoint, insira um endereço de e-mail que possa ser usado para receber notificações. Recomendamos uma lista de distribuição em vez do e-mail de um indivíduo.

  5. Selecione Criar assinatura.

  6. Ao receber um e-mail de confirmação com o assunto “Notificação da AWS — Confirmação da assinatura”, abra o e-mail e escolha Confirmar assinatura para concluir sua assinatura.

nota

Você não está limitado ao e-mail para o Protocolo. Para obter informações sobre outros protocolos aceitáveis e como usá-los, consulte inscrever-se.

Para cancelar a assinatura de novas notificações de AMI do AMS usando o console do AWS SNS:

  1. Abra o console do Amazon SNS no Painel.

  2. Na barra de navegação, mude para a região da AWS de sua escolha. Você deve usar a região da AWS na qual deseja receber notificações para a região correspondente AMIs.

  3. No painel de navegação, escolha Assinaturas, selecione a assinatura e escolha Ações -> Excluir assinaturas.

  4. Quando a confirmação for solicitada, escolha Excluir.

Para assinar as notificações da nova AMI do AMS usando o Deployment | Inestion | Stack from CloudFormation Template | Create (ct-36cn2avfrrj9v):

  1. Para assinar AmazonLinuxSubscription, crie e salve um arquivo JSON de parâmetros de execução; este exemplo o chama de CreateSubscribeAmiParams .json:

    {
    "AWSTemplateFormatVersion": "2010-09-09",
    "Resources": {
        "AmazonLinuxSubscription":{
              "Type" : "AWS::SNS::Subscription",
              "Properties": {
                "TopicArn": "arn:aws:sns:{REGION}:287847593866:{AMS_AMI_NAME}",
                "Protocol": "email",
                "Endpoint": "username@yourdomain.com"
            }
        }
      }
}

  2. Crie e salve o arquivo JSON de parâmetros RFC com o conteúdo a seguir; este exemplo o chama de CreateSubscribeAmiRfc arquivo.json:

    {
   "ChangeTypeId": "ct-36cn2avfrrj9v",
   "ChangeTypeVersion": "1.0",
   "Title": "cfn-ingest-subscribe-ami"
}

  3. Crie o RFC, especificando o CreateSubscribeAmiRfc arquivo e o CreateSubscribeAmiParams arquivo:

    aws amscm create-rfc --cli-input-json file://CreateSubscribeAmiRfc.json  --execution-parameters file://CreateSubscribeAmiParams.json

    Você recebe a ID da nova RFC na resposta e pode usá-la para enviar e monitorar a RFC. Até que você o envie, o RFC permanece no estado de edição e não inicia.

Para ver exemplos de criação AMIs, consulte Criar AMI.

Para obter informações sobre o consumo AMIs programático, consulte EC2 stack: creating.