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 명령을 사용하여 Amazon EKS Anywhere 로컬 사용자에게 IAM 정책을 연결합니다.

   
   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