2023-11-15 18:28:07 +00:00
|
|
|
### Building and Running Webapps
|
|
|
|
|
|
2023-11-15 18:37:30 +00:00
|
|
|
It is possible to build and run Next.js webapps using the `build-webapp` and `run-webapp` subcommands.
|
2023-11-15 18:28:07 +00:00
|
|
|
|
2023-11-15 18:37:30 +00:00
|
|
|
To make it easier to build once and deploy into different environments and with different configuration,
|
|
|
|
|
compilation and static page generation are separated in the `build-webapp` and `run-webapp` steps.
|
2023-11-15 18:28:07 +00:00
|
|
|
|
2023-11-15 18:37:30 +00:00
|
|
|
This offers much more flexibilty than standard Next.js build methods, since any environment variables accessed
|
|
|
|
|
via `process.env`, whether for pages or for API, will have values drawn from their runtime deployment environment,
|
|
|
|
|
not their build environment.
|
2023-11-15 18:28:07 +00:00
|
|
|
|
2023-11-15 18:37:30 +00:00
|
|
|
## Building
|
2023-11-15 18:28:07 +00:00
|
|
|
|
|
|
|
|
```
|
|
|
|
|
$ cd ~/cerc
|
|
|
|
|
$ git clone git@git.vdb.to:cerc-io/test-progressive-web-app.git
|
|
|
|
|
$ laconic-so build-webapp --source-repo ~/cerc/test-progressive-web-app
|
|
|
|
|
...
|
|
|
|
|
|
|
|
|
|
Built host container for ~/cerc/test-progressive-web-app with tag:
|
|
|
|
|
|
|
|
|
|
cerc/test-progressive-web-app:local
|
|
|
|
|
|
|
|
|
|
To test locally run:
|
|
|
|
|
|
|
|
|
|
laconic-so run-webapp --image cerc/test-progressive-web-app:local --env-file /path/to/environment.env
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
|
2023-11-15 18:37:30 +00:00
|
|
|
## Running
|
2023-11-15 18:28:07 +00:00
|
|
|
|
|
|
|
|
```
|
|
|
|
|
$ laconic-so run-webapp --image cerc/test-progressive-web-app:local --env-file ~/tmp/env.igloo
|
|
|
|
|
|
|
|
|
|
Image: cerc/test-progressive-web-app:local
|
|
|
|
|
ID: 4c6e893bf436b3e91a2b92ce37e30e499685131705700bd92a90d2eb14eefd05
|
|
|
|
|
URL: http://localhost:32768
|
|
|
|
|
```
|
