Importieren eines VM-Images auf ein Snowball Edge-Gerät

Sie können den Service AWS CLI und den VM Import/Export verwenden, um ein Image einer virtuellen Maschine (VM) als Amazon Machine Image (AMI) auf das Snowball Edge-Gerät zu importieren. Nachdem Sie ein VM-Image importiert haben, registrieren Sie das Image als AMI und starten Sie es als Amazon EC2 -kompatible Instance.

Sie können dem Gerät AMIs etwas von Amazon EC2 hinzufügen, wenn Sie einen Auftrag zur Bestellung eines Snowball Edge-Geräts erstellen. Gehen Sie wie folgt vor, nachdem Sie das Snowball Edge-Gerät erhalten haben. Weitere Informationen finden Sie unter Wählen Sie Ihre Rechen- und Speicheroptionen.

Sie können es auch verwenden AWS OpsHub , um die VM-Imagedatei hochzuladen. Weitere Informationen finden Sie in diesem Handbuch unter Importieren eines Images auf Ihr Gerät als EC2 Amazon-kompatibles AMI.

Schritt 1: Bereiten Sie das VM-Image vor und laden Sie es auf das Snowball Edge-Gerät hoch

Bereiten Sie das VM-Image vor, indem Sie AWS Cloud mithilfe von VM Import/Export ein VM-Image aus einem Amazon EC2 AMI oder einer Instance exportieren oder indem Sie das VM-Image lokal mit der Virtualisierungsplattform Ihrer Wahl generieren.

Informationen zum Exportieren einer EC2 Amazon-Instance als VM-Image mithilfe von VM Import/Export finden Sie unter Exportieren einer Instanz als VM mithilfe von VM Import/Export in der VMImport/Export User Guide. To export an Amazon EC2 AMI as a VM image using VM Import/Export, unter Exportieren einer VM direkt aus einem Amazon Machine Image (AMI) im VM Import/Export User Guide.

Wenn Sie ein VM-Image aus Ihrer lokalen Umgebung generieren, stellen Sie sicher, dass das Image für die Verwendung als AMI auf dem Snowball Edge-Gerät konfiguriert ist. Abhängig von Ihrer Umgebung müssen Sie möglicherweise die folgenden Elemente konfigurieren.

Hochladen eines VM-Images in einen Amazon S3 S3-Bucket auf dem Snowball Edge-Gerät

Nachdem Sie ein VM-Image vorbereitet haben, laden Sie es in einen S3-Bucket auf dem Snowball Edge-Gerät oder -Cluster hoch. Sie können den S3-Adapter oder Amazon S3 S3-kompatiblen Speicher auf Snowball Edge verwenden, um den Snapshot hochzuladen.

Schritt 2: Richten Sie die erforderlichen Berechtigungen auf dem Snowball Edge ein

Damit der Import erfolgreich ist, müssen Sie die Berechtigungen für VM Import/Export auf dem Snowball Edge-Gerät EC2, Amazon und dem Benutzer einrichten.

Erforderliche Berechtigungen für VM-Import/Export auf einem Snowball Edge

Bevor Sie den Importvorgang starten können, müssen Sie eine IAM-Rolle mit einer Vertrauensrichtlinie erstellen, die es virtuellen Maschinen Import/Export on the Snowball Edge device to assume the role. Additional permissions are given to the role to allow VM Import/Export auf dem Gerät ermöglicht, auf das im S3-Bucket auf dem Gerät gespeicherte Image zuzugreifen.

Erstellen Sie eine JSON-Datei für Vertrauensrichtlinien

Im Folgenden finden Sie ein Beispiel für eine Vertrauensrichtlinie, die an die Rolle angehängt werden muss, damit VM Import/Export auf den Snapshot zugreifen kann, der aus dem S3-Bucket importiert werden muss.

{
   "Version":"2012-10-17",
   "Statement":[
      {
         "Effect":"Allow",
         "Principal":{
            "Service":"vmie.amazonaws.com"
         },
         "Action":"sts:AssumeRole"
      }
   ]
}

Erstellen Sie eine Rolle mit der JSON-Datei für die Vertrauensrichtlinie

Der Rollenname kann vmimport lauten. Sie können ihn ändern, indem Sie die Option --role-name im Befehl verwenden:

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

Im Folgenden finden Sie ein Beispiel für die Ausgabe des Befehls. 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"
   }
}

Erstellen Sie eine Richtlinie für die Rolle

