Vai al contenuto
CivoCloudManager

DNS e domini Civo, modificati da una finestra Mac.

Punti un dominio sui nameserver di Civo e poi tieni la zona in un'app nativa invece che in una scheda del browser.

Civo ospita il DNS di domini che registri altrove. La preparazione è corta: sposti i nameserver dal registrar, crei il dominio dentro Civo, aggiungi i record. È la manutenzione dopo che fa male nel browser, perché il momento che conta di solito è una challenge di certificato a un'ora scomoda, e tu sei tre clic dentro una dashboard web a incollare un valore TXT sperando di non sbagliare un carattere. CivoCloudManager tiene la stessa zona sulla stessa Civo REST API v2, in una finestra che hai già aperta.

Puntare un dominio su Civo, dall'inizio alla fine

  1. 01

    Registra il dominio da un'altra parte

    Civo non vende registrazioni di domini. La sua documentazione è esplicita: il servizio DNS serve solo a ospitare la zona. Il dominio resta dal registrar da cui l'hai comprato, e a spostarsi è soltanto la delega dei nameserver.

  2. 02

    Imposta i nameserver su ns0.civo.com e ns1.civo.com

    Nel pannello del tuo registrar sostituisci i nameserver attuali con ns0.civo.com e ns1.civo.com. Sono i due hostname che Civo documenta. Quanto ci mette il cambio a fare effetto lo decidono il TTL della vecchia delega e il tuo registrar, non Civo, quindi metti in conto un'attesa prima che quello che aggiungi qui sotto sia visibile fuori.

  3. 03

    Crea il dominio in Civo perché la zona esista

    Delegare i nameserver non serve a niente finché Civo non ha una zona per cui rispondere. In CivoCloudManager è la vista Domains: il pulsante più nella toolbar crea il dominio. L'app lo manda all'endpoint /dns della REST API v2 di Civo. I domini valgono per tutto l'account e non sono legati a una regione, quindi la regione scelta nell'onboarding non recinta nessuna zona.

  4. 04

    Aggiungi i record

    Espandi un dominio nella lista e sotto compaiono i suoi record, ognuno con tipo, nome, valore e TTL. Add Record apre un editor con il selettore del tipo, un campo nome (www, mail o @ per l'apex), un campo valore, un TTL che parte da 600 e un campo priorità che compare solo se scegli MX o SRV.

  5. 05

    Verifica contro l'API, non solo contro il tuo resolver

    Ricarica il dominio nell'app per confermare che Civo abbia salvato quello che hai mandato. Se una risoluzione continua a fallire, la causa di solito è la delega o la cache, non un record sbagliato. La vista API Health dell'app ti dice in una schermata se l'endpoint DNS di Civo risponde, e questo separa un problema di Civo da un problema del resolver prima che tu cominci a tirare a indovinare.

I tipi di record che l'app scrive

Il selettore offre A, AAAA, CNAME, MX, TXT, SRV e NS. La priorità viene chiesta solo su MX e SRV, perché sono i due tipi che la portano. Il TTL è precompilato a 600, il default che Civo stessa documenta. La documentazione della CLI Civo nomina A, CNAME, TXT, SRV e MX, quindi se scrivi un AAAA o un NS leggi la risposta che l'app ti mostra invece di dare per scontato che sia andata. Cancellare un record è lento apposta: il foglio di conferma ti fa digitare l'etichetta del record esattamente come la vedi prima che il pulsante di cancellazione si attivi.

Perché un editor nativo vince durante una challenge di certificato

Una challenge ACME DNS-01 ti dà una stringa lunga e casuale e una finestra corta. Nell'app il dominio si espande sul posto, i record esistenti restano visibili mentre lavori, e scegliendo Edit su un record si apre un foglio già compilato con tipo, nome, valore e TTL attuali, quindi correggere un valore TXT è seleziona, incolla, salva. Niente cambia pagina, niente si ricarica, e il record con cui stai confrontando è ancora sullo schermo. Un form web che ricarica la pagina dopo ogni salvataggio ti costa l'unica cosa che in quel momento non hai, cioè attenzione.

Il reverse DNS sta sull'istanza, non nella zona

Il reverse DNS è una funzione Civo vera con documentazione scarna, e non fa parte della zona DNS. È una proprietà dell'istanza, quindi lo imposti nella vista di dettaglio dell'istanza: la riga Reverse DNS mostra l'hostname attuale oppure Not set, e cliccandola la riga diventa un campo di testo. Il salvataggio scrive il campo reverse_dns sull'istanza e il cambio finisce nel log attività locale dell'app con data e ora. Conta soprattutto per qualsiasi cosa mandi posta, perché i server riceventi controllano spesso che un IP risolva verso un hostname plausibile.

Cosa non è: non sostituisce external-dns

external-dns è un controller Kubernetes con un provider Civo integrato che si autentica con un CIVO_TOKEN e crea i record da solo a partire da Service e Ingress. CivoCloudManager non fa niente del genere. Non ha nessun componente dentro il cluster, non reagisce a niente e non creerà mai un record perché è comparso un Service. Se i tuoi record devono seguire i workload, usa external-dns e continua a usarlo. I due convivono sullo stesso dominio senza conflitti finché lasci stare i nomi gestiti da external-dns: usa l'app per i record che appartengono a una persona, tipo l'apex, la posta, le stringhe di verifica e le deleghe, e lascia il resto al controller.

Quando i record non si propagano, escludi prima l'API

L'endpoint DNS è uno dei sedici endpoint REST Civo su cui l'app fa un controllo di salute dalla sezione Account. Ognuno viene chiamato a turno con un timeout di dieci secondi, e ottieni il codice di stato HTTP più il tempo di andata e ritorno in millisecondi, verde sotto 200 ms, arancione sotto 500 ms, rosso oltre. L'intestazione riassume il giro come All Systems Operational oppure come conteggio di endpoint non disponibili. È una cosa piccola che ti salva un tipo preciso di ora buttata: quando un record appena scritto non si vede, capisci se Civo abbia accettato la scrittura prima di metterti a svuotare cache e a dare la colpa al resolver.

Dove stanno le credenziali

Una sola API key Civo muove tutto questo e vive nel Keychain di macOS, con Touch ID richiesto prima che l'app la mostri. Fra il Mac e Civo non c'è nessun server dell'editore, e non c'è telemetria. L'app è in sandbox con quattro entitlement, richiede macOS 15 o successivo su Apple silicon o Intel, e il sorgente è consultabile su github.com/marcelrgberger/civo-cloud-manager se preferisci leggere il codice delle richieste invece di fidarti di una descrizione.

Tre modi per cambiare un record Civo

Più che concorrenti sono lavori diversi. La divisione onesta è che uno serve all'automazione e due servono alle persone.

Capacità Dashboard Civo (browser)external-dnsCivoCloudManager
Modificare un singolo record a mano Non è il suo scopoSì, in un editor precompilato
Creare record automaticamente da Service e Ingress Kubernetes NoSì, è il suo motivo di esistereNo, e non lo farà mai
Richiede un cluster Kubernetes attivo NoNo
Reverse DNS su un'istanza NoSì, in linea sull'istanza
Dove vive la API key Sessione del browserSecret Kubernetes nel clusterKeychain di macOS, Touch ID per svelarla
Salute degli endpoint della Civo API NoNoSedici endpoint con stato e latenza

Domande sul DNS Civo, con risposta

Come punto il mio dominio su Civo?
Cambia i nameserver dal tuo registrar in ns0.civo.com e ns1.civo.com, poi crea il dominio dentro Civo perché ci sia una zona a rispondere. Civo ospita il DNS ma non registra domini, quindi il dominio resta dove l'hai comprato. Servono tutte e due le metà: una delega senza zona non restituisce niente, e una zona senza delega non viene mai interrogata.
Quali tipi di record DNS posso modificare in CivoCloudManager?
Il selettore offre A, AAAA, CNAME, MX, TXT, SRV e NS. Il campo priorità compare solo per MX e SRV, e il TTL è precompilato a 600, il default documentato da Civo. La documentazione della CLI Civo elenca A, CNAME, TXT, SRV e MX, quindi controlla la risposta dopo aver scritto il tuo primo record AAAA o NS.
Posso modificare il DNS Civo senza usare il browser?
Sì. La Civo CLI lo fa da terminale e CivoCloudManager lo fa da una finestra macOS nativa usando la stessa Civo REST API v2. Nell'app i domini si espandono sul posto per mostrare i loro record, Edit apre un foglio precompilato con i valori attuali, e per cancellare devi digitare l'etichetta del record come conferma.
CivoCloudManager sostituisce external-dns?
No. external-dns è un controller Kubernetes con un provider Civo integrato che crea e rimuove record da solo mentre Service e Ingress cambiano. CivoCloudManager non ha nessun componente dentro il cluster e non crea niente di sua iniziativa. Falli girare tutti e due sullo stesso dominio: il controller possiede i nomi che gestisce, il resto è tuo.
A cosa serve il reverse DNS e dove si imposta su Civo?
Il reverse DNS mappa l'IP di un'istanza su un hostname, e chi riceve posta lo controlla di routine prima di accettare un messaggio. Su Civo è una proprietà dell'istanza e non una voce della tua zona, quindi in CivoCloudManager lo imposti nella vista di dettaglio dell'istanza: clicchi la riga Reverse DNS, scrivi l'hostname, salvi.

Tieni la zona dove hai già le mani.

CivoCloudManager è un acquisto una tantum sul Mac App Store, con sette giorni di accesso completo dal primo avvio e un piano firewall in barra dei menu che resta gratis anche dopo.