Configuration et exécution d'Amazon EKS Anywhere sur les appareils Snowball Edge

Effectuer la configuration initiale

1. Téléchargez et installez le client Snowball Edge. Pour de plus amples informations, veuillez consulter Téléchargement et installation du client Snowball Edge.

2. Connectez l'appareil à votre réseau local. Pour de plus amples informations, veuillez consulter Connecter un Snowball Edge à votre réseau local.

3. Obtenez des informations d'identification pour déverrouiller votre appareil. Pour de plus amples informations, veuillez consulter Obtenir des informations d'identification pour accéder à un Snowball Edge.

4. Déverrouillez l'appareil. Pour de plus amples informations, veuillez consulter Débloquer le Snowball Edge. Vous pouvez également utiliser un outil de script au lieu de déverrouiller les appareils manuellement. Consultez la section Déverrouiller des appareils.

Pour créer un document de politique et le joindre à l'utilisateur local Amazon EKS Anywhere

1. Créez un document de politique et enregistrez-le sur votre ordinateur. Copiez la politique ci-dessous dans le document.

   JSON

   
   {
     "Version": "2012-10-17",
     "Statement": [
       {
         "Effect": "Allow",
         "Action": [
           "snowball-device:DescribeDevice",
           "snowball-device:CreateDirectNetworkInterface",
           "snowball-device:DeleteDirectNetworkInterface",
           "snowball-device:DescribeDirectNetworkInterfaces",
           "snowball-device:DescribeDeviceSoftware"
         ],
         "Resource": ["*"]
       },
       {
         "Effect": "Allow",
         "Action": [
           "ec2:RunInstances",
           "ec2:DescribeInstances",
           "ec2:TerminateInstances",
           "ec2:ImportKeyPair",
           "ec2:DescribeKeyPairs",
           "ec2:DescribeInstanceTypes",
           "ec2:DescribeImages",
           "ec2:DeleteTags"
         ],
         "Resource": ["*"]
       }
     ]
   }
       
   

2. Utilisez la create-policy commande pour créer une stratégie IAM basée sur le document de stratégie. La valeur du --policy-document paramètre doit utiliser le chemin absolu vers le fichier de régulation. Par exemple, file:///home/user/policy-name.json

   
   aws iam create-policy --policy-name policy-name --policy-document file:///home/user/policy-name.json --endpoint http://snowball-ip:6078 --profile profile-name
   {
       "Policy": {
           "PolicyName": "policy-name",
           "PolicyId": "ANPACEMGEZDGNBVGY3TQOJQGEZAAAABP76TE5MKAAAABCCOTR2IJ43NBTJRZBU",
           "Arn": "arn:aws:iam::123456789012:policy/policy-name",
           "Path": "/",
           "DefaultVersionId": "v1",
           "AttachmentCount": 0,
           "IsAttachable": true,
           "CreateDate": "2022-04-06T04:46:56.907000+00:00",
           "UpdateDate": "2022-04-06T04:46:56.907000+00:00"
       }
   }     
       

3. Utilisez la attach-user-policy commande pour associer la politique IAM à l'utilisateur local Amazon EKS Anywhere.

   
   aws iam attach-user-policy --policy-arn policy-arn --user-name user-name --endpoint http://snowball-ip:6078 --profile profile-name     
       

1. Utilisez la create-access-key commande pour créer une clé d'accès pour l'utilisateur local Amazon EKS Anywhere.

   
   aws iam create-access-key --user-name user-name --endpoint http://snowball-ip:6078 --profile profile-name
       {
           "AccessKey": {
               "UserName": "eks-a-user",
               "AccessKeyId": "AKIAIOSFODNN7EXAMPLE",
               "Status": "Active",
               "SecretAccessKey": "RTT/wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY",
               "CreateDate": "2022-04-06T04:23:46.139000+00:00"
           }
       }
     

2. Créez un fichier d'informations d'identification. Enregistrez les SecretAccessKey valeurs AccessKeyId et dans le format suivant.

   
   [snowball-ip] 
   aws_access_key_id = ABCDEFGHIJKLMNOPQR2T
   aws_secret_access_key = AfSD7sYz/TBZtzkReBl6PuuISzJ2WtNkeePw+nNzJ
   region = snow            
             

   Note

   Si vous travaillez avec plusieurs appareils Snowball Edge, l'ordre des informations d'identification dans le fichier n'a pas d'importance, mais les informations d'identification de tous les appareils doivent figurer dans un seul fichier.

Pour créer un fichier de certificats

1. Utilisez la list-certificates commande pour obtenir des certificats pour chaque appareil Snowball Edge que vous prévoyez d'utiliser.

   
   PATH_TO_Snowball_Edge_CLIENT/bin/snowballEdge list-certificates --endpoint https://snowball-ip --manifest-file path-to-manifest-file --unlock-code unlock-code
   {
     "Certificates" : [ {
       "CertificateArn" : "arn:aws:snowball-device:::certificate/xxx",
       "SubjectAlternativeNames" : [ "ID:JID-xxx" ]
     } ]
   }
               

