Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# AMI \$1 Crear
Cree una Amazon Machine Image (AMI) basada en una instancia EC2 independiente existente en su cuenta de AMS. La instancia debe estar detenida antes de ejecutar este tipo de cambio.
**Clasificación completa:** Despliegue \$1 Componentes de pila avanzados \$1 AMI \$1 Crear
## Detalles del tipo de cambio
****
| | |
| --- |--- |
| ID de tipo de cambio | ct-3rqqu43krekby |
| Versión actual | 2.0 |
| Duración prevista de la ejecución | 360 minutos |
| Aprobación de AWS | Obligatorio |
| Aprobación del cliente | No obligatorio |
| Modo de ejecución | Automatizado |
## Información adicional
### Creación de una AMI
#### Creación de una AMI con la consola
A continuación se muestra este tipo de cambio en la consola AMS.
![\[Cambio type details for creating an Amazon Machine Image (AMI) from an EC2 instance.\]](http://docs.aws.amazon.com/es_es/managedservices/latest/ctref/images/guiAmiCreateCT.png)
**importante**
Antes de empezar, prepare la instancia EC2 que utilizará para crear la AMI. Sin la preparación adecuada, es probable que la RFC de creación de AMI sea rechazada o no se realice correctamente. Para obtener información sobre cómo preparar la instancia para crear correctamente una AMI, consulte las instrucciones incluidas en este tutorial.
Funcionamiento:
1. Vaya a la página **Crear RFC**: en el panel de navegación izquierdo de la consola AMS, haga clic **RFCs**para abrir la página de RFCs lista y, a continuación, haga clic en **Crear RFC**.
1. Elija un tipo de cambio (CT) popular en la vista predeterminada **de búsqueda de tipos de cambios** o seleccione un CT en la vista **Elegir por categoría**.
+ **Busque por tipo de cambio**: puede hacer clic en un CT popular en el área de **creación rápida** para abrir inmediatamente la página **Ejecutar RFC**. Tenga en cuenta que no puede elegir una versión antigua de CT con Quick Create.
Para ordenar CTs, utilice el área **Todos los tipos de cambios** en la vista **de tarjeta** o de **tabla**. En cualquiera de las vistas, seleccione una CT y, a continuación, haga clic en **Crear RFC** para abrir la página **Ejecutar RFC**. Si corresponde, aparece la opción **Crear con una versión anterior** junto al botón **Crear RFC**.
+ **Elegir por categoría**: seleccione una categoría, una subcategoría, un elemento y una operación, y se abrirá el cuadro de detalles del CT con la opción **Crear con una versión anterior, si corresponde**. Haga clic en **Crear RFC** para abrir la página **Ejecutar RFC**.
1. En la página **Ejecutar RFC**, abra el área del nombre del CT para ver el cuadro de detalles del CT. Se requiere un **asunto** (lo rellena automáticamente si elige su CT en la vista **Buscar tipos de cambios**). Abra el área **de configuración adicional** para añadir información sobre la RFC.
En el área de **configuración de ejecución**, utilice las listas desplegables disponibles o introduzca valores para los parámetros necesarios. Para configurar los parámetros de ejecución opcionales, abra el área **de configuración adicional**.
1. Cuando haya terminado, haga clic en **Ejecutar**. Si no hay errores, aparecerá la página de la **RFC creada correctamente** con los detalles de la RFC enviada y el resultado inicial de la **ejecución**.
1. Abra el área de **parámetros de ejecución** para ver las configuraciones que envió. Actualice la página para actualizar el estado de ejecución de la RFC. Si lo desea, cancele la RFC o cree una copia de la misma con las opciones de la parte superior de la página.
#### Creación de una AMI con la CLI
Funcionamiento:
1. Utilice la función de creación en línea (se emite un `create-rfc` comando con todos los parámetros de ejecución y RFC incluidos) o la de plantilla (se crean dos archivos JSON, uno para los parámetros de RFC y otro para los parámetros de ejecución) y ejecute el `create-rfc` comando con los dos archivos como entrada. Ambos métodos se describen aquí.
1. Envíe el `aws amscm submit-rfc --rfc-id ID` comando RFC: con el ID de RFC devuelto.
Supervise el comando RFC:. `aws amscm get-rfc --rfc-id ID`
Para comprobar la versión del tipo de cambio, utilice este comando:
```
aws amscm list-change-type-version-summaries --filter Attribute=ChangeTypeId,Value=CT_ID
```
**nota**
Puede utilizar cualquier `CreateRfc` parámetro con cualquier RFC, forme o no parte del esquema del tipo de cambio. Por ejemplo, para recibir notificaciones cuando cambie el estado de la RFC, añada esta línea `--notification "{\"Email\": {\"EmailRecipients\" : [\"email@example.com\"]}}"` a la parte de los parámetros de la RFC de la solicitud (no a los parámetros de ejecución). Para ver una lista de todos los CreateRfc parámetros, consulta la referencia de la [API de administración de cambios de AMS](https://docs.aws.amazon.com/managedservices/latest/ApiReference-cm/API_CreateRfc.html).
*CREACIÓN EN LÍNEA*:
Ejecute el comando create RFC con los parámetros de ejecución incluidos en línea (comillas de escape al proporcionar los parámetros de ejecución en línea) y, a continuación, envíe el ID de RFC devuelto. Por ejemplo, puedes reemplazar el contenido por algo como esto:
```
aws --profile saml --region us-east-1 amscm create-rfc --change-type-id "ct-3rqqu43krekby" --change-type-version "2.0" --title "AMI-Create-IC" --execution-parameters "{\"AMIName\":\"MyAmi\",\"VpcId\":\"VPC_ID\",\"EC2InstanceId\":\"INSTANCE_ID\"}"
```
*CREACIÓN DE PLANTILLA*:
1. Envía los parámetros de ejecución del esquema JSON para este tipo de cambio a un archivo; este ejemplo lo nombra CreateAmiParams .json:
```
aws amscm get-change-type-version --change-type-id "ct-3rqqu43krekby" --query "ChangeTypeVersion.ExecutionInputSchema" --output text > CreateAmiParams.json
```
1. Modifique y guarde el CreateAmiParams archivo.json de los parámetros de ejecución. Por ejemplo, puedes reemplazar el contenido por algo como esto:
```
{
"AMIName": "My-AMI",
"InstanceId": "EC2_INSTANCE_ID"
}
```
1. Envía el archivo JSON de la plantilla RFC a un archivo de tu carpeta actual; este ejemplo lo nombra CreateAmiRfc .json:
```
aws amscm create-rfc --generate-cli-skeleton > CreateAmiRfc.json
```
1. Modifique y guarde el CreateAmiRfc archivo.json. Por ejemplo, puedes reemplazar el contenido por algo como esto:
```
{
"ChangeTypeId": "ct-3rqqu43krekby",
"ChangeTypeVersion": "2.0",
"Title": "AMI-Create-RFC"
}
```
1. Cree el RFC, especificando el CreateAmiRfc archivo y el CreateAmiParams archivo:
```
aws amscm create-rfc --cli-input-json file://CreateAmiRfc.json --execution-parameters file://CreateAmiParams.json
```
Recibirá el ID de la nueva RFC en la respuesta y podrá utilizarla para enviar y supervisar la RFC. Hasta que la envíe, la RFC permanece en estado de edición y no se inicia.
#### Consejos
**nota**
Después de crear una AMI personalizada, puede enviar una solicitud de servicio a AMS para que su grupo de Auto Scaling de EC2 existente utilice la nueva AMI. Para obtener información sobre cómo crear una solicitud de servicio, consulte los [ejemplos de solicitudes de servicio](https://docs.aws.amazon.com/managedservices/latest/userguide/serv-req-mgmt-examples.html).
**importante**
Antes de empezar, prepare la instancia EC2 que utilizará para crear la AMI. Sin la preparación adecuada, es probable que la RFC de creación de AMI sea rechazada o no se realice correctamente.
Para evitar problemas de autenticación en las instancias creadas a partir de la nueva AMI, ejecute estos comandos del sistema en la instancia después de aplicar los cambios personalizados y antes de llamar a Create AMI CT.
**importante**
Si la instancia especificada no se detiene ni se separa de su dominio actual, se produce un error en la RFC de creación de la AMI. Prepare la instancia tal y como se describe.
Para obtener más información, consulte [Creación de una imagen de máquina Amazon estándar con Sysprep](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/Creating_EBSbacked_WinAMI.html#23ami-create-standard).
Puede suscribirse a un tema de notificaciones AMI de AMS SNS para recibir una alerta cada vez que se despliegue un nuevo AMS AMIs que le interese. Para obtener más información, consulte el [Servicio de notificaciones AMI de AMS](https://docs.aws.amazon.com/managedservices/latest/userguide/ams-ami-notify.html).
##### Preparación de Linux para AMI Create
Descarga y ejecuta el siguiente script para preparar la instancia para la creación de la AMI. Debe ejecutar este script como usuario root.
```
curl https://amazon-ams-us-east-1.s3.amazonaws.com/latest/linux/prepare_instance_for_ami_and_shutdown.sh -o ./prepare_instance_for_ami_and_shutdown.sh
chmod 744 prepare_instance_for_ami_and_shutdown.sh
./prepare_instance_for_ami_and_shutdown.sh
```
Nota: El script anterior cierra la instancia y se cierra la sesión de los usuarios conectados.
##### Preparación de Windows para AMI Create
Windows Powershell (se ejecuta como administrador):
```
Invoke-AMSSysprep
```
La instancia se detiene y se cierra la sesión actual de Windows RDP de todos los usuarios conectados.
Para obtener más información sobre la creación de AWS Windows AMIs, consulte [Crear una AMI de Windows personalizada](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/Creating_EBSbacked_WinAMI.html#23ami-create-standard).
##### UserData para AMI Create
Si necesita que los datos de usuario se ejecuten en el siguiente arranque desde su AMI, asegúrese de lo siguiente:
+ `HKEY_LOCAL_MACHINE\SOFTWARE\Amazon\ManagedServices\RunUserDataViaAMSBootModule`La clave de registro está presente; si esa clave no está presente, los datos del usuario no se ejecutarán la próxima vez.
+ Para permitir que los datos de usuario se ejecuten en el próximo arranque:
1. Inicie Windows PowerShell con privilegios de administrador (ejecútelo como administrador)
1. Use el siguiente comando:
```
Install-AMSDependencies
```
Para obtener información sobre el error de creación de la AMI RFCs, consulte [Solución de problemas de errores de RFC](https://docs.aws.amazon.com/managedservices/latest/userguide/rfc-failures.html).
## Parámetros de entrada de ejecución
Para obtener información detallada sobre los parámetros de entrada de la ejecución, consulte[Esquema de cambio: tipo ct-3rqqu43krekby](schemas.md#ct-3rqqu43krekby-schema-section).
## Ejemplo: Parámetros necesarios
```
{
"InstanceId": "i-01234567890abcdef",
"AmiName": "MyAMI"
}
```
## Ejemplo: todos los parámetros
```
{
"InstanceId": "i-12345678",
"AmiName": "MyAMI",
"AmiTags": [
{
"Key": "foo",
"Value": "bar"
},
{
"Key": "testkey",
"Value": "testvalue"
}
]
}
```