Snowball Edge デバイスで Amazon EKS Anywhere を設定して実行する

初期セットアップを実行する

1. Snowball Edge クライアントのダウンロードとインストール 詳細については、「Snowball Edge クライアントのダウンロードとインストール」を参照してください。

2. デバイスをローカルネットワークに接続します。詳細については、「Snowball Edge をローカルネットワークに接続する」を参照してください。

3. 認証情報を取得して、デバイスのロックを解除します。詳細については、「Snowball Edge にアクセスするための認証情報の取得」を参照してください。

4. デバイスのロックを解除します。詳細については、「Snowball Edge のロック解除」を参照してください。デバイスを手動でロック解除する代わりにスクリプトツールを使用することもできます。「Unlock devices」を参照してください。

ポリシードキュメントを作成して Amazon EKS Anywhere ローカルユーザーにアタッチするには

1. ポリシードキュメントを作成してコンピュータに保存します。以下のポリシーをドキュメントにコピーします。

   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. 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 つのファイルに含める必要があります。

証明書ファイルを作成するには

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 デバイスを使用している場合、ファイル内の認証情報の順序は関係ありませんが、すべてのデバイスの認証情報を 1 つのファイルに含める必要があります。

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

4. 「Amazon EKS Anywhere IAM ローカルユーザーを作成する」の手順を繰り返して、すべての Snowball Edge デバイスで 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. Amazon EKS Anywhere インスタンスのステータスを確認するには、describe-instances コマンドを使用します。コマンドが 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. Amazon EKS Anywhere の管理インスタンスに SSH で接続します。

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