Configurazione della tua istanza DNS Services
Impostare un'istanza IBM Cloud® DNS Services, zone DNS, reti consentite e record di risorse utilizzando l'interfaccia utente o l'API.
Creare un'istanza di DNS Services nella console
-
Aprire la pagina IBM Cloud Catalogo.
-
Selezionare la categoria Networking.
-
Fai clic sul tile DNS Services.
-
Scegli un piano.
-
Immettere il nome del servizio e fare clic su Crea.
Si viene reindirizzati alla pagina dell'istanza DNS Services che mostra le informazioni Zones DNS.
È inoltre possibile navigare direttamente nella creazione dell'istanza DNS Services andando alla voce del catalogo DNS Services.
Creare una zona DNS nella console
- Navigare nella pagina Risorse e selezionare la tua istanza DNS Services.
- Nella pagina Zones DNS, fare clic su Crea zona.
- Nel pannello Crea zona, inserire il proprio nome di zona. Facoltativamente, inserire un'etichetta e una descrizione.
- Fare clic su Crea zona nel pannello. Se la zona viene creata correttamente, si viene reindirizzati alla pagina Dettagli zona.
Creare un record di risorsa "A" nella console
- Navigare nella pagina Risorse e selezionare la tua istanza DNS Services. Quindi selezionare la tua zona.
- Nella pagina Dettagli DNS, fare clic sulla scheda Record DNS.
- Cliccare su Seleziona azione record e selezionare Aggiungi record dal menu elenco.
- Nel pannello Aggiungi record, selezionare il tipo di record DNS che si desidera aggiungere dal menu Tipo. In questo caso, selezionare il tipo A.
- Inserire i dati richiesti per il tipo di record DNS selezionato. In questo caso, per il tipo A, inserire Nome e IPv4 Indirizzo.
- Fare clic su Aggiungi record nel pannello.
Creazione di una rete consentita nella console
-
Navigare nella pagina Risorse e selezionare la tua istanza DNS Services. Quindi selezionare la tua zona.
-
Fare clic sulla scheda Reti consentite.
-
Fare clic su Aggiungi rete.
-
Nel pannello Aggiungi rete, selezionare la regione del proprio VPC dal menu Regione di rete.
-
Selezionare il VPC dal menu Rete che compare.
-
Fare clic su Aggiungi rete.
Questa richiesta aggiunge la rete VPC alla tua zona, dando così l'accesso di rete alla zona.
Verifica del setup
Per verificare che la tua istanza, zona e record si stiano eseguendo correttamente, eseguire il seguente comando dig:
dig @161.26.0.7 <Record type> <record name>
Esempio:
dig @161.26.0.7 A xyz.example.com
Creazione di un'istanza DNS Services con l'API
Consultare la documentazione creare una nuova istanza di risorsa per le API di Resource Controller. Notare che devono essere impostati i resource_group
e resource_plan_id
. Ogni account può avere più gruppi di risorse e ogni gruppo di risorse ha un ID univoco.
Impostare le variabili come segue per creare un'istanza del piano standard:
"resource_plan_id": "2c8fa097-d7c2-4df2-b53e-2efb7874cdf7",
Consultare la documentazione di Resource Controller API reference per ulteriori informazioni sull'utilizzo dell'API.
Le linee di comando per le istanze stanno utilizzando le API controller delle risorse, non le API DNS. Questi comandi sono equivalenti ai comandi ibmcloud resource service-instance
, che forniscono convenienza agli utenti DNS per
gestire le istanze DNS Services.
Creare una zona DNS con l'API
È necessario creare un VPC in modo da poter collegare la propria zona DNS al VPC.
Memorizzare l'endpoint API in una variabile, in modo da poterlo utilizzare nelle richieste API senza dover digitare l'intero URL. Ad esempio, per memorizzare l'endpoint in una variabile, eseguire questo comando:
DNSSVCS_ENDPOINT=https://api.dns-svcs.cloud.ibm.com
Per verificare che questa variabile sia salvata, eseguire echo $DNSSVCS_ENDPOINT
e verificare che la risposta non sia vuota.
Dopo aver raccolto i dettagli sulla propria istanza, eseguire il seguente comando curl
per creare una zona DNS:
Richiesta
- INSTANCE_ID: GUID dell'istanza
- TOKEN: token IAM OAUTH
curl -X POST \
$DNSSVCS_ENDPOINT/v1/instances/$INSTANCE_ID/dnszones \
-H "Authorization: $TOKEN" \
-d '{
"name": "example.com",
"description": "The DNS zone is used for VPCs in the us-east region",
"label": "us-east"
}'
Risposta
{
"id": "example.com:2d0f862b-67cc-41f3-b6a2-59860d0aa90e",
"created_on": "2019-01-01T05:20:00.12345Z",
"modified_on": "2019-01-01T05:20:00.12345Z",
"instance_id": "1407a753-a93f-4bb0-9784-bcfc269ee1b3",
"name": "example.com",
"description": "The DNS zone is used for VPCs in the us-east region",
"state": "pending_network_add",
"label": "us-east"
}
Creare una rete autorizzata con l'API
DNS Services consente la risoluzione del nome solo da un VPC che è stato aggiunto alla zona DNS.
Quando viene creata una zona DNS, il suo Stato è PENDING_NETWORK_ADD
. Per spostare la zona in stato ACTIVE
, aggiungere una voce per il proprio VPC alla rete consentita della zona.
Aggiungendo il vostro VPC alla rete consentita della vostra zona, le istanze di compimento sul vostro VPC possono accedere a questi record di risorse.
Richiesta
curl -X POST \
$DNSSVCS_ENDPOINT/v1/instances/$INSTANCE_ID/dnszones/$DNSZONE_ID/acls \
-H "Authorization: $TOKEN" \
-d '{
"type": "vpc",
"acl_data": {
"vpc_crn": "crn:v1:staging:public:is:us-east:a/40705ee14536813e2385f26c20be24a5::vpc:ed5e3cdd-8a4f-45ce-bae4-2774cb028caf"
}
}'
Risposta
{
"id": "fecd0173-3919-456b-b202-3029dfa1b0f7",
"created_on": "2019-01-01T05:20:00.12345Z",
"modified_on": "2019-01-01T05:20:00.12345Z",
"acl_data": {
"vpc_crn": "crn:v1:staging:public:is:us-east:a/40705ee14536813e2385f26c20be24a5::vpc:ed5e3cdd-8a4f-45ce-bae4-2774cb028caf"
},
"type": "vpc"
}
Creazione di un record di risorsa "A" con l'API
Un A Record (Address Record) è un record di risorse DNS che associa un dominio o un sottodominio ad un indirizzo IPv4.
Richiesta
name
: FQDN, comewww.example.com
o l'host, comewww
.type
: Tipo di record - A, AAAA, SRV e così via.ip
: indirizzo IP per il nome.ttl
: È tempo di vivere per il record di risorse.
curl -X POST \
$DNSSVCS_ENDPOINT/v1/instances/$INSTANCE_ID/dnszones/$DNSZONE_ID/resource_records \
-H "Authorization: $TOKEN" \
-d '{
"name":"www.example.com",
"type":"A",
"rdata": {
"ip":"1.2.6.7"
},
"ttl":300
}'
Risposta
{
"created_on":"2019-09-13 19:56:42.484382585 +0000 UTC",
"modified_on":"2019-09-13 19:56:42.484382585 +0000 UTC",
"rtype":"A",
"ttl":300,
"name":"www.example.com.testZone.com",
"id":"A:786c07c7-173e-473b-aa09-c186601a5709",
"rdata":{
"ip":"1.2.6.7"
}
}