InfoGrab DocsInfoGrab Docs

Vue 3 마이그레이션

GitLab 프론트엔드 코드베이스를 Vue 2에서 Vue 3으로 마이그레이션하는 방법과 호환성 변경 사항, 공통 마이그레이션 패턴을 설명합니다.

Vue 2에서 Vue 3으로의 마이그레이션은 에픽 &6252 에서 추적됩니다. Vue 3.x로의 마이그레이션을 쉽게 하기 위해, 코드베이스에서 다음의 더 이상 사용되지 않는 기능을 쓰지 못하도록 막는 ESLint 규칙 을 추가했습니다. GitLab에서 Vue 3 (@vue/compat) 사용 가능 # GitLab 프론트엔드 팀은 GDK와 같은 개발 환경에서 Vue 3 (@vue/compat)을 활성화했습니다. 아직 프로덕션에 사용할 준비는 되지 않았지만, 로컬에서 opt-in하여 클라이언트 코드가 Vue 3과 순방향 호환되는지 확인할 수 있습니다. 동작 방식 Rspack이 VUE_VERSION=3 환경 변수를 감지하면, 모듈 에일리어싱을 사용해 Vue 자체를 포함한 특정 의존성을 Vue 3 호환 버전으로 교체합니다. 이 대체 라이브러리 중 일부는 팀에서 직접 유지 관리합니다. 이들은 기존 라이브러리를 감싸는 얇은 래퍼 역할을 하며, 컨슈머 코드를 전혀 변경하지 않고도 Vue 3과 호환되게 합니다. GDK에서 Vue 3 (@vue/compat) 설정 # 이 가이드는 GitLab Development Kit(GDK)에서 Rspack을 빌드 도구로 사용해 Vue 3을 구성하는 과정을 안내합니다. 사전 요구 사항 # GDK 설치 및 구성 완료 Vue.js와 Rspack에 대한 기본적인 이해 GDK 환경에 Rspack 구성( GDK Rspack settings 참고) 초기 설정 # Vue 버전 간 전환 # Vue 2와 Vue 3 사이를 전환하려면 다음 단계를 따릅니다. 원하는 Vue 버전을 설정합니다. gdk config set rspack.vue_version 3 # or 2 GDK를 재구성합니다. gdk reconfigure GDK를 재시작합니다. gdk restart # or `gdk start` if running for the first time 중요: Vue 버전 전환에 문제가 있으면 yarn clean 으로 캐시를 지우거나, rm -rf tmp/cache/rspack && gdk restart rspack 로 Rspack 캐시를 지우고 서비스를 재시작합니다. 설정 확인 # gdk.yml 파일을 확인해 Rspack 구성을 검증할 수 있습니다. gdk config get rspack 활성화 상태와 Vue 버전을 포함한 현재 Rspack 설정이 표시됩니다. GDK도 실행 중이어야 합니다. --- allowed_hosts: [] enabled: true host: 127.0.0.1 live_reload: true port: 3808 public_address: '' sourcemaps: true static: false vue_version: 3 문제 해결 # 일반적인 디버깅 # 문제가 발생하면 먼저 Rspack 로그를 확인합니다. gdk tail rspack 이 명령은 실시간 Rspack 출력과 오류 메시지를 보여 주며, 문제를 파악하는 데 도움이 됩니다. 버전 전환 후 빌드 오류 # Vue 버전을 전환한 뒤 빌