Configuración y ejecución de Amazon EKS Anywhere en dispositivos Snowball Edge

Realización de la configuración inicial

1. Descargue e instale el cliente de Snowball Edge. Para obtener más información, consulte Descarga e instalación del cliente de Snowball Edge.

2. Conecte el dispositivo a la red local. Para obtener más información, consulte Conexión de un Snowball Edge a la red local.

3. Obtenga las credenciales para desbloquear el dispositivo. Para obtener más información, consulte Obtener credenciales para acceder a Snowball Edge.

4. Desbloquee el dispositivo. Para obtener más información, consulte Desbloqueo del dispositivo Snowball Edge. También puede usar una herramienta de script en lugar de desbloquear los dispositivos manualmente. Consulte Desbloqueo de dispositivos.

Cómo crear un documento de política y asociarlo al usuario local de Amazon EKS Anywhere

1. Cree un documento de política y guárdelo en su equipo. Copie al documento la política que se muestra a continuación.

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

2. Utilice el comando create-policy para crear una política de IAM basada en el documento de política. El valor del parámetro --policy-document debe usar la ruta absoluta al archivo de política. Por ejemplo, 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. Utilice el comando attach-user-policy para asociar la política de IAM al usuario local de 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. Utilice el comando create-access-key para crear una clave de acceso para el usuario local de 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. Cree un archivo de credenciales. Guarde en él los valores de AccessKeyId y SecretAccessKey en el siguiente formato.

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

   nota

   Si está trabajando con varios dispositivos Snowball Edge, el orden de las credenciales en el archivo no importa, pero las credenciales de todos los dispositivos deben estar en un solo archivo.

Creación de un archivo de certificados

1. Utilice el comando list-certificates para obtener certificados para cada dispositivo Snowball Edge que vaya a utilizar.

   
   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. Utilice el valor de CertificateArn como valor para el parámetro --certificate-arn del comando get-certificate.

   
   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. Cree un archivo de certificados de los dispositivos. Coloque el resultado de get-certificate en el archivo de certificados. A continuación se muestra un ejemplo de cómo guardar la salida.

   nota

   Si está trabajando con varios dispositivos Snowball Edge, el orden de las credenciales en el archivo no importa, pero las credenciales de todos los dispositivos deben estar en un solo archivo.

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

4. Repita el procedimiento Creación de un usuario local de IAM para Amazon EKS Anywhere para crear un usuario local de IAM para Amazon EKS Anywhere en todos los dispositivos Snowball Edge.

Creación de una clave SSH e importación a la instancia Amazon EKS Anywhere

1. Utilice el comando ssh-keygen para generar una clave SSH.

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

2. Utilice el comando import-key-pair para importar la clave del equipo al dispositivo Snowball Edge.

   nota

   El valor del parámetro key-name debe ser el mismo al importar la clave a todos los dispositivos.

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

Ejecución de una instancia de administración de Amazon EKS Anywhere

1. Utilice el comando create-key-pair para crear una clave SSH para la instancia de administración de Amazon EKS Anywhere. El comando guarda la clave en $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. Utilice el comando describe-images para buscar en la salida el nombre de la imagen que comienza por eks-anywhere-admin.

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

3. Utilice el comando run-instance para iniciar una instancia eks-a admin con la imagen de administración de 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. Utilice el comando describe-instances para comprobar el estado de la instancia de Amazon EKS Anywhere. Espere hasta que el comando indique que el estado de la instancia es running antes de continuar.

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

5. Examine la salida del comando describe-device y anote el valor de PhysicalNetworkInterfaceId de la interfaz de red física que está conectada a la red. Lo utilizará para crear una 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. Cree una VNI para la instancia de administración de Amazon EKS Anywhere. Utilice el valor de PhysicalNetworkInterfaceId como valor del parámetro physical-network-interface-id.

   
   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. Utilice el valor de IpAddress como valor del parámetro public-ip del comando associate-address para asociar la dirección pública a la instancia de administración de Amazon EKS Anywhere.

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

8. Conéctese a la instancia de administración de Amazon EKS Anywhere mediante SSH.

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