사전 요구 사항
IBM Bob으로 Java Modernization 워크플로우를 시작하기 전에 시스템, 환경 및 프로젝트 요구 사항을 검토합니다.
Java Modernization 워크플로우를 시작하기 전에 이러한 요구 사항을 검토하세요. 잘 준비된 프로젝트는 더 빠르고 정확한 분석으로 이어지며 마이그레이션 중 중단이 줄어듭니다.
시스템 요구 사항
| 요구 사항 | 세부 정보 |
|---|---|
| Java Development Kit (JDK) | 최소 JDK 8. 대상 JDK 버전(예: JDK 21)을 사전 설치하는 것이 좋습니다. Bob은 SDKMan 또는 WinGet을 통해 대상 버전을 설치할 수 있습니다. |
| IBM Bob | 버전 2.0.0 이상, 설치 및 인증 완료. |
| Java Modernization 패키지 | IBM Bob Premium Package for Java Modernization 활성 라이선스. |
| Git | 브랜치 및 pull request 관리를 위한 Git flow 기능을 사용하는 경우 필요합니다. |
SDKMan은 Java 버전 설치 관리에 필요합니다. Bob은 워크플로우 중에 SDKMan을 확인하고 감지되지 않으면 설치를 요청할 수 있습니다.
쉘에서 SDKMan을 초기화하려면 쉘 프로파일(~/.bashrc 또는 ~/.zshrc)에 소스 설정되어 있는지 확인하세요. 설치 후 터미널 세션을 다시 시작하세요.
WinGet(Windows Package Manager)은 Java 설치 관리에 필요합니다.
WinGet을 설치한 후 IBM Bob과 열려 있는 터미널 세션을 다시 시작하여 Bob이 업데이트된 PATH에서 감지할 수 있도록 합니다.
프로젝트 요구 사항
빌드 구성
워크플로우를 시작하기 전에 프로젝트가 다음 요구 사항을 충족해야 합니다:
- 유효한 Maven(
pom.xml) 또는 Gradle(build.gradle) 빌드 구성이 있어야 합니다. - IDE에서 올바른 루트 레벨에서 프로젝트가 열려 있어야 합니다.
- 표준 디렉터리 구조(
src/main/java,src/test/java)에 소스 코드가 있어야 합니다. - 모든 종속성이 해결되고 프로젝트가 성공적으로 컴파일되어야 합니다.
- 단일 모듈 프로젝트: 메인
pom.xml또는build.gradle이 포함된 폴더를 엽니다. - 멀티 모듈 프로젝트: 상위 프로젝트 루트를 엽니다. 모든 모듈이 상위 POM에 나열되어 있고 모듈 간 종속성이 올바르게 구성되어 있는지 확인하세요.
- 다중 프로젝트 워크스페이스: Bob이 요청할 때 올바른 프로젝트 루트를 선택합니다.
버전 제어
클린 작업 디렉터리로 Git을 초기화합니다. 시작하기 전에 커밋되지 않은 변경 사항을 커밋하거나 스태시합니다.
전용 마이그레이션 브랜치를 생성합니다:
git checkout -b java-modernization환경 설정
워크플로우를 시작하기 전에 환경이 준비되었는지 확인합니다:
- 빌드 도구(Maven 또는 Gradle)가 설치되고 구성되어 있어야 합니다.
- 빌드 및 테스트를 실행하기 위한 터미널 액세스가 가능해야 합니다.
- 종속성 다운로드를 위한 네트워크 액세스가 가능해야 합니다.
- 불필요한 파일 및 편집기가 닫혀 있어야 합니다.
- 빌드 아티팩트가 정리되어 있어야 합니다(선택 사항이지만 권장).
.bobignore 구성
민감한 파일을 보호하고 Bob의 분석에서 노이즈를 제외하도록 .bobignore를 구성합니다. 파일은 .gitignore 형식을 사용하며 .bob/.bobignore에 위치합니다.
제외 항목:
- 대용량 종속성 및 빌드 아티팩트
- 테스트 데이터 파일
- 민감한 구성 파일
워크플로우별 요구 사항
백업 및 안전
워크플로우를 시작하기 전에:
프로젝트 파일의 최근 백업을 생성하고 모든 변경 사항이 커밋된 클린 Git 리포지토리를 확보합니다. 팀에 현대화 작업이 진행 중임을 알립니다.