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.
# Importación de una imagen de máquina virtual a un dispositivo Snowball Edge
Puede utilizar el Import/Export servicio AWS CLI y VM para importar una imagen de máquina virtual (VM) al dispositivo Snowball Edge como Amazon Machine Image (AMI). Tras importar una imagen de máquina virtual, registre la imagen como una AMI y ejecútela como una instancia EC2 compatible con Amazon.
Puede añadir AMIs desde Amazon EC2 al dispositivo al crear un trabajo para solicitar un dispositivo Snowball Edge. Siga este procedimiento después de recibir el dispositivo Snowball Edge. Para obtener más información, consulte [Elección de las opciones de computación y almacenamiento](create-job-common.md#compute-storage).
También puede utilizarlo AWS OpsHub para cargar el archivo de imagen de la máquina virtual. Para obtener más información, consulte [Importación de una imagen a su dispositivo como una AMI EC2 compatible con Amazon](https://docs.aws.amazon.com/snowball/latest/developer-guide/manage-ec2.html#ec2-ami-import) en esta guía.
**Topics**
+ [Paso 1: Prepare la imagen de la máquina virtual y cárguela en el dispositivo Snowball Edge](#prepare-image-cli)
+ [Paso 2: Configurar los permisos necesarios en Snowball Edge](#setup-permission-cli)
+ [Paso 3: Importar la imagen de la máquina virtual como una instantánea en Snowball Edge](#import-snapshot-cli)
+ [Paso 4: Registrar la instantánea como AMI en Snowball Edge](#register-snapshot-cli)
+ [Paso 5: Lanzar una instancia desde la AMI en Snowball Edge](#launch-ami-cli)
+ [Acciones de AMI adicionales para Snowball Edge](#additional-ami-actions)
## Paso 1: Prepare la imagen de la máquina virtual y cárguela en el dispositivo Snowball Edge
Prepare la imagen de máquina virtual exportando una imagen de máquina virtual desde una instancia o EC2 AMI de Amazon en la máquina virtual en Nube de AWS uso Import/Export o generando la imagen de máquina virtual de forma local con la plataforma de virtualización que elija.
Para exportar una EC2 instancia de Amazon como imagen de VM mediante VM Import/Export, consulte [Exportación de una instancia como VM mediante VM Import/Export](https://docs.aws.amazon.com/vm-import/latest/userguide/vmexport.html) en la Guía del usuario de VM. Import/Export Para exportar una EC2 AMI de Amazon como imagen de máquina virtual mediante VM Import/Export, consulte [Exportación de una máquina virtual directamente desde una imagen de máquina de Amazon (AMI)](https://docs.aws.amazon.com/vm-import/latest/userguide/vmexport_image.html) en la Guía del Import/Export usuario de máquinas virtuales.
Si genera una imagen de máquina virtual desde su entorno local, asegúrese de que la imagen esté configurada para su uso como AMI en el dispositivo Snowball Edge. Es posible que deba configurar los siguientes elementos en función del entorno.
+ Configure y actualice el sistema operativo.
+ Establezca un nombre de host.
+ Asegúrese de que el protocolo de tiempo de red (NTP) esté configurado.
+ Incluya las claves públicas de SSH, si es necesario. Cree copias locales de los pares de claves. Para obtener más información, consulte [Uso de SSH para conectarse a la instancia de computación en un dispositivo Snowball Edge](https://docs.aws.amazon.com/snowball/latest/developer-guide/ssh-ec2-edge.html).
+ Instale y configure cualquier software que vaya a utilizar en el dispositivo Snowball Edge.
**nota**
Tenga en cuenta las siguientes limitaciones al preparar una instantánea de disco para un dispositivo Snowball Edge.
Actualmente, Snowball Edge solo admite la importación de instantáneas en formato de imagen RAW.
Actualmente, Snowball Edge solo admite la importación de instantáneas con tamaños de 1 GB a 1 TB.
### Carga de una imagen de máquina virtual a un bucket de Amazon S3 en el dispositivo Snowball Edge
Tras preparar una imagen de máquina virtual, cárguela en un bucket de S3 del dispositivo o clúster de Snowball Edge. Puede utilizar el adaptador S3 o el almacenamiento compatible con Amazon S3 en Snowball Edge para cargar la instantánea.
**Carga de la imagen de máquina virtual mediante el adaptador de S3**
+ Utilice el comando `cp` para copiar el archivo de imagen de máquina virtual en un bucket del dispositivo.
```
aws s3 cp image-path s3://S3-bucket-name --endpoint http://S3-object-API-endpoint:443 --profile profile-name
```
Para obtener más información, consulte [AWS CLI los comandos compatibles](https://docs.aws.amazon.com/snowball/latest/developer-guide/using-adapter-cli.html) en esta guía.
**Para cargar la imagen de la máquina virtual mediante un almacenamiento compatible con Amazon S3 en Snowball Edge**
+ Utilice el comando `put-object` para copiar el archivo de imagen de instantánea en un bucket del dispositivo.
```
aws s3api put-object --bucket bucket-name --key path-to-snapshot-file --body snapshot-file --endpoint-url s3api-endpoint-ip --profile your-profile
```
Para obtener más información, consulte [Uso de objetos de S3 en un dispositivo Snowball Edge](https://docs.aws.amazon.com/snowball/latest/developer-guide/objects-s3-snow.html).
## Paso 2: Configurar los permisos necesarios en Snowball Edge
Para que la importación se realice correctamente, debe configurar los permisos para la máquina virtual Import/Export en el dispositivo Snowball Edge EC2, Amazon y el usuario.
**nota**
Los roles y políticas de servicio que proporcionan estos permisos se encuentran en el dispositivo Snowball Edge.
### Permisos necesarios para la máquina virtual Import/Export en un Snowball Edge
Antes de iniciar el proceso de importación, debe crear un rol de IAM con una política de confianza que permita que la máquina virtual Import/Export del dispositivo Snowball Edge asuma el rol. Se otorgan permisos adicionales a la función para permitir que la máquina virtual Import/Export del dispositivo acceda a la imagen almacenada en el bucket de S3 del dispositivo.
**Creación de un archivo json de política de confianza**
A continuación, se muestra un ejemplo de política de confianza que se debe adjuntar al rol para que la máquina virtual Import/Export pueda acceder a la instantánea que se debe importar del bucket de S3.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement":[
{
"Effect":"Allow",
"Principal":{
"Service":"vmie.amazonaws.com"
},
"Action":"sts:AssumeRole"
}
]
}
```
------
**Creación de un rol con el archivo json de política de confianza**
El nombre del rol puede ser vmimport. Puede cambiarlo mediante la opción --role-name del comando:
```
aws iam create-role --role-name role-name --assume-role-policy-document file:///trust-policy-json-path --endpoint http://snowball-ip:6078 --region snow --profile profile-name
```
A continuación se muestra un ejemplo de salida del comando `create-role`.
```
{
"Role":{
"AssumeRolePolicyDocument":{
"Version":"2012-10-17",
"Statement":[
{
"Action":"sts:AssumeRole",
"Effect":"Allow",
"Principal":{
"Service":"vmie.amazonaws.com"
}
}
]
},
"MaxSessionDuration":3600,
"RoleId":"AROACEMGEZDGNBVGY3TQOJQGEZAAAABQBB6NSGNAAAABPSVLTREPY3FPAFOLKJ3",
"CreateDate":"2022-04-19T22:17:19.823Z",
"RoleName":"vmimport",
"Path":"/",
"Arn":"arn:aws:iam::123456789012:role/vmimport"
}
}
```
**Creación de una política para el rol**
La siguiente política de ejemplo tiene los permisos mínimos necesarios para obtener acceso a Amazon S3. Cambie el nombre del bucket de Amazon S3 por el del bucket que contiene sus imágenes. En el caso de un dispositivo Snowball Edge independiente, *snow-id* cambie a su ID de trabajo. En el caso de un clúster de dispositivos, cambie *snow-id* al ID del clúster. También puede usar prefijos para restringir aún más la ubicación desde la que la máquina virtual Import/Export puede importar las instantáneas. Cree un archivo json de política como este.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement":[
{
"Effect":"Allow",
"Action":[
"s3:GetBucketLocation",
"s3:GetObject",
"s3:ListBucket",
"s3:GetMetadata"
],
"Resource":[
"arn:aws:s3:snow:account-id:snow/snow-id/bucket/import-snapshot-bucket-name",
"arn:aws:s3:snow:account-id:snow/snow-id/bucket/import-snapshot-bucket-name/*"
]
}
]
}
```
------
**Creación de una política con el archivo de política:**
```
aws iam create-policy --policy-name policy-name --policy-document file:///policy-json-file-path --endpoint http://snowball-ip:6078 --region snow --profile profile-name
```
A continuación, se muestra un ejemplo de salida del comando create-policy.
```
{
"Policy":{
"PolicyName":"vmimport-resource-policy",
"PolicyId":"ANPACEMGEZDGNBVGY3TQOJQGEZAAAABOOEE3IIHAAAABWZJPI2VW4UUTFEDBC2R",
"Arn":"arn:aws:iam::123456789012:policy/vmimport-resource-policy",
"Path":"/",
"DefaultVersionId":"v1",
"AttachmentCount":0,
"IsAttachable":true,
"CreateDate":"2020-07-25T23:27:35.690000+00:00",
"UpdateDate":"2020-07-25T23:27:35.690000+00:00"
}
}
```
****Asociación de la política al rol****
Asocie una política al rol anterior y conceda permisos de acceso a los recursos necesarios. Esto permite que el Import/Export servicio de máquina virtual local descargue la instantánea de Amazon S3 en el dispositivo.
```
aws iam attach-role-policy --role-name role-name --policy-arn arn:aws:iam::123456789012:policy/policy-name --endpoint http://snowball-ip:6078 --region snow --profile profile-name
```
### Permisos requeridos por la persona que llama en un Snowball Edge
Además de la función que debe asumir la máquina virtual Import/Export Snowball Edge, también debe asegurarse de que el usuario tenga los permisos que le permitan transferir la función a VMIE. Si utiliza el usuario raíz predeterminado para realizar la importación, el usuario raíz ya tiene todos los permisos necesarios, por lo que puede omitir este paso e ir al paso 3.
Asocie los dos permisos de IAM siguientes al usuario que está realizando la importación.
+ `pass-role`
+ `get-role`
**Creación de una política para el rol**
A continuación se ofrece un ejemplo de una política que permite a un usuario realizar las acciones `get-role` y `pass-role` para el rol de IAM.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement":[
{
"Effect":"Allow",
"Action": "iam:GetRole",
"Resource":"*"
},
{
"Sid": "iamPassRole",
"Effect": "Allow",
"Action": "iam:PassRole",
"Resource": "arn:aws:iam::*:role/snowball*",
"Condition": {
"StringEquals": {
"iam:PassedToService": "importexport.amazonaws.com"
}
}
}
]
}
```
------
****Creación de una política con el archivo de política:****
```
aws iam create-policy --policy-name policy-name --policy-document file:///policy-json-file-path --endpoint http://snowball-ip:6078 --region snow --profile profile-name
```
A continuación, se muestra un ejemplo de salida del comando create-policy.
```
{
"Policy":{
"PolicyName":"caller-policy",
"PolicyId":"ANPACEMGEZDGNBVGY3TQOJQGEZAAAABOOOTUOE3AAAAAAPPBEUM7Q7ARPUE53C6R",
"Arn":"arn:aws:iam::123456789012:policy/caller-policy",
"Path":"/",
"DefaultVersionId":"v1",
"AttachmentCount":0,
"IsAttachable":true,
"CreateDate":"2020-07-30T00:58:25.309000+00:00",
"UpdateDate":"2020-07-30T00:58:25.309000+00:00"
}
}
```
Una vez que se haya generado la política, adjúntela a los usuarios de IAM que llamarán a la operación de EC2 API o CLI de Amazon para importar la instantánea.
```
aws iam attach-user-policy --user-name your-user-name --policy-arn arn:aws:iam::123456789012:policy/policy-name --endpoint http://snowball-ip:6078 --region snow --profile profile-name
```
### Se requieren permisos para llamar a Amazon EC2 APIs on a Snowball Edge
Para importar una instantánea, el usuario de IAM debe tener los permisos `ec2:ImportSnapshot`. Si no es necesario restringir el acceso al usuario, puedes usar los `ec2:*` permisos para conceder EC2 acceso total a Amazon. Los siguientes son los permisos que se pueden conceder o restringir para Amazon EC2 en tu dispositivo. Se muestra el contenido de la creación de un archivo de política:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement":[
{
"Effect":"Allow",
"Action":[
"ec2:ImportSnapshot",
"ec2:DescribeImportSnapshotTasks",
"ec2:CancelImportTask",
"ec2:DescribeSnapshots",
"ec2:DeleteSnapshot",
"ec2:RegisterImage",
"ec2:DescribeImages",
"ec2:DeregisterImage"
],
"Resource":"*"
}
]
}
```
------
**Creación de una política con el archivo de política:**
```
aws iam create-policy --policy-name policy-name --policy-document file:///policy-json-file-path --endpoint http://snowball-ip:6078 --region snow --profile profile-name
```
A continuación, se muestra un ejemplo de salida del comando create-policy.
```
{
"Policy":
{
"PolicyName": "ec2-import.json",
"PolicyId": "ANPACEMGEZDGNBVGY3TQOJQGEZAAAABQBGPDQC5AAAAATYN62UNBFYTF5WVCSCZS",
"Arn": "arn:aws:iam::123456789012:policy/ec2-import.json",
"Path": "/",
"DefaultVersionId": "v1",
"AttachmentCount": 0,
"IsAttachable": true,
"CreateDate": "2022-04-21T16:25:53.504000+00:00",
"UpdateDate": "2022-04-21T16:25:53.504000+00:00"
}
}
```
Una vez que se haya generado la política, adjúntela a los usuarios de IAM que llamarán a la operación de EC2 API o CLI de Amazon para importar la instantánea.
```
aws iam attach-user-policy --user-name your-user-name --policy-arn arn:aws:iam::123456789012:policy/policy-name --endpoint http://snowball-ip:6078 --region snow --profile profile-name
```
## Paso 3: Importar la imagen de la máquina virtual como una instantánea en Snowball Edge
El siguiente paso consiste en importar la imagen de máquina virtual como una instantánea en el dispositivo. El valor del parámetro `S3Bucket` es el nombre del bucket que contiene la imagen de máquina virtual. El valor del parámetro `S3Key` es la ruta al archivo de imagen de máquina virtual de este bucket.
```
aws ec2 import-snapshot --disk-container "Format=RAW,UserBucket={S3Bucket=bucket-name,S3Key=image-file}" --endpoint http://snowball-ip:8008 --region snow --profile profile-name
```
Para obtener más información, consulte [import-snapshot](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/import-snapshot.html) en la AWS CLI Referencia de comandos.
Este comando no admite los siguientes modificadores.
+ [--client-data `value`]
+ [--client-token `value`]
+ [--dry-run]
+ [--no-dry-run]
+ [--encrypted]
+ [--no-encrypted]
+ [--kms-key-id `value`]
+ [--tag-specifications `value`]
**Example resultado del comando `import-snapshot`**
```
{
"ImportTaskId":"s.import-snap-1234567890abc",
"SnapshotTaskDetail":{
"DiskImageSize":2.0,
"Encrypted":false,
"Format":"RAW",
"Progress":"3",
"Status":"active",
"StatusMessage":"pending",
"UserBucket":{
"S3Bucket":"bucket",
"S3Key":"vmimport/image01"
}
}
}
```
Actualmente, Snowball Edge solo permite ejecutar un trabajo de importación activo a la vez, por dispositivo. Para iniciar una nueva tarea de importación, espere a que finalice la tarea actual o elija otro nodo disponible en un clúster. También puede optar por cancelar la importación actual si lo desea. Para evitar retrasos, no reinicie el dispositivo Snowball Edge mientras la importación esté en curso. Si reinicia el dispositivo, se producirá un error en la importación y el progreso se eliminará cuando se pueda obtener acceso al dispositivo. Para comprobar el estado de la tarea de importación de instantáneas, use el comando siguiente:
```
aws ec2 describe-import-snapshot-tasks --import-task-ids id --endpoint http://snowball-ip:8008 --region snow --profile profile-name
```
## Paso 4: Registrar la instantánea como AMI en Snowball Edge
Cuando la importación de la instantánea al dispositivo se haya realizado correctamente, puede registrarla mediante el comando `register-image`.
**nota**
Solo puede registrar una AMI cuando todas las instantáneas estén disponibles.
Para obtener más información, consulte [register-image en la Referencia de comandos](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/register-image.html). AWS CLI
**Example del comando `register-image`**
```
aws ec2 register-image \
--name ami-01 \
--description my-ami-01 \
--block-device-mappings "[{\"DeviceName\": \"/dev/sda1\",\"Ebs\":{\"Encrypted\":false,\"DeleteOnTermination\":true,\"SnapshotId\":\"snapshot-id\",\"VolumeSize\":30}}]" \
--root-device-name /dev/sda1 \
--endpoint http://snowball-ip:8008 \
--region snow \
--profile profile-name
```
El siguiente es un ejemplo de JSON de asignación de dispositivos de bloques. Para obtener más información, consulte el [block-device-mapping parámetro register-image en la Referencia de](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/register-image.html) comandos. AWS CLI
```
[
{
"DeviceName": "/dev/sda",
"Ebs":
{
"Encrypted": false,
"DeleteOnTermination": true,
"SnapshotId": "snapshot-id",
"VolumeSize": 30
}
}
]
```
**Example del comando `register-image`**
```
{
"ImageId": "s.ami-8de47d2e397937318"
}
```
## Paso 5: Lanzar una instancia desde la AMI en Snowball Edge
Para lanzar una instancia, consulte [run-instances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/run-instances.html) en la AWS CLI Referencia de comandos.
El valor del parámetro `image-id` es el valor del nombre `ImageId` como resultado del comando `register-image`.
```
aws ec2 run-instances --image-id image-id --instance-type instance-type --endpoint http://snowball-ip:8008 --region snow --profile profile-name
```
```
{
"Instances":[
{
"SourceDestCheck":false,
"CpuOptions":{
"CoreCount":1,
"ThreadsPerCore":2
},
"InstanceId":"s.i-12345a73123456d1",
"EnaSupport":false,
"ImageId":"s.ami-1234567890abcdefg",
"State":{
"Code":0,
"Name":"pending"
},
"EbsOptimized":false,
"SecurityGroups":[
{
"GroupName":"default",
"GroupId":"s.sg-1234567890abc"
}
],
"RootDeviceName":"/dev/sda1",
"AmiLaunchIndex":0,
"InstanceType":"sbe-c.large"
}
],
"ReservationId":"s.r-1234567890abc"
}
```
**nota**
También puedes utilizarla AWS OpsHub para lanzar la instancia. Para obtener más información, consulta [Cómo lanzar una instancia EC2 compatible con Amazon](https://docs.aws.amazon.com/snowball/latest/developer-guide/manage-ec2.html#launch-instance) en esta guía.
## Acciones de AMI adicionales para Snowball Edge
Puede utilizar AWS CLI comandos adicionales para supervisar el estado de importación de las instantáneas, obtener detalles sobre las instantáneas que se han importado, cancelar la importación de una instantánea y eliminar o anular el registro de las instantáneas una vez importadas.
### Supervisión del estado de importación de instantáneas en un Snowball Edge
Para ver el estado actual del progreso de la importación, puedes ejecutar el EC2 `describe-import-snapshot-tasks` comando Amazon. Este comando admite paginación y filtrado por `task-state`.
**Example del comando `describe-import-snapshot-tasks`**
```
aws ec2 describe-import-snapshot-tasks --import-task-ids id --endpoint http://snowball-ip:8008 --region snow --profile profile-name
```
**Example del resultado del comando `describe-import-snapshot-tasks`**
```
{
"ImportSnapshotTasks": [
{
"ImportTaskId": "s.import-snap-8f6bfd7fc9ead9aca",
"SnapshotTaskDetail": {
"Description": "Created by AWS-Snowball-VMImport service for s.import-snap-8f6bfd7fc9ead9aca",
"DiskImageSize": 8.0,
"Encrypted": false,
"Format": "RAW",
"Progress": "3",
"SnapshotId": "s.snap-848a22d7518ad442b",
"Status": "active",
"StatusMessage": "pending",
"UserBucket": {
"S3Bucket": "bucket1",
"S3Key": "image1"
}
}
}
]
}
```
**nota**
Este comando solo muestra el resultado de las tareas que se han completado correctamente o que se han marcado como eliminadas en los últimos siete días. El filtrado solo admite `Name=task-state`, `Values=active | deleting | deleted | completed`
Este comando no admite los siguientes parámetros.
+ [--dry-run]
+ [--no-dry-run]
### Cancelar una tarea de importación en un Snowball Edge
Para cancelar una tarea de importación, ejecute el comando `cancel-import-task`.
**Example del comando `cancel-import-task`**
```
aws ec2 cancel-import-task --import-task-id import-task-id --endpoint http://snowball-ip:8008 --region snow --profile profile-name
```
**Example del resultado del comando `cancel-import-task`**
```
{
"ImportTaskId": "s.import-snap-8234ef2a01cc3b0c6",
"PreviousState": "active",
"State": "deleting"
}
```
Solo se pueden cancelar las tareas que no tienen el estado completado.
Este comando no admite los siguientes parámetros.
+ [--dry-run]
+ [--no-dry-run]
### Descripción de las instantáneas en un Snowball Edge
Después de importar una instantánea, puede usar este comando para describirla. Para filtrar las instantáneas, puede pasarlas en `snapshot-ids` con el ID de instantánea de la respuesta de la tarea de importación anterior. Este comando admite paginación y filtrado por `volume-id`, `status` y `start-time`.
**Example del comando `describe-snapshots`**
```
aws ec2 describe-snapshots --snapshot-ids snapshot-id --endpoint http://snowball-ip:8008 --region snow --profile profile-name
```
**Example del resultado del comando `describe-snapshots`**
```
{
"Snapshots": [
{
"Description": "Created by AWS-Snowball-VMImport service for s.import-snap-8f6bfd7fc9ead9aca",
"Encrypted": false,
"OwnerId": "123456789012",
"SnapshotId": "s.snap-848a22d7518ad442b",
"StartTime": "2020-07-30T04:31:05.032000+00:00",
"State": "completed",
"VolumeSize": 8
}
]
}
```
Este comando no admite los siguientes parámetros.
+ [--restorable-by-user-ids `value`]
+ [--dry-run]
+ [--no-dry-run]
### Eliminar una instantánea de un dispositivo Snowball Edge
Para eliminar instantáneas de su propiedad y que ya no necesita, puede usar el comando `delete-snapshot`.
**Example del comando `delete-snapshot`**
```
aws ec2 delete-snapshot --snapshot-id snapshot-id --endpoint http://snowball-ip:8008 --region snow --profile profile-name
```
**nota**
Snowball Edge no permite eliminar instantáneas que se encuentren en estado **PENDIENTE** o que estén designadas como dispositivo raíz para una AMI.
Este comando no admite los siguientes parámetros.
+ [--dry-run]
+ [--no-dry-run]
### Anular el registro de una AMI en un Snowball Edge
Para anular el registro AMIs que ya no necesita, puede ejecutar el comando. `deregister-image` Actualmente, no se puede anular el registro de una AMI que tiene el estado **Pendiente**.
**Example del comando `deregister-image`**
```
aws ec2 deregister-image --image-id image-id --endpoint http://snowball-ip:8008 --region snow --profile profile-name
```
Este comando no admite los siguientes parámetros.
+ [--dry-run]
+ [--no-dry-run]