docs: Update README - Add Rancher/Docker Conflict Resolution and Port Troubleshooting Guide

[hankyo-sorohan]

Summary

Updated the README.md to include commonly overlooked setup requirements and troubleshooting guidance for Docker Compose environment configuration.

Detailed Changes

Prerequisites

• Added Git installation guide (winget, brew)
• Emphasized that after installing Rancher Desktop, the container runtime must be set to dockerd (moby)
• Added a note to prevent Quick Start confusion:
  Docker/Rancher Desktop must be running before executing docker compose up

Windows / Rancher Integration Troubleshooting

• Added guidance and recommendations for resolving CLI conflicts and port occupation issues when Docker Desktop and Rancher Desktop are installed simultaneously
• Added troubleshooting steps for resolving broken Windows host (WSL) port forwarding issues (netsh cleanup guide)

Verification

• Verified Markdown formatting and content rendering

[bumsu-choi-dr]

README 문서 보강 잘 봤습니다. WSL exit code 1 / kubeconfig 심링크 수정과 오래된 netsh portproxy 정리는 실제로 자주 겪는 문제라 유용합니다. 머지 전 확인할 사항 몇 가지 남깁니다.

[수정 필요] simulator 포트 표에 1122이 잘못 기재됨

"Windows Port Conflicts" 표가 simulator의 호스트 포트로 1122을 명시했지만, docker-compose.yml의 simulator 서비스는 다음 4개만 노출합니다:

• 12345:12345
• 3601:3601
• 502:502
• 12360:12360/udp

1122은 compose 파일 어디에도 없습니다. 이대로 두면 가이드를 따르는 사용자가 존재할 수 없는 충돌을 쫓다가 1122 포트를 점유한 무관한 프로세스를 종료할 수 있습니다.

수정 제안: 표의 simulator 행과 Step 1의 netstat ... Select-String 패턴 양쪽에서 1122을 제거.

(build-module-fw 5022, build-module-ui 5023/3002/8089 은 compose와 일치 확인했습니다.)

[경미] Select-String 패턴이 부분 문자열을 매칭함

netstat -ano | Select-String "5023|3002|8089|5022|1122|12345|12360|3601|:502 "

Select-String은 앵커 없는 정규식이라 3002이 13002/30021 등도 매칭해 오탐이 날 수 있습니다. :502 처럼 콜론·공백으로 감싸거나 :5023\b 같은 앵커를 쓰면 정확해집니다.

[경미] 코드 블록 언어 태그 불일치

wsl -d Ubuntu -- mv ..., docker context use default 등 Windows에서 PowerShell로 실행되는 명령이 shell 로 태그되어 있습니다. 인접한 powershell 블록과 통일하면 좋겠습니다. 무해한 수준이라 선택 사항입니다.

---

1122 한 가지만 수정하면 머지해도 좋다고 봅니다. 나머지 둘은 선택적 다듬기입니다.

[hankyo-sorohan]

@bumsu-choi-dr Thanks for the review. All three items have been addressed (959527c).

• [Required] Removed 1122: Dropped from both the simulator port table and the Select-String pattern. Only the ports actually exposed by the simulator service in docker-compose.yml remain: 12345 / 3601 / 502 / 12360(udp).
• [Minor] Select-String anchors: Added :port\b anchors to every port so that values like 3002 no longer match unrelated ports such as 13002 or 30021.
• [Minor] Code block tags: Unified ```shell blocks under the Windows troubleshooting section (docker context use default, wsl ..., netsh ..., and the Step 3 docker compose ... block) with the adjacent ```powershell blocks.

Please take another look when you get a chance.