Network FAQ
Network FAQ
Frequently asked questions about networking on Quake AI. The Network service (OpenStack Neutron) provides isolated project networks, routers, floating IPs, ports, and security groups.
Getting started#
What does the Quake AI Network service provide?
The Network service provides isolated project networks with subnets and DHCP, routers for internet-bound traffic, floating IPs for stable public access, ports for virtual network interfaces, and security groups for per-port firewall rules.
Source: Network overview
What networks does a project start with?
PublicEphemeralattaches an instance directly to a public network. Its address can change when the instance restarts.PublicStaticconnects private project networks to the internet through a router. Floating IPs provide stable inbound addresses.
Use a private network, router, floating IP, and explicit security group rules for public workloads that need stable addressing.
Source: Networks
What is the typical network setup for a public workload?
- Create a network and subnet.
- Create a router, set
PublicStaticas its external gateway, and attach the subnet. - Allocate a floating IP and associate it with the public instance.
- Apply security groups that allow only the required inbound and outbound traffic.
- Run TLS on the application server or a self-managed reverse proxy.
For global caching or request filtering, place a CDN or WAF in front of the public origin.
Source: Network overview
Core concepts#
What is the difference between a fixed IP and a floating IP?
A fixed IP belongs to a port on a project network. A floating IP is a public address mapped to that port through one-to-one NAT on the router. Floating IPs persist until you release them and can move between instance ports in the same region.
Source: Floating IPs
How do I allocate and associate a floating IP?
openstack floating ip create PublicStatic
openstack server add floating ip MY_INSTANCE FLOATING_IP_ADDRESSThe router must use PublicStatic as its external gateway and have an interface on the instance subnet.
Source: Allocate floating IP addresses
What are security groups, and what is their default behavior?
Security groups are stateful packet filters attached to ports. Rules allow traffic that matches their protocol, port, and source or destination. Traffic without a matching allow rule is dropped.
Custom groups begin with outbound rules. Add explicit inbound rules for SSH, HTTP, HTTPS, and application ports.
Source: Security groups
How do I distribute traffic across application instances?
Run a reverse proxy such as HAProxy, Nginx, Caddy, Traefik, or Envoy on a Compute instance. Give the proxy a floating IP, place application instances on a private network, and allow proxy-to-application traffic with security groups.
Configure health checks in the proxy. For an external edge, put a CDN or WAF in front of the proxy's public hostname.
Source: Edge reverse proxy template, Blue/green and canary deployments
How do TLS certificates work on Quake AI workloads?
Install the certificate on the application server or reverse proxy that terminates TLS. Certbot can issue and renew Let's Encrypt certificates on Linux instances. Caddy can request and renew certificates as part of its web server configuration.
If a CDN or WAF terminates public TLS, configure TLS from that service to the Quake AI origin as well.
Source: Let's Encrypt
Operations and troubleshooting#
My SSH connection times out on a new instance. What do I check?
Check the public address, security group, key pair, image username, and boot log in that order. Confirm the instance has a reachable floating IP and an ingress rule for TCP port 22 from your source address.
Source: Instance connectivity troubleshooting
My floating IP is associated, but internet traffic times out. What do I check?
Verify that the security group allows the application port, the router has PublicStatic as its external gateway, the router has an interface on the instance subnet, and the floating IP points to the expected port.
Source: Instance connectivity troubleshooting
How do I get help with a network problem?
Start with the instance connectivity runbook. If the runbook does not resolve the issue, open a support ticket with the instance UUID, floating IP, port ID, router ID, and relevant security group rule output.
Source: Get help, Instance connectivity troubleshooting
Migration#
How should I replace a managed cloud load balancer?
Choose an application-layer reverse proxy for regional traffic distribution. HAProxy and Nginx provide health checks and backend pools. Caddy and Traefik combine routing with certificate automation. Use an external CDN, WAF, or DNS traffic manager when the source architecture depends on global anycast, edge caching, managed WAF rules, or cross-region failover.
For Kubernetes workloads, a standard Service with type: LoadBalancer requests a public endpoint from the cluster.
Source: Network migration guides
What is Quake AI's equivalent of an AWS VPC?
A Quake AI network and subnet provide the private address space. A router supplies outbound SNAT and connects the subnet to PublicStatic. Floating IPs provide stable inbound addresses, and security groups filter traffic at each port.
Source: Migrate from AWS VPC