From 9c48c2b58e1168ef6c4dc698f8e9892f532689e0 Mon Sep 17 00:00:00 2001 From: Lee Robinson Date: Mon, 31 Jan 2022 13:15:59 -0600 Subject: [PATCH] Update deployment documentation for Vercel. (#2500) * Update deployment documentation for Vercel. * Update spanish docs too. * Apply suggestions from code review --- docs/src/pages/en/guides/deploy.md | 25 +++++++++++++++++++++---- docs/src/pages/es/guides/deploy.md | 25 +++++++++++++++++++++---- 2 files changed, 42 insertions(+), 8 deletions(-) diff --git a/docs/src/pages/en/guides/deploy.md b/docs/src/pages/en/guides/deploy.md index f9d34e4be..d5b6797db 100644 --- a/docs/src/pages/en/guides/deploy.md +++ b/docs/src/pages/en/guides/deploy.md @@ -344,13 +344,30 @@ You can also deploy to a [custom domain](http://surge.sh/help/adding-a-custom-do ## Vercel -To deploy your Astro project with a [Vercel for Git](https://vercel.com/docs/git), make sure it has been pushed to a Git repository. +You can deploy Astro to [Vercel](http://vercel.com) through the CLI or the Vercel git integrations. -Go to https://vercel.com/import/git and import the project into Vercel using your Git of choice (GitHub, GitLab or BitBucket). Follow the wizard to select the project root with the project's `package.json` and override the build step using `npm run build` and the output dir to be `./dist` +### CLI -After your project has been imported, all subsequent pushes to branches will generate Preview Deployments, and all changes made to the Production Branch (commonly "main") will result in a Production Deployment. +1. Install the [Vercel CLI](https://vercel.com/cli) and run `vercel` to deploy. +2. When asked `Want to override the settings? [y/N]`, choose `Y`. +3. Update `Output Directory` to `./dist`. +4. Your application is deployed! (e.g. [astro.vercel.app](https://astro.vercel.app/)) -Once deployed, you will get a URL to see your app live, such as the following: https://astro.vercel.app +```bash +$ npm i -g vercel +$ vercel +``` + +### Git + +1. Push your code to your git repository (GitHub, GitLab, BitBucket). +2. [Import your project](https://vercel.com/new) into Vercel. +3. Update `Output Directory` to `./dist`. +4. Your application is deployed! (e.g. [astro.vercel.app](https://astro.vercel.app/)) + +After your project has been imported and deployed, all subsequent pushes to branches will generate [Preview Deployments](https://vercel.com/docs/concepts/deployments/environments#preview), and all changes made to the Production Branch (commonly “main”) will result in a [Production Deployment](https://vercel.com/docs/concepts/deployments/environments#production). + +Learn more about Vercel’s [Git Integration](https://vercel.com/docs/concepts/git). ## Azure Static Web Apps diff --git a/docs/src/pages/es/guides/deploy.md b/docs/src/pages/es/guides/deploy.md index 6f81c0125..8af1c4aa8 100644 --- a/docs/src/pages/es/guides/deploy.md +++ b/docs/src/pages/es/guides/deploy.md @@ -296,13 +296,30 @@ También puedes implementar en un [dominio personalizado](http://surge.sh/help/a ## Vercel -Para implementar tu proyecto Astro con [Vercel para Git](https://vercel.com/docs/git), asegúrate de que lo has enviado a un repositorio de Git. +Puede implementar Astro en [Vercel](http://vercel.com) a través de la CLI o las integraciones de Vercel Git. -Ve a https://vercel.com/import/git e importa el proyecto en Vercel utilizando tu elección de Git (GitHub, GitLab o BitBucket). Sigue el asistente para seleccionar la raíz del proyecto con el `package.json` del proyecto y anula el paso de compilación usando `npm run build` y el directorio de salida sea `./dist`. +### CLI -Una vez que se has importado tu proyecto, todos los envíos posteriores a las ramas generarán vistas previas de desarrollos y todos los cambios realizados en la rama de producción (comúnmente "main") darán como resultado un despliegue de producción. +1. Instale la [Vercel CLI](https://vercel.com/cli) y ejecute `vercel` para implementar. +2. Cuando se le pregunte `¿Desea anular la configuración? [s/N]`, seleccione `S`. +3. Actualice `Directorio de salida` a `./dist`. +4. ¡Su aplicación está implementada! (por ejemplo, [astro.vercel.app](https://astro.vercel.app/)) -Una vez desplegado, obtendrás una URL para ver tu aplicación en vivo, como la siguiente: https://astro.vercel.app +```jsx +$ npm i -g vercel +$ vercel +``` + +### Git + +1. Inserte su código en su repositorio git (GitHub, GitLab, BitBucket). +2. [Importe su proyecto](https://vercel.com/new) a Vercel. +3. Actualice `Directorio de salida` a `./dist`. +4. ¡Su aplicación está implementada! (por ejemplo, [astro.vercel.app](https://astro.vercel.app/)) + +Después de que su proyecto haya sido importado e implementado, todos los envíos subsiguientes a las sucursales generarán [Vista previa de implementaciones] (https://vercel.com/docs/concepts/deployments/environments#preview), y todos los cambios realizados en la rama de producción (comúnmente “principal”) dará como resultado una [Implementación de producción](https://vercel.com/docs/concepts/deployments/environments#production). + +Obtenga más información sobre [Git Integration] de Vercel (https://vercel.com/docs/concepts/git). ## Aplicaciones web estáticas de Azure