java fm playground

Java Java FM 놀이터

Amazon Bedrock 과의 Java 통합을 탐색하기위한 샌드 박스 인 Java Foundation Model (FM) 놀이터에 오신 것을 환영합니다.

중요 : 이 응용 프로그램은 교육 목적을위한 것이며 생산 사용을위한 것이 아닙니다.

개요

이 저장소에는 Spring Boot 응용 프로그램과 Next.js Frontend가 모두 로컬로 실행 가능합니다. 아래는 앱의 스크린 샷입니다.

중요한

• 이 응용 프로그램을 실행하면 AWS 계정에 청구됩니다. 자세한 내용은 Amazon Bedrock 가격을 참조하십시오.
• 이 앱은 us-east-1 에서 실행되도록 구성되며 모든 AWS 지역에서 테스트되지 않았습니다. 자세한 내용은 AWS 지역 서비스를 참조하십시오.
• 코드 최소 특권, 즉 응용 프로그램에 필요한 최소 권한 만 부여하는 것이 좋습니다. 이 저장소의 resources/bedrock-access-policy.json (디스플레이 정책)에서 필요한 권한이있는 IAM 정책 문서를 찾을 수 있습니다.

전제 조건

다음을 설치했는지 확인하십시오.

• Java JDK 17+ (예 : Amazon Corretto, JDK의 무료 배포판)
• 백엔드 서버의 Apache Maven
• 프론트 엔드 애플리케이션의 경우 Node.js (v18.17+)
• AWS 계정이 있어야하며 AWS 도구 및 SDK 공유 구성 및 자격 증명 참조 안내서에 설명 된대로 기본 자격 증명 및 AWS 영역이 구성되어 있어야합니다.
• 모델을 사용하기 전에 모델에 대한 액세스를 요청해야합니다. 자세한 내용은 모델 액세스를 참조하십시오. 앱을 실행하려면 us-east-1 의 다음 모델에 액세스해야합니다.
  • 안트로 클로드
  • AI21 실험실 Jurassic-2 Mid
  • 안정성 AI 안정 확산 XL

응용 프로그램 실행

전제 조건을 확인한 후 다음 단계를 따르십시오.

저장소를 복제하십시오

터미널을 열고 선택한 디렉토리로 이동하여 다음 명령을 실행하십시오.

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

백엔드 설정

java-fm-playground/backend 디렉토리에서 실행 :

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

성공적인 설치 후 다음 명령을 실행하여 프론트 엔드 애플리케이션을 시작할 수 있습니다.

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 바로 가기를 사용하여 서버를 중지하십시오.

문제가 발생하면 프로세스 ID ( PID )를 찾고 Windows의 Unix 기반 시스템 또는 작업 관리자에서 kill 명령을 사용하여 프로세스를 강제로 종료 할 수 있습니다.

다른 포트 사용

다음 파일에서 백엔드 포트를 변경하십시오.

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

다른 포트에서 프론트 엔드를 실행하려면 :

npm run dev -- --port NEW_PORT

문제 해결

AWS 지역은 응용 프로그램에서 하드 코딩되었습니다. 그러나 로컬 AWS_REGION 환경 변수가 다른 영역으로 설정된 경우 응용 프로그램이 실패 할 수 있습니다. 이 경우 UNSET AWS_REGION 또는 us-east-1 로 설정하십시오.

특허

이 라이브러리는 MIT-0 라이센스에 따라 라이센스가 부여됩니다. 라이센스 파일을 참조하십시오.

보안

자세한 내용은 기여를 참조하십시오.