package main import ( "fmt" "io" ) // Wildcard domains need an ACME DNS-01 provider (cloudflare-dns or route53-dns); only one is active, Cloudflare first. func runDomains(prog string, args []string, stdout, stderr io.Writer, lookupEnv func(string) (string, bool)) int { if len(args) == 0 { _, _ = fmt.Fprint(stderr, domainsUsage(prog)) return exitUsage } switch args[0] { case "-h", "--help", "help": _, _ = fmt.Fprint(stdout, domainsUsage(prog)) return exitOK case "list": return runDomainsList(prog, args[1:], stdout, stderr, lookupEnv) case "cloudflare-dns": return runDomainsCloudflareDNS(prog, args[1:], stdout, stderr, lookupEnv) case "route53-dns": return runDomainsRoute53DNS(prog, args[1:], stdout, stderr, lookupEnv) case "google-cloud-dns": return runDomainsGoogleCloudDNS(prog, args[1:], stdout, stderr, lookupEnv) case "basic-auth": return runDomainsBasicAuth(prog, args[1:], stdout, stderr, lookupEnv) case "auth-gate": return runDomainsAuthGate(prog, args[1:], stdout, stderr, lookupEnv) case "limits": return runDomainsLimits(prog, args[1:], stdout, stderr, lookupEnv) case "tuning": return runDomainsTuning(prog, args[1:], stdout, stderr, lookupEnv) case "maintenance": return runDomainsMaintenance(prog, args[1:], stdout, stderr, lookupEnv) case "redirect": return runDomainsRedirect(prog, args[1:], stdout, stderr, lookupEnv) case "tls-cert": return runDomainsTLSCert(prog, args[1:], stdout, stderr, lookupEnv) case "wait": return runDomainsWait(prog, args[1:], stdout, stderr, lookupEnv) case "watch": return runDomainsWatch(prog, args[1:], stdout, stderr, lookupEnv) case "check": return runDomainsCheck(prog, args[1:], stdout, stderr, lookupEnv) case "check-all": return runDomainsCheckAll(prog, args[1:], stdout, stderr, lookupEnv) case "doctor": return runDomainsDoctor(prog, args[1:], stdout, stderr, lookupEnv) case "www-apply": return runDomainsWWWApply(prog, args[1:], stdout, stderr, lookupEnv) case "www-plan": return runDomainsWWWPlan(prog, args[1:], stdout, stderr, lookupEnv) case "cutover": return runDomainsCutover(prog, args[1:], stdout, stderr, lookupEnv) case "diagnose": return runDomainsDiagnose(prog, args[1:], stdout, stderr, lookupEnv) case "add": return runDomainsAdd(prog, args[1:], stdout, stderr, lookupEnv) case "summary": return runDomainsSummary(prog, args[1:], stdout, stderr, lookupEnv) case "activity": return runDomainsActivity(prog, args[1:], stdout, stderr, lookupEnv) case "connectivity": return runDomainsConnectivity(prog, args[1:], stdout, stderr, lookupEnv) case "cert": return runDomainsCert(prog, args[1:], stdout, stderr, lookupEnv) case "certificates": return runDomainsCertificates(prog, args[1:], stdout, stderr, lookupEnv) case "waf": return runDomainsWAF(prog, args[1:], stdout, stderr, lookupEnv) case "error-pages": return runDomainsErrorPages(prog, args[1:], stdout, stderr, lookupEnv) case "search-visibility": return runDomainsSearchVisibility(prog, args[1:], stdout, stderr, lookupEnv) case "dns": return runDomainsDNS(prog, args[1:], stdout, stderr, lookupEnv) case "dns-provider": return runDNSProvider(prog, "domains dns-provider", args[1:], false, stdout, stderr, lookupEnv) case "dns-status": return runDomainDNSStatus(prog, args[1:], stdout, stderr, lookupEnv) case "go-live": return runDomainsGoLive(prog, args[1:], stdout, stderr, lookupEnv) case "changes": return runDomainsChanges(prog, args[1:], stdout, stderr, lookupEnv) case "rollback": return runDomainsRollback(prog, args[1:], stdout, stderr, lookupEnv) case "backfill-base-domain": return runDomainsBackfillBaseDomain(prog, args[1:], stdout, stderr, lookupEnv) case "headers": return runDomainsHeaders(prog, args[1:], stdout, stderr, lookupEnv) case "forwarders": return runDomainsForwarders(prog, args[1:], stdout, stderr, lookupEnv) case "geo": return runDomainsGeo(prog, args[1:], stdout, stderr, lookupEnv) case "shield": return runDomainsShield(prog, args[1:], stdout, stderr, lookupEnv) case "cache": return runDomainsCache(prog, args[1:], stdout, stderr, lookupEnv) case "redirects": return runDomainsRedirects(prog, args[1:], stdout, stderr, lookupEnv) case "park": return runDomainsPark(prog, args[1:], stdout, stderr, lookupEnv) case "move": return runDomainsMove(prog, args[1:], stdout, stderr, lookupEnv) case "batch": return runDomainsBatch(prog, args[1:], stdout, stderr, lookupEnv) case "export": return runDomainsExport(prog, args[1:], stdout, stderr, lookupEnv) case "parked": return runDomainsParked(prog, args[1:], stdout, stderr, lookupEnv) case "standalone": return runDomainsStandalone(prog, args[1:], stdout, stderr, lookupEnv) case "ports": return runDomainsPorts(prog, args[1:], stdout, stderr, lookupEnv) case "provider": return runDomainsProvider(prog, args[1:], stdout, stderr, lookupEnv) default: _, _ = fmt.Fprintf(stderr, "%s: unknown domains subcommand %q\n\n", prog, args[0]) _, _ = fmt.Fprint(stderr, domainsUsage(prog)) return exitUsage } } func domainsUsage(prog string) string { return fmt.Sprintf(`Usage: %[1]s domains list [flags] list every app's domains in one call %[1]s domains cloudflare-dns [flags] configure wildcard-domain ACME DNS-01 via Cloudflare %[1]s domains route53-dns [flags] configure wildcard-domain ACME DNS-01 via Route53 %[1]s domains google-cloud-dns [flags] connect Google Cloud DNS for records and wildcard certificates %[1]s domains basic-auth [flags] protect an app's domain with HTTP Basic Auth %[1]s domains auth-gate [flags] check every request with your auth service or built-in sign-in %[1]s domains limits [flags] cap a domain's request body size and upstream timeouts %[1]s domains tuning [flags] proxy tuning presets: compression, streaming, websocket, timeouts %[1]s domains maintenance [flags] take one of an app's domains in or out of maintenance mode %[1]s domains redirect [flags] point one of an app's domains at a target URL %[1]s domains tls-cert [flags] upload or clear a domain's own (BYO) TLS certificate %[1]s domains check [flags] run a real DNS lookup and report whether the domain reaches this control plane %[1]s domains wait [--timeout 10m] wait until a new domain is live (DNS and certificate) %[1]s domains watch list [flags] list the domains being followed in the background %[1]s domains www-apply [--mode both|apex_only|www_only] [--canonical apex|www] [--replace] [--yes] write apex and www DNS records %[1]s domains check-all [--app ] [flags] check every domain: DNS, certificate, site, next step %[1]s domains doctor [flags] run every domain check and print a prioritised fix list %[1]s domains www-plan [--mode both|apex_only|www_only] [--canonical apex|www] preview apex and www DNS records %[1]s domains diagnose [flags] why isn't my domain working: every check with the exact fix, optionally applied with --fix %[1]s domains cutover [flags] test before you switch: app, certificate, DNS and downtime risk %[1]s domains add ... [flags] add domains and print the exact DNS records to create %[1]s domains summary [flags] count domains by status and certificates needing attention %[1]s domains activity [flags] list a domain's recent changes and certificate events %[1]s domains connectivity [flags] check whether ports 80/443 reach this node and whether HTTP-01 can work %[1]s domains cert [--staging] [--wait] get a real Let's Encrypt certificate for a domain, with a preflight %[1]s domains certificates [flags] list every certificate in certmagic storage, healthy or not %[1]s domains waf [flags] configure a domain's opt-in WAF and rate limiting %[1]s domains error-pages [flags] configure a domain's custom error pages (404, 500, 502, 503) %[1]s domains search-visibility [--hide|--show] hide a domain from search engines %[1]s domains dns [flags] list/add/remove the real DNS records in a domain's zone %[1]s domains dns-provider [flags] where the domain's DNS lives and whether it is connected %[1]s domains dns-status [--app NAME] each required record: live, waiting, different, conflict or unknown %[1]s domains go-live [flags] create the DNS record and watch the domain go live %[1]s domains go-live runs|undo [flags] automation history and one-step undo %[1]s domains changes [--json] recent changes and whether each can be rolled back %[1]s domains rollback [--yes] [--json] undo one DNS change or domain move inside the window %[1]s domains backfill-base-domain [flags] give existing apps without a domain . %[1]s domains park [flags] take a domain off an app but keep it registered %[1]s domains move --from A --to B hand a domain to another app (collision check, --confirm) %[1]s domains parked [flags] list, attach or delete parked domains %[1]s domains export [--out FILE] export every domain and parked domain as CSV %[1]s domains batch [flags] ... park, move, attach or delete-parked several domains at once %[1]s domains standalone [flags] proxy a domain to a port, address or URL without an app %[1]s domains provider [flags] choose the free wildcard-DNS provider for automatic hostnames %[2]s Run "%[1]s domains -h" for a subcommand's own flags. `, prog, domainsPoliciesUsageLines(prog)) }