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.
eb create
Descripción
Crea un nuevo entorno e implementa una versión de la aplicación en él.
nota
Para usar el comando eb create en una aplicación .NET, debe crear un paquete de implementación como se describe en Creación de un paquete de código fuente para una aplicación .NET, después definir la configuración de la CLI para implementar el paquete como un artefacto, como se describe en Implementar un artefacto en lugar de la carpeta del proyecto.
-
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
.
Puede implementar la versión de la aplicación desde varios orígenes:
-
De forma predeterminada: desde el código fuente de la aplicación en el directorio de proyectos locales.
-
Mediante la opción
--version
: desde una versión de la aplicación que ya existe en su aplicación. -
Cuando el directorio de proyectos no tiene código de aplicación o al utilizar la opción
--sample
: implementada desde una aplicación de ejemplo, específica de la plataforma de su entorno.
Sintaxis
eb create
eb create environment-name
Un nombre de entorno debe tener una longitud entre 8 y 64 caracteres. Solo puede contener letras, números y guiones (-). Un nombre de entorno no puede empezar ni terminar con un guion.
Si incluye un nombre del entorno en el comando, la CLI de EB no le pedirá que seleccione ningún valor ni que cree un rol de servicio.
Si ejecuta el comando sin argumento de nombre de entorno, se ejecuta en un flujo interactivo y le pide que escriba o seleccione valores para algunos ajustes. En este flujo interactivo, en caso de que esté implementando una aplicación de ejemplo, la CLI de EB también le pregunta si desea descargar esta aplicación de ejemplo en el directorio de proyectos locales. Al descargarlo, puede utilizar la CLI de EB con el nuevo entorno más tarde para ejecutar las operaciones que requieran el código de la aplicación, como por ejemplo eb deploy.
Algunas solicitudes de flujo interactivo solo se muestran en determinadas condiciones. Por ejemplo, si elige utilizar un Application Load Balancer y su cuenta tiene al menos un Application Load Balancer compartible, Elastic Beanstalk mostrará un mensaje que le preguntará si desea utilizar un balanceador de carga compartido. Si no existe un Application Load Balancer compartible en su cuenta, este mensaje no se muestra.
Opciones
Ninguna de estas opciones es obligatoria. Si ejecuta eb create sin ninguna opción, la CLI de EB le pedirá que escriba o seleccione un valor para cada ajuste.
Nombre |
Descripción |
---|---|
o bien
|
Establece el entorno como predeterminado en el repositorio actual. |
|
Utilice los ajustes de la plataforma de una configuración guardada en |
o bien
|
Nombre del subdominio que se va a incluir como prefijo en la entrada DNS de CNAME que direcciona el tráfico al sitio web. Tipo: String Valor predeterminado: nombre del entorno. |
o bien
|
Adjunta una base de datos al entorno. Si ejecuta eb create con la opción |
o bien
|
Tipo de motor de base de datos. Si ejecuta eb create con esta opción, la CLI de EB lanza el entorno con una base de datos adjuntada. Este es el caso incluso si no ejecutó el comando con la opción Tipo: String Valores válidos: |
o bien
|
Tipo de Amazon EC2 instance que se va a utilizar con la base de datos. Si ejecuta eb create con esta opción, la CLI de EB lanza el entorno con una base de datos adjuntada. Este es el caso incluso si no ejecutó el comando con la opción Tipo: cadena Valores válidos: Amazon RDS es compatible con un conjunto estándar de instancias de base de datos. Para seleccionar una instancia de base de datos adecuada para su motor de base de datos, es necesario tener en cuenta algunos aspectos específicos. Para obtener más información, consulte Clases de instancia de base de datos en la Guía del usuario de Amazon RDS. |
o bien
|
Contraseña de la base de datos. Si ejecuta eb create con esta opción, la CLI de EB lanza el entorno con una base de datos adjuntada. Este es el caso incluso si no ejecutó el comando con la opción |
o bien
|
Número de gigabytes (GB) que se van a asignar al almacenamiento de la base de datos. Si ejecuta eb create con esta opción, la CLI de EB lanza el entorno con una base de datos adjuntada. Este es el caso incluso si no ejecutó el comando con la opción Tipo: Number Valores válidos:
|
o bien
|
Nombre de usuario de la base de datos. Si ejecuta eb create con esta opción, la CLI de EB lanza el entorno con una base de datos adjuntada aunque el comando no se ejecute con la opción |
o bien
|
Utilizado para especificar la versión del motor de base de datos. Si esta marca esta presente, el entorno se lanzará con una base de datos que tiene el número de versión especificado, aunque no se incluya la marca |
|
El tipo de balanceador de carga. Tipo: String Valores válidos: Valor predeterminado: |
o bien
|
Habilite las solicitudes de instancias de spot para su entorno. Para obtener más información, consulte Grupo de Auto Scaling. Opciones relacionadas:
|
--env-group-suffix |
El nombre del grupo que se agrega nombre del entorno. Solo se utiliza con Compose Environments. |
|
Propiedades del entorno en una lista separada por comas con el formato |
o bien
|
El perfil de instancia con la función de IAM con las credenciales de seguridad temporales que la aplicación necesita para acceder a AWS los recursos. |
o
|
Una lista separada por comas de los tipos de Amazon EC2 instance que desea utilizar en el entorno. Si no especifica esta opción, Elastic Beanstalk proporciona tipos de instancia predeterminados. Para obtener más información, consulte Instancias de Amazon EC2 y Grupo de Auto Scaling. importanteLa CLI de EB sólo aplica esta opción a instancias Spot. A menos que esta opción se use con la opción |
o bien
|
El tipo de Amazon EC2 instance que desea que se utilice en el entorno. Si no especifica esta opción, Elastic Beanstalk proporciona un tipo de instancia predeterminado. Para obtener más información, consulte Instancias de Amazon EC2. importanteLa CLI de EB sólo aplica esta opción a instancias en diferido. No utilice esta opción con la opción |
o bien
|
Nombre del par de claves de Amazon EC2 que se va a utilizar con el cliente de Secure Shell (SSH) para iniciar sesión de forma segura en las instancias de Amazon EC2 que ejecutan su aplicación Elastic Beanstalk. Si incluye esta opción con el comando eb create, el valor que proporcione anulará cualquier nombre de clave que haya especificado con eb init. Valores válidos: nombre de clave existente que esté registrado con Amazon EC2. |
o
|
El número mínimo de instancias de Amazon EC2 necesarias para su entorno. Tipo: número (entero) Valor predeterminado: Valores válidos: de |
o
|
El número máximo de instancias de Amazon EC2 que permite para su entorno. Tipo: número (entero) Valor predeterminado: Valores válidos: de |
|
Una lista de los entornos de componentes que se van a crear. Solo se utiliza con Entornos compuestos. |
o bien
|
Número mínimo de instancias en diferido que el grupo de Auto Scaling aprovisiona antes de considerar la posibilidad de utilizar instancias de spot cuando se amplía el entorno. Esta opción solo se puede especificar con Tipo: número (entero) Valor predeterminado: Valores válidos: de |
o bien
|
El porcentaje de instancias en diferido como parte de la capacidad adicional que el grupo de Auto Scaling aprovisiona además del número de instancias especificado mediante la opción Esta opción solo se puede especificar con Tipo: número (entero) Valor predeterminado: Valores válidos: de |
o bien
|
La versión de la plataforma que se va a usar. Puede especificar una plataforma, una plataforma y la versión, una rama de la plataforma, el nombre de una pila de soluciones o el ARN de una pila de soluciones. Por ejemplo:
Utilice eb platform list para obtener una lista con las configuraciones disponibles. Si especifica la opción |
o bien
|
Procesar previamente y validar el manifiesto del entorno y los archivos de configuración del paquete de código fuente. La validación de los archivos de configuración puede identificar los problemas antes de implementar la versión de la aplicación en un entorno. |
o bien
|
La AWS región en la que desea implementar la aplicación. Para obtener la lista de valores que puede especificar para esta opción, consulte Puntos de enlace y cuotas de AWS Elastic Beanstalk en la Referencia general de AWS. |
|
Implemente la aplicación de ejemplo en el nuevo entorno en lugar del código del repositorio. |
|
Lance el número especificado de instancias. |
--service-role rolDeServicio |
Asigne al entorno un rol de servicio que no sea el predeterminado. notaNo ingrese un ARN. Ingrese sólo el nombre de rol. Elastic Beanstalk agrega como prefijo los valores correctos al nombre de rol para crear internamente el ARN resultante. |
o bien
|
Configure el entorno para utilizar un balanceador de carga compartido. Proporcione el nombre o ARN de un balanceador de carga compartible en su cuenta, un Application Load Balancer que haya creado explícitamente, no uno creado por otro entorno de Elastic Beanstalk. Para obtener más información, consulte Balanceador de carga de aplicaciones compartido.. Ejemplos de parámetros:
Puede especificar esta opción solo con |
o bien
|
Puerto de agente de escucha predeterminado del balanceador de carga compartido para este entorno. Elastic Beanstalk agrega una regla de escucha que enruta todo el tráfico de este agente de escucha al proceso de entorno predeterminado. Para obtener más información, consulte Balanceador de carga de aplicaciones compartido.. Tipo: número (entero) Valor predeterminado: Valores válidos: cualquier entero que represente un puerto de agente de escucha del balanceador de carga compartido. |
|
Cree el entorno con una sola Amazon EC2 instance y sin un balanceador de carga. avisoUn entorno de una sola instancia no está preparado para producción. Si la instancia se vuelve inestable durante la implementación o Elastic Beanstalk termina y reinicia la instancia durante una actualización de la configuración, es posible que la aplicación no esté disponible durante algún tiempo. Utilice entornos de una sola instancia para desarrollo, pruebas o ensayos. Utilice entornos con balanceo de carga para producción. |
o bien
|
El precio máximo unidad por hora, en dólares estadounidenses, que está dispuesto a pagar por una instancia de Spot. Esta opción solo se puede especificar con Tipo: número (float) Predeterminado: precio en diferido, para cada tipo de instancias. En este caso, el valor de la opción es Valores válidos: de Para obtener recomendaciones sobre las opciones de precio máximo para las instancias puntuales, consulte el historial de precios de las instancias puntuales en la Guía del usuario de Amazon EC2. |
|
Etiquete los recursos del entorno. Las etiquetas se especifican como una lista de pares Para obtener más información, consulte Etiquetado de entornos. |
o bien
|
Cree un entorno de trabajo. Omita esta opción para crear un entorno de servidor web. |
|
Establezca el número de minutos que deben transcurrir antes de que se agote el tiempo de espera del comando. |
|
Especifica la versión de la aplicación que se va a implementar en el entorno en lugar del código fuente de la aplicación del directorio de proyectos local. Tipo: String Valores válidos: etiqueta de la versión de la aplicación existente. |
|
Configure una VPC para el entorno. Cuando se incluye esta opción, la CLI de EB le pide que configure todos los ajustes obligatorios antes de lanzar el entorno. |
|
Especifica subredes para las instancias de base de datos de una VPC. Es obligatorio cuando se especifica |
|
Especifica subredes para las instancias Amazon EC2 de una VPC. Es obligatorio cuando se especifica |
|
Inicia el balanceador de carga Elastic Load Balancing en una subred pública de la VPC. No puede especificar esta opción con las opciones |
|
Especifica subredes para el balanceador de carga Elastic Load Balancing en una VPC. No puede especificar esta opción con las opciones |
|
Lanza el entorno en la VPC especificada. |
|
Lanza instancias de Amazon EC2 en una subred pública de la VPC. No puede especificar esta opción con la opción |
|
Especifica los ID de grupo de seguridad. Es obligatorio cuando se especifica |
Salida
Si se ejecuta correctamente, el comando le hará preguntas y después devolverá el estado de la operación de creación. Si hubiera algún problema durante el lanzamiento, utilice la operación eb events para obtener más detalles.
Si habilitó el CodeBuild soporte en su aplicación, eb create muestra la información a CodeBuild medida que se crea el código. Para obtener información sobre el CodeBuild soporte de Elastic Beanstalk, consulte. Uso de la CLI de EB con AWS CodeBuild
Ejemplos
En el siguiente ejemplo, se crea un entorno en modo interactivo.
$ eb create
Enter Environment Name
(default is tmp-dev): ENTER
Enter DNS CNAME prefix
(default is tmp-dev): ENTER
Select a load balancer type
1) classic
2) application
3) network
(default is 2): ENTER
Environment details for: tmp-dev
Application name: tmp
Region: us-east-2
Deployed Version: app-141029_145448
Environment ID: e-um3yfrzq22
Platform: 64bit Amazon Linux 2014.09 v1.0.9 running PHP 5.5
Tier: WebServer-Standard-1.0
CNAME: tmp-dev.elasticbeanstalk.com
Updated: 2014-10-29 21:54:51.063000+00:00
Printing Status:
...
En el siguiente ejemplo también se crea un entorno en modo interactivo. En este ejemplo, su directorio de proyecto no tiene código de aplicación. El comando implementa una aplicación de ejemplo y la descarga en el directorio de proyectos local.
$ eb create
Enter Environment Name
(default is tmp-dev): ENTER
Enter DNS CNAME prefix
(default is tmp-dev): ENTER
Select a load balancer type
1) classic
2) application
3) network
(default is 2): ENTER
NOTE: The current directory does not contain any source code. Elastic Beanstalk is launching the sample application instead.
Do you want to download the sample application into the current directory?
(Y/n): ENTER
INFO: Downloading sample application to the current directory.
INFO: Download complete.
Environment details for: tmp-dev
Application name: tmp
Region: us-east-2
Deployed Version: Sample Application
Environment ID: e-um3yfrzq22
Platform: 64bit Amazon Linux 2014.09 v1.0.9 running PHP 5.5
Tier: WebServer-Standard-1.0
CNAME: tmp-dev.elasticbeanstalk.com
Updated: 2017-11-08 21:54:51.063000+00:00
Printing Status:
...
El siguiente comando crea un entorno sin plantear ninguna pregunta.
$ eb create dev-env
Creating application version archive "app-160312_014028".
Uploading test/app-160312_014028.zip to S3. This may take a while.
Upload Complete.
Application test has been created.
Environment details for: dev-env
Application name: test
Region: us-east-2
Deployed Version: app-160312_014028
Environment ID: e-6fgpkjxyyi
Platform: 64bit Amazon Linux 2015.09 v2.0.8 running PHP 5.6
Tier: WebServer-Standard
CNAME: UNKNOWN
Updated: 2016-03-12 01:40:33.614000+00:00
Printing Status:
...
El siguiente comando crea un entorno en una VPC personalizada.
$ eb create dev-vpc --vpc.id vpc-0ce8dd99 --vpc.elbsubnets subnet-b356d7c6,subnet-02f74b0c --vpc.ec2subnets subnet-0bb7f0cd,subnet-3b6697c1 --vpc.securitygroup sg-70cff265
Creating application version archive "app-160312_014309".
Uploading test/app-160312_014309.zip to S3. This may take a while.
Upload Complete.
Environment details for: dev-vpc
Application name: test
Region: us-east-2
Deployed Version: app-160312_014309
Environment ID: e-pqkcip3mns
Platform: 64bit Amazon Linux 2015.09 v2.0.8 running Java 8
Tier: WebServer-Standard
CNAME: UNKNOWN
Updated: 2016-03-12 01:43:14.057000+00:00
Printing Status:
...