View a markdown version of this page

Amazon Bedrock AgentCore 런타임 직접 코드 배포 시작하기 - Amazon Bedrock AgentCore
다이렉트 코드 배포 개념

Amazon Bedrock AgentCore 런타임 직접 코드 배포 시작하기

직접 코드 배포를 사용하면 에이전트 코드와 해당 종속성을 .zip 파일 아카이브에 패키징하여 에이전트를 Amazon Bedrock AgentCore 런타임으로 가져올 수 있습니다. 에이전트는 여전히 AgentCore 런타임 요구 사항을 따라야 합니다.

배포 패키지를 .zip 파일 아카이브로 생성하려면 AgentCore CLI를 사용하거나 아래 언어별 가이드의 단계 또는 7zip과 같은 기타 .zip 파일 유틸리티를 따릅니다. 다음 섹션에 표시된 예제에서는 Linux 또는 MacOS 환경에서 명령줄 zip 도구를 사용한다고 가정합니다. Windows에서 동일한 명령을 사용하려면 Windows Subsystem for Linux를 설치하여 Ubuntu 및 Bash의 Windows 통합 버전을 가져옵니다.

AgentCore 런타임은 POSIX 파일 권한을 사용하므로 .zip 파일 아카이브를 생성하기 전에 배포 패키지 폴더에 대한 권한을 설정해야 할 수 있습니다.

주제

다이렉트 코드 배포 개념

Amazon Bedrock AgentCore 런타임에서 직접 코드 배포를 사용할 때의 주요 개념에 대해 알아봅니다.

주제

    직접 코드 배포가 포함된 Amazon Bedrock AgentCore 런타임은 AWS Lambda와 유사한 공동 책임 모델을 사용합니다. AgentCore 런타임은 에이전트 코드와 종속성에 집중하면서 언어 런타임 환경을 관리하고 보안 패치를 자동으로 적용합니다.

    컨테이너 이미지를 사용하여 에이전트를 배포하는 경우 AgentCore 런타임은 컴퓨팅 커널만 패치할 책임이 있습니다. 이 경우 최신 보안 이미지에서 에이전트의 컨테이너 이미지를 다시 빌드하고 컨테이너 이미지를 다시 배포해야 합니다.

    이 내용은 다음 표에 요약되어 있습니다.

    Deployment mode(배포 모드) AgentCore 런타임의 책임 사용자의 책임

    직접 배포 모드

    언어 런타임에 대한 최신 패치가 포함된 새 언어 런타임 버전을 게시합니다. 언어 런타임 패치를 기존 AgentCore 런타임 직접 배포에 적용합니다.

    종속성을 포함한 에이전트 코드를 업데이트하여 보안 취약성을 해결합니다.

    컨테이너 이미지

    기본 컴퓨팅 OS 커널을 최신 버전으로 자동으로 패치합니다.

    종속성을 포함한 에이전트 코드를 업데이트하여 보안 취약성을 해결합니다. 최신 기본 이미지를 사용하여 컨테이너 이미지를 정기적으로 다시 빌드하고 배포합니다.

    공동 책임에 대한 자세한 내용은 공동 책임 모델을 AWS참조하세요.

    AgentCore 런타임은 보안 업데이트, 버그 수정, 새로운 기능, 성능 향상 및 마이너 버전 릴리스 지원을 통해 각 직접 코드 배포 런타임을 최신 상태로 유지합니다. 이러한 런타임 업데이트는 런타임 버전으로 게시됩니다. AgentCore 런타임은 에이전트를 이전 런타임 버전에서 새 런타임 버전으로 마이그레이션하여 에이전트에게 직접 코드 배포 런타임 업데이트를 적용합니다.

    직접 배포 런타임의 경우 AgentCore 런타임은 런타임 업데이트를 자동으로 적용합니다. 자동 런타임 업데이트를 통해 AgentCore 런타임은 런타임 버전 패치 적용의 운영 부담을 감수합니다. 언어 런타임 패치만 자동으로 적용되고 고객은 코드 종속성을 가져오고 관리할 책임이 있으므로 대부분의 고객에게 이는 안전한 선택이어야 합니다. 현재 AgentCore 런타임은이 자동 패치 동작 변경을 지원하지 않습니다.

    AgentCore 런타임은 기존 함수와 역호환되는 런타임 업데이트를 제공하기 위해 노력합니다. 하지만 소프트웨어 패치와 마찬가지로, 드물지만 런타임 업데이트가 기존 함수에 부정적인 영향을 미칠 수 있는 경우도 있습니다. 예를 들어 보안 패치는 이전의 안전하지 않은 동작에 의존하는 기존 함수의 근본적인 문제를 노출시킬 수 있습니다. 매우 드문 경우지만이 위험을 허용할 수 없는 경우 컨테이너 이미지를 사용하여 에이전트를 배포하십시오.

    한 옵션이 다른 옵션과 어떻게 다른지 확인하기 위한 비교 차원 중 일부는 올바른 옵션을 선택하는 데 도움이 됩니다.

    • 배포 프로세스: 다이렉트 코드 배포는 컨테이너 대신 ZIP 파일을 사용하여 에이전트를 배포하므로 개발 반복 속도가 빨라집니다.

    • 배포 시간: 에이전트를 처음 배포하는 동안에는 큰 차이가 없지만 직접 코드를 배포하면 에이전트에 대한 후속 업데이트가 훨씬 빨라집니다.

    • 사용자 지정 : 다이렉트 코드는 ZIP 기반 패키징을 통해 사용자 지정 종속성을 지원하는 동시에 배포 간소화를 유지하면서 컨테이너 기반은 Docker 파일에 따라 달라집니다.

    • 패키지 크기: 다이렉트 코드 배포는 패키지 크기를 250MB로 제한하는 반면 컨테이너 기반 패키지는 최대 2GB 크기일 수 있습니다.

    • 세션 생성 속도: 직접 코드 배포를 사용하면 컨테이너 기반 배포의 경우 초당 1.6개의 새 세션에 비해 초당 25개의 새 세션을 더 많이 생성할 수 있습니다.

    일반적인 지침은 다음과 같습니다.

    • 배포 패키지의 크기가 250MB를 초과하고 기존 컨테이너 CI/CD 파이프라인이 있으며 고도로 전문화된 종속성과 패키징이 필요한 경우 컨테이너 기반 배포를 선택하는 것이 좋습니다.

    • 배포 패키지의 크기가 작으면 코드와 패키지가 빌드하기 복잡하지 않고 일반적인 프레임워크와 언어를 사용하며 신속한 프로토타입 생성 및 반복이 필요한 경우 직접 코드 배포가 옵션입니다.

    또한 개발자가 직접 코드 배포를 사용하여 에이전트를 빠르게 실험하고 프로토타입을 만든 다음 컨테이너 기반 배포로 전환하여(위의 이유로) 프로덕션에 개발, 테스트 및 배포하는 하이브리드 옵션이 있을 수 있습니다.