66 lines
2.1 KiB
Markdown
66 lines
2.1 KiB
Markdown
# GuestOps deployment
|
|
|
|
GuestOps is deployed by the central Futuresens Ansible repository. Sandbox is
|
|
`https://guestops-sandbox.futuresens.co.uk` and production is
|
|
`https://guestops.futuresens.co.uk`.
|
|
|
|
## Prepare a version
|
|
|
|
The .NET version in `Directory.Build.props` and the frontend version in
|
|
`web/package.json` must match. Test the committed revision, then package it:
|
|
|
|
```sh
|
|
dotnet run --project tests/GuestOps.Tests
|
|
python3 -m unittest discover -s tests -p "test_*.py"
|
|
cd web && npm ci && npm run build && cd ..
|
|
|
|
python3 deploy/package_release.py \
|
|
--ref FULL_COMMIT_OR_TAG \
|
|
--output-directory ../ansible/playbooks/files/guestops
|
|
```
|
|
|
|
For version `0.2.2`, this creates `guestops_0.2.2.tar.gz`. The archive contains
|
|
self-contained Linux x64 API and worker applications, including the built
|
|
frontend. Published version files are immutable; change the application version
|
|
before making another archive.
|
|
|
|
## Configure Ansible
|
|
|
|
The server group needs only the application switch, version and subdomain:
|
|
|
|
```yaml
|
|
hasguestops: true
|
|
guestopsversion: "0.2.2"
|
|
guestopssubdomain: "guestops-sandbox"
|
|
```
|
|
|
|
Production uses `guestopssubdomain: "guestops"`. The native services use the
|
|
existing MongoDB service on `127.0.0.1:27017`. Google sending,
|
|
automatic live replies, AI, PMS connections, and payment connections remain
|
|
disabled until they are configured separately.
|
|
|
|
## Deploy
|
|
|
|
Deploy sandbox first:
|
|
|
|
```sh
|
|
ansible-playbook playbooks/guestops.yml -K \
|
|
--extra-vars "thehost=sandbox"
|
|
```
|
|
|
|
After acceptance, deploy the same versioned archive to production:
|
|
|
|
```sh
|
|
ansible-playbook playbooks/guestops.yml -K \
|
|
--extra-vars "thehost=dbserver"
|
|
```
|
|
|
|
The playbook stops the existing systemd services, replaces `/srv/guestops`,
|
|
renders its environment configuration, starts the self-contained API and worker,
|
|
configures Nginx, and verifies local and public readiness. Port 8080 remains
|
|
loopback-only and `/var/lib/guestops/keys` survives redeployment.
|
|
|
|
To roll back, select an older retained native `guestopsversion` (version 0.2.2 or
|
|
later) in group vars and run the same playbook. MongoDB backup, Filebeat, certificates, and host monitoring
|
|
are provided by the existing central infrastructure.
|