NGINX Workers
This playbook deploys NGINX on existing anycast worker nodes provisioned by netactuate-ansible-bgp-bird2. Run this after your anycast BGP infrastructure is deployed and verified.
Prerequisites
- Existing anycast nodes from netactuate-ansible-bgp-bird2 or netactuate-ansible-bgp-frr
- BGP sessions established and anycast IPs bound
- Ansible and venv already set up (from the BGP deployment)
Playbook Repository
git clone https://github.com/netactuate/netactuate-ansible-nginx
Configuration
group_vars/all
| Variable | Type | Default | Description |
|---|---|---|---|
nginx_port | integer | 80 | Port NGINX listens on |
nginx_worker_processes | string | auto | NGINX worker process count |
Inventory
Reuse the hosts file from your BGP deployment, or create one pointing to existing nodes:
[nodes]
worker-LAX.example.com ansible_host=192.0.2.10 ansible_user=ubuntu
worker-AMS.example.com ansible_host=192.0.2.11 ansible_user=ubuntu
Deployment
ansible-playbook nginx.yaml
Validation
curl http://YOUR_ANYCAST_IP
The response includes the node's hostname and PoP location. Response headers X-Node and X-Location identify which PoP served the request.
Teardown
Node deletion is handled by the BGP playbook's deletenode.yaml.
Need Help?
If you need assistance deploying NGINX workers, visit our support page.