기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # Amazon Bedrock 에이전트를 사용하여 텍스트 기반 프롬프트를 통해 Amazon EKS에서 액세스 항목 제어 생성 자동화 *Keshav Ganesh 및 Sudhanshu Saurav, Amazon Web Services* ## 요약 조직은 여러 팀이 공유 Amazon Elastic Kubernetes Service(Amazon EKS) 클러스터로 작업해야 하는 경우 액세스 제어 및 리소스 프로비저닝을 관리하는 데 어려움을 겪습니다. Amazon EKS와 같은 관리형 Kubernetes 서비스는 클러스터 작업을 간소화했습니다. 그러나 팀 액세스 및 리소스 권한 관리의 관리 오버헤드는 복잡하고 시간이 많이 걸립니다. 이 패턴은 Amazon Bedrock 에이전트가 Amazon EKS 클러스터 액세스 관리를 자동화하는 데 어떻게 도움이 되는지 보여줍니다. 이 자동화를 통해 개발 팀은 액세스 제어 설정 및 관리를 처리하는 대신 핵심 애플리케이션 개발에 집중할 수 있습니다. 간단한 자연어 프롬프트를 통해 다양한 작업에 대한 작업을 수행하도록 Amazon Bedrock 에이전트를 사용자 지정할 수 있습니다. Amazon Bedrock 에이전트는 AWS Lambda 함수를 작업 그룹으로 사용하여 사용자 액세스 항목 생성 및 액세스 정책 관리와 같은 작업을 처리할 수 있습니다. 또한 Amazon Bedrock 에이전트는 클러스터에서 실행되는 포드의 AWS Identity and Access Management (IAM) 리소스에 대한 액세스를 허용하는 포드 자격 증명 연결을 구성할 수 있습니다. 이 솔루션을 사용하면 조직은 간단한 텍스트 기반 프롬프트로 Amazon EKS 클러스터 관리를 간소화하고, 수동 오버헤드를 줄이고, 전반적인 개발 효율성을 개선할 수 있습니다. ## 사전 조건 및 제한 사항 **사전 조건 ** + 활성. AWS 계정 + 배포 프로세스에 대해 설정된 IAM [역할 및 권한](https://docs.aws.amazon.com/bedrock/latest/userguide/security_iam_id-based-policy-examples.html)입니다. 여기에는 Amazon Bedrock 파운데이션 모델(FM)에 액세스하고 Lambda 함수 및 대상 전반의 기타 필수 리소스를 생성할 수 있는 권한이 포함됩니다 AWS 계정. + 에서 Amazon Bedrock FMs AWS 계정 에 대해 [활성화된 액세스](https://docs.aws.amazon.com/bedrock/latest/userguide/model-access.html): Amazon Titan Text Embeddings V2 및 Anthropic Claude 3 Haiku. + AWS Command Line Interface (AWS CLI) 버전 2.9.11 이상, [설치](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html) 및 [구성](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html)됨. + eksctl 0.194.0 이상, [설치](https://eksctl.io/installation/)됨. **제한 사항 ** + 이러한 기술을 원활하게 채택하고 효과적으로 사용하는 데 도움이 되도록 교육 및 설명서가 필요할 수 있습니다. Amazon Bedrock, Amazon EKS, Lambda, Amazon OpenSearch Service 및 [OpenAPI](https://www.openapis.org/what-is-openapi)를 사용할 때는 개발자와 DevOps 팀에 상당한 학습 곡선이 필요합니다. + 일부 AWS 서비스 는 전혀 사용할 수 없습니다 AWS 리전. 리전별 가용성은 [리전별 AWS 서비스](https://aws.amazon.com/about-aws/global-infrastructure/regional-product-services/)를 참조하세요. 구체적인 엔드포인트는 [서비스 엔드포인트 및 할당량](https://docs.aws.amazon.com/general/latest/gr/aws-service-information.html)을 참조하고 서비스 링크를 선택합니다. ## 아키텍처 다음 다이어그램은 이 패턴의 워크플로 및 구성 요소를 보여 줍니다. ![\[Amazon Bedrock 에이전트를 사용하여 Amazon EKS에서 액세스 제어를 생성하는 워크플로 및 구성 요소입니다.\]](http://docs.aws.amazon.com/ko_kr/prescriptive-guidance/latest/patterns/images/pattern-img/2c52b1ba-bbad-4a46-ab1e-10e69a0a66e7/images/c7981a86-f734-4c07-a2f7-63ad38b66ab6.png) 해결 방법: 다음 단계를 수행합니다. 1. 사용자는 에이전트가 처리하고 조치를 취할 수 있도록 입력 역할을 하는 프롬프트 또는 쿼리를 제출하여 Amazon Bedrock 에이전트와 상호 작용합니다. 1. 프롬프트를 기반으로 Amazon Bedrock 에이전트는 OpenAPI 스키마를 확인하여 대상으로 지정할 올바른 API를 식별합니다. Amazon Bedrock 에이전트가 올바른 API 직접 호출을 찾으면 요청은 이러한 작업을 구현하는 Lambda 함수와 연결된 작업 그룹으로 이동합니다. 1. 관련 API를 찾을 수 없는 경우 Amazon Bedrock 에이전트는 OpenSearch 컬렉션을 쿼리합니다. OpenSearch 컬렉션은 Amazon EKS 사용 설명서가 포함된 Amazon S3 버킷에서 가져온 인덱싱된 지식 기반 콘텐츠를 사용합니다. ** 1. OpenSearch 컬렉션은 Amazon Bedrock 에이전트에 관련 컨텍스트 정보를 반환합니다. 1. 실행 가능한 요청(API 작업과 일치하는 요청)의 경우 Amazon Bedrock 에이전트는 Virtual Private Cloud(VPC) 내에서 실행되고 Lambda 함수를 트리거합니다. 1. Lambda 함수는 Amazon EKS 클러스터 내에서 사용자의 입력을 기반으로 하는 작업을 수행합니다. 1. Lambda 코드용 Amazon S3 버킷은 Lambda 함수에 대해 작성된 코드와 로직이 있는 아티팩트를 저장합니다. ## 도구 **AWS 서비스** + Amazon Bedrock은 선도적인 AI 스타트업과 Amazon의 고성능 파운데이션 모델(FM)을 통합 API를 통해 사용할 수 있게 해주는 완전 관리형 서비스입니다. + [AWS CloudFormation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html)를 사용하면 AWS 리소스를 설정하고, 빠르고 일관되게 프로비저닝하고, AWS 계정 및의 수명 주기 동안 리소스를 관리할 수 있습니다 AWS 리전. + [Amazon Elastic Kubernetes Service(Amazon EKS)](https://docs.aws.amazon.com/eks/latest/userguide/getting-started.html)를 사용하면 자체 Kubernetes 컨트롤 플레인 또는 노드를 설치하거나 유지 관리할 필요 AWS 없이에서 Kubernetes를 실행할 수 있습니다. + [AWS Identity and Access Management (IAM)](https://docs.aws.amazon.com/IAM/latest/UserGuide/introduction.html)는 AWS 리소스에 대한 액세스를 인증하고 사용할 수 있는 권한을 부여받은 사용자를 제어하여 리소스에 대한 액세스를 안전하게 관리하는 데 도움이 됩니다. + [AWS Lambda](https://docs.aws.amazon.com/lambda/latest/dg/welcome.html)는 서버를 프로비저닝하거나 관리할 필요 없이 코드를 실행하는 데 도움이 되는 컴퓨팅 서비스입니다. 필요할 때만 코드를 실행하며 자동으로 확장이 가능하므로 사용한 컴퓨팅 시간만큼만 비용을 지불합니다. + Amazon OpenSearch Service는 클라우드에서 OpenSearch 클러스터를 손쉽게 배포, 운영 및 확장할 수 있도록 해주는 관리형 서비스입니다. 컬렉션 기능을 사용하면 데이터를 구성하고 Amazon Bedrock 에이전트와 같은 AI 어시스턴트가 사용할 수 있는 포괄적인 지식 기반을 구축할 수 있습니다. + [Amazon Simple Storage Service(S3)](https://docs.aws.amazon.com/AmazonS3/latest/userguide/Welcome.html)는 원하는 양의 데이터를 저장, 보호 및 검색하는 데 도움이 되는 클라우드 기반 객체 스토리지 서비스입니다. **기타 도구** + [eksctl](https://docs.aws.amazon.com/eks/latest/userguide/getting-started-eksctl.html)은 Amazon EKS에서 Kubernetes 클러스터를 생성하고 관리하기 위한 명령줄 유틸리티입니다. **코드 리포지토리** 이 패턴의 코드는 GitHub [eks-access-controls-bedrock-agent](https://github.com/aws-samples/eks-access-controls-bedrock-agent.git) 리포지토리에서 사용할 수 있습니다. ## 모범 사례 + 이 패턴을 구현할 때 최대한 보안을 유지합니다. Amazon EKS 클러스터가 프라이빗이고, 액세스 권한이 제한되어 있으며, 모든 리소스가 Virtual Private Cloud(VPC) 내에 있는지 확인합니다. 자세한 내용은 IAM 설명서의 [보안 모범 사례](https://docs.aws.amazon.com/eks/latest/best-practices/security.html)를 참조하세요. + 가능하면 AWS KMS [고객 관리형 키를](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html) 사용하고 제한된 액세스 권한을 부여합니다. + 최소 권한 원칙을 따르고 작업을 수행하는 데 필요한 최소 권한을 부여하세요. 자세한 내용은 IAM 설명서의 [최소 권한 부여](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html#grant-least-priv) 및 [보안 모범 사례](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html)를 참조하세요. ## 에픽 ### 환경 설정 | 작업 | 설명 | 필요한 기술 | | --- | --- | --- | | 리포지토리를 복제합니다. | 이 패턴의 리포지토리를 복제하려면 로컬 워크스테이션에서 다음 명령을 실행합니다.
git clone https://github.com/aws-samples/eks-access-controls-bedrock-agent.git
| DevOps | | AWS 계정 ID를 가져옵니다. | AWS 계정 ID를 가져오려면 다음 단계를 사용합니다.[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/prescriptive-guidance/latest/patterns/using-amazon-bedrock-agents-to-automate-creation-of-access-entry-controls-in-amazon-eks.html)이 명령은 AWS 계정 ID를 `AWS_ACCOUNT` 변수에 저장합니다. | DevOps | | Lambda 코드용 S3 버킷을 생성합니다. | 이 솔루션을 구현하려면 [아키텍처](#using-amazon-bedrock-agents-to-automate-creation-of-access-entry-controls-in-amazon-eks-architecture) 다이어그램과 같이 서로 다른 용도로 사용되는 Amazon S3 버킷 3개를 생성해야 합니다. S3 버킷은 Lambda 코드, 지식 기반 및 OpenAPI 스키마용입니다.Lambda 코드 버킷을 생성하려면 다음 단계를 사용합니다.[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/prescriptive-guidance/latest/patterns/using-amazon-bedrock-agents-to-automate-creation-of-access-entry-controls-in-amazon-eks.html)패키지 명령은 다음을 포함하는 새 CloudFormation 템플릿(`eks-access-controls-template.yaml`)을 생성합니다.[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/prescriptive-guidance/latest/patterns/using-amazon-bedrock-agents-to-automate-creation-of-access-entry-controls-in-amazon-eks.html) | DevOps | | 지식 기반용 S3 버킷을 생성합니다. | 지식 기반용 Amazon S3 버킷을 생성하려면 다음 단계를 사용합니다.[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/prescriptive-guidance/latest/patterns/using-amazon-bedrock-agents-to-automate-creation-of-access-entry-controls-in-amazon-eks.html) | DevOps | | OpenAPI 스키마에 대한 S3 버킷을 생성합니다. | OpenAPI 스키마에 대한 Amazon S3 버킷을 생성하려면 다음 단계를 사용합니다.[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/prescriptive-guidance/latest/patterns/using-amazon-bedrock-agents-to-automate-creation-of-access-entry-controls-in-amazon-eks.html) | DevOps | ### CloudFormation 스택 배포 | 작업 | 설명 | 필요한 기술 | | --- | --- | --- | | CloudFormation 스택 배포 | CloudFormation 스택을 배포하려면 이전에 `eks-access-controls-template.yaml` 생성한 CloudFormation 템플릿 파일을 사용합니다. 자세한 지침은 [ CloudFormation 설명서의 CloudFormation 콘솔에서 스택 생성을](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-console-create-stack.html) 참조하세요. CloudFormation CloudFormation 템플릿을 사용하여 OpenSearch 인덱스를 프로비저닝하는 데 약 10분이 걸립니다.OAC를 생성한 후 `VPC_ID`Name`PRIVATE_SUBNET ID`(이름)을 기록해 둡니다. | DevOps | | Amazon EKS 클러스터를 생성합니다. | VPC 내에 Amazon EKS 클러스터를 생성하려면 다음 단계를 사용합니다.[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/prescriptive-guidance/latest/patterns/using-amazon-bedrock-agents-to-automate-creation-of-access-entry-controls-in-amazon-eks.html)결과는 다음과 같습니다.[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/prescriptive-guidance/latest/patterns/using-amazon-bedrock-agents-to-automate-creation-of-access-entry-controls-in-amazon-eks.html) | DevOps | ### Lambda 함수와 Amazon EKS 클러스터 연결 | 작업 | 설명 | 필요한 기술 | | --- | --- | --- | | Amazon EKS 클러스터와 Lambda 함수 간에 연결을 생성합니다. | Lambda 함수가 Amazon EKS 클러스터와 통신할 수 있도록 네트워크 및 IAM 권한을 설정하려면 다음 단계를 사용합니다.[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/prescriptive-guidance/latest/patterns/using-amazon-bedrock-agents-to-automate-creation-of-access-entry-controls-in-amazon-eks.html) | DevOps | ### 솔루션 테스트 | 작업 | 설명 | 필요한 기술 | | --- | --- | --- | | Amazon Bedrock 설정 테스트 | Amazon Bedrock 에이전트를 테스트하기 전에 다음을 수행해야 합니다.[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/prescriptive-guidance/latest/patterns/using-amazon-bedrock-agents-to-automate-creation-of-access-entry-controls-in-amazon-eks.html)Amazon Bedrock 에이전트에 액세스하려면 다음 단계를 사용합니다.[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/prescriptive-guidance/latest/patterns/using-amazon-bedrock-agents-to-automate-creation-of-access-entry-controls-in-amazon-eks.html)[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/prescriptive-guidance/latest/patterns/using-amazon-bedrock-agents-to-automate-creation-of-access-entry-controls-in-amazon-eks.html)에이전트에게 EKS Pod Identity 연결에 대한 작업을 수행하도록 요청할 수도 있습니다. 자세한 내용은 Amazon [EKS 설명서의 EKS Pod Identity가 포드에 액세스 권한을 부여하는 방법 알아보기 AWS 서비스](https://docs.aws.amazon.com/eks/latest/userguide/pod-identities.html)를 참조하세요. | DevOps | ### 정리 | 작업 | 설명 | 필요한 기술 | | --- | --- | --- | | 리소스를 정리하십시오. | 이 패턴으로 생성된 리소스를 정리하려면 다음 명령을 실행합니다. 다음 단계를 진행하기 전에 각 삭제 단계가 완료될 때까지 기다립니다.이 절차는 이러한 스택에서 생성된 모든 리소스를 영구적으로 삭제합니다. 계속하기 전에 중요한 데이터를 백업했는지 확인합니다.[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/prescriptive-guidance/latest/patterns/using-amazon-bedrock-agents-to-automate-creation-of-access-entry-controls-in-amazon-eks.html) | DevOps | ## 문제 해결 | 문제 | Solution | | --- | --- | | 환경 설정 중에 0이 아닌 오류 코드가 반환됩니다. | 명령을 실행하여이 솔루션을 배포할 때 올바른 폴더를 사용하고 있는지 확인합니다. 자세한 내용은이 패턴의 리포지토리에 있는 [FIRST\$1DEPLOY.md](https://github.com/aws-samples/eks-access-controls-bedrock-agent/blob/main/FIRST_DEPLOY.md) 파일을 참조하세요. | | Lambda 함수는 작업을 수행할 수 없습니다. | Lambda 함수에서 Amazon EKS 클러스터로의 연결이 올바르게 설정되어 있는지 확인합니다. | | 에이전트 프롬프트가 API를 인식하지 못합니다. | 솔루션을 재배포합니다. 자세한 내용은이 패턴의 리포지토리에 있는 [RE\$1DEPLOY.md](https://github.com/aws-samples/eks-access-controls-bedrock-agent/blob/main/RE_DEPLOY.md) 파일을 참조하세요. | | 클러스터 스택 삭제에 실패했습니다. | 스택을 삭제하려는 초기 시도가 실패할 수 있습니다. 이 실패는 지식 기반에 대한 인덱싱을 수행하는 OpenSearch 컬렉션에 대해 생성된 사용자 지정 리소스의 종속성 문제로 인해 발생할 수 있습니다. 스택을 삭제하려면 사용자 지정 리소스를 유지하여 삭제 작업을 다시 시도합니다. | ## 관련 리소스 **AWS 블로그 ** + [간소화된 Amazon EKS 액세스 관리 제어에 대한 심층 분석](https://aws.amazon.com/blogs/containers/a-deep-dive-into-simplified-amazon-eks-access-management-controls/) **Amazon Bedrock 설명서** + [에이전트를 사용하여 애플리케이션에서 태스크 자동화](https://docs.aws.amazon.com/bedrock/latest/userguide/agents.html) + [Amazon Bedrock Agents 작동 방식](https://docs.aws.amazon.com/bedrock/latest/userguide/agents-how.html) + [에이전트 동작 테스트 및 문제 해결](https://docs.aws.amazon.com/bedrock/latest/userguide/agents-test.html) + [작업 그룹을 사용하여 에이전트가 수행할 작업 정의](https://docs.aws.amazon.com/bedrock/latest/userguide/agents-action-create.html) **Amazon EKS 설명서** + [Amazon EKS에서 액세스 제어가 작동하는 방식 알아보기](https://docs.aws.amazon.com/eks/latest/userguide/cluster-auth.html)