mirror of https://github.com/nuxt/nuxt.git
docs: update deployment urls & azure instructions (#4193)
* docs: update deployment urls & azure instructions * style: lint
This commit is contained in:
Daniel Roe
GitHub
parent
4253d2ed62
commit
0e4def19f8
|
|
@ -4,7 +4,69 @@ icon: LogoAzure
|
|||
|
||||
# Azure
|
||||
|
||||
How to deploy Nuxt to Azure Static Web Apps or Azure Functions.
|
||||
How to deploy to Azure Static Web Apps or Azure Functions with Nitro.
|
||||
|
||||
## Azure Static Web Apps
|
||||
|
||||
How to deploy to Azure Static Web Apps with Nitro.
|
||||
|
||||
::list
|
||||
|
||||
- Support for serverless SSR build
|
||||
- Auto-detected when deploying
|
||||
- Minimal configuration required
|
||||
::
|
||||
|
||||
### Setup
|
||||
|
||||
Azure Static Web Apps are designed to be deployed continuously in a [GitHub Actions workflow](https://docs.microsoft.com/en-us/azure/static-web-apps/github-actions-workflow). By default, Nitro will detect this deployment environment and enable the `azure` preset.
|
||||
|
||||
### Local preview
|
||||
|
||||
You can invoke a development environment to preview before deploying.
|
||||
|
||||
```bash
|
||||
NITRO_PRESET=azure yarn build
|
||||
npx @azure/static-web-apps-cli start .output/public --api-location .output/server
|
||||
```
|
||||
|
||||
### Deploy from CI/CD via GitHub Actions
|
||||
|
||||
When you link your GitHub repository to Azure Static Web Apps, a workflow file is added to the repository.
|
||||
|
||||
When you are asked to select your framework, select custom and provide the following information:
|
||||
|
||||
| Input | Value |
|
||||
| --- | --- |
|
||||
| **app_location** | '/' |
|
||||
| **api_location** | '.output/server' |
|
||||
| **output_location** | '.output/public' |
|
||||
|
||||
If you miss this step, you can always find the build configuration section in your workflow and update the build configuration:
|
||||
|
||||
```yml{}[.github/workflows/azure-static-web-apps-<RANDOM_NAME>.yml]
|
||||
###### Repository/Build Configurations ######
|
||||
app_location: '/'
|
||||
api_location: '.output/server'
|
||||
output_location: '.output/public'
|
||||
###### End of Repository/Build Configurations ######
|
||||
```
|
||||
|
||||
#### Note
|
||||
|
||||
Pending an update in the [Azure Static Web Apps workflow](https://github.com/Azure/static-web-apps-deploy), you will also need to run the following in your root directory:
|
||||
|
||||
```bash
|
||||
mkdir -p .output/server
|
||||
touch .output/server/.gitkeep
|
||||
git add -f .output/server/.gitkeep
|
||||
```
|
||||
|
||||
That's it! Now Azure Static Web Apps will automatically deploy your Nitro-powered Nuxt application on push.
|
||||
|
||||
### Demo
|
||||
|
||||
A live demo is available on <https://icy-pond-008be3f03.1.azurestaticapps.net/>.
|
||||
|
||||
## Azure Functions
|
||||
|
||||
|
|
@ -36,7 +98,7 @@ Install [Azure Functions Core Tools](https://docs.microsoft.com/en-us/azure/azur
|
|||
You can invoke a development environment from the serverless directory.
|
||||
|
||||
```bash
|
||||
NITRO_PRESET=azure_functions yarn build
|
||||
NITRO_PRESET=azure-functions yarn build
|
||||
cd .output
|
||||
func start
|
||||
```
|
||||
|
|
@ -103,7 +165,7 @@ jobs:
|
|||
- name: Build
|
||||
run: npm run build
|
||||
env:
|
||||
NITRO_PRESET: azure_functions
|
||||
NITRO_PRESET: azure-functions
|
||||
|
||||
- name: 'Deploy to Azure Functions'
|
||||
uses: Azure/functions-action@v1
|
||||
|
|
@ -119,66 +181,4 @@ Consider [turning on immutable packages](https://docs.microsoft.com/en-us/azure/
|
|||
|
||||
### Demo
|
||||
|
||||
A live demo is available on <https://nuxt-nitro.azurewebsites.net/>
|
||||
|
||||
## Azure Static Web Apps
|
||||
|
||||
::alert{type=warning icon=🚧}
|
||||
Azure Static Web Apps currently defaults to a Node.js 12.x runtime, which means it is not currently compatible with Nuxt Nitro. For now, you can deploy via [Azure Functions](#azure-functions) instead.
|
||||
::
|
||||
|
||||
How to deploy Nuxt to Azure Static Web Apps with Nuxt Nitro.
|
||||
|
||||
::list
|
||||
|
||||
- Support for serverless SSR build
|
||||
- Auto-detected when deploying
|
||||
- Minimal configuration required
|
||||
::
|
||||
|
||||
### Setup
|
||||
|
||||
Azure Static Web Apps are designed to be deployed continuously in a [GitHub Actions workflow](https://docs.microsoft.com/en-us/azure/static-web-apps/github-actions-workflow). By default, Nitro will detect this deployment environment and enable the `azure` preset.
|
||||
|
||||
### Local preview
|
||||
|
||||
You can invoke a development environment to preview before deploying.
|
||||
|
||||
```bash
|
||||
NITRO_PRESET=azure yarn build
|
||||
npx @azure/static-web-apps-cli start .output/public --api-location .output/server
|
||||
```
|
||||
|
||||
### Deploy from CI/CD via GitHub Actions
|
||||
|
||||
When you link your GitHub repository to Azure Static Web Apps, a workflow file is added to the repository.
|
||||
|
||||
When you are asked to select your framework, select custom and provide the following information:
|
||||
|
||||
| Input | Value |
|
||||
| --- | --- |
|
||||
| **app_location** | '/' |
|
||||
| **api_location** | '.output/server' |
|
||||
| **output_location** | '.output/public' |
|
||||
|
||||
If you miss this step, you can always find the build configuration section in your workflow and update the build configuration:
|
||||
|
||||
```yml{}[.github/workflows/azure-static-web-apps-<RANDOM_NAME>.yml]
|
||||
###### Repository/Build Configurations ######
|
||||
app_location: '/'
|
||||
api_location: '.output/server'
|
||||
output_location: '.output/public'
|
||||
###### End of Repository/Build Configurations ######
|
||||
```
|
||||
|
||||
#### Note
|
||||
|
||||
Pending an update in the [Azure Static Web Apps workflow](https://github.com/Azure/static-web-apps-deploy), you will also need to run the following in your root directory:
|
||||
|
||||
```bash
|
||||
mkdir -p .output/server
|
||||
touch .output/server/.gitkeep
|
||||
git add -f .output/server/.gitkeep
|
||||
```
|
||||
|
||||
That's it! Now Azure Static Web Apps will automatically deploy your Nitro-powered Nuxt application on push.
|
||||
A live demo is available on <https://nitro-deployment.azurewebsites.net/>.
|
||||
|
|
|
|||
|
|
@ -133,4 +133,4 @@ See [more information on the service worker preset](/guide/deployment/presets/se
|
|||
|
||||
## Demo
|
||||
|
||||
A live demo is available on <https://nitro-demo.nuxt.workers.dev/>.
|
||||
A live demo is available on <https://nitro-deployment.pi0.workers.dev>.
|
||||
|
|
|
|||
|
|
@ -111,4 +111,4 @@ firebase deploy
|
|||
|
||||
## Demo site
|
||||
|
||||
A live demo is available on <https://nitro-demo-dfabe.web.app>.
|
||||
A live demo is available on <https://nitro-deployment.web.app/>.
|
||||
|
|
|
|||
|
|
@ -30,4 +30,4 @@ See [more information on the Lambda preset](/guide/deployment/presets/lambda) fo
|
|||
|
||||
## Demo
|
||||
|
||||
A live demo is available on <https://nitro-demo.netlify.app/>.
|
||||
A live demo is available on <https://nitro-deployment.netlify.app/>.
|
||||
|
|
|
|||
Loading…
Reference in New Issue