Adicionar e personalizar recursos do ambiente do Elastic Beanstalk - AWS Elastic Beanstalk

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

Adicionar e personalizar recursos do ambiente do Elastic Beanstalk

Você também pode personalizar seus recursos de ambiente que são parte do ambiente do Elastic Beanstalk. Por exemplo, é possível adicionar uma fila do Amazon SQS e um alarme sobre o comprimento da fila, ou adicionar um cluster do Amazon ElastiCache. Você pode personalizar facilmente seu ambiente ao mesmo tempo que implanta a versão do aplicativo incluindo um arquivo de configuração com o pacote de origem.

Você pode usar a chave Resources em um arquivo de configuração para criar e personalizar recursos da AWS em seu ambiente. Os recursos definidos em arquivos de configuração são adicionados ao modelo do AWS CloudFormation usado para iniciar seu ambiente. Todos os tipos de recursos do AWS CloudFormation são suportados https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-template-resource-type-ref.html.

nota

Sempre que você adicionar um recurso que não seja gerenciado pelo Elastic Beanstalk, certifique-se de adicionar uma política de usuário com as permissões apropriadas aos usuários do AWS Identity and Access Management (IAM). As políticas de usuário gerenciadas que o Elastic Beanstalk fornece apenas permissões de cobertura para recursos gerenciados pelo Elastic Beanstalk.

Por exemplo, o arquivo de configuração a seguir adiciona um gancho de ciclo de vida do Auto Scaling ao grupo de Auto Scaling padrão criado pelo Elastic Beanstalk:

~/my-app/.ebextensions/as-hook.config

Resources:
  hookrole:
    Type: AWS::IAM::Role
    Properties:
      AssumeRolePolicyDocument: {
               "Version" : "2012-10-17",
               "Statement": [ {
                  "Effect": "Allow",
                  "Principal": {
                     "Service": [ "autoscaling.amazonaws.com" ]
                  },
                  "Action": [ "sts:AssumeRole" ]
               } ]
            }
      Policies: [ {
               "PolicyName": "SNS",
               "PolicyDocument": {
                      "Version": "2012-10-17",
                      "Statement": [{
                          "Effect": "Allow",
                          "Resource": "*",
                          "Action": [
                              "sqs:SendMessage",
                              "sqs:GetQueueUrl",
                              "sns:Publish"
                          ]
                        }
                      ]
                  }
               } ]
  hooktopic:
    Type: AWS::SNS::Topic
    Properties:
      Subscription:
        - Endpoint: "my-email@example.com"
          Protocol: email
  lifecyclehook:
    Type: AWS::AutoScaling::LifecycleHook
    Properties:
      AutoScalingGroupName: { "Ref" : "AWSEBAutoScalingGroup" }
      LifecycleTransition: autoscaling:EC2_INSTANCE_TERMINATING
      NotificationTargetARN: { "Ref" : "hooktopic" }
      RoleARN: { "Fn::GetAtt" : [ "hookrole", "Arn"] }

Este exemplo define três recursos: hookrole, hooktopic e lifecyclehook. Os dois primeiros recursos são uma função do IAM, que concede ao Amazon EC2 Auto Scaling permissão para publicar mensagens no Amazon SNS e um tópico SNS, que retransmite mensagens do grupo de Auto Scaling para um endereço de e-mail. O Elastic Beanstalk cria esses recursos com as propriedades e os tipos especificados.

O recurso final, lifecyclehook, é o ciclo de vida do gancho propriamente dito:

  lifecyclehook:
    Type: AWS::AutoScaling::LifecycleHook
    Properties:
      AutoScalingGroupName: { "Ref" : "AWSEBAutoScalingGroup" }
      LifecycleTransition: autoscaling:EC2_INSTANCE_TERMINATING
      NotificationTargetARN: { "Ref" : "hooktopic" }
      RoleARN: { "Fn::GetAtt" : [ "hookrole", "Arn"] }

A definição de gancho do ciclo de vida usa duas funções para preencher valores para as propriedades do gancho. { "Ref" : "AWSEBAutoScalingGroup" } recupera o nome do grupo de Auto Scaling criado pelo Elastic Beanstalk para o ambiente. AWSEBAutoScalingGroup é um dos nomes de recurso padrão fornecidos pelo Elastic Beanstalk.

Para AWS::IAM::Role, Ref retorna somente o nome da função, não o nome de região da Amazon (ARN). Para obter o ARN para o parâmetro RoleARN, use outra função intrínseca, Fn::GetAtt, que pode obter qualquer atributo de um recurso. RoleARN: { "Fn::GetAtt" : [ "hookrole", "Arn"] } obtém o atributo Arn do recurso hookrole.

{ "Ref" : "hooktopic" } obtém o ARN do tópico do Amazon SNS criado anteriormente no arquivo de configuração. O valor retornado por Ref varia por tipo de recurso e pode ser encontrado no tópico do Guia do Usuário do AWS CloudFormation para o tipo de recurso AWS::SNS::Topic.