feat(dns): allow setting an externally managed cluster domain

This commit is contained in:
Pasha Sviderski committed 2026-09-25 16:20:54 +10:00
1 parent b28c458029
commit 9ee3ca15eb
21 files changed
+233 -136

No files matched your search

+1 -1
View File
@@ -18,7 +18,7 @@ A CLI tool for managing Uncloud resources such as machines, services, and volume
* [uc caddy](uc_caddy.md) - Manage Caddy reverse proxy service.
* [uc ctx](uc_ctx.md) - Switch between different cluster contexts. Contains subcommands to manage contexts.
* [uc deploy](uc_deploy.md) - Deploy services from a Compose file.
* [uc dns](uc_dns.md) - Manage cluster domain in Uncloud DNS.
* [uc dns](uc_dns.md) - Manage the cluster domain.
* [uc exec](uc_exec.md) - Execute a command in a running service container.
* [uc image](uc_image.md) - Manage images on machines in the cluster.
* [uc images](uc_images.md) - List images on machines in the cluster.
+5 -3
View File
@@ -1,12 +1,14 @@
# uc dns
Manage cluster domain in Uncloud DNS.
Manage the cluster domain.
## Synopsis
Manage cluster domain in Uncloud DNS.
Manage the cluster domain.
DNS commands allow you to reserve or release a unique 'xxxxxx.uncld.dev' domain for your cluster. When reserved, Caddy service deployments will automatically update DNS records to route traffic to the services in the cluster.
EXPERIMENTAL: Use 'uc dns set' to configure an externally managed domain instead. Uncloud does not manage DNS records for manually set domains.
## Options
```
@@ -27,6 +29,6 @@ DNS commands allow you to reserve or release a unique 'xxxxxx.uncld.dev' domain
* [uc](uc.md) - A CLI tool for managing Uncloud resources such as machines, services, and volumes.
* [uc dns release](uc_dns_release.md) - Release the reserved cluster domain.
* [uc dns reserve](uc_dns_reserve.md) - Reserve a cluster domain in Uncloud DNS.
* [uc dns set](uc_dns_set.md) - Set a cluster domain directly in the cluster.
* [uc dns set](uc_dns_set.md) - Set or unset an externally managed cluster domain (EXPERIMENTAL).
* [uc dns show](uc_dns_show.md) - Print the cluster domain name.
@@ -23,5 +23,5 @@ uc dns release [flags]
## See also
* [uc dns](uc_dns.md) - Manage cluster domain in Uncloud DNS.
* [uc dns](uc_dns.md) - Manage the cluster domain.
@@ -24,5 +24,5 @@ uc dns reserve [flags]
## See also
* [uc dns](uc_dns.md) - Manage cluster domain in Uncloud DNS.
* [uc dns](uc_dns.md) - Manage the cluster domain.
+12 -3
View File
@@ -1,15 +1,24 @@
# uc dns set
Set a cluster domain directly in the cluster.
Set or unset an externally managed cluster domain (EXPERIMENTAL).
## Synopsis
Set a cluster domain directly in the cluster, bypassing Uncloud DNS. This assumes the DNS is externally set up.
EXPERIMENTAL: Set the cluster domain used to generate ingress hostnames for services.
Configure wildcard DNS records for this domain with your DNS provider. Uncloud will not create, verify, update, or delete external DNS records.
Pass an empty string to unset a manually set domain. Use 'uc dns release' to release a domain reserved in Uncloud DNS. Setting or unsetting the domain does not change existing service hostnames.
```
uc dns set DOMAIN_NAME [flags]
```
## Examples
```
uc dns set apps.example.com
uc dns set ""
```
## Options
```
@@ -27,5 +36,5 @@ uc dns set DOMAIN_NAME [flags]
## See also
* [uc dns](uc_dns.md) - Manage cluster domain in Uncloud DNS.
* [uc dns](uc_dns.md) - Manage the cluster domain.
+1 -1
View File
@@ -23,5 +23,5 @@ uc dns show [flags]
## See also
* [uc dns](uc_dns.md) - Manage cluster domain in Uncloud DNS.
* [uc dns](uc_dns.md) - Manage the cluster domain.