在 Snowball Edge 裝置上設定和執行 Amazon EKS Anywhere

執行初始設定

1. 下載並安裝 Snowball Edge 用戶端。如需詳細資訊，請參閱下載並安裝 Snowball Edge 用戶端。

2. 將裝置連接到您的本機網路。如需詳細資訊，請參閱將 Snowball Edge 連接到您的本機網路。

3. 取得登入資料以解除鎖定您的裝置。如需詳細資訊，請參閱取得登入資料以存取 Snowball Edge。

4. 解鎖裝置。如需詳細資訊，請參閱解鎖 Snowball Edge。您也可以使用指令碼工具，而不是手動解鎖裝置。請參閱解鎖裝置。

建立政策文件並將其連接至 Amazon EKS Anywhere 本機使用者

1. 建立政策文件並將其儲存至您的電腦。將以下政策複製到 文件。

   
   {
     "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. 使用 create-policy命令，根據政策文件建立 IAM 政策。--policy-document 參數的值應使用政策檔案的絕對路徑。例如 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. 使用 attach-user-policy命令將 IAM 政策連接至 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. 使用 create-access-key命令為 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. 建立登入資料檔案。在其中，以下列格式儲存 AccessKeyId和 SecretAccessKey值。

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

   注意

   如果您使用的是多個 Snowball Edge 裝置，檔案中的登入資料順序並不重要，但所有裝置的登入資料都必須在一個檔案中。

建立憑證檔案

1. 使用 list-certificates命令來取得您計劃使用的每個 Snowball Edge 裝置的憑證。

   
   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. 使用 的值CertificateArn做為 get-certificate命令--certificate-arn參數的值。

   
   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. 建立裝置憑證檔案。將 的輸出get-certificate放入憑證檔案中。以下是如何儲存輸出的範例。

   注意

   如果您使用的是多個 Snowball Edge 裝置，檔案中的登入資料順序並不重要，但所有裝置的登入資料都必須在一個檔案中。

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

4. 在所有 Snowball Edge 裝置上建立 Amazon EKS Anywhere IAM 本機使用者重複為 Amazon EKS Anywhere 建立 IAM 本機使用者。

建立 SSH 金鑰並將其匯入 Amazon EKS Anywhere 執行個體

1. 使用 ssh-keygen命令來產生 SSH 金鑰。

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

2. 使用 import-key-pair命令將金鑰從您的電腦匯入 Snowball Edge 裝置。

   注意

   當您將金鑰匯入所有裝置時， key-name 參數的值必須相同。

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

執行 Amazon EKS Anywhere 管理執行個體

1. 使用 create-key-pair命令為 Amazon EKS Anywhere 管理執行個體建立 SSH 金鑰。命令會將金鑰儲存至 $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. 使用 describe-images命令從輸出尋找開頭為 eks-anywhere-admin的映像名稱。

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

3. 使用 run-instance命令啟動具有 Amazon EKS Anywhere 管理映像的 eks-a 管理執行個體。

   
   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. 使用 describe-instances命令來檢查 Amazon EKS Anywhere 執行個體的狀態。等待命令指出執行個體狀態為 running，再繼續。

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

5. 從 describe-device命令的輸出中，記下連線至您網路PhysicalNetworkInterfaceId之實體網路界面的 值。您將使用此項目來建立 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. 為 Amazon EKS Anywhere 管理執行個體建立 VNI。使用 的值PhysicalNetworkInterfaceId做為 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. 使用 的值IpAddress做為 associate-address命令的 public-ip 參數值，將公有地址與 Amazon EKS Anywhere 管理執行個體建立關聯。

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

8. 透過 SSH 連線至 Amazon EKS Anywhere 管理員執行個體。

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