agents-deploy

agents-deploy — навык AWS для развёртывания AgentCore agent и диагностики неудачного deploy. Он охватывает pre-flight-проверки, анализ ошибок CDK, IAM и квот, управление версиями, rollback и canary deployment. Навык срабатывает, когда агент готовят к публикации, когда deploy завершился ошибкой, когда нужно выполнить предварительную проверку или выбрать конкретную staging либо production цель. Он также описывает preview, откат к прежней версии и закрепление версии. Для добавления новых возможностей до deploy, production hardening и ошибок настройки VPC источник направляет к другим навыкам, поэтому agents-deploy не следует расширять на эти задачи. Перед работой требуется проверить версию CLI командой agentcore --version: заявлено требование не ниже 0.9.0. Затем нужно определить ситуацию и прочитать agentcore/agentcore.json и agentcore/aws-targets.json, если эти файлы существуют. В режиме pre-flight сначала запускается agentcore validate, чтобы поймать некорректную конфигурацию до CDK. После этого сверяются регион AWS, регион deployment target и аккаунт, под которым действительно выполняются команды. Источник предлагает сравнить aws configure get region, содержимое aws-targets.json и результат aws sts get-caller-identity; регион и аккаунт должны соответствовать выбранной цели. Отдельная проверка касается доступа к foundation models Amazon Bedrock. Навык предлагает получить активные model IDs через aws bedrock list-foundation-models с регионом из конфигурации. Для cross-region inference profiles учитываются geographic-префиксы us., eu., apac. и global.; geographic-профиль ограничивает направление запросов своей зоной, а global. допускает маршрутизацию по коммерческим регионам. Доступ к модели должен быть включён в каждом регионе, который покрывает выбранный профиль. Это проверяется до deploy, а не после ошибки авторизации. Для предварительного просмотра применяются agentcore deploy --dry-run и agentcore deploy --diff: первый показывает ресурсы, которые будут созданы, второй — CDK-разницу относительно уже развёрнутого состояния. IAM-права можно проверить через iam simulate-principal-policy для действия iam:CreateRole и ролей BedrockAgentCore. Когда проверки пройдены, источник приводит команды agentcore deploy -y, verbose-вариант с -v и запуск для отдельной цели через --target staging. Наличие memory может добавить к операции две-пять минут на переход ресурса в ACTIVE; это предлагается проверять командой agentcore status --type memory. Для failed deploy сначала читаются последние файлы в agentcore/.cli/logs и последние строки deploy-логов. Далее ошибка сопоставляется с конкретным классом причины. Для отсутствующего IAM-разрешения нужен доступ к созданию BedrockAgentCore role. Для ошибки CDK bootstrap используется npx cdk bootstrap с account и region. Ошибка ECR authorization проверяется через docker login с паролем из AWS ECR. ValidationException о неверном model identifier требует включить модель в Bedrock Model access и сверить ID в agentcore.json. Несовпадение регионов исправляется выравниванием aws-targets.json и AWS CLI. Зависшую memory можно проверить в JSON-статусе, а превышение квоты AgentCore runtime требует запроса увеличения Service Quotas. После исправления источник рекомендует повторить agentcore deploy -y и, если проблема возвращается, проверить agentcore status, включая ресурсы в состоянии pending-removal. Для нескольких targets в agentcore/aws-targets.json задаются имя, описание, account и region каждой цели; затем staging и production запускаются отдельными командами с --target. Результатом навыка должны быть результаты pre-flight с конкретными исправлениями, диагноз deploy с точной причиной и команда повторного запуска. Это рабочий процесс проверки и восстановления deployment, а не гарантия успешного доступа к AWS без корректных аккаунта, региона, IAM, модели и квот.