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

Personalização da imagem do contêiner

Carregar imagem do testador

Essa solução usa um repositório público de imagens do Amazon Elastic Container Registry (Amazon ECR) gerenciado pela AWS para armazenar a imagem usada para executar os testes configurados. Você pode reconstruir e enviar a imagem do contêiner para um repositório de imagens ECR em sua própria conta da AWS.

Você pode editar a imagem padrão do contêiner para atender às suas necessidades. Defina essas variáveis de ambiente antes de criar uma imagem personalizada.

#!/bin/bash
export REGION=aws-region-code # the AWS region to launch the solution (e.g. us-east-1)
export BUCKET_PREFIX=my-bucket-name # prefix of the bucket name without the region code
export BUCKET_NAME=$BUCKET_PREFIX-$REGION # full bucket name where the code will reside
export SOLUTION_NAME=my-solution-name
export VERSION=my-version # version number for the customized code
export PUBLIC_ECR_REGISTRY=public.ecr.aws/awssolutions/distributed-load-testing-on-aws-load-tester # replace with the container registry and image if you want to use a different container image export PUBLIC_ECR_TAG=v3.1.0 # replace with the container image tag if you want to use a different container image

Você pode hospedar uma imagem de contêiner personalizada em um repositório de imagens público ou privado em sua conta da AWS. Os recursos de imagem estão no deployment/ecr/distributed-load-testing-on-aws-load-tester diretório na base de código.

Em seguida, você pode criar e enviar a imagem para o destino do host.

Depois de criar a imagem personalizada, declare as seguintes variáveis de ambiente antes de criar a solução personalizada.

#!/bin/bash
export PUBLIC_ECR_REGISTRY=YOUR_ECR_REGISTRY_URI # e.g. YOUR_ACCOUNT_ID.dkr.ecr.us-east-1.amazonaws.com/YOUR_IMAGE_NAME
export PUBLIC_ECR_TAG=YOUR_ECR_TAG # e.g. latest, v3.4.0

O Dockerfile define a imagem de teste de carga. Ele se baseia em uma imagem básica do Amazon Linux, instala os tempos de execução da linguagem, os pacotes do sistema e as ferramentas de teste necessários para executar testes de carga, adiciona os arquivos de metadados da versão da estrutura e o script do load-test.sh ponto de entrada e é executado como um usuário não root. Para visualizar o Dockerfile, consulte Dockerfile no repositório. GitHub

O script do load-test.sh ponto de entrada é executado dentro do contêiner sempre que uma tarefa é iniciada. Ele lê a configuração do teste e os metadados do contêiner. Em seguida, ele baixa a definição de teste do Amazon S3 e provisiona a estrutura de teste selecionada para a execução. O script espera por um sinal de início para que todas as tarefas em um teste comecem ao mesmo tempo. Em seguida, ele executa o teste pela duração configurada enquanto produz métricas e registros. Quando o teste termina, o script coleta os resultados e os enriquece com detalhes sobre o contêiner que os produziu. Ele carrega os resultados, registros e outros artefatos para o Amazon S3. O script também manipula sinais de terminação, portanto, preserva resultados e registros parciais se você cancelar um teste antes que ele seja concluído. Para ver o script completo, consulte load-test.sh no GitHub repositório.

Imagem do console web (somente modelo ALB + ECS Fargate)

O modelo ALB + ECS Fargate executa o console web como um contêiner no ECS Fargate. Por padrão, a solução extrai a imagem do console web de um repositório público do Amazon ECR gerenciado pela AWS.

Em ambientes em que o acesso aos registros públicos de contêineres é restrito (por exemplo, VPCs sem acesso à Internet ou contas com políticas de acesso público do ECR), você deve espelhar a imagem pública em um repositório privado do Amazon ECR e fornecer o URI da imagem privada no parâmetro URI da imagem do console da Web. CloudFormation Você também pode usar as etapas a seguir para personalizar a imagem do console web.

Espelhe a imagem pública em um repositório ECR privado

Para espelhar a imagem do console web em um repositório ECR privado:

Personalize a imagem do console web

Você também pode personalizar a imagem do console web. Os recursos de imagem estão no deployment/ecr/distributed-load-testing-on-aws-web-console diretório, localizado no GitHub repositório. Você pode editar os arquivos de contêiner, criar uma imagem local, enviá-la para um repositório ECR privado e fornecer o URI da imagem resultante no parâmetro URI de imagem do console da Web.

