2017-03-09 15:12:01 -05:00
|
|
|
# Miscellaneous - Debug docker container
|
|
|
|
|
|
|
|
|
|
|
|
TODO (gkalpak): Add docs. Mention:
|
|
|
|
- `aio-health-check`
|
|
|
|
- `aio-verify-setup`
|
|
|
|
- Test nginx accessible at:
|
2018-08-15 08:47:45 -04:00
|
|
|
- `http://$TEST_AIO_NGINX_HOSTNAME:$TEST_AIO_NGINX_PORT_HTTP`
|
|
|
|
- `https://$TEST_AIO_NGINX_HOSTNAME:$TEST_AIO_NGINX_PORT_HTTPS`
|
|
|
|
- Test preview-server accessible at:
|
|
|
|
- `http://$TEST_AIO_PREVIEW_SERVER_HOSTNAME:$TEST_AIO_PREVIEW_SERVER_PORT`
|
2017-03-09 15:12:01 -05:00
|
|
|
- Local DNS (via dnsmasq) maps the above hostnames to 127.0.0.1
|
2018-05-09 13:54:53 -04:00
|
|
|
|
|
|
|
|
2018-08-15 08:47:45 -04:00
|
|
|
## Developing the preview server TypeScript files
|
2018-05-09 13:54:53 -04:00
|
|
|
|
|
|
|
If you are running Docker on OS/X then you can benefit from linking the built TypeScript
|
|
|
|
files (i.e. `script-js/dist`) to the JavaScript files inside the Docker container.
|
|
|
|
|
|
|
|
First start watching and building the TypeScript files (in the host):
|
|
|
|
|
|
|
|
```bash
|
|
|
|
yarn build-watch
|
|
|
|
```
|
|
|
|
|
|
|
|
Now build, start and attach to the Docker container. See "Setting up the VM"
|
|
|
|
section in [TOC](_TOC.md). Then link the JavaScript folders (in the container):
|
|
|
|
|
|
|
|
```bash
|
|
|
|
aio-dev-mode
|
|
|
|
```
|
|
|
|
|
|
|
|
Now whenever you make changes to the TypeScript, it will be automatically built
|
|
|
|
in the host, and the changes are automatically available in the container.
|
|
|
|
You can then run the unit tests (in the container):
|
|
|
|
|
|
|
|
```bash
|
|
|
|
aio-verify-setup
|
|
|
|
```
|
|
|
|
|
|
|
|
Sometimes, the errors in the unit test log are not enough to tell you what went wrong.
|
2018-08-15 08:47:45 -04:00
|
|
|
In that case you can also look at the log of the preview-server itself.
|
2018-05-09 13:54:53 -04:00
|
|
|
A helper script that runs the unit tests (i.e. `aio-verify-setup`) and displays the
|
2018-08-15 08:47:45 -04:00
|
|
|
last relevant test-preview-server log is:
|
2018-05-09 13:54:53 -04:00
|
|
|
|
|
|
|
```bash
|
|
|
|
aio-verify-setup-and-log
|
|
|
|
```
|