mirror of
https://github.com/psviderski/uncloud.git
synced 2026-08-26 11:03:34 +00:00
docs: 2 new pages: Connecting to a cluster and CLI configuration file
This commit is contained in:
@@ -0,0 +1,26 @@
|
||||
---
|
||||
sidebar_label: Overview
|
||||
---
|
||||
|
||||
# Ingress & HTTPS
|
||||
|
||||
Uncloud uses [Caddy](https://caddyserver.com/) as its reverse proxy to handle incoming traffic, provide automatic HTTPS
|
||||
with [Let's Encrypt](https://letsencrypt.org/), and route requests to your services.
|
||||
|
||||
## How it works
|
||||
|
||||
By default, Caddy runs as a global service `caddy` on every machine in your cluster, listening on the host ports 80
|
||||
(HTTP), 443 (HTTPS), and 443/UDP (HTTP/3).
|
||||
|
||||
It's deployed during cluster initialisation (`uc machine init`) unless you use the `--no-caddy` flag.
|
||||
See [Managing Caddy](3-managing-caddy.md) for deployment and customisation instructions.
|
||||
|
||||
When you [publish a service port](2-publishing-services.md), Uncloud automatically configures Caddy to:
|
||||
|
||||
1. Listen for requests on the specified hostname (domain name).
|
||||
2. Automatically obtain and renew a TLS certificate from Let's Encrypt for HTTPS.
|
||||
3. Route traffic to the **healthy** service container(s).
|
||||
4. Load balance across healthy replicas if there are multiple.
|
||||
|
||||
For advanced use cases, Uncloud allows to customise the Caddy config using the `x-caddy` extension in Compose files.
|
||||
See [Custom Caddy configuration](2-publishing-services.md#custom-caddy-configuration) for details.
|
||||
Reference in New Issue
Block a user