A imagem do contêiner do console web se baseia em uma imagem base do Nginx e instala a AWS CLI. Suas cópias do Dockerfile na configuração do Nginx e em um script de ponto de entrada. O Dockerfile expõe a porta HTTP e define o script do ponto de entrada para ser executado quando o contêiner é iniciado. Quando o contêiner é iniciado, o entrypoint.sh usa a AWS CLI para baixar os ativos do console web do Amazon S3. Ele os extrai na raiz do documento Nginx e, em seguida, inicia o Nginx em primeiro plano. O nginx.conf serve o aplicativo de página única (SPA) e roteia caminhos incomparáveis de volta ao ponto de entrada do aplicativo. Ele também adiciona um endpoint de verificação de integridade para o Application Load Balancer, permite a compactação gzip, define o cache de longa duração para ativos estáticos (ao mesmo tempo em que desativa o armazenamento em cache para o ponto de entrada e a configuração do tempo de execução) e adiciona cabeçalhos comuns de resposta de segurança.

Para obter mais informações, consulte Enviando uma imagem do Docker para um repositório privado do Amazon ECR no Guia do usuário do Amazon ECR.

URI da imagem do testador de carga

Todos os três modelos de implantação (Amazon CloudFront + S3, Application Load Balancer (ALB) + ECS no AWS Fargate e headless) extraem uma imagem de contêiner do testador de carga do registro público do Amazon Elastic Container Registry (Amazon ECR) () no momento da implantação. public.ecr.aws

Em ambientes em que o acesso aos registros públicos de contêineres é restrito, espelhe a imagem do testador de carga em um repositório privado do Amazon ECR e forneça o URI da imagem privada no parâmetro Load Tester Image URI () da AWS. LoadTesterImageUri CloudFormation Exemplos comuns incluem VPCs sem acesso à Internet, contas com políticas de acesso público do ECR e regiões da AWS GovCloud (EUA), nas quais as tarefas do ECS não podem acessar o registro público do ECR. O espelhamento em um repositório privado em sua região de implantação é obrigatório para implantações da AWS GovCloud (EUA) e opcional em outros lugares.

Espelhe a imagem do testador de carga em um repositório ECR privado

Para espelhar a imagem do testador de carga em um repositório ECR privado, conclua as etapas a seguir. Nos comandos a seguir, <version> substitua pela tag de imagem (por exemplo,v4.0.0), <region> pela sua região de implantação (por exemplo,us-gov-west-1), <profile> pelo nome do perfil da AWS Command Line Interface (AWS CLI) e <account-id> pelo ID de conta da AWS de 12 dígitos.

Exemplos de implantação da AWS GovCloud (EUA)

Os exemplos a seguir mostram os parâmetros necessários para cada variante de pilha na AWS GovCloud (EUA).

Para a pilha sem cabeça, só LoadTesterImageUri é necessário:

aws cloudformation create-stack \
  --stack-name dlt-govcloud \
  --template-url https://solutions-reference-us-gov.s3.us-gov-west-1.amazonaws.com/distributed-load-testing-on-aws/latest/distributed-load-testing-on-aws-headless.template \
  --parameters \
    ParameterKey=AdminName,ParameterValue=admin \
    ParameterKey=AdminEmail,ParameterValue=admin@example.com \
    ParameterKey=LoadTesterImageUri,ParameterValue=<account-id>.dkr.ecr.us-gov-west-1.amazonaws.com/dlt-load-tester:<version> \
  --capabilities CAPABILITY_IAM \
  --region us-gov-west-1

Para o Application Load Balancer (ALB) + ECS na pilha AWS Fargate, forneça e. LoadTesterImageUri WebConsoleImageUri As tarefas do ECS na AWS GovCloud (EUA) não podem acessar o registro público do ECR (public.ecr.aws), portanto, você deve espelhar as duas imagens do contêiner.

aws cloudformation create-stack \
  --stack-name dlt-govcloud \
  --template-url https://solutions-reference-us-gov.s3.us-gov-west-1.amazonaws.com/distributed-load-testing-on-aws/latest/distributed-load-testing-on-aws-alb-ecs.template \
  --parameters \
    ParameterKey=AdminName,ParameterValue=admin \
    ParameterKey=AdminEmail,ParameterValue=admin@example.com \
    ParameterKey=ConsoleDomainName,ParameterValue=dlt.example.gov \
    ParameterKey=ACMCertificateArn,ParameterValue=arn:aws-us-gov:acm:us-gov-west-1:123456789012:certificate/abcd1234-ef56-gh78-ij90-klmnopqrstuv \
    ParameterKey=LoadTesterImageUri,ParameterValue=<account-id>.dkr.ecr.us-gov-west-1.amazonaws.com/dlt-load-tester:<version> \
    ParameterKey=WebConsoleImageUri,ParameterValue=<account-id>.dkr.ecr.us-gov-west-1.amazonaws.com/dlt-web-console:<version> \
  --capabilities CAPABILITY_IAM \
  --region us-gov-west-1

Para obter instruções sobre como espelhar a imagem do console web, consulte Imagem do console web.