Administración de entornos de Elastic Beanstalk con la CLI de EB - AWS Elastic Beanstalk
Eb createEb statusEb healthEb eventsEb logsEb openEb deployEb configEb terminate

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Administración de entornos de Elastic Beanstalk con la CLI de EB

Después de instalar la CLI de EB y configurar el directorio del proyecto, estará listo para crear un entorno de Elastic Beanstalk mediante la CLI de EB, para implementar el código fuente y las actualizaciones de configuración y para obtener registros y eventos.

nota

Para crear entornos con la CLI de EB, se requiere una función de servicio. Puede crear una función de servicio creando un entorno en la consola de Elastic Beanstalk. Si no cuenta con ninguna función de servicio, el EB CLI intentará crear uno cuando ejecute eb create.

La CLI de EB devuelve un código de salida cero (0) para todos los comandos correctos y un código de salida distinto de cero cuando encuentra un error.

Los siguientes ejemplos utilizan una carpeta del proyecto vacía llamada eb que se ha inicializado con la CLI de EB para usarla con una aplicación Docker de ejemplo.

Eb create

Para crear su primer entorno, ejecute eb create y siga las instrucciones. Si el directorio del proyecto contiene código fuente, la CLI de EB lo empaquetará e implementará en su entorno. De lo contrario, se usará una aplicación de ejemplo.

~/eb$ eb create
Enter Environment Name
(default is eb-dev): eb-dev
Enter DNS CNAME prefix
(default is eb-dev): eb-dev
WARNING: The current directory does not contain any source code. Elastic Beanstalk is launching the sample application instead.
Environment details for: elasticBeanstalkExa-env
  Application name: elastic-beanstalk-example
  Region: us-west-2
  Deployed Version: Sample Application
  Environment ID: e-j3pmc8tscn
  Platform: 64bit Amazon Linux 2015.03 v1.4.3 running Docker 1.6.2
  Tier: WebServer-Standard
  CNAME: eb-dev.elasticbeanstalk.com
  Updated: 2015-06-27 01:02:24.813000+00:00
Printing Status:
INFO: createEnvironment is starting.
 -- Events -- (safe to Ctrl+C) Use "eb abort" to cancel the command.

Pueden transcurrir varios minutos hasta que su entorno esté preparado. Presione Ctrl+C para volver a la línea de comandos mientras se crea el entorno.

Eb status

Ejecute eb status para ver el estado actual de su entorno. Cuando el estado es ready, la aplicación de ejemplo está disponible en elasticbeanstalk.com y el entorno está listo para su actualización.

~/eb$ eb status
Environment details for: elasticBeanstalkExa-env
  Application name: elastic-beanstalk-example
  Region: us-west-2
  Deployed Version: Sample Application
  Environment ID: e-gbzqc3jcra
  Platform: 64bit Amazon Linux 2015.03 v1.4.3 running Docker 1.6.2
  Tier: WebServer-Standard
  CNAME: elasticbeanstalkexa-env.elasticbeanstalk.com
  Updated: 2015-06-30 01:47:45.589000+00:00
  Status: Ready
  Health: Green

Eb health

Utilice el comando eb health para ver información de estado de las instancias de su entorno y el estado general del entorno. Utilice la opción --refresh para ver el estado en una vista interactiva que se actualiza cada 10 segundos.

~/eb$ eb health
 api                                    Ok                 2016-09-15 18:39:04
