java fm playground

☕ Java FM Playground

Добро пожаловать на детскую площадку Foundation Foundation (FM), песочница для изучения интеграции Java с Amazon Bedrock .

Важно: это приложение для образовательных целей и не предназначено для использования производства.

Обзор

Этот репозиторий включает в себя приложение Spring Boot и Frontend Next.js , оба на локально. Ниже приведен скриншот приложения в действии.

Важный

• Запуск этого приложения может привести к сбору в вашей учетной записи AWS. Для получения более подробной информации см. Цены на Amazon Bendrock.
• Это приложение настроено для запуска в us-east-1 и не было протестировано в каждом регионе AWS. Для получения дополнительной информации см. Региональные услуги AWS.
• Мы рекомендуем предоставить ваш код наименьшую привилегию, то есть только минимальные разрешения, требуемые заявлением. Вы можете найти документ политики IAM с необходимыми разрешениями в этом хранилище в resources/bedrock-access-policy.json (Политика отображения).

Предварительные условия

Убедитесь, что у вас установлено следующее:

• Java JDK 17+ (например, Amazon Corretto, бесплатное дистрибутив JDK)
• Apache Maven для бэкэнд -сервера
• Node.js (v18.17+) для приложения Frontend
• У вас должна быть учетная запись AWS, и ваши учетные данные по умолчанию и регион AWS настроены, как описано в Справочном руководстве по общей конфигурации и учетных данных SDKS и SDK.
• Вы должны запросить доступ к моделям, прежде чем вы сможете их использовать. Для получения дополнительной информации см. Модель Access. Чтобы запустить приложение, вам нужен доступ к следующим моделям в us-east-1 :
  • Антропический Клод
  • AI21 Labs Jurassic-2 Mid
  • Стабильность Стабильная диффузия xl ​​xl

Запуск приложения

После проверки предпосылок выполните эти шаги:

Клонировать репозиторий

Откройте терминал, перейдите к каталогу по вашему выбору и выполните следующую команду:

git clone https://github.com/build-on-aws/java-fm-playground.git

Настройка бэкэнд

В каталоге java-fm-playground/backend Run:

mvn spring-boot:run

Как только сервер будет запущен, вы увидите следующий вывод:

...
2023-11-13T14:19:02.862+01:00  INFO 34848 --- [main] o.s.b.w.embedded.tomcat.TomcatWebServer  : Tomcat started on port(s): 55500 (http) with context path ' '
2023-11-13T14:19:02.868+01:00  INFO 34848 --- [main] a.c.e.b.SpringFmPlaygroundApplication    : Started SpringFmPlaygroundApplication in 1.415 seconds (process running for 1.659)

? Бэкэнд работает по порту 55500 по умолчанию. Смотрите ниже для сменов порта.

Настройка фронта

В новом окне терминала перейдите в каталог frontend и установите пакеты, необходимые путем выполнения следующей команды:

npm install

После успешной установки вы можете запустить приложение Frontend, выполнив следующую команду:

npm run dev

Когда приложение запускается, вы увидите следующий вывод:

 > [email protected] dev
> next dev

   ▲ Next.js 14.0.0
   - Local:        http://localhost:3000

 ✓ Ready in 3.3s

Доступ к приложению

Откройте http://localhost:3000 в вашем веб -браузере, чтобы взаимодействовать с приложением.

Остановка приложения

Чтобы остановить приложение, вам нужно будет остановить как бэкэнд, так и фронтальные процессы.

Остановка фронта

В терминале, где работает фронт, нажмите Ctrl + C чтобы завершить процесс.

Остановив бэкэнд

Точно так же в бэкэнд -терминале используйте ярлык Ctrl + C , чтобы остановить сервер.

Если вы столкнетесь с какими-либо проблемами, вы можете насильственно прекратить процессы, обнаружив идентификатор процесса ( PID ) и используя команду kill в системах UNIX или менеджер задач в Windows.

Используя разные порты

Измените бэкэнд -порт в следующих файлах:

• backend/src/main/resources/application.yml
• frontend/app/app.config.js

Запустить фронт на другом порту:

npm run dev -- --port NEW_PORT

Поиск неисправностей

Регион AWS жестко кодируется в приложении. Однако, если ваша локальная переменная среды AWS_REGION устанавливается в другой регион, приложение может потерпеть неудачу. В этом случае, пожалуйста, убедитесь, что вы не установите AWS_REGION , либо установите его на us-east-1 .

Лицензия

Эта библиотека лицензирована по лицензии MIT-0. Смотрите файл лицензии.

Безопасность

Смотрите Anploying для получения дополнительной информации.