Die folgende Beispielrichtlinie enthält die erforderlichen Mindestberechtigungen für den Zugriff auf Amazon S3. Ändern Sie den Namen des Amazon S3 S3-Buckets in den Namen, der Ihre Bilder enthält. Wechseln Sie bei einem eigenständigen Snowball Edge-Gerät snow-id zu Ihrer Job-ID. Wechseln Sie für einen Gerätecluster snow-id zur Cluster-ID. Sie können auch Präfixe verwenden, um den Ort, von dem VM Import/Export Snapshots importieren kann, weiter einzugrenzen. Erstellen Sie eine Richtlinien-JSON-Datei wie diese.

{
   "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/*"
            ]
      }
   ]
}

Erstellen Sie eine Richtlinie mit der Richtliniendatei:

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

Im Folgenden finden Sie ein Ausgabebeispiel für den Befehl 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"
   }
}

Hängen Sie die Richtlinie an die Rolle an

Fügen Sie der vorherigen Rolle eine Richtlinie hinzu und gewähren Sie Berechtigungen für den Zugriff auf die erforderlichen Ressourcen. Dadurch kann der lokale VM Import/Export Service den Snapshot von Amazon S3 auf das Gerät herunterladen.

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

Berechtigungen, die der Anrufer auf einem Snowball Edge benötigt

Zusätzlich zu der Rolle, die der Snowball Edge-VM Import/Export übernehmen muss, müssen Sie auch sicherstellen, dass der Benutzer über die Berechtigungen verfügt, die es ihm ermöglichen, die Rolle an VMIE zu übergeben. Wenn Sie den Standard-Root-Benutzer für den Import verwenden, verfügt der Root-Benutzer bereits über alle erforderlichen Berechtigungen. Sie können diesen Schritt also überspringen und mit Schritt 3 fortfahren.

Ordnen Sie dem Benutzer, der den Import durchführt, die folgenden beiden IAM-Berechtigungen zu.

Erstellen Sie eine Richtlinie für die Rolle

Im Folgenden finden Sie ein Beispiel für eine Richtlinie, die es einem Benutzer ermöglicht, die pass-role Aktionen get-role und für die IAM-Rolle auszuführen.

{
   "Version":"2012-10-17",
   "Statement":[
        {
            "Effect":"Allow",
            "Action": "iam:GetRole",
            "Resource":"*"
        },
        {
            "Sid": "iamPassRole",
            "Effect": "Allow",
            "Action": "iam:PassRole",
            "Resource": "*",
            "Condition": {
                "StringEquals": {
                    "iam:PassedToService": "importexport.amazonaws.com"
                }
            }
        }
   ]
}

Erstellen Sie eine Richtlinie mit der Richtliniendatei:

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

Im Folgenden finden Sie ein Ausgabebeispiel für den Befehl 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"
   }
}

Nachdem die Richtlinie generiert wurde, hängen Sie die Richtlinie an die IAM-Benutzer an, die die EC2 Amazon-API- oder CLI-Operation aufrufen, um den Snapshot zu importieren.

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

Erforderliche Berechtigungen, um Amazon EC2 APIs auf einem Snowball Edge aufzurufen

Um einen Snapshot zu importieren, muss der IAM-Benutzer über die ec2:ImportSnapshot entsprechenden Berechtigungen verfügen. Wenn eine Beschränkung des Zugriffs auf den Benutzer nicht erforderlich ist, können Sie die ec2:* Berechtigungen verwenden, um Amazon vollen EC2 Zugriff zu gewähren. Im Folgenden sind die Berechtigungen aufgeführt, die Amazon EC2 auf Ihrem Gerät gewährt oder eingeschränkt werden können. Erstellen Sie eine Richtliniendatei mit dem angezeigten Inhalt:

{
   "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":"*"
      }
   ]
}

Erstellen Sie eine Richtlinie mit der Richtliniendatei:

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

Im Folgenden finden Sie ein Ausgabebeispiel für den Befehl 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"
        }
}

Nachdem die Richtlinie generiert wurde, hängen Sie die Richtlinie an die IAM-Benutzer an, die die EC2 Amazon-API- oder CLI-Operation aufrufen, um den Snapshot zu importieren.

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

Schritt 3: Importieren Sie das VM-Image als Snapshot auf Snowball Edge

Der nächste Schritt besteht darin, das VM-Image als Snapshot auf das Gerät zu importieren. Der Wert des S3Bucket Parameters ist der Name des Buckets, der das VM-Image enthält. Der Wert des S3Key Parameters ist der Pfad zur VM-Image-Datei in diesem 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

Weitere Informationen finden Sie unter import-snapshot in der AWS CLI Befehlsreferenz.

