********************************* Deploy ********************************* .. contents:: Table of Contents --------- .. raw:: html .. role:: blue Cloud-Based ============= Jira + GitHub + Docker Hub --------------------------- `Deployment Management `__ 배포 버전 관리 `Deployment Image Repository `__ 배포 이미지 저장소 On-Premise ============= Jira + SCM-Manager + Docker Hub -------------------------------- `Deployment Image Repository `__ 배포 버전 관리 `Deployment Image Repository `__ 배포 이미지 저장소 ( Docker Hub ) User Manual ============ SD Card 양산 복제 ----------------- 1. Windows에서 FTP 서버 네트워크 드라이브 연결 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - 파일 탐색기에서 '내 PC' 마우스 오른쪽 클릭 → '네트워크 위치 추가'를 선택합니다. .. figure:: ../static/1.jpg :width: 100% :align: left :figclass: margin 2. 서버 주소 입력 ~~~~~~~~~~~~~~~~ - FTP 서버 주소를 입력합니다. - ftp://ftp-dinsight@192.168.1.133 .. figure:: ../static/2.jpg :width: 100% :align: left :figclass: margin :alt: 3. 네트워크 위치 이름 지정 ~~~~~~~~~~~~~~~~~~~~~~~~~ - 사용자가 알아보기 쉬운 이름을 입력합니다. - 예: systempart-ftp-server .. figure:: ../static/3.jpg :width: 100% :align: left :figclass: margin :alt: 4. 로그인 정보 입력 ~~~~~~~~~~~~~~~~ - 사용자 이름: ftp-dinsight - 암호: dinsight0625 - "익명 로그인"은 체크하지 않음 - "암호 저장" 체크 .. figure:: ../static/4.jpg :width: 100% :align: left :figclass: margin :alt: 5. 네트워크 위치 확인 ~~~~~~~~~~~~~~~~~~ - 연결이 성공하면 내 PC → 네트워크 위치에 FTP 서버 폴더가 표시됩니다. .. figure:: ../static/6.jpg :width: 100% :align: left :figclass: margin :alt: - FTP 서버 내 파일(rpi.img)이 탐색기에 나타나는지 확인합니다. .. figure:: ../static/5.jpg :width: 100% :align: left :figclass: margin :alt: 6. SD카드에 Raspberry Pi 이미지 굽기 (Balena Etcher 사용) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 6.0 Image Flasher 다운로드 및 설치 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - `Balena Etcher`_\ 다운로드 후 설치 진행 .. _Balena Etcher: https://www.balena.io/etcher/ 6.1 Image Flasher 실행 ^^^^^^^^^^^^^^^^^^^^^^ - Balena Etcher 프로그램을 실행합니다. .. figure:: ../static/7.png :width: 100% :align: left :figclass: margin :alt: 6.2 이미지 파일 선택 ^^^^^^^^^^^^^^^^^^^ - Flash from file 버튼 클릭 .. figure:: ../static/7.png :width: 100% :align: left :figclass: margin :alt: - rpi.img 파일을 선택합니다. .. figure:: ../static/8.png :width: 100% :align: left :figclass: margin :alt: 6.3 대상 디스크 선택 ^^^^^^^^^^^^^^^^^^^ - Select target 버튼 클릭 - 목록에서 SD 카드를 선택합니다. .. figure:: ../static/9.png :width: 100% :align: left :figclass: margin :alt: - 6.9 Large drive 경고가 표시되면 선택을 다시 한번 확인합니다. 6.4 굽기(Flash) ^^^^^^^^^^^^^^^ - Flash! 버튼 클릭 .. figure:: ../static/10.png :width: 100% :align: left :figclass: margin :alt: - 이미지가 SD카드에 기록되고 완료 후 자동으로 검증됩니다. Terinal Emulator 설치 --------------------- 1. `PuTTY`_\ 다운로드 - Windows용 SSH 및 텔넷 클라이언트 .. _PuTTY: https://the.earth.li/~sgtatham/putty/latest/w64/putty.exe 2. 실행 - 다운로드한 `putty.exe` 파일을 실행 3. Serial 설정 - 장치 관리자에서 PC에 연결된 COM 포트 번호 확인 - Category :blue:`Session` --> :blue:`Serial` 선택 - Serial line :blue:`COMx` (x는 PC에 연결된 포트 번호) - Speed :blue:`115200` 입력 - :blue:`Open` 버튼 클릭하여 연결 .. figure:: ../static/11.jpeg :width: 100% :align: left :figclass: margin :alt: .. figure:: ../static/12.png :width: 100% :align: left :figclass: margin :alt: Windows Git 설치 가이드 ----------------------- 1단계: PowerShell 실행 ~~~~~~~~~~~~~~~~~~~~~~ :menuselection:`Windows키 + R --> 'powershell' 입력 --> Enter` 또는 :menuselection:`Windows키 + X --> 'Windows PowerShell or '터미널(I)' 선택` .. figure:: ../static/17.png :width: 100% :align: left :figclass: margin :alt: .. figure:: ../static/13.png :width: 100% :align: left :figclass: margin :alt: 2단계: Git 설치 ~~~~~~~~~~~~~~~ .. code-block:: bash winget install --id Git.Git -e --source winget .. figure:: ../static/14.jpeg :width: 100% :align: left :figclass: margin :alt: .. figure:: ../static/15.jpeg :width: 100% :align: left :figclass: margin :alt: .. figure:: ../static/16.png :width: 100% :align: left :figclass: margin :alt: 3단계: 새 PowerShell 창 열기 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - 기존 창 닫고 새로 실행 (PATH 적용을 위해) 4단계: 설치 확인 ~~~~~~~~~~~~~~~~ .. code-block:: bash git --version .. figure:: ../static/18.jpeg :width: 100% :align: left :figclass: margin :alt: EEPROM 설정 스크립트 실행 가이드 ------------------------------- 📋 개요 ~~~~~~~~ Raspberry Pi CM4 lite SoM의 EEPROM 설정을 위한 스크립트 실행 절차를 설명합니다. 🔧 사전 준비 ~~~~~~~~~~~~~ 1단계: PowerShell 실행 ^^^^^^^^^^^^^^^^^^^^^^ :menuselection:`Windows키 + R --> 'powershell' 입력 --> Enter` 또는 :menuselection:`Windows키 + X --> 'Windows PowerShell or '터미널(I)' 선택` 2단계: 스크립트 다운로드 ^^^^^^^^^^^^^^^^^^^^^^^ 1. Git 저장소에서 `cm4_eeprom_manual.sh` 스크립트 다운로드 .. code-block:: bash git clone http://192.168.1.133:8085/scm/repo/solution-Lumino-Imager-Color/deploy2mmt cd deploy2mmt .. important:: - ID 및 비밀번호 입력 필요 ( ID: louis, PW: louis0625 ) .. figure:: ../static/26.png :width: 100% :align: left :figclass: margin :alt: 2. SD Card로 복사 - Step.1) USB to Serial 케이블로 RPi CM4 보드와 PC 연결 - Step.2) 전원 인가 - Step.3) OTG 케이블로 PC와 연결 (부팅 시간: 약 23초 소요) .. figure:: ../static/19.jpeg :width: 100% :align: left :figclass: margin :alt: .. figure:: ../static/20.jpeg :width: 100% :align: left :figclass: margin :alt: .. figure:: ../static/21.jpeg :width: 100% :align: left :figclass: margin :alt: .. figure:: ../static/22.jpeg :width: 100% :align: left :figclass: margin :alt: .. warning:: - 데이터 통신용 USB C-type OTG 케이블 사용 필수 (충전용 케이블 사용 시 인식 불가) - Step.4) 디스크 레이블명 :blue:`'REC_USB'` 가 자동 마운트됨. (예: :blue:`'REC_USB(D:)'` 확인) .. figure:: ../static/23.jpeg :width: 100% :align: left :figclass: margin :alt: - Step.5) ``cm4_eeprom_manual.sh`` 스크립트를 'REC_USB(D:)'에 복사 .. figure:: ../static/24.jpeg :width: 100% :align: left :figclass: margin :alt: - Step.6) RPi UART 콘솔 출력 터미널창에 아래와 같이 부팅 후 자동 로그인이 되었는지 확인 .. figure:: ../static/25.jpeg :width: 100% :align: left :figclass: margin :alt: - Step.7) 명령어 프롬프트에서 다음 명령어로 ``cm4_eeprom_manual.sh`` 스크립트를 홈 디렉토리로 복사 .. code-block:: bash $ cp /mnt/usb_storage/cm4_eeprom_manual.sh ~/ - Step.8) 스크립트에 실행 권한 부여 .. code-block:: bash $ chmod +x ~/cm4_eeprom_manual.sh - Step.9) 스크립트의 줄바꿈 형식 변환 (Windows -> Unix) .. code-block:: bash $ dos2unix ~/cm4_eeprom_manual.sh - Step.10) 홈 디렉토리로 이동 .. code-block:: bash $cd ~/ 📝 USB 3.0 Controller 활성화 실행 절차 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .. important:: - :blue:`반드시 순서대로 실행` 해야 합니다. - 각 단계 후 :blue:`재부팅이 필수` 입니다. 1단계: EEPROM 설정 활성화 ^^^^^^^^^^^^^^^^^^^^^^^^ .. code-block:: bash $ ./cm4_eeprom_manual.sh step1 - 기존 [cm4] 섹션의 EEPROM 설정을 활성화합니다 - **실행 완료 후 반드시 재부팅** .. code-block:: bash $ sudo reboot 25,1 꼭대기 2단계: EEPROM 설정 적용 ^^^^^^^^^^^^^^^^^^^^^^ .. code-block:: bash $ ./cm4_eeprom_manual.sh step2 # 첫번째 실행에서 오류 발생 시 재시도 ( 참고로 항상 첫번째 실행에서 오류가 발생하니 재시도 필요 ) $ ./cm4_eeprom_manual.sh step2 # 재시도 - VL805=1 EEPROM 설정을 적용합니다 - **실행 완료 후 반드시 재부팅** .. code-block:: bash sudo reboot 3단계: EEPROM 설정 비활성화 ^^^^^^^^^^^^^^^^^^^^^^^^^^ .. code-block:: bash $ ./cm4_eeprom_manual.sh step3 - EEPROM 설정을 다시 주석처리로 원복합니다 - **실행 완료 후 반드시 재부팅** .. code-block:: bash $ sudo reboot 4단계: USB 3.0 Controller 인식 확인 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. code-block:: bash lsusb # lsusb명령어 실행 결과가 아래와 같이 나오면 성공 Bus 002 Device 002: ID 04b4:00f9 Cypress Semiconductor Corp. FX3 Bus 002 Device 001: ID 1d6b:0003 Linux Foundation 3.0 root hub Bus 001 Device 002: ID 2109:3431 VIA Labs, Inc. Hub Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub 📝 OTG 케이블로 연결된 USB Mass Storage 포맷 (윈도우 OS 환경) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - Step.1) OTG 케이블 준비 ( USB C-type OTG 케이블 사용 필수 ) .. figure:: ../static/27.jpeg :width: 50% :align: center :figclass: margin :alt: - Step.2) OTG 케이블 연결 ( PC <-> LIC Device ) .. figure:: ../static/27-1.jpeg :width: 50% :align: left :figclass: margin :alt: - Step.3) USB Mass Storage 장치 접근에 필요한 비밀번호 입력 ( :menuselection:`'<' 버튼--> 전원 버튼 --> 녹화 버튼 --> '>' 버튼`. ) .. figure:: ../static/27-2.jpeg :width: 50% :align: left :figclass: margin :alt: - Step.3) 윈도우 OS 환경에서 OTG 케이블로 연결된 USB Mass Storage 장치 인식 확인 .. figure:: ../static/28.jpeg :width: 100% :align: left :figclass: margin :alt: - Step.3) 해당 장치를 마우스 오른쪽 클릭 후 포맷 선택 - Step.4) 포맷 형식 변경 ( extFAT 포맷 선택, 나머지 설정은 기본값 그대로 선택 ) 후 포맷 진행 .. list-table:: * - .. figure:: ../static/29.jpeg :width: 100% :align: left :figclass: margin :alt: * - .. figure:: ../static/29-1.jpeg :width: 100% :align: left :figclass: margin :alt: - Step.5) 포맷 진행 완료 .. list-table:: * - .. figure:: ../static/30.png :width: 100% :align: left :figclass: margin :alt: * - .. figure:: ../static/30-1.png :width: 100% :align: left :figclass: margin :alt: ✅ 전체 실행 순서 요약 ~~~~~~~~~~~~~~~~~~~~~~ .. code-block:: bash # 스크립트 실행 권한 부여 $ chmod +x cm4_eeprom_manual.sh # 줄바꿈 형식 변환 (Windows -> Unix) $ dos2unix cm4_eeprom_manual.sh # 1단계: 기존 EEPROM 설정 활성화 $ ./cm4_eeprom_manual.sh step1 $ sudo reboot # 2단계: VL805 EEPROM 설정 적용 $ ./cm4_eeprom_manual.sh step2 # 첫번째 실행에서 오류 발생 시 재시도 ( 참고로 항상 첫번째 실행에서 오류가 발생하니 재시도 필요 ) $ ./cm4_eeprom_manual.sh step2 # 재시도 $ sudo reboot # 3단계: 설정 원복 (EEPROM 설정 다시 주석처리) $./cm4_eeprom_manual.sh step3 $ sudo reboot # 4단계: USB 3.0 Controller 인식 확인 $ lsusb # 5단계: USB Mass Storage 장치 포맷 .. warning:: - 스크립트 실행 중 오류 발생 시 시스템을 재부팅하고 해당 단계부터 다시 시작 - 각 단계가 성공적으로 완료되었는지 확인 후 다음 단계 진행