Desarrollar. Avance. Barco.
Documentación · ChangeLog · Plantillas · CLI
El Frontend Cloud de Vercely proporciona la experiencia y la infraestructura del desarrollador para construir, escalar y asegurar una web más rápida y personalizada.
Comience importando un proyecto, eligiendo una plantilla o usando la CLI Vercel. Luego, git push
para desplegarse.
Para obtener detalles sobre cómo usar VERCEL, consulte nuestra documentación.
Este proyecto utiliza PNPM para instalar dependencias y ejecutar scripts.
Puede usar el script vercel
para ejecutar cambios locales como si estuviera invocando Vercli CLI. Por ejemplo, vercel deploy --cwd=/path/to/project
podría ejecutarse con cambios locales con pnpm vercel deploy --cwd=/path/to/project
.
Al contribuir a este repositorio, primero discuta el cambio que desea realizar a través de discusiones de GitHub con los propietarios de este repositorio antes de enviar una solicitud de extracción.
Lea nuestro código de conducta y sígalo en todas sus interacciones con el proyecto.
Este proyecto está configurado en un Monorepo, donde un repositorio contiene múltiples paquetes de NPM. Las dependencias se instalan y se gestionan con pnpm
, no en npm
CLI.
Para comenzar, ejecute lo siguiente:
git clone https://github.com/vercel/vercel cd vercel corepack enable pnpm install pnpm build pnpm lint pnpm test-unit
Asegúrese de que todas las pruebas pasen antes de hacer cambios.
Puede usar pnpm vercel
del paquete cli
para invocar el CLI Vercel con cambios locales:
cd ./packages/cli pnpm vercel <cli-commands...>
Vea el desarrollo local de CLI para obtener más detalles.
Una vez que haya terminado con sus cambios (incluso sugerimos hacerlo en el camino), asegúrese de que todas las pruebas aún pasen funcionando:
pnpm test-unit
de la raíz del proyecto.
Si alguna prueba falla, asegúrese de arreglarla junto con sus cambios. Consulte la interpretación de errores de prueba para obtener más información sobre cómo se ejecutan las pruebas, especialmente las pruebas de integración.
Una vez que esté seguro de que sus cambios funcionan correctamente, abra una solicitud de extracción en el repositorio principal.
La solicitud de extracción será revisada por los mantenedores y las pruebas serán verificadas por nuestra plataforma de integración continua.
Hay 2 tipos de pruebas en este repositorio: pruebas unitarias y pruebas de integración.
Las pruebas unitarias se ejecutan localmente con jest
y se ejecutan rápidamente porque están probando las unidades de código más pequeñas.
Las pruebas de integración crean implementaciones en su cuenta Vercel utilizando el nombre del proyecto test
. Después de implementar cada prueba, la clave probes
se usa para verificar si la respuesta es el valor esperado. Si el valor no coincide, verá un mensaje que explica la diferencia. Si la implementación no se construyó, verá un mensaje más genérico como el siguiente:
[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]
En tales casos, puede visitar la URL de la implementación fallida y agregar /_logs
para ver el error de compilación. En el caso anterior, eso sería https://test-8ashcdlew.vercel.app/_logs
Los registros de esta implementación contendrán el error real que puede ayudarlo a comprender lo que salió mal.
Si bien no se recomienda la suite de integración completa localmente, a veces es útil aislar una prueba de falla ejecutándola en su máquina. Para hacerlo, deberá asegurarse de tener las credenciales apropiadas obtenidas en su caparazón:
Crea un token de acceso. Siga las insructivas aquí https://vercel.com/docs/rest-api#creating-an-access-token. Asegúrese de que el alcance del token sea para su cuenta personal.
Tome la ID del equipo desde el tablero de Vercelicidad en https://vercel.com/<MY-TEAM>/~/settings
~/settings.
Fuente estos en su archivo shell rc: echo 'export VERCEL_TOKEN=<MY-TOKEN> VERCEL_TEAM_ID=<MY-TEAM-ID>' >> ~/.zshrc
A partir de ahí, debería poder activar una prueba de integración. Elija uno que ya esté aislado para verificar que las cosas funcionen:
cd packages/next
Ejecute la prueba:
pnpm test test/fixtures/00-server-build/index.test.js
Algunos de los constructores usan @vercel/nft
a los archivos de Shake de Tree antes de la implementación. Si sospecha un error con este mecanismo de sacudida de árboles, puede crear el siguiente script en su proyecto:
const {nodefiletrace} = require ('@vercel/nft'); nodefiletrace (['ruta/a/entrypoint.js'], { TS: Verdadero, mixedmodules: verdadero,}) .Then (o => console.log (O.Filelist)) .Then (e => console.error (e));
Cuando ejecute este script, verá todos los archivos importados. Si faltan archivos, el error está en @Vercel/NFT y no en el constructor.
A veces desea probar los cambios en un constructor contra un proyecto existente, tal vez con vercel dev
o implementación real. Puede evitar publicar cada cambio de constructor a NPM cargando el constructor como tarball.
Cambiar directorio al cd ./packages/node
Ejecute pnpm build
para compilar TypeScript y otros pasos de compilación
Ejecute npm pack
para crear un archivo de tarball
Ejecute vercel *.tgz
para cargar el archivo de tarball y obtener una URL
Edite cualquier proyecto vercel.json
existente y reemplace use
con la URL
Ejecute vercel
o vercel dev
para implementar con el generador experimental
Código de conducta
Pautas contribuyentes
Licencia Apache 2.0