2. Utilisez la valeur de CertificateArn comme valeur du --certificate-arn paramètre de la get-certificate commande.

   
   PATH_TO_Snowball_Edge_CLIENT/bin/snowballEdge get-certificate --certificate-arn ARN --endpoint https://snowball-ip --manifest-file path-to-manifest-file --unlock-code unlock-code            
             

3. Créez un fichier de certificat de terminal. Placez le résultat de get-certificate dans le fichier de certificat. Voici un exemple de la façon d'enregistrer la sortie.

   Note

   Si vous travaillez avec plusieurs appareils Snowball Edge, l'ordre des informations d'identification dans le fichier n'a pas d'importance, mais les informations d'identification de tous les appareils doivent figurer dans un seul fichier.

   
   -----BEGIN CERTIFICATE-----
   ZWtzYSBzbm93IHRlc3QgY2VydGlmaWNhdGUgZWtzYSBzbm93IHRlc3QgY2VydGlm  
   aWNhdGVla3NhIHNub3cgdGVzdCBjZXJ0aWZpY2F0ZWVrc2Egc25vdyB0ZXN0IGNl  
   cnRpZmljYXRlZWtzYSBzbm93IHRlc3QgY2VydGlmaWNhdGVla3NhIHNub3cgdGVz  
   dCBjZXJ0aWZpY2F0ZQMIIDXDCCAkSgAwIBAgIJAISM0nTVmbj+MA0GCSqGSIb3DQ  
   ...                                                               
   -----END CERTIFICATE----- 
               

4. Répétez Création d'un utilisateur local Amazon EKS Anywhere IAM l'opération pour créer un utilisateur local IAM pour Amazon EKS Anywhere sur tous les appareils Snowball Edge.

Créez une clé SSH et importez-la dans l'instance Amazon EKS Anywhere

1. Utilisez la ssh-keygen commande pour générer une clé SSH.

   
   ssh-keygen -t rsa -C "key-name" -f path-to-key-file
        

2. Utilisez la import-key-pair commande pour importer la clé de votre ordinateur vers le périphérique Snowball Edge.

   Note

   La valeur du key-name paramètre doit être identique lorsque vous importez la clé sur tous les appareils.

   
   aws ec2 import-key-pair --key-name key-name --public-key-material fileb:///path/to/key-file --endpoint http://snowball-ip:8008 --profile profile-name 
   {
       "KeyFingerprint": "5b:0c:fd:e1:a0:69:05:4c:aa:43:f3:3b:3e:04:7f:51",
       "KeyName": "default",
       "KeyPairId": "s.key-85edb5d820c92a6f8"
   }
        

Pour exécuter une instance d'administration Amazon EKS Anywhere

1. Utilisez la create-key-pair commande pour créer une clé SSH pour l'instance d'administration Amazon EKS Anywhere. La commande enregistre la clé dans$PWD/key-file-name.

   
   aws ec2 create-key-pair --key-name key-name --query 'KeyMaterial' --output text --endpoint http://snowball ip:8008 > key-file-name --profile profile-name

2. Utilisez la describe-images commande pour trouver le nom de l'image qui commence eks-anywhere-admin par le résultat.

   
   aws ec2 describe-images --endpoint http://snowball-ip:8008 --profile profile-name
         

3. Utilisez la run-instance commande pour démarrer une instance d'administration eks-a avec l'image d'administration Amazon EKS Anywhere.

   
   aws ec2 run-instances --image-id eks-a-admin-image-id --key-name key-name --instance-type sbe-c.xlarge --endpoint http://snowball-ip:8008 --profile profile-name
         

4. Utilisez la describe-instances commande pour vérifier l'état de l'instance Amazon EKS Anywhere. Attendez que la commande indique que l'état de l'instance est tel running qu'il est avant de continuer.

   
   aws ec2 describe-instances --instance-id instance-id --endpoint http://snowball-ip:8008 --profile profile-name
   

5. Dans le résultat de la describe-device commande, notez la valeur de PhysicalNetworkInterfaceId pour l'interface réseau physique connectée à votre réseau. Vous allez l'utiliser pour créer un VNI.

    
   PATH_TO_Snowball_Edge_CLIENT/bin/snowballEdge describe-device --endpoint https://snowball-ip --manifest-file path-to-manifest-file --unlock-code unlock-code
   

6. Créez un VNI pour l'instance d'administration Amazon EKS Anywhere. Utilisez la valeur de PhysicalNetworkInterfaceId comme valeur du physical-network-interface-id paramètre.

   
   PATH_TO_Snowball_Edge_CLIENT/bin/snowballEdge create-virtual-network-interface --ip-address-assignment dhcp --physical-network-interface-id PNI --endpoint https://snowball-ip --manifest-file path-to-manifest-file --unlock-code unlock-code
   

7. Utilisez la valeur de IpAddress comme valeur du public-ip paramètre de la associate-address commande pour associer l'adresse publique à l'instance d'administration Amazon EKS Anywhere.

   
   aws ec2 associate-address --instance-id instance-id --public-ip VNI-IP --endpoint http://snowball-ip:8008 --profile profile-name 
   

8. Connectez-vous à l'instance d'administration Amazon EKS Anywhere par SSH.

   
   ssh -i path-to-key ec2-user@VNI-IP