Dieser Befehl unterstützt die folgenden Optionen nicht.

{
   "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"
      }
   }
}

aws ec2 describe-import-snapshot-tasks --import-task-ids id --endpoint http://snowball-ip:8008 --region snow --profile profile-name

Schritt 4: Registrieren Sie den Snapshot als AMI auf dem Snowball Edge

Wenn der Snapshot-Import auf das Gerät erfolgreich ist, können Sie ihn mit dem register-image Befehl registrieren.

Weitere Informationen finden Sie unter register-image in der AWS CLI Befehlsreferenz.

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

Im Folgenden finden Sie ein Beispiel für die Blockgerätezuweisung im JSON-Format. Weitere Informationen finden Sie unter dem block-device-mapping Parameter von register-image in der AWS CLI Befehlsreferenz.

[
    {
        "DeviceName": "/dev/sda",
        "Ebs": 
            {
                "Encrypted": false,
                "DeleteOnTermination": true,
                "SnapshotId": "snapshot-id",
                "VolumeSize": 30
            }
    }
]

{
    "ImageId": "s.ami-8de47d2e397937318"
 }

Schritt 5: Starten Sie eine Instance über das AMI auf dem Snowball Edge

Informationen zum Starten einer Instance finden Sie unter run-instances in der AWS CLI Befehlsreferenz.

Der Wert des image-id Parameters entspricht dem Wert des ImageId Namens als Ausgabe des register-image Befehls.

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"
}

Zusätzliche AMI-Aktionen für einen Snowball Edge

Sie können zusätzliche AWS CLI Befehle verwenden, um den Status des Snapshot-Imports zu überwachen, Details zu importierten Snapshots abzurufen, den Import eines Snapshots abzubrechen und Snapshots nach dem Import zu löschen oder deren Registrierung aufzuheben.

Überwachen des Snapshot-Importstatus auf einem Snowball Edge

Um den aktuellen Status des Importvorgangs zu sehen, können Sie den EC2 describe-import-snapshot-tasks Amazon-Befehl ausführen. Dieser Befehl unterstützt Paginierung und Filterung auf demtask-state.

aws ec2 describe-import-snapshot-tasks --import-task-ids id --endpoint http://snowball-ip:8008 --region snow --profile profile-name

{
        "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"                        
                    }
                }
            }
        ]
 }

Dieser Befehl unterstützt die folgenden Parameter nicht.

Abbrechen einer Importaufgabe auf einem Snowball Edge

Um eine Importaufgabe abzubrechen, führen Sie den cancel-import-task Befehl aus.

aws ec2 cancel-import-task --import-task-id import-task-id --endpoint http://snowball-ip:8008 --region snow --profile profile-name

{
        "ImportTaskId": "s.import-snap-8234ef2a01cc3b0c6",
        "PreviousState": "active",
        "State": "deleting"
}

Dieser Befehl unterstützt die folgenden Parameter nicht.

Beschreibung von Schnappschüssen auf einem Snowball Edge

Nachdem ein Snapshot importiert wurde, können Sie ihn mit diesem Befehl beschreiben. Um die Snapshots zu filtern, können Sie sie snapshot-ids mit der Snapshot-ID aus der vorherigen Antwort auf die Importaufgabe übergeben. Dieser Befehl unterstützt Seitennummerierung und Filterung nach volume-idstatus, und. start-time

aws ec2 describe-snapshots --snapshot-ids snapshot-id --endpoint http://snowball-ip:8008 --region snow --profile profile-name

{
    "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
        }
    ]
 }

Dieser Befehl unterstützt die folgenden Parameter nicht.

Löschen eines Snapshots von einem Snowball Edge-Gerät

Um Snapshots zu entfernen, die Ihnen gehören und die Sie nicht mehr benötigen, können Sie den delete-snapshot Befehl verwenden.

aws ec2 delete-snapshot --snapshot-id snapshot-id --endpoint http://snowball-ip:8008 --region snow --profile profile-name

Dieser Befehl unterstützt die folgenden Parameter nicht.

Abmeldung eines AMI auf einem Snowball Edge

Um die Registrierung eines nicht mehr benötigten Produkts aufzuheben AMIs , können Sie den Befehl ausführen. deregister-image Das Abmelden eines AMI, das sich im Status Ausstehend befindet, wird derzeit nicht unterstützt.

aws ec2 deregister-image --image-id image-id --endpoint http://snowball-ip:8008 --region snow --profile profile-name

Dieser Befehl unterstützt die folgenden Parameter nicht.