2025 연말데모를 위한 branch 사용

[youngtaekiim]

현재 demo25 , rocksdb branch 가 사용중입니다.

내 commit PR은 어떤 branch에 생성해야 하나?

모든 연말 데모를 위해 demo25 branch가 생성되었습니다.
데모용으로만 필요한 코드는 demo25 branch에 PR을 넣어주세요.
rocksdb branch 는 DB 교체를 위한 테스트 branch 입니다.

main branch에만 들어가는 코드는 기존과 같이 main branch로 PR을 넣어주시고, 공통으로 들어가야 하는 코드는 둘다 PR을 만들거나 main에만 넣고 저한테 알려주시면 cherry-pick 하도록 하겠습니다.

Release 정책

가급적 주요 변경사항이 있을 때마다 demo25 branch에서 release 를 생성할 예정입니다. vMM.DD.n-demo 과 같은 식으로 날짜와 0~9 로 생성됩니다.
arm, x86 버전으로 생성된 container image는 release 생성 후 약 3시간 후에 ghcr 에 업로드 됩니다.
각 태그의 CPU 아키텍처 별 nodeagent 바이너리는 release 생성 후 약 5분 후에 release note의 asset 에 업로드 됩니다.
각 버전 별 주요 변경사항은 Branch - demo25 에 업데이트 됩니다.

rocksdb 관련 내용은 Branch - rocksdb 에 업데이트 됩니다.

(Admin only) Release 생성 시 유의사항

1. Release 생성 시, 반드시 하단 pre-release 체크, latest release 언체크 확인
2. Release 생성 전, 반드시 doc/scripts/version.txt 에 동일한 이름으로 업데이트하기

코드 다운로드 후 설치 (Master node only)

1. github.com/eclipse-pullpiri/pullpiri 프로젝트에서 demo25 branch 클론하기
2. Bluechi 설정, node name 확인
3. src/settings.yaml 에서 name 및 ip 변경
4. doc/scripts/install_nodeagent.sh 에서 MASTER_IP, NODE_IP 변경 후 실행은 하지말기 (마스터노드이므로 두 값이 동일함)
5. root폴더에서 (sudo) make install
6. doc/scripts 폴더에서 install_nodeagent.sh 실행 (sudo) ./install_nodeagent.sh
7. 상태 확인 - sudo podman ps -a , sudo systemctl status nodeagent

코드 다운로드 후 설치 (guest node only)

1. github.com/eclipse-pullpiri/pullpiri 프로젝트에서 demo25 branch 클론하기
2. Bluechi 설정, node name 확인, bluechi-agent.service 만 controller에 연결되면 됨
3. src/settings.yaml 에 master node의 name 및 ip 입력
4. doc/scripts/install_nodeagent.sh 에서 MASTER_IP, NODE_IP 변경 후 실행은 하지말기 (2개가 달라야 함)
5. 각 노드의 doc/scripts 폴더에서 install_nodeagent.sh 실행 (sudo) ./install_nodeagent.sh
6. 상태 확인 - sudo systemctl status nodeagent

Helloworld test 사용법

1. 위 설치 단계 마무리
2. examples 폴더에서 helloworld.sh 의 IP 주소가 제대로 되어 있는지 확인
3. examples/resources/helloworld_no_condition.yaml 의 Package 에서 node 가 내 bluechi node와 맞는지 확인 (Line 20)
4. examples 폴더에서 ./helloworld.sh 실행
5. podman ps -a 로 helloworld 컨테이너 확인하거나 디버깅 진행

Dashboard 사용법

1. src/tools/dashboard 폴더에서 podman build -t dashboard:settings .
2. podman run -it -d --name dashboard-ui --network host dashboard:settings
3. Flask 사용 시에는 tag 를 flask로 사용

Local 빌드 사용법

1. piccolo-server.yaml piccolo-player.yaml 파일의 container image 정보를 내가 빌드한 로컬 image 정보로 업데이트
2. IP 설정은 위와 동일하게 진행