"`. Para especificar el nombre de archivo sin un`path`, guárdelo en la carpeta en la que ejecuta el comando. Como alternativa, especifique el nombre del archivo al proporcionar la ruta completa. La información de configuración debe cumplir las siguientes condiciones. Se requiere al menos una de las secciones**OptionSettings** o **OptionsToRemove**. Se utiliza**OptionSettings** para agregar o cambiar opciones. Se utiliza**OptionsToRemove** para quitar opciones de un espacio de nombres. Para obtener ejemplos específicos, consulte la sección [Ejemplos](#eb3-configexample) , más adelante en este tema.
**Example**
*Formato YAML*
```
OptionSettings:
namespace1:
option-name-1: option-value-1
option-name-2: option-value-2
...
OptionsToRemove:
namespace1:
option-name-1
option-name-2
...
```
**Example**
*Formato JSON*
```
{
"OptionSettings": {
"namespace1": {
"option-name-1": "option-value-1",
"option-name-2": "option-value-2",
...
}
},
"OptionsToRemove": {
"namespace1": {
"option-name-1",
"option-name-2",
...
}
}
}
``` |
| [Opciones comunes](eb3-cmd-options.md) | |
## Output
Si el comando **eb config** o **eb config *environment-name*** se ejecuta correctamente sin agregar subcomandos ni opciones, el comando muestra la configuración de la opción actual en el editor de texto que configuró como variable de entorno EDITOR. Si no ha configurado una variable de entorno EDITOR, la CLI de EB muestra la configuración de opciones en el editor predeterminado para los archivos YAML.
Cuando guarda los cambios en el archivo y cierra el editor, el entorno se actualiza con la configuración de opciones que ha guardado en el archivo. Se muestra el siguiente resultado para confirmar la actualización de la configuración.
```
$ eb config myApp-dev
Printing Status:
2021-05-19 18:09:45 INFO Environment update is starting.
2021-05-19 18:09:55 INFO Updating environment myApp-dev's configuration settings.
2021-05-19 18:11:20 INFO Successfully deployed new configuration to environment.
```
Si el comando se ejecuta correctamente con la opción `--display` , muestra los valores de configuración del entorno actual (escribe en* stdout*).
Si el comando se ejecuta correctamente con el parámetro `get`, muestra la ubicación de la copia local que ha descargado.
Si el comando se ejecuta correctamente con el parámetro `save`, muestra la ubicación del archivo guardado.
## Ejemplos
En esta sección se describe cómo cambiar el editor de texto que utiliza para ver y editar el archivo de configuración de opciones.
Para Linux y UNIX, el siguiente ejemplo cambia el editor a vim:
```
$ export EDITOR=vim
```
Para Linux y UNIX, el siguiente ejemplo cambia el editor a lo que esté instalado en `/usr/bin/kate`.
```
$ export EDITOR=/usr/bin/kate
```
Para Windows, el siguiente ejemplo cambia el editor a Notepad\$1\$1.
```
> set EDITOR="C:\Program Files\Notepad++\Notepad++.exe
```
En esta sección se proporcionan ejemplos del comando **eb config** cuando se ejecuta con subcomandos.
En el ejemplo siguiente se elimina la configuración guardada denominad `app-tmp`.
```
$ eb config delete app-tmp
```
El siguiente ejemplo descarga la configuración guardada con el nombre app-tmp de su bucket de Amazon S3.
```
$ eb config get app-tmp
```
El siguiente ejemplo muestra los nombres de las configuraciones guardadas almacenadas en el bucket de Amazon S3.
```
$ eb config list
```
El siguiente ejemplo carga la copia local de la configuración guardada con el nombre app-tmp en su bucket de Amazon S3.
```
$ eb config put app-tmp
```
El siguiente ejemplo guarda las opciones de configuración del entorno en ejecución actual. Si no proporciona un nombre para utilizarlo en la configuración guardada, Elastic Beanstalk nombra el archivo de configuración según el nombre del entorno. Por ejemplo, un entorno llamado* tmp-dev* se denominaría `tmp-dev.cfg.yml`. Elastic Beanstalk guarda el archivo en la carpeta `/.elasticbeanstalk/saved_configs/` .
```
$ eb config save
```
En el ejemplo siguiente, se utiliza la opción `--cfg` para guardar los valores de configuración del entorno tmp-dev en un archivo denominado`v1-app-tmp.cfg.yml`. Elastic Beanstalk guarda el archivo en la carpeta `/.elasticbeanstalk/saved_configs/`. Si no especifica un nombre de entorno, Elastic Beanstalk guarda los valores de configuración del entorno en ejecución actual.
```
$ eb config save tmp-dev --cfg v1-app-tmp
```
En esta sección se proporcionan ejemplos del comando **eb config** cuando se ejecuta sin subcomandos.
El siguiente comando muestra la configuración de opciones del entorno actual en un editor de texto.
```
$ eb config
```
El siguiente comando muestra la configuración de opciones del entorno* my-env* en un editor de texto.
```
$ eb config my-env
```
En el ejemplo siguiente se muestra la configuración de opciones del entorno actual. Se produce en formato YAML porque no se especificó ningún formato puntual con la opción `--format` .
```
$ eb config --display
```
En el siguiente ejemplo se actualiza la configuración de opciones del entorno actual con las especificaciones del archivo denominad `example.txt`. El archivo está en formato YAML o JSON. La CLI de EB detecta automáticamente el formato de archivo.
+ La opción Minsize se establece en 1 para el espacio de nombre `aws:autoscaling:asg`.
+ El tamaño del lote del espacio de nombres`aws:elasticbeanstalk:command` se establece en 30 %.
+ Elimina la configuración de la opción *IdleTimeout: Ninguna* del espacio de nombres`AWSEBV2LoadBalancer.aws:elbv2:loadbalancer`.
```
$ eb config --update "file://example.txt"
```
**Example - nombre de archivo:`example.txt` , formato YAML**
```
OptionSettings:
'aws:elasticbeanstalk:command':
BatchSize: '30'
BatchSizeType: Percentage
'aws:autoscaling:asg':
MinSize: '1'
OptionsToRemove:
'AWSEBV2LoadBalancer.aws:elbv2:loadbalancer':
IdleTimeout
```
**Example - nombre de archivo:`example.txt` , formato JSON**
```
{
"OptionSettings": {
"aws:elasticbeanstalk:command": {
"BatchSize": "30",
"BatchSizeType": "Percentage"
},
"aws:autoscaling:asg": {
"MinSize": "1"
}
},
"OptionsToRemove": {
"AWSEBV2LoadBalancer.aws:elbv2:loadbalancer": {
"IdleTimeout"
}
}
}
```
En los ejemplos siguientes se actualizan la configuración de opciones del entorno actual. El comando establece la opción Minsize en 1 para el espacio de nombres `aws:autoscaling:asg` .
**nota**
Estos ejemplos son específicos de Windows. PowerShell Escapa de las apariciones literales del carácter de comilla doble (`"`) al precederlo con un carácter de barra inclinada (`\`). Los distintos sistemas operativos y entornos de línea de comandos pueden tener secuencias de escape diferentes. Por este motivo, recomendamos utilizar la opción de archivo que se muestra en los ejemplos anteriores. La especificación de las opciones de configuración en un archivo no requiere caracteres de escape y es coherente en distintos sistemas operativos.
El siguiente ejemplo está en formato JSON. La CLI de EB detecta si el formato está en JSON o YAML.
```
PS C:\Users\myUser\EB_apps\myApp-env>eb config --update '{\"OptionSettings\":{\"aws:autoscaling:asg\":{\"MaxSize\":\"1\"}}}'
```
El siguiente ejemplo está en formato YAML. Para introducir la cadena YAML en el formato correcto, el comando incluye los espacios y end-of-line retornos necesarios en un archivo YAML.
+ Finaliza cada línea con la tecla “enter” (ingresar) o “return” (volver).
+ Comience la segunda línea con dos espacios y la tercera línea con cuatro espacios.
```
PS C:\Users\myUser\EB_apps\myApp-env>eb config --update 'OptionSettings:
>> aws:autoscaling:asg:
>> MinSize: \"1\"'
```
# **eb console**
## Description (Descripción)
Abra un navegador para mostrar el panel de configuración del entorno en la consola de administración de Elastic Beanstalk.
Si el directorio raíz contiene un archivo `platform.yaml` donde se especifica una plataforma personalizada, este comando mostrará también la configuración del entorno del constructor, tal y como se especifica en el archivo `platform.yaml`, en la consola de administración de Elastic Beanstalk.
## Sintaxis
**eb console**
**eb console *environment-name***
## Opciones
****
| Name | Descripción |
| --- | --- |
| [Opciones comunes](eb3-cmd-options.md) | |
# **eb create**
## Description (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](applications-sourcebundle.md#using-features.deployment.source.dotnet), 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](eb-cli3-configuration.md#eb-cli3-artifact).
Para crear entornos con la CLI de EB, se requiere un [rol de servicio](concepts-roles-service.md). Puede crear un rol de servicio creando un entorno en la consola de Elastic Beanstalk. Si no cuenta con ningún rol 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 muestra, específica de la plataforma de su entorno.
## Sintaxis
**eb create**
**eb create *environment-name***
Un nombre de entorno debe tener una longitud entre 4 y 40 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 muestra, la CLI de EB también le pregunta si desea descargar esta aplicación de muestra 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**](eb3-deploy.md).
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 equilibrador 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 |
| --- | --- |
| `-d` o bien `--branch_default` | Establece el entorno como predeterminado en el repositorio actual. |
| `--cfg` *config-name* | [Utilice los ajustes de la plataforma de una configuración guardada](environment-configuration-methods-during.md#configuration-options-during-ebcli-savedconfig) en `.elasticbeanstalk/saved_configs/` o en el bucket de Amazon S3. Especifique el nombre del archivo sin la extensión `.cfg.yml`. |
| `-c` *subdomain-name* o `--cname` *subdomain-name* | 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. |
| `-db` o bien `--database` | Adjunta una base de datos al entorno. Si ejecuta **eb create** con la opción `--database` pero sin las opciones `--database.username` y `--database.password`, la CLI de EB le pide el nombre del usuario principal y la contraseña de la base de datos. |
| `-db.engine` *engine* o `--database.engine` *engine* | 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 `--database`. Tipo: String Valores válidos: `mysql`, `oracle-se1`, `postgres`, `sqlserver-ex`, `sqlserver-web`, `sqlserver-se` |
| `-db.i` *instance\$1type* o `--database.instance` *instance\$1type* | El tipo de EC2 instancia de Amazon que se va a utilizar para 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 `--database`. 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](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Concepts.DBInstanceClass.html) en la *Guía del usuario de Amazon RDS*. |
| `-db.pass` *password* o `--database.password` *password* | 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 `--database`. |
| `-db.size` *number\$1of\$1gigabytes* o `--database.size` *number\$1of\$1gigabytes* | 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 `--database`. Tipo: Number Valores válidos: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/elasticbeanstalk/latest/dg/eb3-create.html) |
| `-db.user` *username* o `--database.username` *username* | 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 `--database`. Si ejecuta **eb create** con la opción `--database` pero sin las opciones `--database.username` y `--database.password`, la CLI de EB le pide el nombre de usuario maestro y la contraseña maestra de la base de datos. |
| `-db.version` *version* o `--database.version` *version* | 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 `--database`. |
| `--elb-type` *type* | El [tipo de equilibrador de carga](using-features.managing.elb.md). Tipo: String Valores válidos: `classic`, `application`, `network` Valor predeterminado: `application` |
| `-es` o bien `--enable-spot` | Habilite las solicitudes de instancias de spot para su entorno. Para obtener más información, consulte [Grupo de escalado automático](using-features.managing.as.md). Opciones relacionadas: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/elasticbeanstalk/latest/dg/eb3-create.html) |
| --env-group-suffix groupname | El nombre del grupo que se agrega nombre del entorno. Solo se utiliza con [Compose Environments](ebcli-compose.md). |
| `--envvars` | [Propiedades del entorno](environments-cfg-softwaresettings.md) en una lista separada por comas con el formato *name* =. *value* Consulte [Configuración de las propiedades del entorno (variables de entorno)](environments-cfg-softwaresettings.md#environments-cfg-softwaresettings-console) para ver los límites. |
| `-ip` *profile\$1name* o `--instance_profile` *profile\$1name* | El perfil de instancia con la función de IAM con las credenciales de seguridad temporales que la aplicación necesita para acceder a los recursos. AWS |
| `-it` o `--instance-types type1[,type2 ...]` | Una lista separada por comas de los tipos de EC2 instancias de Amazon que quieres que utilice tu entorno. Si no especifica esta opción, Elastic Beanstalk proporciona tipos de instancia predeterminados. Para obtener más información, consulte [ EC2 Instancias de Amazon](using-features.managing.ec2.md) y [Grupo de escalado automático](using-features.managing.as.md). La CLI de EB sólo aplica esta opción a instancias Spot. A menos que esta opción se use con la opción `--enable-spot`, la CLI de EB la ignora. Para especificar un tipo de instancia para una instancia en diferido, utilice la herramienta `--intance-type` (sin “s”) en su lugar. |
| `-i` o `--instance_type` | El tipo de EC2 instancia de Amazon que desea que utilice su entorno. Si no especifica esta opción, Elastic Beanstalk proporciona un tipo de instancia predeterminado. Para obtener más información, consulte [ EC2 Instancias de Amazon](using-features.managing.ec2.md). La CLI de EB sólo aplica esta opción a instancias en diferido. No utilice esta opción con la opción `--enable-spot`, porque la CLI de EB la ignora cuando lo hace. Para especificar tipos de instancia para una instancia Spot, utilice la herramienta `--intance-types` (sin “s”) en su lugar. |
| `-k` *key\$1name* o `--keyname` *key\$1name* | El nombre del par de EC2 claves de Amazon que se utilizará con el cliente Secure Shell (SSH) para iniciar sesión de forma segura en las EC2 instancias de Amazon que ejecutan la aplicación de 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: un nombre de clave existente registrado en Amazon EC2 |
| `-im` *number-of-instances* o `--min-instances` *number-of-instances* | El número mínimo de EC2 instancias de Amazon que necesita que tenga su entorno. Tipo: número (entero) Valor predeterminado: `1` Valores válidos: de `1` a `10000` |
| `-ix` *number-of-instances* o `--max-instances` *number-of-instances* | El número máximo de EC2 instancias de Amazon que permite que tenga su entorno. Tipo: número (entero) Valor predeterminado: `4` Valores válidos: de `1` a `10000` |
| `--modules` *component-a component-b* | Una lista de los entornos de componentes que se van a crear. Solo se utiliza con [Entornos compuestos](ebcli-compose.md). |
| `-sb` o bien `--on-demand-base-capacity` | Número mínimo de instancias en diferido que el grupo de escalado automático 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 `--enable-spot`. Para obtener más información, consulte [Grupo de escalado automático](using-features.managing.as.md). Tipo: número (entero) Valor predeterminado: `0` Valores válidos: de `0` a `--max-instances` (cuando no hay ningún valor: opción `MaxSize` del espacio de nombres [`aws:autoscaling:asg`](command-options-general.md#command-options-general-autoscalingasg)) |
| `-sp` o bien `--on-demand-above-base-capacity` | El porcentaje de instancias en diferido como parte de la capacidad adicional que el grupo de escalado automático aprovisiona además del número de instancias especificado mediante la opción `--on-demand-base-capacity`. Esta opción solo se puede especificar con `--enable-spot`. Para obtener más información, consulte [Grupo de escalado automático](using-features.managing.as.md). Tipo: número (entero) Valor predeterminado: `0` para un entorno de una sola instancia; `70` para un entorno con balanceo de carga Valores válidos: de `0` a `100` |
| `-p` *platform-version* o `--platform` *platform-version* | La [versión de la plataforma](concepts.platforms.md) 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: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/elasticbeanstalk/latest/dg/eb3-create.html) Utilice [`eb platform list`](eb3-platform.md) para obtener una lista con las configuraciones disponibles. Si especifica la opción `--platform`, anula el valor que se proporcionó durante `eb init`. |
| `-pr` o bien `--process` | 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. |
| `-r` *region* o `--region` *region* | 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 conexión y cuotas de AWS Elastic Beanstalk](https://docs.aws.amazon.com/general/latest/gr/elasticbeanstalk.html) en la *Referencia general de AWS*. |
| `--sample` | Implemente la aplicación de muestra en el nuevo entorno en lugar del código del repositorio. |
| `--scale` *number-of-instances* | Lance el número especificado de instancias. |
| --service-role servicerole | Asigne al entorno un rol de servicio que no sea el predeterminado. No 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. |
| `-ls` *load-balancer* o `--shared-lb` *load-balancer* | Configure el entorno para utilizar un equilibrador de carga compartido. Proporcione el nombre o ARN de un equilibrador 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.](environments-cfg-alb-shared.md). Ejemplos de parámetros: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/elasticbeanstalk/latest/dg/eb3-create.html) Puede especificar esta opción solo con `--elb-type application`. Si especifica esa opción y no especifica `--shared-lb`, Elastic Beanstalk crea un equilibrador de carga dedicado para el entorno. |
| `-lp` *port* o `--shared-lb-port` *port* | Puerto de agente de escucha predeterminado del equilibrador 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.](environments-cfg-alb-shared.md). Tipo: número (entero) Valor predeterminado: `80` Valores válidos: cualquier entero que represente un puerto de agente de escucha del equilibrador de carga compartido. |
| `--single` | Cree el entorno con una sola EC2 instancia de Amazon y sin un balanceador de carga. Un 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. |
| `-sm` o bien `--spot-max-price` | 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 `--enable-spot`. Para obtener más información, consulte [Grupo de escalado automático](using-features.managing.as.md). Tipo: número (float) Predeterminado: precio en diferido, para cada tipo de instancias. En este caso, el valor de la opción es `null`. Valores válidos: de `0.001` a `20.0` Para obtener recomendaciones sobre las opciones de precio máximo para las instancias puntuales, consulte el [historial de precios de las instancias puntuales](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-spot-instances-history.html) en la *Guía del EC2 usuario de Amazon*. |
| `--tags key1=value1[,key2=value2 ...]` | Etiquete los recursos del entorno. Las etiquetas se especifican como una lista de pares `key=value` separados por comas. Para obtener más información, consulte [Entornos de etiquetado](using-features.tagging.md). |
| `-t worker` o bien `--tier worker` | Cree un entorno de trabajo. Omita esta opción para crear un entorno de servidor web. |
| `--timeout` *minutes* | Establezca el número de minutos que deben transcurrir antes de que se agote el tiempo de espera del comando. |
| `--version` *version\$1label* | 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. |
| `--vpc` | 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. |
| `--vpc.dbsubnets subnet1,subnet2` | Especifica subredes para las instancias de base de datos de una VPC. Es obligatorio cuando se especifica `--vpc.id`. |
| `--vpc.ec2subnets subnet1,subnet2` | Especifica las subredes para las EC2 instancias de Amazon en una VPC. Es obligatorio cuando se especifica `--vpc.id`. |
| `--vpc.elbpublic` | Inicia el equilibrador de carga Elastic Load Balancing en una subred pública de la VPC. No puede especificar esta opción con las opciones `--tier worker` o `--single`. |
| `--vpc.elbsubnets subnet1,subnet2` | Especifica subredes para el equilibrador de carga Elastic Load Balancing en una VPC. No puede especificar esta opción con las opciones `--tier worker` o `--single`. |
| `--vpc.id ID` | Lanza el entorno en la VPC especificada. |
| `--vpc.publicip` | Lanza tus EC2 instancias de Amazon en una subred pública de tu VPC. No puede especificar esta opción con la opción `--tier worker`. |
| `--vpc.securitygroups securitygroup1,securitygroup2` | Especifica el grupo de seguridad. IDs Es obligatorio cuando se especifica `--vpc.id`. |
| [Opciones comunes](eb3-cmd-options.md) | |
## Output
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**](eb3-events.md) para obtener más detalles.
Si habilitó la CodeBuild compatibilidad 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](eb-cli-codebuild.md)
## 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 muestra 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:
...
```
# **eb deploy**
## Description (Descripción)
Implementa el paquete de código fuente de la aplicación desde el directorio del proyecto inicializado en la aplicación en ejecución.
Si se instala Git, la CLI de EB utiliza el comando `git archive` para crear un archivo `.zip` a partir del contenido del comando `git commit` más reciente.
Sin embargo, cuando `.ebignore` se encuentra en su directorio de proyecto, la CLI de EB no utiliza comandos ni semántica de git para crear el paquete de código fuente. Esto significa que la CLI de EB omite los archivos especificados en `.ebignore` e incluye todos los demás archivos. En concreto, incluye archivos de código fuente sin validar.
**nota**
Puede configurar la CLI de EB para implementar un artefacto de su proceso de compilación en lugar de crear un archivo ZIP de la carpeta del proyecto. Para obtener más información, consulte [Implementar un artefacto en lugar de la carpeta del proyecto](eb-cli3-configuration.md#eb-cli3-artifact).
## Sintaxis
**eb deploy**
**eb deploy *environment-name***
## Opciones
****
| Name | Descripción |
| --- | --- |
| `-l` *version\$1label* o bien `--label` *version\$1label* | Especifique una etiqueta para usarla con la versión que crea la CLI de EB. Si la etiqueta ya se ha utilizado, la CLI de EB vuelve a implementar la versión anterior a dicha etiqueta. Tipo: String |
| --env-group-suffix groupname | Nombre del grupo que se agrega al nombre del entorno. Solo se utiliza con [Compose Environments](ebcli-compose.md). |
| `-m` "*version\$1description*" o `--message` "*version\$1description*" | La descripción de la versión de la aplicación, incluida entre comillas dobles. Tipo: cadena |
| `--modules` *component-a component-b* | Lista de componentes que se van a actualizar. Solo se utiliza con [Compose Environments](ebcli-compose.md). |
| `-p` o bien `--process` | 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. |
| `--source codecommit/repository-name/branch-name` | CodeCommit repositorio y sucursal. |
| `--staged` | Implementar archivos almacenados en el índice de git en lugar de la validación HEAD. |
| `--timeout` *minutes* | Número de minutos que deben transcurrir antes de que se agote el tiempo de espera del comando. |
| `--version` *version\$1label* | La versión de la aplicación existente que se va a implementar. Tipo: String |
| [Opciones comunes](eb3-cmd-options.md) | |
## Output
Si se ejecuta correctamente, el comando devuelve el estado de la operación `deploy`.
Si habilitaste el CodeBuild soporte en tu aplicación, **eb deploy** 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](eb-cli-codebuild.md)
## Ejemplo
En el ejemplo siguiente, se implementa la aplicación actual.
```
$ eb deploy
2018-07-11 21:05:22 INFO: Environment update is starting.
2018-07-11 21:05:27 INFO: Deploying new version to instance(s).
2018-07-11 21:05:53 INFO: New application version was deployed to running EC2 instances.
2018-07-11 21:05:53 INFO: Environment update completed successfully.
```
# **eb events**
## Description (Descripción)
Muestra los eventos más recientes del entorno.
Si el directorio raíz contiene un archivo `platform.yaml` donde se especifica una plataforma personalizada, este comando también devuelve los eventos más recientes del entorno del constructor.
## Sintaxis
**eb events**
**eb events *environment-name***
## Opciones
****
| Name | Descripción |
| --- | --- |
| `-f` o bien `--follow` | Muestra secuencias de eventos. Para cancelar, pulse CTRL\$1C. |
## Output
Si se ejecuta correctamente, el comando devuelve los eventos recientes.
## Ejemplo
En el siguiente ejemplo, se devuelven los eventos más recientes.
```
$ eb events
2014-10-29 21:55:39 INFO createEnvironment is starting.
2014-10-29 21:55:40 INFO Using elasticbeanstalk-us-west-2-111122223333 as Amazon S3 storage bucket for environment data.
2014-10-29 21:55:57 INFO Created load balancer named: awseb-e-r-AWSEBLoa-NSKUOK5X6Z9J
2014-10-29 21:56:16 INFO Created security group named: awseb-e-rxgrhjr9bx-stack-AWSEBSecurityGroup-1UUHU5LZ20ZY7
2014-10-29 21:57:18 INFO Waiting for EC2 instances to launch. This may take a few minutes.
2014-10-29 21:57:18 INFO Created Auto Scaling group named: awseb-e-rxgrhjr9bx-stack-AWSEBAutoScalingGroup-1TE320ZCJ9RPD
2014-10-29 21:57:22 INFO Created Auto Scaling group policy named: arn:aws:autoscaling:us-east-2:11122223333:scalingPolicy:2cced9e6-859b-421a-be63-8ab34771155a:autoScalingGroupName/awseb-e-rxgrhjr9bx-stack-AWSEBAutoScalingGroup-1TE320ZCJ9RPD:policyName/awseb-e-rxgrhjr9bx-stack-AWSEBAutoScalingScaleUpPolicy-1I2ZSNVU4APRY
2014-10-29 21:57:22 INFO Created Auto Scaling group policy named: arn:aws:autoscaling:us-east-2:11122223333:scalingPolicy:1f08b863-bf65-415a-b584-b7fa3a69a0d5:autoScalingGroupName/awseb-e-rxgrhjr9bx-stack-AWSEBAutoScalingGroup-1TE320ZCJ9RPD:policyName/awseb-e-rxgrhjr9bx-stack-AWSEBAutoScalingScaleDownPolicy-1E3G7PZKZPSOG
2014-10-29 21:57:25 INFO Created CloudWatch alarm named: awseb-e-rxgrhjr9bx-stack-AWSEBCloudwatchAlarmLow-VF5EJ549FZBL
2014-10-29 21:57:25 INFO Created CloudWatch alarm named: awseb-e-rxgrhjr9bx-stack-AWSEBCloudwatchAlarmHigh-LA9YEW3O6WJO
2014-10-29 21:58:50 INFO Added EC2 instance 'i-c7ee492d' to Auto ScalingGroup 'awseb-e-rxgrhjr9bx-stack-AWSEBAutoScalingGroup-1TE320ZCJ9RPD'.
2014-10-29 21:58:53 INFO Successfully launched environment: tmp-dev
2014-10-29 21:59:14 INFO Environment health has been set to GREEN
2014-10-29 21:59:43 INFO Adding instance 'i-c7ee492d' to your environment.
```
# **eb health**
## Description (Descripción)
Devuelve el estado más reciente del entorno.
Si el directorio raíz contiene un archivo `platform.yaml` donde se especifica una plataforma personalizada, este comando también devuelve el estado más reciente del entorno del constructor.
## Sintaxis
**eb health**
**eb health *environment-name***
## Opciones
****
| Name | Descripción |
| --- | --- |
| `-r` o bien `--refresh` | Muestra información de estado de forma interactiva y la actualiza cada 10 segundos cuando se registra nueva información. |
| --mono | No muestra ningún color en la salida. |
## Output
Si se ejecuta correctamente, el comando devuelve el estado reciente.
## Ejemplo
En el siguiente ejemplo se devuelve la información de estado más reciente para un entorno Linux.
```
~/project $ eb health
elasticBeanstalkExa-env Ok 2015-07-08 23:13:20
WebServer Ruby 2.1 (Puma)
total ok warning degraded severe info pending unknown
5 5 0 0 0 0 0 0
instance-id status cause health
Overall Ok
i-d581497d Ok
i-d481497c Ok
i-136e00c0 Ok
i-126e00c1 Ok
i-8b2cf575 Ok
instance-id r/sec %2xx %3xx %4xx %5xx p99 p90 p75 p50 p10 requests
Overall 671.8 100.0 0.0 0.0 0.0 0.003 0.002 0.001 0.001 0.000
i-d581497d 143.0 1430 0 0 0 0.003 0.002 0.001 0.001 0.000
i-d481497c 128.8 1288 0 0 0 0.003 0.002 0.001 0.001 0.000
i-136e00c0 125.4 1254 0 0 0 0.004 0.002 0.001 0.001 0.000
i-126e00c1 133.4 1334 0 0 0 0.003 0.002 0.001 0.001 0.000
i-8b2cf575 141.2 1412 0 0 0 0.003 0.002 0.001 0.001 0.000
instance-id type az running load 1 load 5 user% nice% system% idle% iowait% cpu
i-d581497d t2.micro 1a 12 mins 0.0 0.04 6.2 0.0 1.0 92.5 0.1
i-d481497c t2.micro 1a 12 mins 0.01 0.09 5.9 0.0 1.6 92.4 0.1
i-136e00c0 t2.micro 1b 12 mins 0.15 0.07 5.5 0.0 0.9 93.2 0.0
i-126e00c1 t2.micro 1b 12 mins 0.17 0.14 5.7 0.0 1.4 92.7 0.1
i-8b2cf575 t2.micro 1c 1 hour 0.19 0.08 6.5 0.0 1.2 92.1 0.1
instance-id status id version ago deployments
i-d581497d Deployed 1 Sample Application 12 mins
i-d481497c Deployed 1 Sample Application 12 mins
i-136e00c0 Deployed 1 Sample Application 12 mins
i-126e00c1 Deployed 1 Sample Application 12 mins
i-8b2cf575 Deployed 1 Sample Application 1 hour
```
# **eb init**
## Description (Descripción)
Establece valores predeterminados para las aplicaciones de Elastic Beanstalk que se han creado con la CLI de EB a través de una serie de preguntas.
**nota**
Los valores que se establecen con **eb init** se aplican únicamente al directorio y repositorio actuales del equipo actualmente en uso.
El comando crea una aplicación de Elastic Beanstalk en su cuenta. Para crear un entorno de Elastic Beanstalk, ejecute **[eb create](eb3-create.md)** después de ejecutarlo **eb init**.
## Sintaxis
**eb init**
**eb init** *application-name*
## Opciones
Si ejecuta **eb init** sin especificar la opción `--platform`, la CLI de EB le pedirá que especifique un valor para cada ajuste.
**nota**
Si desea utilizar **eb init** para crear un nuevo par de claves, `ssh-keygen` debe estar instalado en la máquina local y disponible desde la línea de comando.
****
| Nombre | Descripción | |
| --- | --- | --- |
| `-i` `--interactive` | Obliga a la CLI de EB a pedirle un valor para cada opción del comando **eb init**. El comando `init` le pide que proporcione valores para las opciones del comando **eb init** que no tienen ningún valor (predeterminado). Después de ejecutar por primera vez el comando **eb init** en un directorio, es posible que la CLI de EB no le pida valores para las opciones del comando. En este caso, utilice la opción `--interactive` cuando desee cambiar un ajuste que configuró previamente. | |
| `-k` *keyname* `--keyname` *keyname* | El nombre del par de EC2 claves de Amazon que se utilizará con el cliente Secure Shell (SSH) para iniciar sesión de forma segura en las EC2 instancias de Amazon que ejecutan la aplicación de Elastic Beanstalk. | |
| `--modules folder-1 folder-2` | Muestra los directorios secundarios que se van a inicializar. Solo se utiliza con [Compose Environments](ebcli-compose.md). | |
| `-p` *platform-version* `--platform` *platform-version* | La [versión de la plataforma](concepts.platforms.md) 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: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/elasticbeanstalk/latest/dg/eb3-init.html) Utilice [`eb platform list`](eb3-platform.md) para obtener una lista con las configuraciones disponibles. Especifique la opción `--platform` para omitir la configuración interactiva. Si especifica esta opción, la CLI de EB no le pedirá valores para ninguna otra opción. En su lugar, presupondrá los valores predeterminados para cada opción. Puede especificar todas las opciones para las que no desee utilizar valores predeterminados. | |
| `--source codecommit/repository-name/branch-name` | CodeCommit repositorio y sucursal. | |
| `--tags key1=value1[,key2=value2 ...]` | Etiquete su aplicación. Las etiquetas se especifican como una lista de pares `key=value` separados por comas. Para obtener más información, consulte [Etiquetado de aplicaciones](applications-tagging.md). |
| [Opciones comunes](eb3-cmd-options.md) | | |
## CodeBuild soporte
Si ejecuta **eb init** en una carpeta que contiene un archivo [buildspec.yml](https://docs.aws.amazon.com/codebuild/latest/userguide/build-spec-ref.html) Elastic Beanstalk analiza el archivo en busca de una entrada **eb\$1codebuild\$1settings** con opciones específicas de Elastic Beanstalk. Para obtener información sobre el CodeBuild soporte de Elastic Beanstalk, consulte. [Uso de la CLI de EB con AWS CodeBuild](eb-cli-codebuild.md)
## Output
Si se ejecuta correctamente, el comando le guía por el proceso de configuración de una nueva aplicación de Elastic Beanstalk a través una serie de mensajes.
## Ejemplo
La solicitud de ejemplo siguiente inicializa la CLI de EB y le pide que especifique información sobre la aplicación. Sustituya *placeholder* el texto por sus propios valores.
```
$ eb init -i
Select a default region
1) us-east-1 : US East (N. Virginia)
2) us-west-1 : US West (N. California)
3) us-west-2 : US West (Oregon)
4) eu-west-1 : Europe (Ireland)
5) eu-central-1 : Europe (Frankfurt)
6) ap-south-1 : Asia Pacific (Mumbai)
7) ap-southeast-1 : Asia Pacific (Singapore)
...
(default is 3): 3
Select an application to use
1) HelloWorldApp
2) NewApp
3) [ Create new Application ]
(default is 3): 3
Enter Application Name
(default is "tmp"):
Application tmp has been created.
It appears you are using PHP. Is this correct?
(y/n): y
Select a platform branch.
1) PHP 7.2 running on 64bit Amazon Linux
2) PHP 7.1 running on 64bit Amazon Linux (Deprecated)
3) PHP 7.0 running on 64bit Amazon Linux (Deprecated)
4) PHP 5.6 running on 64bit Amazon Linux (Deprecated)
5) PHP 5.5 running on 64bit Amazon Linux (Deprecated)
6) PHP 5.4 running on 64bit Amazon Linux (Deprecated)
(default is 1): 1
Do you want to set up SSH for your instances?
(y/n): y
Select a keypair.
1) aws-eb
2) [ Create new KeyPair ]
(default is 2): 1
```
# **eb labs**
## Description (Descripción)
Subcomandos de **eb labs** soporte work-in-progress o funcionalidad experimental. Estos comandos pueden eliminarse o modificarse en futuras versiones de la CLI de EB y no se garantiza su compatibilidad con versiones posteriores.
Para ver una lista de los comandos secundarios disponibles y sus descripciones, ejecute **eb labs --help**.
# **eb list**
## Description (Descripción)
Muestra todos los entornos de la aplicación actual o todos los entornos de todas las aplicaciones, según se especifique en la opción `--all`.
Si el directorio raíz contiene un archivo `platform.yaml` que especifica una plataforma personalizada, este comando también muestra los entornos de constructor.
## Sintaxis
**eb list**
## Opciones
****
| Name | Descripción |
| --- | --- |
| `-a` o bien `--all` | Muestra todos los entornos de todas las aplicaciones. |
| `-v` o bien `--verbose` | Proporciona información más detallada sobre todos los entornos, incluidas las instancias. |
| [Opciones comunes](eb3-cmd-options.md) | |
## Output
Si se ejecuta correctamente, el comando devuelve una lista de nombres de entorno en la que su entorno actual está marcado con un asterisco (\$1).
## Ejemplo 1
El siguiente ejemplo muestra sus entornos e indica que tmp-dev es su entorno predeterminado.
```
$ eb list
* tmp-dev
```
## Ejemplo 2
El siguiente ejemplo muestra sus entornos con detalles adicionales.
```
$ eb list --verbose
Region: us-west-2
Application: tmp
Environments: 1
* tmp-dev : ['i-c7ee492d']
```
# **eb local**
## Description (Descripción)
Utilice **eb local run** para ejecutar localmente los contenedores de la aplicación en Docker. Compruebe el estado del contenedor de la aplicación con **eb local status**. Abra la aplicación en un navegador web con **eb local open**. Recupere la ubicación de los registros de la aplicación con **eb local logs**.
**eb local setenv** y **eb local printenv** le permiten configurar y ver las variables de entorno proporcionadas para los contenedores de Docker que se ejecutaron localmente con **eb local run**.
Debe ejecutar todos los comandos **eb local** del directorio del proyecto de una aplicación de Docker que se haya inicializado como un repositorio de la CLI de EB mediante **eb init**.
**nota**
Utilice **eb local** en un equipo local que ejecute Linux o macOS. El comando no admite Windows.
Antes de utilizar el comando en macOS, instale Docker para Mac, y asegúrese de que boot2docker no está instalado (o no está en la ruta de ejecución). El comando **eb local** intenta utilizar boot2docker si está presente, pero no funciona correctamente con él en macOS.
## Sintaxis
**eb local run**
**eb local status**
**eb local open**
**eb local logs**
**eb local setenv**
**eb local printenv**
## Opciones
**eb local run**
****
| Name | Descripción |
| --- | --- |
| `--envvars key1=value1,key2=value2` | Define variables de entorno que la CLI de EB pasará a los contenedores locales de Docker. En los entornos con varios contenedores, todas las variables se pasan a todos los contenedores. |
| `--port hostport` | Asigna un puerto del host al puerto expuesto en el contendor. Si no se especifica esta opción, la CLI de EB utiliza el mismo puerto en el host y el contenedor. Esta opción solo funciona con aplicaciones de plataforma Docker. No se aplica a la plataforma Multicontainer Docker. |
| [Opciones comunes](eb3-cmd-options.md) | |
**eb local status**
**eb local open**
**eb local logs**
**eb local setenv**
**eb local printenv**
****
| Nombre | Descripción |
| --- | --- |
| [Opciones comunes](eb3-cmd-options.md) | |
## Output
**eb local run**
Mensajes de estado de Docker. Permanece activo mientras se ejecuta la aplicación. Presione **Ctrl\$1C** para detener la aplicación.
**eb local status**
Estado de cada uno de los contenedores que utiliza la aplicación, estén en ejecución o no.
**eb local open**
Abre la aplicación en un navegador web o sale.
**eb local logs**
Ubicación de los registros generados en el directorio del proyecto por las aplicaciones que se ejecutan localmente con **eb local run**.
**eb local setenv**
Ninguno
**eb local printenv**
Nombre y valores de las variables de entorno configuradas con **eb local setenv**.
## Ejemplos
**eb local run**
```
~/project$ eb local run
Creating elasticbeanstalk_phpapp_1...
Creating elasticbeanstalk_nginxproxy_1...
Attaching to elasticbeanstalk_phpapp_1, elasticbeanstalk_nginxproxy_1
phpapp_1 | [23-Apr-2015 23:24:25] NOTICE: fpm is running, pid 1
phpapp_1 | [23-Apr-2015 23:24:25] NOTICE: ready to handle connections
```
**eb local status**
Consulte el estado de los contenedores locales:
```
~/project$ eb local status
Platform: 64bit Amazon Linux 2014.09 v1.2.1 running Multi-container Docker 1.3.3 (Generic)
Container name: elasticbeanstalk_nginxproxy_1
Container ip: 127.0.0.1
Container running: True
Exposed host port(s): 80
Full local URL(s): 127.0.0.1:80
Container name: elasticbeanstalk_phpapp_1
Container ip: 127.0.0.1
Container running: True
Exposed host port(s): None
Full local URL(s): None
```
**eb local logs**
Consulte la ruta de los registros del proyecto actual:
```
~/project$ eb local logs
Elastic Beanstalk will write logs locally to /home/user/project/.elasticbeanstalk/logs/local.
Logs were most recently created 3 minutes ago and written to /home/user/project/.elasticbeanstalk/logs/local/150420_234011665784.
```
**eb local setenv**
Establezca las variables de entorno para utilizarlas con **eb local run**.
```
~/project$ eb local setenv PARAM1=value
```
Imprima las variables de entorno configuradas con **eb local setenv**.
```
~/project$ eb local printenv
Environment Variables:
PARAM1=value
```
# **eb logs**
## Description (Descripción)
El **eb logs** comando tiene tres propósitos distintos: habilitar o deshabilitar la transmisión de CloudWatch registros a Logs, recuperar registros de instancias o CloudWatch registros de registros y solicitar un análisis de su entorno mediante IA. Con la opción `--cloudwatch-logs` (`-cw`), el comando habilita o deshabilita el streaming de registros. Con la opción `--analyze` (`-ai`), el comando solicita un análisis basado en inteligencia artificial de los registros, los eventos y el estado de las instancias del entorno. Sin ninguna de estas opciones, recupera los registros.
Al recuperar los registros, especifique la opción `--all`, `--zip` o `--stream` para recuperar los registros completas. Si no especifica ninguna de estas opciones, Elastic Beanstalk recupera los registros de finalización.
El comando procesa los registros del entorno especificado o predeterminado. Los registros pertinentes dependen del tipo de contenedor. Si el directorio raíz contiene un archivo `platform.yaml` donde se especifica una plataforma personalizada, este comando también procesa los registros del entorno del constructor.
Para obtener más información, consulte [Uso de Elastic CloudWatch Beanstalk con Amazon Logs](AWSHowTo.cloudwatchlogs.md). Para obtener más información sobre el análisis basado en la IA, consulte. [Análisis del entorno impulsado por IA](health-ai-analysis.md)
## Sintaxis
Para activar o desactivar la transmisión de registros a CloudWatch Logs:
```
eb logs --cloudwatch-logs [enable | disable] [--cloudwatch-log-source instance | environment-health | all] [environment-name]
```
Para recuperar los registros de instancias:
```
eb logs [-all | --zip | --stream] [--cloudwatch-log-source instance] [--instance instance-id] [--log-group log-group] [environment-name]
```
Para recuperar los registros de estado de entorno:
```
eb logs [-all | --zip | --stream] --cloudwatch-log-source environment-health [environment-name]
```
Para solicitar un análisis basado en IA:
```
eb logs --analyze [environment-name]
```
## Opciones
****
| Name | Descripción |
| --- | --- |
| `-cw [enable \| disable]` o bien `--cloudwatch-logs [enable \| disable]` | Activa o desactiva la transmisión de registros a Logs. CloudWatch Si no se proporciona ningún argumento, se habilita el streaming de registros. Si tampoco se especifica la opción `--cloudwatch-log-source` (`-cls`), el streaming de logs de instancias está habilitado o deshabilitado. |
| `-cls instance \| environment-health \| all` o `--cloudwatch-log-source instance \| environment-health \| all` | Especifica el origen de los registros cuando se trabaja con CloudWatch los registros. Con la forma de activación o desactivación del comando, estos son los registros para los que se puede habilitar o deshabilitar la transmisión de CloudWatch registros. Con el formulario de recuperación del comando, estos son los registros que se deben recuperar de CloudWatch los registros. Valores válidos: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/elasticbeanstalk/latest/dg/eb3-logs.html) Significado de los valores: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/elasticbeanstalk/latest/dg/eb3-logs.html) |
| `-a` o bien `--all` | Recupera todos los logs completos y los guarda en el directorio `.elasticbeanstalk/logs`. |
| `-z` o bien `--zip` | Recupera los logs completos, los comprime en un archivo `.zip` y guarda el archivo en el directorio `.elasticbeanstalk/logs`. |
| `--stream` | Realiza streaming (salidas de forma continua) de logs completos. Con esta opción, el comando se sigue ejecutando hasta que lo interrumpa (pulse **Ctrl\$1C**). |
| `-i instance-id` o bien `--instance instance-id` | Recupera exclusivamente los logs de la instancia especificada. |
| `-g log-group` o `--log-group log-group` | Especifica el grupo CloudWatch de registros del que se van a recuperar los registros. La opción solo es válida cuando la transmisión de CloudWatch registros de instancias a Logs está habilitada. Si el streaming de logs de instancias está habilitado, y no especifica la opción `--log-group`, el grupo de logs predeterminado es uno de los siguientes: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/elasticbeanstalk/latest/dg/eb3-logs.html) Para obtener información sobre el grupo de logs correspondiente a cada archivo de log, consulte [Cómo configura Elastic Beanstalk los registros CloudWatch](AWSHowTo.cloudwatchlogs.md#AWSHowTo.cloudwatchlogs.loggroups). |
| `-ai` o `--analyze` | Solicita un análisis basado en inteligencia artificial de los registros, los eventos y el estado de las instancias de su entorno. El análisis utiliza Amazon Bedrock para identificar las causas fundamentales y recomendar soluciones para los problemas de salud ambiental. El comando envía la solicitud, espera a que se complete el análisis y, a continuación, muestra los resultados. Esta opción no es compatible con `--instance``--all`, `--zip``--log-group`, o`--cloudwatch-logs`. Para conocer los requisitos previos y los permisos necesarios, consulte[Análisis del entorno impulsado por IA](health-ai-analysis.md). |
| [Opciones comunes](eb3-cmd-options.md) | |
## Output
De forma predeterminada, muestra los logs directamente en el terminal. Utiliza un programa de paginación para mostrar la salida. Pulse **Q** o **q** para salir.
Con `--stream` muestra los logs existentes en el terminal y se sigue ejecutando. Pulse **Ctrl\$1C** para salir.
Con `--all` y `--zip` se guardan los logs en archivos locales y se muestra la ubicación del archivo.
Con`--analyze`, muestra el análisis generado por la IA directamente en el terminal una vez finalizado el análisis.
## Ejemplos
El siguiente ejemplo permite la transmisión de registros de instancias a CloudWatch Logs.
```
$ eb logs -cw enable
Enabling instance log streaming to CloudWatch for your environment
After the environment is updated you can view your logs by following the link:
https://console.aws.amazon.com/cloudwatch/home?region=us-east-1#logs:prefix=/aws/elasticbeanstalk/environment-name/
Printing Status:
2018-07-11 21:05:20 INFO: Environment update is starting.
2018-07-11 21:05:27 INFO: Updating environment environment-name's configuration settings.
2018-07-11 21:06:45 INFO: Successfully deployed new configuration to environment.
```
El siguiente ejemplo recupera los logs de instancias en un archivo `.zip`.
```
$ eb logs --zip
Retrieving logs...
Logs were saved to /home/workspace/environment/.elasticbeanstalk/logs/150622_173444.zip
```
En el siguiente ejemplo, se solicita un análisis del entorno basado en la IA.
```
$ eb logs --analyze
Analyzing environment...
No critical issues detected. Environment appears healthy.
---
Note: This analysis was generated by AI.
```
# **eb migrate**
## Description (Descripción)
Migra sitios y aplicaciones de Internet Information Services (IIS) de un servidor Windows a Elastic Beanstalk. El comando empaqueta las aplicaciones, conserva sus configuraciones y las implementa en un nuevo entorno de Elastic Beanstalk.
Para obtener más información sobre cómo migrar los sitios y aplicaciones de IIS, consulte [Migración de aplicaciones de IIS a Elastic Beanstalk](dotnet-migrating-applications.md).
**nota**
Antes de utilizar este comando, asegúrese de que su sistema cumpla estos requisitos:
Internet Information Services (IIS) versión 7.0 o posterior
Web Deploy 3.6 o posterior instalado
Privilegios administrativos en el servidor de Windows
AWS credenciales configuradas con los permisos adecuados
El servidor de origen tiene acceso saliente a los AWS servicios de Internet.
El proceso de migración se resumen en los siguientes pasos:
1. Detecte los sitios de IIS y sus configuraciones.
1. Contenido y configuración del contenido de la aplicación de paquete.
1. Cree una aplicación y un entorno de Elastic Beanstalk.
1. Implemente la aplicación con la configuración conservada.
El comando crea artefactos de migración en un directorio estructurado, como se muestra en la siguiente lista:
```
C:\migration_workspace\
└── .\migrations\latest\
├── upload_target.zip
└── upload_target\
├── [SiteName].zip # One ZIP per default application of IIS site
├── [SiteName-ApplicationName].zip # One ZIP per additional application
├── aws-windows-deployment-manifest.json
└── ebmigrateScripts\
├── site_installer.ps1 # Site installation scripts
├── permission_handler.ps1 # Permission management
└── other helper scripts
```
Utilice **eb migrate cleanup** para administrar estos artefactos.
## Sintaxis
**eb migrate *[options]***
**eb migrate explore *[options]***
**eb migrate cleanup *[options]***
Cuando ejecuta sin argumentos, **eb migrate** funciona en modo no interactivo. Para ejecutarlo en modo interactivo, ejecute **eb migrate --interactive**.
El comando del modo interactivo solicita la siguiente información:
+ Selección de sitios de IIS para migrar
+ Nombres de entornos y aplicaciones
+ Selección de la versión de la plataforma
+ Tipo de instancia y otras opciones de configuración
## Subcomandos
### explore
El subcomando **eb migrate explore** examina el servidor IIS y muestra los sitios disponibles.
Utilice este comando para mostrar la siguiente información:
+ Ver todos los sitios de IIS del servidor
+ Con `--verbose`, inspeccione la configuración detallada, que incluye los siguiente:
+ Puertos y enlaces de sitios
+ Grupos de aplicaciones
+ Directorios virtuales y sus rutas físicas
+ Configuración de autenticación
```
PS C:\migrations_workspace > eb migrate explore
Default Web Site
Site2
site3
router
```
```
PS C:\migrations_workspace > eb migrate explore --verbose
1: Default Web Site:
- Bindings:
- *:8083:
- Application '/':
- Application Pool: DefaultAppPool
- Enabled Protocols: http
- Virtual Directories:
- /:
- Physical Path: C:\inetpub\wwwroot
- Logon Method: ClearText
- Application '/dotnet-6-0':
- Application Pool: DefaultAppPool
- Enabled Protocols: http
- Virtual Directories:
- /:
- Physical Path: C:\inetpub\AspNetCoreWebApps\CoreWebApp-6-0
- Logon Method: ClearText
- Application '/dotnet-8-0':
- Application Pool: DefaultAppPool
- Enabled Protocols: http
- Virtual Directories:
- /:
- Physical Path: C:\inetpub\AspNetCoreWebApps\CoreWebApp-8-0
- Logon Method: ClearText
2: Site2:
- Bindings:
- *:8081:
...
```
### eliminación
El subcomando **eb migrate cleanup** administra los artefactos de migración con las siguientes acciones:
+ Preservar la migración exitosa más reciente en `./migrations/latest`.
+ Eliminar los directorios de migración más antiguos.
+ Mantener los archivos de configuración críticos.
```
PS C:\migrations_workspace > eb migrate cleanup
Are you sure you would like to cleanup older artifacts within `./migrations/`? (y/N):
```
Utilice `--force` para omitir las peticiones de confirmación durante la limpieza.
```
PS C:\migrations_workspace > eb migrate cleanup --force
```
## Opciones
Ninguna de estas opciones es obligatoria. Si ejecuta **eb migrate** sin ninguna opción, la CLI de EB se ejecutará en modo no interactivo. Con **eb migrate --interactive**, la CLI de EB le pedirá que escriba o seleccione un valor para los ajustes necesarios.
****
| Name | Descripción |
| --- | --- |
| `-a` *application-name* o bien `--application-name` *application-name* | Nombre para la nueva aplicación de Elastic Beanstalk. Tipo: cadena Predeterminado: aplicación EBMigrated |
| `--archive` *directory-or-zip* | El directorio o archivo ZIP que contiene el código fuente generado previamente por **eb migrate --archive-only**. Use esta opción para implementar un paquete de migración creado anteriormente. Ejemplo: `--archive .\migrations\latest\upload_target` o `--archive .\migrations\latest\upload_target.zip` |
| `-ao` o `--archive-only` | Cree solo el directorio de archivos de destino sin implementación. El directorio resultante se puede implementar manualmente **eb migrate** con la opción `archive` o **eb deploy**. |
| `-c` *subdomain-name* o `--cname` *subdomain-name* | Nombre del subdominio que se va a incluir como prefijo en la entrada DNS de CNAME de la aplicación migrada. Tipo: cadena Valor predeterminado: nombre del entorno. |
| `-cf` o `--copy-firewall-config` | Copie la configuración del firewall del servidor de origen en el destino para todos los puertos HTTP con enlaces activos. Crea las reglas del grupo de seguridad correspondientes en AWS. |
| `-es` *snapshot-id* [*snapshot-id* ...] o `--ebs-snapshots` *snapshot-id* [*snapshot-id* ...] | Lista separada por comas de instantáneas de Amazon EBS IDs para asociarlas al entorno. Ejemplo: `--ebs-snapshots snap-1234567890abcdef0, snap-0987654321fedcba1` |
| `--encrypt-ebs-volumes` | Aplica el cifrado a todos los volúmenes de Amazon EBS nuevos. Se trata de una configuración que se aplica a toda la cuenta y afecta toda la creación futura de volúmenes de Amazon EBS. |
| `-e` *environment-name* o `--environment-name` *environment-name* | Nombre del nuevo entorno de Elastic Beanstalk. Tipo: cadena Predeterminado: Env EBMigrated Restricciones: debe tener una longitud entre 4 y 40 caracteres. Solo puede contener letras, números y guiones. No puede empezar ni terminar con un guion. |
| `--force` | Omite las solicitudes de confirmación durante las operaciones. Cuando se usa con un subcomando **cleanup**, elimina los artefactos de migración sin confirmación. |
| `-ip` *profile-name* o `--instance-profile` *profile-name* | Perfil de instancia para asociarlo a las EC2 instancias de Amazon del entorno. Si no se especifica, crea un perfil de instancia predeterminado con permisos para acceder a los recursos de Elastic Beanstalk. Para obtener más información, consulte [Perfil de instancia de Elastic Beanstalk](concepts-roles-instance.md). |
| `-i` *instance-type* o `--instance-type` *instance-type* | El tipo de EC2 instancia de Amazon para el entorno de Elastic Beanstalk. Tipo: cadena Valor predeterminado: c5.2xlarge Para ver los tipos de instancias disponibles, consulta los [tipos de EC2 instancias de](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html) *Amazon en la Guía del EC2 usuario de Amazon*. |
| `-in` o `--interactive` | Fuerza el modo interactivo para el proceso de migración. Solicita los valores de configuración incluso cuando los valores predeterminados están disponibles. |
| `-k` *key-name* o `--keyname` *key-name* | Amazon EC2 key pair para permitir el acceso RDP a las instancias del entorno. Es útil para investigar problemas a nivel de instancia que no están visibles en los registros. Valores válidos: un nombre de key pair existente registrado en Amazon EC2 |
| `-p` *platform-version* o `--platform` *platform-version* | Tiempo de ejecución de la plataforma de Elastic Beanstalk para el entorno. Si no se especifica, se detecta automáticamente desde la versión host de Windows Server. Ejemplo: `"64bit Windows Server 2016 v2.16.2 running IIS 10.0"` Para obtener una lista de las versiones de plataforma disponibles, utilice la [lista de plataformas eb](eb3-platform.md#eb3-platform-list). |
| `--remote` | Indica que se debe ejecutar la migración en modo remoto. Esta opción permite la ejecución desde un host bastión, que se conecta al servidor de destino que contiene la aplicación y las configuraciones que se van a migrar a Elastic Beanstalk. Si se ejecuta desde el servidor bastión, `eb migrate` detecta las configuraciones, organiza la lógica de migración en el host bastión y, a continuación, implementa la aplicación en un nuevo entorno de Elastic Beanstalk. Esta opción elimina la necesidad de instalar la CLI de EB y Python en el servidor Windows que necesita migrar. En su lugar, instale Python y la CLI de EB en un host bastión, donde ejecute el comando **eb migrate** con la opción `--remote`. Utilice la opción `--target-ip` para especificar el host con las configuraciones de IIS que desea migrar. Debe usarse con `--target-ip`, `--username` y `--password`. |
| `--target-ip` *ip-address* | Dirección IP pública de la máquina Windows remota que contiene los servidores IIS que se van a migrar. Obligatorio cuando se utiliza `--remote`. Se puede especificar solamente cuando se usa `--remote`. |
| `--username` *username* | Nombre de usuario del perfil de usuario para acceder a la máquina Windows remota que contiene los servidores de IIS que se van a migrar. Obligatorio cuando se utiliza `--remote`. Se puede especificar solamente cuando se usa `--remote`. |
| `--password` *password* | Contraseña del perfil de usuario para acceder a la máquina Windows remota que contiene los servidores de IIS que se van a migrar. Obligatorio cuando se utiliza `--remote`. Se puede especificar solamente cuando se usa `--remote`. |
| `-sr` *role-name* o `--service-role` *role-name* | Función de servicio de IAM para Elastic Beanstalk a fin de gestionar los servicios relacionados. AWS Si no se especifica, crea un rol de servicio predeterminado con los permisos necesarios. Para obtener más información, consulte [Rol de servicio de Elastic Beanstalk](concepts-roles-service.md). Especifique solo el nombre del rol, no el ARN completo. Elastic Beanstalk crea automáticamente el ARN completo. |
| `-s` *site-names* o `--sites` *site-names* | Lista separada por comas de los sitios de IIS que se van a migrar. Si no se especifica, migra todos los sitios disponibles en el servidor. Ejemplo: `--sites "Default Web Site,Intranet,API"` |
| `--ssl-certificates` *certificate-arn*[,*certificate-arn* ...] | Lista separada por comas del certificado SSL de ACM ARNs para asociarlo al Application Load Balancer. Se requiere cuando se migran sitios con enlaces HTTPS. Ejemplo: `--ssl-certificates arn:aws:acm:region:account:certificate/certificate-id` |
| `-t key1=value1[,key2=value2 ...]` o `--tags key1=value1[,key2=value2 ...]` | Lista separada por comas de pares de `key=value` para etiquetar los nuevos recursos de su entorno: entorno, aplicación de Elastic Beanstalk, versión de la aplicación. Para obtener más información, consulte [Entornos de etiquetado](using-features.tagging.md). |
| `--verbose` | Muestre información detallada durante el proceso de migración. Cuando se usa con un subcomando **explore**, muestra detalles completos de la configuración del sitio. |
| `-vpc` *config-file-or-string* o `--vpc-config` *config-file-or-string* | Configuración de la VPC para el entorno, especificada como una ruta de archivo JSON o una cadena JSON. La configuración debe incluir lo siguiente: {
"id": "vpc-1234567890abcdef0",
"publicip": "true|false",
"elbscheme": "public|private",
"ec2subnets": ["subnet-a1b2c3d4", "subnet-e5f6g7h8"],
"securitygroups": "sg-123456,sg-789012",
"elbsubnets": ["subnet-a1b2c3d4", "subnet-e5f6g7h8"]
} [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/elasticbeanstalk/latest/dg/eb3-migrate.html) *La migración ignorará cualquier configuración de la VPC existente en el entorno de origen cuando especifiques el *parámetro* `--vpc-config`*. Cuando usa este parámetro, la migración usará solamente la configuración de la VPC especificada en el archivo de configuración que está transfiriendo. El uso de este parámetro anula el comportamiento predeterminado de detección de la configuración de VPC de la instancia de origen o de uso de la VPC predeterminada. |
| [Opciones comunes](eb3-cmd-options.md) | |
## Output
El comando proporciona actualizaciones de estado durante todo el proceso de migración:
1. Detección de configuración de VPC (cuando se ejecuta en una EC2 instancia)
1. Progreso de la generación del paquete fuente para cada sitio
1. Estado de creación del entorno
1. Implementación en curso
Si se realiza correctamente, muestra los detalles del nuevo entorno, que incluyen:
+ Nombre e ID del entorno
+ Nombre de la aplicación
+ Region
+ Versión de la plataforma
+ CNAME del entorno
Si hay problemas durante la migración, use los comandos [**eb events**](eb3-events.md) y [**eb health**](eb3-health.md) para obtener información detallada.
## Ejemplos
### Uso básico
Migración básica en modo interactivo:
```
PS C:\migrations_workspace > eb migrate
Identifying VPC configuration of this EC2 instance (i-0123456789abcdef0):
id: vpc-1234567890abcdef0
publicip: true
elbscheme: public
ec2subnets: subnet-123,subnet-456,subnet-789
securitygroups: sg-123,sg-456
elbsubnets: subnet-123,subnet-456,subnet-789
Using .\migrations\latest to contain artifacts for this migration run.
Generating source bundle for sites, applications, and virtual directories...
Default Web Site/ -> .\migrations\latest\upload_target\DefaultWebSite.zip
Creating application version
Creating environment
Environment details for: EBMigratedEnv
Application name: EBMigratedApp
Region: us-west-2
Deployed Version: app-230320_153045
Environment ID: e-abcdef1234
Platform: 64bit Windows Server 2019 v2.7.0 running IIS 10.0
Tier: WebServer-Standard-1.0
CNAME: ebmigratedenv.us-west-2.elasticbeanstalk.com
Updated: 2023-03-20 15:30:45
```
Migración de sitios específicos con una configuración personalizada:
```
PS C:\migrations_workspace > eb migrate `
--sites "Default Web Site,InternalAPI" `
--application-name "CorporateApp" `
--environment-name "Production" `
--instance-type "c5.xlarge" `
--tags "Environment=Production,Team=WebOps" `
--copy-firewall-config
```
Creación de un archivo de migración sin implementación:
```
PS C:\migrations_workspace > eb migrate --archive-only
Using .\migrations\latest to contain artifacts for this migration run.
Generating source bundle for sites, applications, and virtual directories...
Default Web Site/ -> .\migrations\latest\upload_target\DefaultWebSite.zip
Generated destination archive directory at .\migrations\latest\upload_target
You can execute `eb init` and `eb create` from this directory to deploy to EB.
```
### Ejemplos de configuración avanzados
Migración con configuración personalizada de la VPC mediante un archivo JSON:
```
PS C:\migrations_workspace > cat vpc-config.json
{
"id": "vpc-1234567890abcdef0",
"publicip": "false",
"elbscheme": "internal",
"ec2subnets": [
"subnet-private1",
"subnet-private2"
],
"securitygroups": [
"sg-app",
"sg-database",
"sg-monitoring"
],
"elbsubnets": [
"subnet-private1",
"subnet-private2"
]
}
PS C:\migrations_workspace eb migrate `
--sites "InternalAPI" `
--vpc-config vpc-config.json `
--instance-type "r5.xlarge" `
--tags "Environment=Internal,Security=High"
```
Migración de sitios con certificados SSL y encabezados de host:
```
PS C:\migrations_workspace > eb migrate `
--sites "SecurePortal" `
--ssl-certificates "arn:aws:acm:region:account:certificate/cert1,arn:aws:acm:region:account:certificate/cert2" `
--verbose
INFO: Detected HTTPS bindings:
- www.example.com:443
- api.example.com:443
INFO: Configuring Application Load Balancer with SSL certificates
INFO: Creating host-based routing rules:
- www.example.com -> target group 1
- api.example.com -> target group 2
```
Migración con configuración instantánea de EBS:fo
```
PS C:\migrations_workspace > eb migrate `
--sites "Default Web Site" `
--ebs-snapshots "snap-1234567890abcdef0" "snap-0987654321fedcba1" `
--encrypt-ebs-volumes
Using .\migrations\latest to contain artifacts for this migration run.
INFO: Enabling EBS encryption for all new volumes in us-west-2
INFO: Configuring environment with specified EBS snapshots
```
### Ejemplos de configuración de seguridad
Manejo de sitios con reglas de firewall complejas:
```
PS C:\migrations_workspace > eb migrate `
--sites "Default Web Site,ReportingService" `
--copy-firewall-config `
--verbose
INFO: Detected the following Windows Firewall rules:
- Allow Web Traffic (TCP 80, 443)
- Allow Reporting Traffic (TCP 8081)
INFO: Creating corresponding security group rules
```
Migración con roles de IAM personalizados:
```
PS C:\migrations_workspace > eb migrate `
--sites "SecureApp" `
--instance-profile "CustomInstanceProfile" `
--service-role "CustomServiceRole"
```
### Ejemplos de ejecución remota
Migración de aplicaciones de IIS desde un servidor de Windows remoto:
```
PS C:\migrations_workspace > eb migrate `
--remote `
--target-ip "192.0.2.10" `
--username "administrator" `
--password "YourPassword123" `
--application-name "RemoteApp" `
--environment-name "RemoteEnv"
INFO: Establishing SSH connection to remote host 192.0.2.10...
INFO: Connection established
INFO: Discovering IIS sites on remote host...
INFO: Found 2 sites: Default Web Site, API
INFO: Extracting site configurations...
INFO: Generating source bundle for sites, applications, and virtual directories...
Default Web Site/ -> .\migrations\latest\upload_target\DefaultWebSite.zip
API/ -> .\migrations\latest\upload_target\API.zip
Creating application version
Creating environment
Environment details for: RemoteEnv
Application name: RemoteAppstage mi
Region: us-west-2
Deployed Version: app-230320_153045
Environment ID: e-abcdef1234
Platform: 64bit Windows Server 2019 v2.7.0 running IIS 10.0
Tier: WebServer-Standard-1.0
CNAME: remoteenv.us-west-2.elasticbeanstalk.com
Updated: 2023-03-20 15:30:45
```
Migración remota con selección de sitios específicos:
```
PS C:\migrations_workspace > eb migrate `
--remote `
--target-ip "192.0.2.10" `
--username "administrator" `
--password "YourPassword123" `
--sites "API" `
--instance-type "c5.large"
```
# **eb open**
## Description (Descripción)
Abre la dirección URL pública de su sitio web en el navegador predeterminado.
## Sintaxis
**eb open**
**eb open *environment-name***
## Opciones
****
| Name | Descripción |
| --- | --- |
| [Opciones comunes](eb3-cmd-options.md) | |
## Output
El comando **eb open** no genera ninguna salida. Simplemente abre la aplicación en una ventana del navegador.
# **eb platform**
## Description (Descripción)
Este comando admite dos WorkSpaces diferentes:
[Plataforma](#eb3-platform-preconfigured)
Utilice este WorkSpace para administrar las plataformas personalizadas.
[Entorno](#eb3-platform-environment)
Utilice este WorkSpace para seleccionar una plataforma predeterminada o mostrar información sobre la plataforma actual.
Elastic Beanstalk proporciona el acceso directo **ebp** para **eb platform**.
**nota**
Windows **ebp** lo PowerShell usa como alias de comando. Si ejecuta la CLI de EB en Windows PowerShell, utilice la forma larga de este comando:**eb platform**.
## Uso de eb platform en plataformas personalizadas
Muestra las versiones de la plataforma actual y permite administrar las plataformas personalizadas.
### Sintaxis
**eb platform create [*version*] [*options*]**
**eb platform delete [*version*] [*options*]**
**eb platform events [*version*] [*options*]**
**eb platform init [*platform*] [*options*]**
**eb platform list [*options*]**
**eb platform logs [*version*] [*options*]**
**eb platform status [*version*] [*options*]**
**eb platform use [*platform*] [*options*]**
### Opciones
****
| Name | Descripción |
| --- | --- |
| `create [version] [options]` | Crea una nueva versión de la plataforma. [Más información](#eb3-platform-create). |
| `delete version [options]` | Elimina una versión de la plataforma. [Más información](#eb3-platform-delete). |
| `events [version] [options]` | Muestra los eventos de una versión de la plataforma. [Más información](#eb3-platform-events). |
| `init [platform] [options]` | Inicializa un repositorio de la plataforma. [Más información](#eb3-platform-init). |
| `list [options]` | Muestra las versiones de la plataforma actual. [Más información](#eb3-platform-list). |
| `logs [version] [options]` | Muestra los registros creados en el entorno del constructor sobre una versión de la plataforma. [Más información](#eb3-platform-logs). |
| `status [version] [options]` | Muestra el estado de una versión de la plataforma. [Más información](#eb3-platform-status). |
| `use [platform] [options]` | Permite seleccionar una plataforma diferente en la que se van a crear las nuevas versiones. [Más información](#eb3-platform-use). |
| [Opciones comunes](eb3-cmd-options.md) | |
### Opciones comunes
Todos los comandos **eb platform** incluyen las siguientes opciones comunes.
****
| Nombre | Descripción |
| --- | --- |
| `-h` O BIEN `--help` | Muestra un mensaje de ayuda y termina. |
| `--debug` | Muestra una salida de depuración adicional. |
| `--quiet` | Suprime todos los datos de salida. |
| `-v` O BIEN `--verbose` | Muestra una salida adicional. |
| `--profile PROFILE` | Utiliza lo especificado *PROFILE* en sus credenciales. |
| `-r REGION` OR `--region REGION` | Usa la región*REGION*. |
| `--no-verify-ssl` | No verifique los certificados AWS SSL. |
### Eb platform create
Crea una nueva versión de la plataforma y devuelve el ARN de la nueva versión. Si ningún entorno del constructor se está ejecutando en la región actual, este comando lanza uno. Las opciones de incremento (`-M``-m`, *version* y`-p`) y las opciones de incremento se excluyen mutuamente.
#### Opciones
****
| Name | Description (Descripción) |
| --- | --- |
| *version* | Si *version* no se especifica, crea una nueva versión basada en la plataforma más reciente con la versión del parche (N en N.n.N) incrementada. |
| `-M` OR `--major-increment` | Aumenta el número de la versión principal (N en N.n.n). |
| `-m` O BIEN `--minor-increment` | Aumenta el número de la versión secundaria (N en n.N.n). |
| `-p` O BIEN `--patch-increment` | Aumenta el número de la versión de lote (N en n.n.N). |
| `-i INSTANCE_TYPE` OR --tipo de instancia *INSTANCE\$1TYPE* | Úselo *INSTANCE\$1TYPE* como tipo de instancia, por ejemplo. **t1.micro** |
| `-ip INSTANCE_PROFILE` OR `--instance-profile INSTANCE_PROFILE` | *INSTANCE\$1PROFILE*Úselo como perfil de instancia al crear AMIs para una plataforma personalizada. Si no se especifica la opción `-ip`, crea el perfil de instancia `aws-elasticbeanstalk-custom-platforme-ec2-role` y lo utiliza en la plataforma personalizada. |
| `--tags key1=value1[,key2=value2 ...]` | Las etiquetas se especifican como una lista de pares `key=value` separados por comas. |
| `--timeout` *minutes* | Establezca el número de minutos que deben transcurrir antes de que se agote el tiempo de espera del comando. |
| `--vpc.id VPC_ID` | ID de la VPC en la que Packer crea el contenido. |
| `--vpc.subnets VPC_SUBNETS` | Subredes de la VPC en las que Packer crea el contenido. |
| `--vpc.publicip` | Asocia el público IPs a EC2 las instancias lanzadas. |
### Eb platform delete
Elimina una versión de la plataforma. La versión no se elimina si algún entorno la está utilizando.
#### Opciones
****
| Name | Descripción |
| --- | --- |
| `version` | Versión que se va a eliminar. Este valor es obligatorio. |
| `--cleanup` | Elimina todas las versiones de la plataforma con el estado `Failed`. |
| `--all-platforms` | Si se especifica `--cleanup`, se eliminan todas las versiones con el estado `Failed` de todas las plataformas. |
| `--force` | No pide confirmación cuando se elimina una versión. |
### eb platform events
Muestra los eventos de una versión de la plataforma. Si *version* se especifica, muestre los eventos de esa versión; de lo contrario, muestre los eventos de la versión actual.
#### Opciones
****
| Name | Description (Descripción) |
| --- | --- |
| *version* | Versión de los eventos que van a mostrar. Este valor es obligatorio. |
| `-f` O BIEN `--follow` | Continua mostrando los eventos a medida que se producen. |
### Eb platform init
Inicializa un repositorio de la plataforma.
#### Opciones
****
| Name | Descripción |
| --- | --- |
| `platform` | Nombre de la plataforma que se va a inicializar. Este valor es obligatorio a menos que `-i` (modo interactivo) esté habilitado. |
| `-i` O BIEN `--interactive` | Utiliza el modo interactivo. |
| `-k KEYNAME` OR `--keyname KEYNAME` | El nombre de EC2 clave predeterminado. |
Puede ejecutar este comando en un directorio que se haya inicializado anteriormente, aunque, en ese caso, no se puede cambiar el tipo de WorkSpace.
Para volver a inicializar con otra configuración, utilice la opción `-i`.
### Eb platform list
Muestra las versiones de la plataforma vinculadas a un WorkSpace (directorio) o una región.
El comando devuelve resultados diferentes en función del tipo de WorkSpace en el que se ejecute, tal y como se indica a continuación:
+ En un WorkSpace de plataforma (un directorio inicializado por `eb platform init`), el comando devuelve una lista de todas las versiones de la plataforma personalizada definida en el WorkSpace. Agrega la opción `--all-platforms` o `--verbose` para obtener una lista de todas las versiones de la plataforma de todas las plataformas personalizadas que tiene su cuenta en la región vinculada al WorkSpace.
+ En un WorkSpace de aplicaciones (un directorio inicializado por `eb init`), el comando devuelve una lista de todas las versiones de la plataforma, tanto para plataformas administradas por Elastic Beanstalk como para las plataformas personalizadas de su cuenta. La lista utiliza nombres de versión de la plataforma cortos y algunas variantes de versión de la plataforma pueden combinarse. Agrega la opción `--verbose` para obtener una lista detallada con nombres completos y todas las variantes enumeradas por separado.
+ En un directorio sin inicializar, el comando solo funciona con la opción `--region`. Devuelve una lista de todas las versiones de la plataforma administradas por Elastic Beanstalk admitidas en la región. La lista utiliza nombres de versión de la plataforma cortos y algunas variantes de versión de la plataforma pueden combinarse. Agrega la opción `--verbose` para obtener una lista detallada con nombres completos y todas las variantes enumeradas por separado.
#### Opciones
****
| Name | Descripción |
| --- | --- |
| `-a` O BIEN `--all-platforms` | Válido únicamente en un WorkSpace inicializado (un directorio inicializado por `eb platform init` o `eb init`). Muestra las versiones de las plataformas personalizadas asociadas a la cuenta. |
| `-s STATUS` OR `--status STATUS` | Enumere solo las plataformas que coincidan*STATUS*: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/elasticbeanstalk/latest/dg/eb3-platform.html) |
### Eb platform logs
Muestra los registros creados en el entorno del constructor sobre una versión de la plataforma.
#### Opciones
****
| Name | Descripción |
| --- | --- |
| `version` | Versión de la plataforma cuyos registros se van a mostrar. Si se omite, se muestran los registros de la versión actual. |
| `--stream` | Transmita los registros de implementación con los que se configuraron CloudWatch. |
### Eb platform status
Muestra el estado de una versión de la plataforma.
#### Opciones
****
| Name | Descripción |
| --- | --- |
| `version` | Versión de la plataforma cuyo estado se va a recuperar. Si se omite, se muestra el estado de la versión actual. |
### Eb platform use
Permite seleccionar una plataforma diferente en la que se van a crear las nuevas versiones.
#### Opciones
****
| Name | Description (Descripción) |
| --- | --- |
| `platform` | Especifica *platform* la versión activa de este espacio de trabajo. Este valor es obligatorio. |
## Uso de eb platform en entornos
Muestra las plataformas admitidas y permite definir la plataforma y la versión predeterminadas que se van a utilizar cuando se lance un entorno. Utilice **eb platform list** para ver una lista de todas las plataformas admitidas. Utilice **eb platform select** para cambiar la plataforma del proyecto. Utilice **eb platform show** para ver la plataforma del proyecto seleccionada.
### Sintaxis
**eb platform list**
**eb platform select**
**eb platform show**
### Opciones
****
| Name | Descripción |
| --- | --- |
| `list` | Muestra la versión de la plataforma actual. |
| `select` | Seleccione la plataforma predeterminada. |
| `show` | Muestra información sobre la plataforma actual. |
### Ejemplo 1
En el siguiente ejemplo, se muestran los nombres de todas las configuraciones de todas las plataformas que admite Elastic Beanstalk.
```
$ eb platform list
docker-1.5.0
glassfish-4.0-java-7-(preconfigured-docker)
glassfish-4.1-java-8-(preconfigured-docker)
go-1.3-(preconfigured-docker)
go-1.4-(preconfigured-docker)
iis-7.5
iis-8
iis-8.5
multi-container-docker-1.3.3-(generic)
node.js
php-5.3
php-5.4
php-5.5
python
python-2.7
python-3.4
python-3.4-(preconfigured-docker)
ruby-1.9.3
ruby-2.0-(passenger-standalone)
ruby-2.0-(puma)
ruby-2.1-(passenger-standalone)
ruby-2.1-(puma)
ruby-2.2-(passenger-standalone)
ruby-2.2-(puma)
tomcat-6
tomcat-7
tomcat-7-java-6
tomcat-7-java-7
tomcat-8-java-8
```
### Ejemplo 2
En el siguiente ejemplo, se le pedirá que elija una plataforma en una lista y la versión que desee implementar en la plataforma especificada.
```
$ eb platform select
Select a platform.
1) PHP
2) Node.js
3) IIS
4) Tomcat
5) Python
6) Ruby
7) Docker
8) Multi-container Docker
9) GlassFish
10) Go
(default is 1): 5
Select a platform version.
1) Python 2.7
2) Python
3) Python 3.4 (Preconfigured - Docker)
```
### Ejemplo 3
En el ejemplo siguiente, se muestra información sobre la plataforma predeterminada actual.
```
$ eb platform show
Current default platform: Python 2.7
New environments will be running: 64bit Amazon Linux 2014.09 v1.2.0 running Python 2.7
Platform info for environment "tmp-dev":
Current: 64bit Amazon Linux 2014.09 v1.2.0 running Python
Latest: 64bit Amazon Linux 2014.09 v1.2.0 running Python
```
# **eb printenv**
## Description (Descripción)
Muestra todas las propiedades del entorno en la ventana de comandos.
## Sintaxis
**eb printenv**
**eb printenv *environment-name***
## Opciones
****
| Name | Descripción |
| --- | --- |
| [Opciones comunes](eb3-cmd-options.md) | |
## Output
Si se ejecuta correctamente, el comando devuelve el estado de la operación `printenv`.
## Ejemplo
El siguiente ejemplo muestras las propiedades de entorno del entorno especificado.
```
$ eb printenv
Environment Variables:
PARAM1 = Value1
```
# **eb restore**
## Description (Descripción)
Vuelve a crear un entorno terminado, creando un nuevo entorno con el mismo nombre, ID y configuración. El nombre del entorno, el nombre del dominio y la versión de la aplicación debe estar disponibles para que la reconstrucción se realice correctamente.
## Sintaxis
**eb restore**
**eb restore *environment\$1id***
## Opciones
****
| Name | Descripción |
| --- | --- |
| [Opciones comunes](eb3-cmd-options.md) | |
## Output
La CLI de EB muestra una lista de entornos terminados disponibles para su restauración.
## Ejemplo
```
$ eb restore
Select a terminated environment to restore
# Name ID Application Version Date Terminated Ago
3 gamma e-s7mimej8e9 app-77e3-161213_211138 2016/12/14 20:32 PST 13 mins
2 beta e-sj28uu2wia app-77e3-161213_211125 2016/12/14 20:32 PST 13 mins
1 alpha e-gia8mphu6q app-77e3-161213_211109 2016/12/14 16:21 PST 4 hours
(Commands: Quit, Restore, ▼ ▲)
Selected environment alpha
Application: scorekeep
Description: Environment created from the EB CLI using "eb create"
CNAME: alpha.h23tbtbm92.us-east-2.elasticbeanstalk.com
Version: app-77e3-161213_211109
Platform: 64bit Amazon Linux 2016.03 v2.1.6 running Java 8
Terminated: 2016/12/14 16:21 PST
Restore this environment? [y/n]: y
2018-07-11 21:04:20 INFO: restoreEnvironment is starting.
2018-07-11 21:04:39 INFO: Created security group named: sg-e2443f72
...
```
# **eb scale**
## Description (Descripción)
Escala el entorno para que siempre se ejecute en un número especificado de instancias. Para ello, establece el número mínimo y máximo de instancias en el número especificado.
## Sintaxis
**eb scale *number-of-instances***
**eb scale *number-of-instances* *environment-name***
## Opciones
****
| Name | Descripción |
| --- | --- |
| --timeout | Número de minutos que deben transcurrir antes de que se agote el tiempo de espera del comando. |
| [Opciones comunes](eb3-cmd-options.md) | |
## Output
Si se ejecuta correctamente, el comando actualiza el número mínimo y máximo de instancias que se van a ejecutar al número especificado.
## Ejemplo
En el siguiente ejemplo, el número de instancias se establece en 2.
```
$ eb scale 2
2018-07-11 21:05:22 INFO: Environment update is starting.
2018-07-11 21:05:27 INFO: Updating environment tmp-dev's configuration settings.
2018-07-11 21:08:53 INFO: Added EC2 instance 'i-5fce3d53' to Auto Scaling Group 'awseb-e-2cpfjbra9a-stack-AWSEBAutoScalingGroup-7AXY7U13ZQ6E'.
2018-07-11 21:08:58 INFO: Successfully deployed new configuration to environment.
2018-07-11 21:08:59 INFO: Environment update completed successfully.
```
# **eb setenv**
## Description (Descripción)
Establece [propiedades de entorno](environments-cfg-softwaresettings.md) para el entorno predeterminado.
## Sintaxis
**eb setenv *key*=*value***
Puede incluir tantas propiedades como desee, pero el tamaño total de todas las propiedades no puede superar los 4096 bytes. Puede eliminar una variable dejando su valor en blanco. Consulte [Configuración de las propiedades del entorno (variables de entorno)](environments-cfg-softwaresettings.md#environments-cfg-softwaresettings-console) para ver los límites.
**nota**
Si `value` contiene un [carácter especial](http://tldp.org/LDP/abs/html/special-chars.html), ese carácter debe ir precedido por el carácter de escape `\`.
## Opciones
****
| Name | Descripción |
| --- | --- |
| --timeout | Número de minutos que deben transcurrir antes de que se agote el tiempo de espera del comando. |
| [Opciones comunes](eb3-cmd-options.md) | |
## Output
Si se ejecuta sin errores, el comando indica que la actualización del entorno se ejecutó correctamente.
## Ejemplo
En el ejemplo siguiente, se establece la variable de entorno ExampleVar.
```
$ eb setenv ExampleVar=ExampleValue
2018-07-11 21:05:25 INFO: Environment update is starting.
2018-07-11 21:05:29 INFO: Updating environment tmp-dev's configuration settings.
2018-07-11 21:06:50 INFO: Successfully deployed new configuration to environment.
2018-07-11 21:06:51 INFO: Environment update completed successfully.
```
El comando siguiente establece varias propiedades del entorno. Agrega la propiedad de entorno `foo` y establece su valor en `bar`, cambia el valor de la propiedad `JDBC_CONNECTION_STRING` y elimina las propiedades `PARAM4` y `PARAM5`.
```
$ eb setenv foo=bar JDBC_CONNECTION_STRING=hello PARAM4= PARAM5=
```
# **eb ssh**
## Description (Descripción)
**nota**
Este comando no funciona con entornos que ejecutan instancias Windows Server.
Conéctese a una EC2 instancia de Amazon Linux de su entorno mediante Secure Shell (SSH). Si un entorno tiene varias instancias en ejecución, la CLI de EB le pedirá que especifique a qué instancia quiere conectarse. Para poder utilizar este comando, SSH debe estar instalado en la máquina local y disponible en la línea de comando. Los archivos de clave privada deben estar ubicados en una carpeta `.ssh` denominada en su directorio de usuarios y las EC2 instancias de su entorno deben tener direcciones IP públicas.
Si el directorio raíz contiene un archivo `platform.yaml` donde se especifica una plataforma personalizada, este comando también se conecta a las instancias del entorno personalizado.
**Claves de SSH**
Si no configuró SSH anteriormente, puede utilizar la CLI de EB para crear una clave cuando ejecute **eb init**. Si ya ejecutó **eb init**, hágalo de nuevo con la opción `--interactive` y seleccione **Yes** y **Create New Keypair** cuando se lo pidan al configurar SSH. La CLI de EB almacenará las claves creadas durante este proceso en la propia carpeta.
Este comando abre temporalmente el puerto 22 del grupo de seguridad del entorno al tráfico entrante procedente de 0.0.0.0/0 (todas las direcciones IP) si no hay ninguna regla aplicable al puerto 22. Si ha configurado el grupo de seguridad del entorno para que abra el puerto 22 a un intervalo de CIDR limitado para aumentar la seguridad, la CLI de EB respetará esta configuración y no hará ningún cambio en el grupo de seguridad. Para anular esta configuración y hacer que la CLI de EB abra el puerto 22 a todo el tráfico entrante, utilice la opción `--force`.
Consulte [EC2 grupos de seguridad](using-features.managing.ec2.console.md#using-features.managing.ec2.securitygroups) para obtener información sobre la configuración del grupo de seguridad del entorno.
## Sintaxis
**eb ssh**
**eb ssh *environment-name***
## Opciones
****
| Name | Descripción |
| --- | --- |
| `-i` o bien `--instance` | Especifica el ID de la instancia a la que se conecta. Le recomendamos que utilice esta opción. |
| `-n` o bien `--number` | Especifica la instancia a la que se va a conectar mediante un número. |
| `-o` o bien `--keep_open` | Deja el puerto 22 abierto en el grupo de seguridad una vez que la sesión de SSH ha terminado. |
| `--command` | Ejecuta un comando shell en la instancia especificada en lugar de iniciar una sesión de SSH. |
| `--custom` | Especifique un comando SSH para utilizarlo en lugar de 'ssh -i keyfile'. No incluya el usuario remoto ni el nombre de host. |
| `--setup` | Cambia el par de claves asignado a las instancias del entorno (requiere que las instancias se sustituyan). |
| `--force` | Abre el puerto 22 al tráfico entrante procedente de 0.0.0.0/0 en el grupo de seguridad del entorno, incluso si el grupo de seguridad ya está configurada para SSH. Utilice esta opción si el grupo de seguridad del entorno está configurado para abrir el puerto 22 a un rango de CIDR limitado que no incluye la dirección IP a la que está intentando conectarse. |
| `--timeout` *minutes* | Establezca el número de minutos que deben transcurrir antes de que se agote el tiempo de espera del comando. Solo se puede utilizar con el argumento `--setup`. |
| [Opciones comunes](eb3-cmd-options.md) | |
## Output
Si se ejecuta correctamente, el comando abre una conexión SSH con la instancia.
## Ejemplo
En el siguiente ejemplo, se establece conexión con el entorno especificado.
```
$ eb ssh
Select an instance to ssh into
1) i-96133799
2) i-5931e053
(default is 1): 1
INFO: Attempting to open port 22.
INFO: SSH port 22 open.
The authenticity of host '54.191.45.125 (54.191.45.125)' can't be established.
RSA key fingerprint is ee:69:62:df:90:f7:63:af:52:7c:80:60:1b:3b:51:a9.
Are you sure you want to continue connecting (yes/no)? yes
Warning: Permanently added '54.191.45.125' (RSA) to the list of known hosts.
__| __|_ )
_| ( / Amazon Linux AMI
___|\___|___|
https://aws.amazon.com/amazon-linux-ami/2014.09-release-notes/
No packages needed for security; 1 packages available
Run "sudo yum update" to apply all updates.
[ec2-user@ip-172-31-8-185 ~]$ ls
[ec2-user@ip-172-31-8-185 ~]$ exit
logout
Connection to 54.191.45.125 closed.
INFO: Closed port 22 on ec2 instance security group
```
# **eb status**
## Description (Descripción)
Proporciona información sobre el estado del entorno.
Si el directorio raíz contiene un archivo `platform.yaml` donde se especifica una plataforma personalizada, este comando también proporciona información sobre el entorno del constructor.
## Sintaxis
**eb status**
**eb status *environment-name***
## Opciones
****
| Name | Descripción |
| --- | --- |
| `-v` o bien `--verbose` | Proporciona más información sobre las distintas instancias, como su estado con el equilibrador de carga de Elastic Load Balancing. |
| [Opciones comunes](eb3-cmd-options.md) | |
## Output
Si se ejecuta correctamente, el comando devuelve la siguiente información sobre el entorno:
+ Environment name
+ Nombre de la aplicación
+ Versión de la aplicación implementada
+ ID del entorno
+ Plataforma
+ Capa del entorno
+ CNAME
+ Momento en que se actualizó por última vez el entorno
+ Estado
+ Estado
Si utiliza el modo detallado, la CLI de EB también le proporciona el número de instancias de Amazon EC2 en ejecución.
## Ejemplo
El siguiente ejemplo muestra el estado del entorno tmp-dev.
```
$ eb status
Environment details for: tmp-dev
Application name: tmp
Region: us-west-2
Deployed Version: None
Environment ID: e-2cpfjbra9a
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:37:19.050000+00:00
Status: Launching
Health: Grey
```
# **eb swap**
## Description (Descripción)
Intercambia el CNAME del entorno con el CNAME de otro entorno (por ejemplo, para evitar tiempos de inactividad cuando se actualiza la versión de la aplicación).
**nota**
Si tiene más de dos entornos, se le pedirá que seleccione el nombre del entorno que actualmente está utilizando el CNAME deseado en una lista de entornos. Para evitar esto, puede especificar el nombre del entorno que se va utilizar con la opción `-n` al ejecutar el comando.
## Sintaxis
**eb swap**
**eb swap *environment-name***
**nota**
Este *environment-name* es el entorno para el que desea un CNAME diferente. Si no lo especifica *environment-name* como parámetro de línea de comandos al ejecutar**eb swap**, la CLI de EB actualiza el CNAME del entorno predeterminado.
## Opciones
****
| Name | Descripción |
| --- | --- |
| `-n` o bien `--destination_name` | Especifica el nombre del entorno con el que desea realizar el intercambio CNAMEs. Si ejecuta **eb swap** sin esta opción, la CLI de EB le pedirá que elija un entorno en una lista. |
| [Opciones comunes](eb3-cmd-options.md) | |
## Output
Si se ejecuta correctamente, el comando devuelve el estado de la operación `swap`.
## Ejemplos
La solicitud del ejemplo siguiente intercambia el entorno tmp-dev con live-env.
```
$ eb swap
Select an environment to swap with.
1) staging-dev
2) live-env
(default is 1): 2
2018-07-11 21:05:25 INFO: swapEnvironmentCNAMEs is starting.
2018-07-11 21:05:26 INFO: Swapping CNAMEs for environments 'tmp-dev' and 'live-env'.
2018-07-11 21:05:30 INFO: 'tmp-dev.elasticbeanstalk.com' now points to 'awseb-e-j-AWSEBLoa-M7U21VXNLWHN-487871449.us-west-2.elb.amazonaws.com'.
2018-07-11 21:05:30 INFO: Completed swapping CNAMEs for environments 'tmp-dev' and 'live-env'.
```
En el ejemplo siguiente, el entorno tmp-dev se intercambia con el entorno live-env, pero no se le pide que especifique ni seleccione ningún valor para las opciones de configuración.
```
$ eb swap tmp-dev --destination_name live-env
2018-07-11 21:18:12 INFO: swapEnvironmentCNAMEs is starting.
2018-07-11 21:18:13 INFO: Swapping CNAMEs for environments 'tmp-dev' and 'live-env'.
2018-07-11 21:18:17 INFO: 'tmp-dev.elasticbeanstalk.com' now points to 'awseb-e-j-AWSEBLoa-M7U21VXNLWHN-487871449.us-west-2.elb.amazonaws.com'.
2018-07-11 21:18:17 INFO: Completed swapping CNAMEs for environments 'tmp-dev' and 'live-env'.
```
# **eb tags**
## Description (Descripción)
Agregar, eliminar, actualizar y enumerar etiquetas de un recurso de Elastic Beanstalk.
Para obtener más información sobre el etiquetado de recursos en Elastic Beanstalk, consulte [Etiquetar recursos de la aplicación Elastic Beanstalk](applications-tagging-resources.md).
## Sintaxis
**eb tags [*environment-name*] [--resource *ARN*] -l \$1 --list**
**eb tags [*environment-name*] [--resource *ARN*] -a \$1 --add *key1*=*value1*[,*key2*=*value2* ...]**
**eb tags [*environment-name*] [--resource *ARN*] -u \$1 --update *key1*=*value1*[,*key2*=*value2* ...]**
**eb tags [*environment-name*] [--resource *ARN*] -d \$1 --delete *key1*[,*key2* ...]**
Puede combinar las opciones de subcomando `--add`, `--update` y `--delete` en un único comando. Se necesita como mínimo uno. No se puede combinar ninguna de estas tres opciones de subcomandos con `--list`.
Si no hay argumentos adicionales, todos estos comandos enumeran o modifican las etiquetas del entorno predeterminado en la aplicación del directorio actual. Con un *environment-name* argumento, los comandos enumeran o modifican las etiquetas de ese entorno. Con la opción `--resource`, los comandos enumeran o modifican las etiquetas de cualquier recurso de Elastic Beanstalk: una aplicación, un entorno, una versión de la aplicación, una configuración guardada o una versión de la plataforma personalizada. Especifique el recurso por su nombre de recurso de Amazon (ARN).
## Opciones
Ninguna de estas opciones es obligatoria. Si ejecuta **eb create** sin especificar ninguna opción, le pedirán que especifique o seleccione un valor para cada ajuste.
****
| Nombre | Descripción |
| --- | --- |
| `-l` o bien `--list` | Enumere todas las etiquetas aplicadas actualmente al recurso. |
| `-a key1=value1[,key2=value2 ...]` o bien `--add key1=value1[,key2=value2 ...]` | Aplique nuevas etiquetas al recurso. Especifique las etiquetas como una lista de pares `key=value` separados por comas. No puede especificar las claves de etiquetas existentes. Valores válidos: consulte [Etiquetado de recursos](applications-tagging-resources.md). |
| `-u key1=value1[,key2=value2 ...]` o bien `--update key1=value1[,key2=value2 ...]` | Actualice los valores de etiquetas de recursos existentes. Especifique las etiquetas como una lista de pares `key=value` separados por comas. Debe especificar las claves de etiquetas existentes. Valores válidos: consulte [Etiquetado de recursos](applications-tagging-resources.md). |
| `-d key1[,key2 ...]` o bien `--delete key1[,key2 ...]` | Elimine las etiquetas de recursos existentes. Especifique las etiquetas como una lista de claves separadas por comas. Debe especificar las claves de etiquetas existentes. Valores válidos: consulte [Etiquetado de recursos](applications-tagging-resources.md). |
| `-r` *region* o `--region` *region* | El lugar Región de AWS en el que se encuentra el recurso. Default: la región configurada predeterminada. Para obtener la lista de valores que puede especificar para esta opción, consulte [Puntos de conexión y cuotas de AWS Elastic Beanstalk](https://docs.aws.amazon.com/general/latest/gr/elasticbeanstalk.html) en la *Referencia general de AWS*. |
| `--resource ARN` | El ARN del recurso para el que el comando modifica o enumera las etiquetas. Si no se especifica, el comando hace referencia al entorno (valor predeterminado o especificado) en la aplicación del directorio actual. Valores válidos: consulte uno de los subtemas de [Etiquetado de recursos](applications-tagging-resources.md) específicos del recurso en el que está interesado. En estos temas se muestra cómo se construye el ARN del recurso y se explica cómo obtener una lista de los recursos ARNs que existen para su aplicación o cuenta. |
## Output
La opción del subcomando `--list` muestra una lista de las etiquetas del recurso. La salida muestra tanto las etiquetas que Elastic Beanstalk aplica de forma predeterminada como las etiquetas personalizadas.
```
$ eb tags --list
Showing tags for environment 'MyApp-env':
Key Value
Name MyApp-env
elasticbeanstalk:environment-id e-63cmxwjaut
elasticbeanstalk:environment-name MyApp-env
mytag tagvalue
tag2 2nd value
```
Las opciones de subcomandos `--add`, `--update` y `--delete` no tienen ninguna salida cuando se ejecutan con éxito. Puede agregar la opción `--verbose` para ver la salida detallada de la actividad del comando.
```
$ eb tags --verbose --update "mytag=tag value"
Updated Tags:
Key Value
mytag tag value
```
## Ejemplos
El siguiente comando agrega una etiqueta correctamente con la clave `tag1` y el valor `value1` al entorno predeterminado de la aplicación y, al mismo tiempo, elimina la etiqueta `tag2`.
```
$ eb tags --add tag1=value1 --delete tag2
```
El siguiente comando agrega correctamente una etiqueta a una configuración guardada dentro de una aplicación.
```
$ eb tags --add tag1=value1 \
--resource "arn:aws:elasticbeanstalk:us-east-2:my-account-id:configurationtemplate/my-app/my-template"
```
El siguiente comando produce un error porque intenta actualizar una etiqueta no existente.
```
$ eb tags --update tag3=newval
ERROR: Tags with the following keys can't be updated because they don't exist:
tag3
```
El siguiente comando produce un error porque intenta actualizar y eliminar la misma clave.
```
$ eb tags --update mytag=newval --delete mytag
ERROR: A tag with the key 'mytag' is specified for both '--delete' and '--update'. Each tag can be either deleted or updated in a single operation.
```
# **eb terminate**
## Description (Descripción)
Termina el entorno en ejecución para que no se incurra en cargos por los recursos no utilizados AWS .
Con la opción `--all` se elimina la aplicación en que se inicializó el directorio actual mediante [**eb init**](eb3-init.md). El comando termina todos los entornos de la aplicación. También termina las [versiones de la aplicación](applications-versions.md) y sus [configuraciones guardadas](environment-configuration-savedconfig.md) y, a continuación, elimina la aplicación.
Si el directorio raíz contiene un archivo `platform.yaml` donde se especifica una plataforma personalizada, este comando termina el entorno personalizado en ejecución.
**nota**
Siempre podrá lanzar más adelante un nuevo entorno con la misma versión.
Si tiene datos de un entorno que desea conservar, establezca la política de eliminación de base de datos en `Retain` antes de terminar el entorno. Esto mantiene la base de datos en funcionamiento fuera de Elastic Beanstalk. Después de esto, cualquier entorno de Elastic Beanstalk debe conectarse a él como una base de datos externa. Si desea hacer una copia de seguridad de los datos sin mantener la base de datos en funcionamiento, configure la política de eliminación para que tome una instantánea de la base de datos antes de terminar el entorno. Para obtener más información, consulte [Ciclo de vida de la base de datos](using-features.managing.db.md#environments-cfg-rds-lifecycle) en el capítulo *Configuración de entornos* de esta guía.
**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](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/protection-from-dangling-dns.html) en la *Guía para desarrolladores de Amazon Route 53*. También puedes obtener más información sobre las entradas de DNS pendientes en [Enhanced Domain Protections for Amazon CloudFront Requests](https://aws.amazon.com/blogs/security/enhanced-domain-protections-for-amazon-cloudfront-requests/) en el *blog AWS de seguridad*.
## Sintaxis
**eb terminate**
**eb terminate *environment-name***
## Opciones
****
| Name | Descripción |
| --- | --- |
| `--all` | Termina todos los entornos de la aplicación, las [versiones de la aplicación](applications-versions.md) y sus [configuraciones guardadas](environment-configuration-savedconfig.md) y, a continuación, elimina la aplicación. |
| `--force` | Termina el entorno sin pedir confirmación. |
| `--ignore-links` | Termina el entorno aunque haya otros entornos asociados que dependen de él. Consulte [Compose Environments](ebcli-compose.md). |
| `--timeout` | Número de minutos que deben transcurrir antes de que se agote el tiempo de espera del comando. |
## Output
Si se ejecuta correctamente, el comando devuelve el estado de la operación `terminate`.
## Ejemplo
La solicitud del ejemplo siguiente termina el entorno tmp-dev.
```
$ eb terminate
The environment "tmp-dev" and all associated instances will be terminated.
To confirm, type the environment name: tmp-dev
2018-07-11 21:05:25 INFO: terminateEnvironment is starting.
2018-07-11 21:05:40 INFO: Deleted CloudWatch alarm named: awseb-e-2cpfjbra9a-stack-AWSEBCloudwatchAlarmHigh-16V08YOF2KQ7U
2018-07-11 21:05:41 INFO: Deleted CloudWatch alarm named: awseb-e-2cpfjbra9a-stack-AWSEBCloudwatchAlarmLow-6ZAWH9F20P7C
2018-07-11 21:06:42 INFO: Deleted Auto Scaling group policy named: arn:aws:autoscaling:us-east-2:11122223333:scalingPolicy:5d7d3e6b-d59b-47c5-b102-3e11fe3047be:autoScalingGroupName/awseb-e-2cpfjbra9a-stack-AWSEBAutoScalingGroup-7AXY7U13ZQ6E:policyName/awseb-e-2cpfjbra9a-stack-AWSEBAutoSca
lingScaleUpPolicy-1876U27JEC34J
2018-07-11 21:06:43 INFO: Deleted Auto Scaling group policy named: arn:aws:autoscaling:us-east-2:11122223333:scalingPolicy:29c6e7c7-7ac8-46fc-91f5-cfabb65b985b:autoScalingGroupName/awseb-e-2cpfjbra9a-stack-AWSEBAutoScalingGroup-7AXY7U13ZQ6E:policyName/awseb-e-2cpfjbra9a-stack-AWSEBAutoSca
lingScaleDownPolicy-SL4LHODMOMU
2018-07-11 21:06:48 INFO: Waiting for EC2 instances to terminate. This may take a few minutes.
2018-07-11 21:08:55 INFO: Deleted Auto Scaling group named: awseb-e-2cpfjbra9a-stack-AWSEBAutoScalingGroup-7AXY7U13ZQ6E
2018-07-11 21:09:10 INFO: Deleted security group named: awseb-e-2cpfjbra9a-stack-AWSEBSecurityGroup-XT4YYGFL7I99
2018-07-11 21:09:40 INFO: Deleted load balancer named: awseb-e-2-AWSEBLoa-AK6RRYFQVV3S
2018-07-11 21:09:42 INFO: Deleting SNS topic for environment tmp-dev.
2018-07-11 21:09:52 INFO: terminateEnvironment completed successfully.
```
# **eb upgrade**
## Description (Descripción)
Actualiza la plataforma de su entorno a la versión más reciente de la plataforma en la que se está ejecutando en este momento.
Si el directorio raíz contiene un archivo `platform.yaml` que especifica una plataforma personalizada, este comando actualiza el entorno a la versión más reciente de la plataforma personalizada en la que se está ejecutando en este momento.
## Sintaxis
**eb upgrade**
**eb upgrade *environment-name***
## Opciones
****
| Name | Descripción |
| --- | --- |
| `--force` | Actualiza sin pedirle que confirme el nombre del entorno antes de empezar el proceso de actualización. |
| `--noroll` | Actualiza todas las instancias sin usar las actualizaciones continuas para mantener algunas instancias en servicio durante la actualización. |
| [Opciones comunes](eb3-cmd-options.md) | |
## Output
El comando muestra un resumen de los cambios y le pedirá que confirme la actualización escribiendo el nombre del entorno. En caso de éxito, el entorno se actualiza y se lanza con la versión más reciente de la plataforma.
## Ejemplo
En el siguiente ejemplo se actualiza la versión de la plataforma actual del entorno especificado a la última versión de la plataforma disponible.
```
$ eb upgrade
Current platform: 64bit Amazon Linux 2014.09 v1.0.9 running Python 2.7
Latest platform: 64bit Amazon Linux 2014.09 v1.2.0 running Python 2.7
WARNING: This operation replaces your instances with minimal or zero downtime. You may cancel the upgrade after it has started by typing "eb abort".
You can also change your platform version by typing "eb clone" and then "eb swap".
To continue, type the environment name:
```
# **eb use**
## Description (Descripción)
Establece el entorno especificado en el entorno predeterminado.
Cuando se utiliza Git, **eb use** establece el entorno predeterminado de la ramificación actual. Ejecute este comando una vez en cada ramificación que desee implementar en Elastic Beanstalk.
## Sintaxis
**eb use *environment-name***
## Opciones
****
| Name | Description (Descripción) |
| --- | --- |
| `--source codecommit/repository-name/branch-name` | CodeCommit repositorio y sucursal. |
| `-r region` `--region region` | Cambie la región en la que se van a crear los entornos. |
| [Opciones comunes](eb3-cmd-options.md) | |