AWS에 관리자 설치
시작하기 전에 필수 조건이 있고 AWS 계정이 요구 사항을 충족하는지 확인합니다.
AI Unlimited 관리자는 엔진 배포를 조율하고 설정을 위한 웹 기반 사용자 인터페이스를 포함합니다.
Teradata에서 제공하는 CloudFormation 템플릿을 사용하여 AWS Management Console에서 관리자를 설치합니다. systemd로 제어되는 컨테이너에서 관리자가 실행되는 서버 인스턴스를 배포합니다.
저장소 복제
Teradata에서 제공하는 AI Unlimited GitHub 저장소의 배치 폴더에는 AI Unlimited를 설치하기 위한 템플릿, 매개변수 및 정책 파일이 포함되어 있습니다.
터미널 창을 열고 저장소를 복제합니다.
관리자 템플릿 찾기
관리자를 위한 CloudFormation 템플릿은 AI Unlimited GitHub 저장소에 있습니다.
deployments/aws/templates/ai-unlimited/
로드 밸런서를 사용할지 여부와 어떤 유형을 사용할지에 따라 템플릿을 선택합니다.
조직의 클라우드 관리자에게 지침을 요청할 수 있습니다.
- — ai-unlimited-with-alb.yaml다음 뒤의 관리자를 호스팅합니다. Application Load Balancer
- — ai-unlimited-with-nlb.yaml다음 뒤의 관리자를 호스팅합니다. Network Load Balancer
- ai-unlimited-without-lb.yaml—로드 밸런서가 없습니다. 어떤 템플릿을 사용해야 할지 확실하지 않으면 이 템플릿을 권장합니다.
템플릿을 로드합니다.
- AWS 콘솔에 로그인합니다.
노트AWS Management Console에 대한 참조는 2024년 5월 29일 기준으로 최신 상태입니다.
- AI Unlimited를 배포할 AWS 리전을 선택합니다.
주요 근무지와 가장 가까운 리전을 선택하는 것이 좋습니다. - 검색하여 CloudFormation으로 이동합니다.
- 스택 생성을 선택한 다음 **새로운 리소스 사용(표준)**을 선택합니다.
- 기존 템플릿 선택을 선택한 다음 템플릿 파일 업로드를 선택합니다.
- 사용할 템플릿 파일을 선택하고 다음을 클릭합니다.
스택 세부 정보 및 옵션 지정
- 스택 이름을 입력합니다.
- 매개변수를 검토합니다. 필수 매개변수에 대한 값을 제공합니다. 귀하의 조직에는 다른 매개변수가 필요할 수 있습니다.
AWS 및 관리자 매개변수
각 템플릿의 매개변수는 다양합니다. 콘솔에서 볼 수 없는 매개변수가 여기에 표시될 수 있습니다.
| 매개변수 | 설명 | 노트 |
|---|---|---|
| Stack name | 스택 목록에서 AI Unlimited 스택을 찾는 데 도움이 되는 식별자입니다. | 필수 사항 기본값: NA 이름에는 영숫자 문자(대소문자 구분)와 하이픈만 포함될 수 있습니다. 알파벳 문자로 시작해야 하며 128자를 넘을 수 없습니다. |
| AiUnlimitedName | AI Unlimited 인스턴스의 이름입니다. | 필수 사항(기본값 제공) 기본값: ai-unlimited 이름에는 영숫자 문자(대소문자 구분)와 하이픈만 포함될 수 있습니다. 알파벳 문자로 시작해야 하며 20자를 넘을 수 없습니다. |
| InstanceType | 관리자의 EC2 인스턴스 유형입니다. | 필수 사항(기본값 제공) 기본값: t3.micro 중요: 인스턴스 크기가 적절하지 않으면 엔진 배포 및 일시 중단이 실패할 수 있으며 더 큰 인스턴스에 관리자를 다시 설치해야 합니다. 매개변수 섹션 아래의 자세히 알아보기: 관리자 인스턴스 유형(크기) 권장 사항을 참조하십시오. |
| RootVolumeSize | 인스턴스에 연결하려는 루트 디스크의 크기(GB)입니다. | 필수 사항(기본값 제공) 기본값: 20 8~1000 사이의 값을 지원합니다. |
| TerminationProtection | 인스턴스 종료 보호를 활성화합니다. | 필수 사항(기본값 제공) 기본값: false |
| IamRole | CloudFormation에서 새로운 IAM 역할을 만들어야 하는지 아니면 기존 역할을 사용해야 하는지 지정합니다. | 필수 사항(기본값 제공) 기본값: 신규 지원되는 옵션은 다음과 같습니다. 신규 또는 기존 |
| IamRoleName | 인스턴스에 할당할 IAM 역할의 이름으로, 기존 IAM 역할이거나 새로 만든 역할일 수 있습니다. | 선택 사항(기본값 제공) 기본값: ai-unlimited-iam-role 새 IAM 역할의 이름을 지정하는 경우 CloudFormation에 CAPABILITY_NAMED_IAM 기능이 필요합니다. 자동 생성된 이름을 사용하려면 이 값을 비워 둡니다. |
| IamPermissionsBoundary | 인스턴스에 할당된 IAM 역할과 연결할 IAM 권한 경계의 ARN입니다. | 선택 사항 기본값: NA |
| AvailabilityZone | 인스턴스를 배포할 가용성 영역입니다. | 필수 사항 기본값: NA 값은 서브넷, 기존 볼륨의 영역과 일치해야 하며 인스턴스 유형은 선택한 영역에서 사용할 수 있어야 합니다. |
| LoadBalancerScheme | 로드 밸런서를 사용하는 경우 이 필드는 인스턴스에 인터넷에서 액세스할 수 있는지 아니면 VPC 내에서만 액세스할 수 있는지 여부를 지정합니다. | 선택 사항(기본값 제공) 기본값: Internet-facing Internet-facing 로드 밸런서의 DNS 이름은 노드의 공용 IP 주소로 공개적으로 확인 가능합니다. 따라서 Internet-facing 로드 밸런서는 인터넷을 통해 클라이언트의 요청을 라우팅할 수 있습니다. 내부 로드 밸런서의 노드에는 개인 IP 주소만 있습니다. 내부 로드 밸런서의 DNS 이름은 노드의 개인 IP 주소로 공개적으로 확인 가능합니다. 따라서 내부 로드 밸런서는 로드 밸런서의 VPC에 액세스할 수 있는 클라이언트의 요청을 라우팅할 수 있습니다. |
| LoadBalancerSubnetOne | 로드 밸런서가 호스팅되는 서브넷. 서브넷은 로드 밸런서 가용성 영역, IP 주소 및 엔드포인트를 결정합니다. | 선택 사항(기본값 제공) 기본값: NA NLB(Network Load Balancer)를 생성하려면 최소한 하나의 사용 가능한 서브넷을 정의해야 하며 ALB(Application Load Balancer)의 경우 두 개의 서브넷을 정의해야 합니다. |
| LoadBalancerSubnetTwo | 로드 밸런서가 호스팅되는 서브넷입니다. | 선택 사항. 이 옵션은 ALB가 있는 템플릿에서만 사용할 수 있습니다. 기본값: NA |
| HostedZoneID | 호스팅 영역을 생성할 때 Amazon Route 53이 해당 호스팅 영역에 할당한 ID입니다. | 선택 사항 기본값: NA 각 호스팅 영역은 도메인 이름 또는 하위 도메인에 해당합니다. 호스팅 영역은 DNS 레코드의 컨테이너로, 레코드가 있는 IP 주소로 가리키는 것과 같이 도메인과 상호 작용하는 방식을 구성할 수 있습니다. AWS 콘솔에서 Route 53 > 호스팅 영역으로 이동합니다. 등록된 도메인 이름과 해당 호스팅 영역 ID를 찾습니다. |
| DnsName | 도메인 이름입니다. 공용 호스팅 영역의 경우, 이는 DNS 등록 기관에 등록한 이름입니다. | 선택 사항 기본값: NA a-z, 0-9 및 -(하이픈) 이외의 문자를 지정하는 방법과 국제화된 도메인 이름을 지정하는 방법에 대한 자세한 내용은 호스팅 영역 만들기를 참조하십시오. |
| Private | 서비스가 공용 IP가 없는 개인 네트워크에 배포되는지 여부를 지정합니다. | 필수 사항 기본값: false 관리자가 있는 서브넷에서 공용 IPv4 주소 자동 할당 활성화 옵션을 선택했는지 확인합니다. 이 옵션을 선택하지 않으면 설치가 실패할 수 있습니다. |
| Session | AWS Session Manager를 사용하여 인스턴스에 액세스할 수 있는지 여부를 지정합니다. | 필수 사항 기본값: false |
| Vpc | 인스턴스를 배포할 네트워크입니다. | 필수 사항 기본값: NA |
| Subnet | 인스턴스를 배포하려는 하위 네트워크입니다. | 필수 사항 기본값: NA 서브넷은 선택한 가용성 영역에 있어야 합니다. |
| KeyName | 인스턴스가 시작된 후 인스턴스에 안전하게 연결할 수 있는 공용/개인 키 쌍입니다. AWS 계정을 만들 때 선호하는 리전에서 만드는 키 쌍입니다. | 선택 사항 기본값: NA SSH 키를 포함하지 않으려면 이 필드를 비워둡니다. |
| AccessCIDR | 인스턴스에 액세스할 수 있는 CIDR IP 주소 범위입니다. | 선택 사항 기본값: NA 이 값을 신뢰할 수 있는 IP 범위로 설정하는 것이 좋습니다. 사용자 지정 보안 그룹 수신 규칙을 만들지 않는 한 AccessCIDR, PrefixList 또는 SecurityGroup 중 하나 이상을 정의하여 인바운드 트래픽을 허용합니다. |
| PrefixList | 인스턴스와 통신하는 데 사용할 수 있는 접두사 목록입니다. 동일한 정책 시행이 필요한 IP 주소 범위 세트를 정의하는 CIDR 블록의 컬렉션입니다. | 선택 사항 기본값: NA 사용자 지정 보안 그룹 수신 규칙을 만들지 않는 한 인바운드 트래픽을 허용하려면 AccessCIDR, PrefixList 또는 SecurityGroup 중 하나 이상을 정의합니다. ID가 아닌 접두사 목록 이름을 입력해야 합니다. |
| SecurityGroup | 인스턴스에 대한 인바운드 및 아웃바운드 트래픽을 제어하는 가상 방화벽입니다. | 선택 사항 기본값: NA 인스턴스에 액세스할 수 있는 프로토콜, 포트 및 IP 주소 또는 CIDR 블록을 지정하는 규칙 세트로 구현됩니다. 사용자 지정 보안 그룹 수신 규칙을 만들지 않는 한 AccessCIDR, PrefixList 또는 SecurityGroup 중 하나 이상을 정의하여 인바운드 트래픽을 허용합니다. |
| AIUnlimitedHttpPort | AI Unlimited UI에 액세스하는 포트입니다. | 필수 사항(기본값 제공) 기본값: 3000 |
| AIUnlimitedGrpcPort | AI Unlimited API에 액세스하는 포트입니다. | 필수 사항(기본값 제공) 기본값: 3282 |
| AIUnlimitedVersion | 배포하려는 AI Unlimited 버전입니다. | 필수 사항(기본값 제공) 기본값: 최신 값은 컨테이너 버전 태그입니다. |
| UsePersistentVolume | 데이터를 저장하기 위해 새 영구 볼륨을 사용할지 기존 영구 볼륨을 사용할지 지정합니다. 매개변수 섹션 아래의 자세히 알아보기: 영구 볼륨 사용을 참조하십시오. | 선택 사항(기본값 제공) 기본값: 신규 지원되는 옵션은 사용 사례에 따라 새 영구 볼륨 또는 기존 영구 볼륨입니다. |
| PersistentVolumeSize | 인스턴스에 연결하는 영구 볼륨의 크기(GB)입니다. | 필수 사항(기본값 제공) 기 본값: 20 8~1000 사이의 값을 지원합니다. |
| ExistingPersistentVolumeId | 인스턴스에 연결하는 기존 영구 볼륨의 ID입니다. | UsePersistentVolume이 기존으로 설정된 경우 필수 사항. 기본값: NA 영구 볼륨은 AI Unlimited 인스턴스와 동일한 가용성 영역에 있어야 합니다. |
| PersistentVolume DeletionPolicy | CloudFormation 배포를 삭제할 때의 영구 볼륨 동작입니다. | 필수 사항(기본값 제공) |
| LatestAmiId | AMI의 최신 버전을 가리키는 이미지의 ID입니다. 이 값은 SSM 조회에 사용됩니다. | 필수 사항(기본값 제공) 기본값: NA 이 배포에서는 사용 가능한 최신 ami-amazon-linux-latest/amzn2-ami-hvm-x86_64-gp2 이미지를 사용합니다. 중요: 이 값을 변경하면 스택이 손상될 수 있습니다. |
자세히 알아보기: 관리자 인스턴스 유형(크기) 권장 사항
AI Unlimited 유료 공용 미리보기의 경우, 동시 엔진 배포 및 일시 중단 작업의 양을 기준으로 이러한 t3 인스턴스 유형을 권장합니다. 다른 사용 가능한 인스턴스 유형의 성능은 다를 수 있습니다.
| 인스턴스 유형 | 동시 작업 |
|---|---|
| t3.micro | 1 |
| t3.small | 최대 5개 |
| t3.medium | 최대 10개 |
| t3.large | 최대 20개 |
| t3.xlarge | 21개 이상 |
AI Unlimited가 일반에 출시되면 동시성이 높아질 것입니다.
자세히 알아보기: 영구 볼륨 사용
관리자 인스턴스는 컨테이너에서 실행되고 인스턴스의 루트 볼륨에 있는 데이터베이스에 구성 데이터를 저장합니다. 인스턴스를 종료, 다시 시작 또는 스냅샷하고 다시 시작해도 이 데이터가 유지됩니다.
영구 볼륨은 컨테이너화된 애플리케이션의 데이터를 해당 애플리케이션이 실행되는 컨테이너, 포드 또는 노드의 수명을 넘어 저장합니다.
영구 볼륨 없음
컨테이너, 포드 또는 노드가 충돌하거나 종료되면 관리자의 구성 데이터를 잃게 됩니다. 새로운 관리자 인스턴스를 배포할 수 있지만 손실된 인스턴스와 동일한 상태로는 배포할 수 없습니다.
영구 볼륨 사용
컨테이너, 포드 또는 노드가 충돌하거나 종료되고 관리자의 구성 데이터가 영구 볼륨에 저장된 경우 손실된 관리자 인스턴스와 동일한 구성을 갖는 새 관리자 인스턴스를 배포할 수 있습니다.
예
- 관리자를 배포하고 다음 매개변수를 포함합니다.
UsePersistentVolume: 신규PersistentVolumeDeletionPolicy: 유지
- 스택을 생성한 후 출력 탭에서
volume-id를 기록해 둡니다. - AI Unlimited를 사용합니다.
- 관리자 인스턴스가 손실된 경우 관리자를 다시 배포하고 다음 매개변수를 포함합니다.
UsePersistentVolume: 신규PersistentVolumeDeletionPolicy: 유지ExistingPersistentVolumeId: 2단계에서 기록한 값
새로운 관리자 인스턴스는 손실된 관리자 인스턴스와 동일한 구성을 갖습 니다.
- 다음을 선택합니다.
- 요구 사항에 따라 스택 옵션을 구성한 후, 다음을 선택합니다.
스택을 검토하고 생성합니다.
- 템플릿 설정을 검토합니다.
- 템플릿이 IAM 리소스를 생성할 것임을 확인하려면 확인란을 선택합니다.
- 스택을 배포하려면 제출을 선택합니다.
이벤트 탭에서 진행 상황을 모니터링할 수 있습니다. 모든 리소스의 상태가CREATE_COMPLETE이면 관리자가 준비된 것입니다.
출력 탭은 생성된 리소스에 대해 생성된 값을 보여줍니다.
관리자에 액세스하고 AI Unlimited를 설정하려면 URL이 필요합니다.
다음 항목
OAuth 앱 생성하여 AI Unlimited와 Git 공급자 계정 간 인증을 허용합니다.