WebServer                                                               Java 8
  total      ok    warning  degraded  severe    info   pending  unknown
    3        3        0        0        0        0        0        0

  instance-id           status     cause                                health
    Overall             Ok
  i-0ef05ec54918bf567   Ok
  i-001880c1187493460   Ok
  i-04703409d90d7c353   Ok

  instance-id           r/sec    %2xx   %3xx   %4xx   %5xx      p99      p90      p75     p50     p10
    Overall             8.6     100.0    0.0    0.0    0.0    0.083*   0.065    0.053   0.040   0.019
  i-0ef05ec54918bf567   2.9        29      0      0      0    0.069*   0.066    0.057   0.050   0.023
  i-001880c1187493460   2.9        29      0      0      0    0.087*   0.069    0.056   0.050   0.034
  i-04703409d90d7c353   2.8        28      0      0      0    0.051*   0.027    0.024   0.021   0.015

  instance-id           type       az   running     load 1  load 5      user%  nice%  system%  idle%   iowait%
  i-0ef05ec54918bf567   t2.micro   1c   23 mins       0.19    0.05        3.0    0.0      0.3   96.7       0.0
  i-001880c1187493460   t2.micro   1a   23 mins        0.0     0.0        3.2    0.0      0.3   96.5       0.0
  i-04703409d90d7c353   t2.micro   1b   1 day          0.0     0.0        3.6    0.0      0.2   96.2       0.0

  instance-id           status     id   version                  ago                                deployments
  i-0ef05ec54918bf567   Deployed   28   app-bc1b-160915_181041   20 mins
  i-001880c1187493460   Deployed   28   app-bc1b-160915_181041   20 mins
  i-04703409d90d7c353   Deployed   28   app-bc1b-160915_181041   27 mins

Eb events

Utilice eb events para ver una lista de eventos generados por Elastic Beanstalk.

~/eb$ eb events
2015-06-29 23:21:09    INFO    createEnvironment is starting.
2015-06-29 23:21:10    INFO    Using elasticbeanstalk-us-east-2-EXAMPLE as Amazon S3 storage bucket for environment data.
2015-06-29 23:21:23    INFO    Created load balancer named: awseb-e-g-AWSEBLoa-EXAMPLE
2015-06-29 23:21:42    INFO    Created security group named: awseb-e-gbzqc3jcra-stack-AWSEBSecurityGroup-EXAMPLE
...

Eb logs

Utilice eb logs para obtener los registros de una instancia de su entorno. De forma predeterminada,eb logs obtiene los registros de la primera instancia lanzada y los muestra en la salida estándar. Puede especificar un ID de instancia con la opción --instance para obtener los registros de una instancia específica.

La opción --all obtiene los registros de todas las instancias y los guarda en subdirectorios bajo .elasticbeanstalk/logs.

~/eb$ eb logs --all
Retrieving logs...
Logs were saved to /home/local/ANT/mwunderl/ebcli/environments/test/.elasticbeanstalk/logs/150630_201410
Updated symlink at /home/local/ANT/mwunderl/ebcli/environments/test/.elasticbeanstalk/logs/latest

Eb open

Para abrir el sitio web de su entorno en un navegador, utilice eb open:

~/eb$ eb open

En un entorno con ventanas, su navegador predeterminado se abrirá en una nueva ventana. En un entorno de terminal, se usará un explorador de línea de comandos (como w3m) si está disponible.

Eb deploy

Una vez que el entorno esté listo, puede actualizarlo mediante eb deploy.

Este comando funciona mejor con código fuente que se vaya a empaquetar e implementar, así que para este ejemplo hemos creado un Dockerfile en el directorio del proyecto con el siguiente contenido:

~/eb/Dockerfile

FROM ubuntu:12.04

RUN apt-get update
RUN apt-get install -y nginx zip curl

