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_source.py \
|
|
--ref FULL_COMMIT_OR_TAG \
|
|
--output-directory ../ansible/playbooks/files/guestops
|
|
```
|
|
|
|
For version `0.2.1`, this creates `guestops_0.2.1.tar.gz`. 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.1"
|
|
guestopssubdomain: "guestops-sandbox"
|
|
```
|
|
|
|
Production uses `guestopssubdomain: "guestops"`. Runtime credentials and the
|
|
MongoDB connection string belong in encrypted Ansible Vault data. The MongoDB
|
|
URI must use a least-privilege `guestops` database user and an address reachable
|
|
from Docker containers.
|
|
|
|
## Deploy
|
|
|
|
Deploy sandbox first:
|
|
|
|
```sh
|
|
ansible-playbook playbooks/guestops.yml -K --ask-vault-pass \
|
|
--extra-vars "thehost=sandbox"
|
|
```
|
|
|
|
After acceptance, deploy the same versioned archive to production:
|
|
|
|
```sh
|
|
ansible-playbook playbooks/guestops.yml -K --ask-vault-pass \
|
|
--extra-vars "thehost=dbserver"
|
|
```
|
|
|
|
The playbook stops the existing Compose project without deleting volumes,
|
|
replaces `/srv/guestops`, renders private configuration, builds and starts the
|
|
API and worker, configures Nginx, and verifies local and public readiness. Port
|
|
8080 remains loopback-only and the `guestops_app-keys` volume survives
|
|
redeployment.
|
|
|
|
To roll back, select an older retained `guestopsversion` in group vars and run
|
|
the same playbook. MongoDB backup, Filebeat, certificates, and host monitoring
|
|
are provided by the existing central infrastructure.
|