이 저장소는 Build Tools for VMware Aria(공식 명칭: vRealize Build Tools)의 소스 코드를 포함합니다.
Build Tools for VMware Aria는 VMware Cloud Foundation 9 구성 요소(VCF Automation, VCF Operations Orchestrator, VCF Operations, VCF Operations for Logs)에 대한 자동화 솔루션을 구현하기 위한 고급 개발 및 릴리스 관리 도구를 제공합니다. 이 솔루션은 가상 인프라 관리자(Virtual Infrastructure Administrators)와 자동화 개발자(Automation Developers)가 표준 DevOps 관행을 사용하여 콘텐츠를 관리하고 배포할 수 있도록 합니다.
문서 (Documentation)
빌드 방법 (How to build)
- 다음 내용으로 ~/.m2/settings.xml을 업데이트합니다:
<profiles>
<profile>
<id>packaging</id>
...
2. 다음 명령어를 실행합니다: shell
mvn clean install -D modules.plugins
mvn clean install -D modules.tools
mvn clean package -D modules.repository
```
패키지 의존성 (Package dependencies)
소비 의존성 (Consumption dependencies)
BTVA를 사용(소비)하려면 다음 의존성이 필요합니다. 이는 프로젝트 생성, 빌드, 콘텐츠 푸시 및 풀을 수행하는 데 필요합니다:
- npm: 6.14.x (사용자의 node 버전에 호환되는 버전)
- node: 22.x.x (vcd-ng의 경우 14만 지원됨)
- maven: 3.9.x
- jdk: 17, 21, 24
선택한 런타임 환경(Node, Python, PowerShell)에 따라 추가적인 의존성이 필요할 수 있습니다 (polyglot/ABX 프로젝트 유형 기반).
개발자 의존성 (Developer dependencies)
BTVA 프로젝트 자체를 빌드하고 디버깅하며 기여하려면 다음 추가 의존성이 필요합니다:
- Python: >= 3.10
- PowerShell: 7.1 - 7.4
- OpenSSL: >= 3.0
의존성 검증 스크립트 (Dependency validation scripts)
Linux/MacOS에서 의존성이 충족되었는지 확인하려면 다음을 실행할 수 있습니다:
curl -o- https://raw.githubusercontent.com/vmware/build-tools-for-vmware-aria/main/health.sh | bash
Windows에서 의존성이 충족되었는지 확인하려면 다음을 실행할 수 있습니다:
Set-ExecutionPolicy Bypass -Scope Process -Force; Invoke-Expression ((New-Object System.Net.WebClient).DownloadString('https://raw.githubusercontent.com/vmware/build-tools-for-vmware-aria/main/health.ps1'))
기본적으로 healthcheck 스크립트는 사용 가능한 프로젝트 유형 중 하나를 통해 Build Tools for Aria의 종속성을 검증합니다. Build Tools for Aria에 기여하는 데 필요한 모든 종속성을 검증하려면 --contribute 플래그를 전달하십시오. 예를 들어:
또는 Windows의 경우
인코딩 (UTF-8)
일부 개발 환경은 플랫폼별 파일 인코딩(예: 일부 Windows 시스템의 Cp1252)을 기본값으로 사용합니다. Build Tools for VMware Aria는 가능한 경우 UTF-8을 사용하여 파일을 읽고 쓰지만, JVM 및 툴체인(toolchain)의 기본값이 여전히 동작에 영향을 미칠 수 있습니다. 비-ASCII 문자(예: CSS/폼 스타일의 이모지)가 물음표로 대체되는 문제가 발생하는 경우, 다음 방법 중 하나를 사용하여 Java가 UTF-8을 사용하도록 보장하십시오:
- 시스템 속성으로 JVM 시작:
-Dfile.encoding=UTF-8.
- JVM 실행 환경 변수 설정:
JAVA_TOOL_OPTIONS="-Dfile.encoding=UTF-8".
- Maven 실행 시, 다음 속성을 전달할 수 있습니다:
mvn -Dfile.encoding=UTF-8 <goal>.
지원 (Support)
자세한 지원 명세는 여기에서 찾을 수 있습니다.