RUN echo "daemon off;" >> /etc/nginx/nginx.conf
RUN curl -o /usr/share/nginx/www/master.zip -L https://codeload.github.com/gabrielecirulli/2048/zip/master
RUN cd /usr/share/nginx/www/ && unzip master.zip && mv 2048-master/* . && rm -rf 2048-master master.zip

EXPOSE 80

CMD ["/usr/sbin/nginx", "-c", "/etc/nginx/nginx.conf"]

Este Dockerfile implementa una imagen de Ubuntu 12.04 e instala el juego 2048. Ejecute eb deploy para cargar la aplicación en su entorno:

~/eb$ eb deploy
Creating application version archive "app-150630_014338".
Uploading elastic-beanstalk-example/app-150630_014338.zip to S3. This may take a while.
Upload Complete.
INFO: Environment update is starting.
 -- Events -- (safe to Ctrl+C) Use "eb abort" to cancel the command.

Cuando ejecuta eb deploy, la CLI de EB empaqueta el contenido del directorio del proyecto y lo implementa en su entorno.

nota

Si ha inicializado un repositorio Git en la carpeta del proyecto, la CLI de EB siempre implementará la última validación, aunque tenga cambios pendientes. Valide los cambios antes de ejecutar eb deploy para implementarlos en su entorno.

Eb config

Eche un vistazo a las opciones de configuración disponibles para su entorno en ejecución con el comando eb config:

~/eb$ eb config
ApplicationName: elastic-beanstalk-example
DateUpdated: 2015-06-30 02:12:03+00:00
EnvironmentName: elasticBeanstalkExa-env
SolutionStackName: 64bit Amazon Linux 2015.03 v1.4.3 running Docker 1.6.2
settings:
  AWSEBAutoScalingScaleDownPolicy.aws:autoscaling:trigger:
    LowerBreachScaleIncrement: '-1'
  AWSEBAutoScalingScaleUpPolicy.aws:autoscaling:trigger:
    UpperBreachScaleIncrement: '1'
  AWSEBCloudwatchAlarmHigh.aws:autoscaling:trigger:
    UpperThreshold: '6000000'
...

Este comando rellena una lista de opciones de configuración disponibles en un editor de texto. Muchas de las opciones que se muestran tienen un valor null; estas opciones no están configuradas de forma predeterminada, pero pueden modificarse para actualizar los recursos de su entorno. Para obtener más información sobre estas opciones, consulte Opciones de configuración.

Eb terminate

Si ha terminado de usar el entorno de momento, use eb terminate para terminarlo.

~/eb$ eb terminate
The environment "eb-dev" and all associated instances will be terminated.
To confirm, type the environment name: eb-dev
INFO: terminateEnvironment is starting.
INFO: Deleted CloudWatch alarm named: awseb-e-jc8t3pmscn-stack-AWSEBCloudwatchAlarmHigh-1XLMU7DNCBV6Y
INFO: Deleted CloudWatch alarm named: awseb-e-jc8t3pmscn-stack-AWSEBCloudwatchAlarmLow-8IVI04W2SCXS
INFO: Deleted Auto Scaling group policy named: arn:aws:autoscaling:us-east-2:123456789012:scalingPolicy:1753d43e-ae87-4df6-a405-11d31f4c8f97:autoScalingGroupName/awseb-e-jc8t3pmscn-stack-AWSEBAutoScalingGroup-90TTS2ZL4MXV:policyName/awseb-e-jc8t3pmscn-stack-AWSEBAutoScalingScaleUpPolicy-A070H1BMUQAJ
INFO: Deleted Auto Scaling group policy named: arn:aws:autoscaling:us-east-2:123456789012:scalingPolicy:1fd24ea4-3d6f-4373-affc-4912012092ba:autoScalingGroupName/awseb-e-jc8t3pmscn-stack-AWSEBAutoScalingGroup-90TTS2ZL4MXV:policyName/awseb-e-jc8t3pmscn-stack-AWSEBAutoScalingScaleDownPolicy-LSWFUMZ46H1V
INFO: Waiting for EC2 instances to terminate. This may take a few minutes.
 -- Events -- (safe to Ctrl+C)

Para obtener una lista completa de comandos de la CLI de EB disponibles, consulte la Referencia de los comandos de la CLI de EB.

importante

Si termina un entorno, también debe eliminar todas las asignaciones de CNAME que ha creado, ya que otros clientes pueden reutilizar un nombre de host disponible. Asegúrese de eliminar los registros de DNS que apuntan a su entorno terminado para evitar que se cree una entrada de DNS colgante. Una entrada de DNS colgante puede exponer el tráfico de Internet destinado a su dominio a vulnerabilidades de seguridad. También puede presentar otros riesgos.

Para más información, consulte Protección contra registros de delegación colgantes en Route 53 en la Guía para desarrolladores de Amazon Route 53. También puede obtener más información sobre las entradas de DNS colgantes en Protecciones de dominio mejoradas para solicitudes de Amazon CloudFront en el Blog de seguridad de AWS.