개발하다. 시사. 배.
문서화 · ChangeLog · 템플릿 · CLI
Vercel의 Frontend Cloud는 개발자 경험과 인프라를 제공하여보다 빠르고 개인화 된 웹을 구축, 확장 및 보호합니다.
프로젝트를 가져 오거나 템플릿을 선택하거나 Vercel CLI를 사용하여 시작하십시오. 그런 다음 git push
.
Vercel 사용 방법에 대한 자세한 내용은 문서를 확인하십시오.
이 프로젝트는 PNPM을 사용하여 종속성을 설치하고 스크립트를 실행합니다.
vercel
스크립트를 사용하여 Vercel CLI를 호출하는 것처럼 로컬 변경 사항을 실행할 수 있습니다. 예를 들어, vercel deploy --cwd=/path/to/project
pnpm vercel deploy --cwd=/path/to/project
사용하여 로컬 변경으로 실행할 수 있습니다.
이 저장소에 기여할 때는 먼저 풀 요청을 제출하기 전에이 저장소 소유자와 GitHub 토론을 통해 변경하려는 변경 사항을 논의하십시오.
당사의 행동 강령을 읽고 프로젝트와의 모든 상호 작용에서이를 따르십시오.
이 프로젝트는 하나의 저장소에 여러 NPM 패키지가 포함 된 Monorepo에서 구성됩니다. 종속성은 npm
CLI가 아닌 pnpm
으로 설치 및 관리됩니다.
시작하려면 다음을 실행하십시오.
git clone https://github.com/vercel/vercel cd vercel corepack enable pnpm install pnpm build pnpm lint pnpm test-unit
변경하기 전에 모든 테스트가 통과해야합니다.
cli
패키지에서 pnpm vercel
사용하여 로컬 변경 사항으로 Vercel CLI를 호출 할 수 있습니다.
cd ./packages/cli pnpm vercel <cli-commands...>
자세한 내용은 CLI 지역 개발을 참조하십시오.
변경 사항이 완료되면 (우리는 도중에 수행하는 것이 좋습니다) 모든 테스트가 여전히 실행 중이 있는지 확인하십시오.
pnpm test-unit
프로젝트의 근원에서.
테스트가 실패하면 변경 사항과 함께 수정하십시오. 테스트 실행 방법, 특히 통합 테스트에 대한 자세한 내용은 테스트 오류 해석을 참조하십시오.
변경 사항이 제대로 작동한다고 확신하면 기본 저장소에 풀 요청을 엽니 다.
풀 요청은 관리자가 검토하고 테스트는 지속적인 통합 플랫폼에서 확인합니다.
이 저장소에는 단위 테스트 및 통합 테스트의 2 가지 종류의 테스트가 있습니다.
단위 테스트는 jest
으로 로컬로 실행되며 가장 작은 코드 단위를 테스트하고 있기 때문에 빠르게 실행됩니다.
통합 테스트는 test
프로젝트 이름을 사용하여 Vercel 계정에 배포를 만듭니다. 각 테스트가 배포 된 후 probes
키는 응답이 예상 값인지 확인하는 데 사용됩니다. 값이 일치하지 않으면 차이를 설명하는 메시지가 표시됩니다. 배포가 구축되지 않은 경우 다음과 같은보다 일반적인 메시지가 표시됩니다.
[Error: Fetched page https://test-8ashcdlew.vercel.app/root.js does not contain hello Root!. Instead it contains An error occurred with this application. NO_STATUS_CODE_FRO Response headers: cache-control=s-maxage=0 connection=close content-type=text/plain; charset=utf-8 date=Wed, 19 Jun 2019 18:01:37 GMT server=now strict-transport-security=max-age=63072000 transfer-encoding=chunked x-now-id=iad1:hgtzj-1560967297876-44ae12559f95 x-now-trace=iad1]
이 경우 실패한 배포의 URL을 방문하여 /_logs
추가하여 빌드 오류를 확인할 수 있습니다. 위의 경우 https://test-8ashcdlew.vercel.app/_logs입니다
이 배포의 로그에는 실제 오류가 포함되어있어 무엇이 잘못되었는지 이해하는 데 도움이 될 수 있습니다.
전체 통합 제품군을 로컬로 실행하는 것은 권장되지 않지만 때로는 기계에서 실행하여 실패한 테스트를 분리하는 것이 유용합니다. 그렇게하려면 쉘에 적절한 자격 증명이 있는지 확인해야합니다.
액세스 토큰을 만듭니다. 여기 https://vercel.com/docs/rest-api#creating-an-access-token을 따르십시오. 토큰 범위가 귀하의 개인 계정에 대한 것인지 확인하십시오.
https://vercel.com/<MY-TEAM>/~/settings
의 Vercel 대시 보드에서 팀 ID를 잡으십시오.
이것들을 당신의 쉘 rc 파일에 소스 : echo 'export VERCEL_TOKEN=<MY-TOKEN> VERCEL_TEAM_ID=<MY-TEAM-ID>' >> ~/.zshrc
거기에서 통합 테스트를 트리거 할 수 있어야합니다. 이미 고립 된 것을 선택하여 일이 작동하는지 확인하십시오.
cd packages/next
시험 실행 :
pnpm test test/fixtures/00-server-build/index.test.js
일부 빌더는 배포하기 전에 @vercel/nft
to tree-shake 파일을 사용합니다. 이 나무 흔들리는 메커니즘에 오류가 발생했다고 의심되면 프로젝트에서 다음 스크립트를 만들 수 있습니다.
const {nodefiletrace} = require ( '@vercel/nft'); nodeFiletrace ([ 'path/to/entherpoint.js'], { TS : 사실, MixedModules : true,}) . (o => console.log (O.filelist)) . (e => console.error (e));
이 스크립트를 실행하면 모든 가져 오기 파일이 표시됩니다. 파일이 없으면 버그는 @vercel/nft에 있고 빌더가 아닙니다.
때로는 기존 프로젝트, 아마도 vercel dev
또는 실제 배포를 통해 빌더의 변경 사항을 테스트하려고합니다. 건축업자를 Tarball로 업로드하여 모든 빌더 변경을 NPM에 게시하는 것을 피할 수 있습니다.
디렉토리를 원하는 빌더 cd ./packages/node
로 변경하십시오
pnpm build
실행하여 TypeScript 및 기타 빌드 단계를 컴파일합니다.
npm pack
실행하여 타르 볼 파일을 만듭니다
tarball 파일을 업로드하고 URL을 얻으려면 vercel *.tgz
실행하십시오.
기존 vercel.json
프로젝트 편집 및 URL로 use
하는 것
실험 빌더와 함께 배포하려면 vercel
또는 vercel dev
실행하십시오.
행동 강령
기고 가이드 라인
Apache 2.0 라이센스