download vercel - download do código fonte vercel

vercel

Outro código-fonte

39.1.0

Baixar

Vercel

Desenvolver. Visualização. Enviar.

Documentação · Changelog · Modelos · CLI

Vercel

O Frontend Cloud da Vercel fornece a experiência e a infraestrutura do desenvolvedor para construir, escalar e garantir uma web mais rápida e personalizada.

Implantar

Comece importando um projeto, escolhendo um modelo ou usando a CLI da Vercel. Em seguida, git push to implant.

Documentação

Para detalhes sobre como usar o Vercel, consulte nossa documentação.

Contribuindo

Este projeto usa o PNPM para instalar dependências e executar scripts.

Você pode usar o script vercel para executar alterações locais como se estivesse invocando a CLI da Vercel. Por exemplo, vercel deploy --cwd=/path/to/project pode ser executado com alterações locais com pnpm vercel deploy --cwd=/path/to/project .

Ao contribuir para este repositório, primeiro discuta a alteração que você deseja fazer através das discussões do GitHub com os proprietários deste repositório antes de enviar uma solicitação de tração.

Leia nosso código de conduta e siga -o em todas as suas interações com o projeto.

Desenvolvimento local

Este projeto está configurado em um monorepo, onde um repositório contém vários pacotes NPM. As dependências são instaladas e gerenciadas com pnpm , não npm CLI.

Para começar, execute o seguinte:

git clone https://github.com/vercel/vercel
cd vercel
corepack enable
pnpm install
pnpm build
pnpm lint
pnpm test-unit

Verifique se todos os testes passam antes de fazer alterações.

Running Vercel CLI muda

Você pode usar pnpm vercel do pacote cli para invocar a vercel cli com alterações locais:

cd ./packages/cli
pnpm vercel <cli-commands...>

Consulte o desenvolvimento local da CLI para obter mais detalhes.

Verificando sua mudança

Depois de terminar suas alterações (até sugerimos fazê -lo ao longo do caminho), verifique se todos os testes ainda passam correndo:

pnpm test-unit

Da raiz do projeto.

Se algum teste falhar, certifique -se de corrigi -lo junto com suas alterações. Consulte a interpretação de erros de teste para obter mais informações sobre como os testes são executados, especialmente os testes de integração.

Processo de solicitação de puxar

Depois de confiar que suas alterações funcionam corretamente, abra uma solicitação de tração no repositório principal.

A solicitação de tração será revisada pelos mantenedores e os testes serão verificados por nossa plataforma de integração contínua.

Interpretando erros de teste

Existem 2 tipos de testes neste repositório - testes de unidade e testes de integração.

Os testes de unidade são executados localmente com jest e são executados rapidamente porque estão testando as menores unidades de código.

Testes de integração

Os testes de integração criam implantações na sua conta de vercel usando o nome do projeto test . Após a implantação de cada teste, a tecla probes é usada para verificar se a resposta é o valor esperado. Se o valor não corresponder, você verá uma mensagem explicando a diferença. Se a implantação não for construída, você verá uma mensagem mais genérica como a seguinte:

[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]

Nesses casos, você pode visitar o URL da implantação com falha e append /_logs para ver o erro de compilação. No caso acima, isso seria https://test-8ashcdlew.vercel.app/_logs

Os registros dessa implantação conterão o erro real que pode ajudá -lo a entender o que deu errado.

Executando testes de integração localmente

Embora a execução do conjunto de integração completo localmente não seja recomendado, às vezes é útil isolar um teste de falha executando -o em sua máquina. Para fazer isso, você precisará garantir que você tenha as credenciais apropriadas fornecidas em seu shell:

Crie um token de acesso. Siga os insrúcios aqui https://vercel.com/docs/rest-api#creating-an-access-token. Verifique se o escopo do token é para sua conta pessoal.
Pegue o ID da equipe no painel Vercel em https://vercel.com/<MY-TEAM>/~/settings ~/settings.
Goste-os no seu arquivo shell rc: echo 'export VERCEL_TOKEN=<MY-TOKEN> VERCEL_TEAM_ID=<MY-TEAM-ID>' >> ~/.zshrc

A partir daí, você poderá acionar um teste de integração. Escolha um que já esteja isolado para verificar se as coisas funcionam:

cd packages/next

Execute o teste:

pnpm test test/fixtures/00-server-build/index.test.js

@vercel/nft

Alguns dos construtores usam @vercel/nft para arquivos de shake de árvore antes da implantação. Se você suspeitar de um erro com este mecanismo de troca de árvores, poderá criar o seguinte script em seu projeto:

 const {nodeFileTrace} = requer ('@vercel/nft'); nodeFileTrace (['caminho/to/entradas
  TS: Verdadeiro,
  ModedModules: True,})
  .Then (o => console.log (O.Filelist))
  .Then (e => console.error (e));

Ao executar esse script, você verá todos os arquivos importados. Se falta os arquivos, o bug está em @vercel/nft e não no construtor.

Implantar um construtor com projeto existente

Às vezes, você deseja testar as alterações em um construtor em relação a um projeto existente, talvez com vercel dev ou a implantação real. Você pode evitar a publicação de cada construtor mudar para o NPM, carregando o construtor como um tarball.